SIMD.%type%.select()

SIMD.js n'est plus en phase de développement actif par le le TC39 et a été retiré du niveau 3. Cette fonctionnalité n'est plus en cours d'implémentation par les différents éditeurs de navigateur. Les opérations SIMD exposées au Web sont en cours de développement au sein de WebAssembly afin d'obtenir des opérations analogues à celles décrites par SIMD.js.

La méthode statique SIMD.%type%.select() permet de créer un nouveau type de donnée SIMD dont les valeurs des voies sont définies à partir d'un masque de sélection et de deux vecteurs sources.

Syntax

SIMD.Float32x4.select(mask, trueValue, falseValue)
SIMD.Float64x2.select(mask, trueValue, falseValue)

SIMD.Int8x16.select(mask, trueValue, falseValue)
SIMD.Int16x8.select(mask, trueValue, falseValue)
SIMD.Int32x4.select(mask, trueValue, falseValue)

SIMD.Uint8x16.select(mask, trueValue, falseValue)
SIMD.Uint16x8.select(mask, trueValue, falseValue)
SIMD.Uint32x4.select(mask, trueValue, falseValue)

Paramètres

mask

Un vecteur Int32x4, Int16x8 ou Int8x16 qui est utilisé comme masque de sélection.

trueValue

Si la valeur du masque de sélection correspond à true, on prendra la valeur de la voie à partir de ce vecteur.

falseValue

Si la valeur du masque de sélection correspond à false, on prendra la valeur de la voie à partir de ce vecteur.

Valeur de retour

Un nouveau type de donnée SIMD.

Description

La méthode SIMD.%type%.select() permet de sélectionner certaines voies à partir d'un masque de sélection. L'application d'un masque (également appelé « branching » en anglais) permet de n'agir que sur un fragment d'un vecteur et permettent de combiner différents vecteurs pour en fabriquer un autre.

Exemples

Masque de sélection défini statiquement

Dans cet exemple, on utilise le type Bool32x4 pour créer un masque de sélection sur mesure. Grâce à ce masque, on peut sélectionner la première et dernière voies d'un vecteur Float32x4. Ainsi, quand on utilise la fonction select, cela sélectionnera la première et dernière voie d'un vecteur a et la deuxième et troisième voie d'un vecteur b (dans le cas du second select ici, on prendra le vecteur sum).

var a = SIMD.Float32x4(1, 2, 3, 4);
var b = SIMD.Float32x4(5, 6, 7, 8);

var mask = SIMD.Bool32x4(true, false, false, true);

SIMD.Float32x4.select(mask, a, b);
// Float32x4[1, 6, 7, 4]

var sum = SIMD.Float32x4.add(a,b);
SIMD.Float32x4.select(mask, a, sum);
// Float32x4[1, 8, 10, 4]

Les opérations qui renvoient un masque de sélection

Toutes les opérations de comparaison SIMD renvoient un masque de comparaison qui permet de sélectionner le résultat de la comparaison effectué :

var a = SIMD.Float32x4(0, 12, 3, 4);
var b = SIMD.Float32x4(0, 6, 7, 50);

var mask = SIMD.Float32x4.lessThan(a,b);
// Bool32x4[false, false, true, true]

var result = SIMD.Float32x4.select(mask, a, b);
// Float32x4[0, 6, 3, 4]

Spécifications

Compatibilité des navigateurs

SIMD.js a été retiré des différents navigateurs. Cette API est encore présente dans Firefox Nightly mais sera retirée pour être remplacée par une implémentation WebAssembly. Cf. bug 1416723.

Voir aussi

• SIMD
• SIMD.%type%.selectBits()