Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
Le type de donnée SIMD.Int32x4
est un vecteur de 128 bits, découpé en 4 voies, chacune stockant des valeurs entières signées sur 32 bits.
SIMD.Int32x4 dans un registre SIMD 128 bits.
Syntaxe
SIMD.Int32x4(x, y, z, w);
Paramètres
x
Facultatif- Un entier qui fournit la valeur à utiliser pour la première voie, la valeur par défaut est 0.
y
Facultatif- Un entier qui fournit la valeur à utiliser pour la deuxième voie, la valeur par défaut est 0.
z
Facultatif- Un entier qui fournit la valeur à utiliser pour la troisième voie, la valeur par défaut est 0.
w
Facultatif- Un entier qui fournit la valeur à utiliser pour la quatrième voie, la valeur par défaut est 0.
Constructeurs
En plus des constructeurs simples, l'API SIMD fournit les constructeurs suivants. On notera qu'il est possible de convertir des données depuis un autre type SIMD vers Int32x4.
SIMD.Int32x4.splat()
- Crée un
Int32x4
dont toutes les voies reçoivent une valeur donnée.
Note : Les types SIMD ne fonctionnent pas avec l'opérateur new
, en effet les valeurs SIMD ne sont pas des valeurs « objectifiées » (à la différence des chaînes qu'on peut créer avec String(s)
et new String(s)
).
var v = new SIMD.Int32x4(1,2,3,4); // TypeError: SIMD.Int32x4 is not a constructor var w = new SIMD.Int32x4.splat(3); // TypeError: SIMD.Int32x4.splat is not a constructor
Il faut écrire :
var v = SIMD.Int32x4(1,2,3,4); var w = SIMD.Int32x4.splat(3);
Opérations
Pour réaliser des opérations avec des types de données SIMD, il est nécessaire d'utiliser des opération SIMD.
Vérification des types SIMD
SIMD.Int32x4.check()
- Renvoie un nouvel
Int32x4
si le paramètre passé est un type de donnée SIMD valide et si c'est le même queInt32x4
. Sinon, cette méthode lèvera une exceptionTypeError
.
Accéder aux voies et les modifier
SIMD.%type%.extractLane()
- Renvoie la valeur d'une voie donnée.
SIMD.%type%.replaceLane()
- Renvoie un nouveau vecteur
Int32x4
dont la voie donnée a été remplacée par la valeur fournie.
Chargement et enregistrement depuis les tableaux typés
SIMD.Int32x4.load()
SIMD.Int32x4.load1()
SIMD.Int32x4.load2()
SIMD.Int32x4.load3()
- Renvoie une nouvelle instance
Int32x4
dont les voies sont chargées avec les valeurs d'un tableau typé. SIMD.Int32x4.store()
SIMD.Int32x4.store1()
SIMD.Int32x4.store2()
SIMD.Int32x4.store3()
- Enregistre un
Int32x4
dans un tableau typé.
Opérations arithmétiques
SIMD.Int32x4.add()
- Renvoie un nouvel
Int32x4
avec la somme des voies (a + b
). SIMD.Int32x4.mul()
- Renvoieun nouvel
Int32x4
avec la multiplication des voies (a * b
). SIMD.Int32x4.neg()
- Renvoieun nouvel
Int32x4
avec les valeurs opposées des voies. SIMD.Int32x4.sub()
- Renvoie un nouvel
Int32x4
avec la soustraction des voies (a - b
).
Mélange et permutation
SIMD.Int32x4.shuffle()
- Renvoie un nouvel
Int32x4
dont les valeurs des voies ont été mélangées à partir de deux vecteurs. SIMD.Int32x4.swizzle()
- Renvoie un nouvel
Int32x4
dont les valeurs des voies ont été permutées.
Sélections
SIMD.Int32x4.select()
- Renvoie une nouvelle instance dont les valeurs des voies sont un mélange des différentes voies en fonction d'un masque de sélection.
Comparaisons
SIMD.Int32x4.equal()
- Renvoie un masque de sélection selon le résultat de
a == b
. SIMD.Int32x4.notEqual()
- Renvoie un masque de sélection selon le résultat de
a != b
. SIMD.Int32x4.lessThan()
- Renvoie un masque de sélection selon le résultat de
a < b
. SIMD.Int32x4.lessThanOrEqual()
- Renvoie un masque de sélection selon le résultat de
a <= b
. SIMD.Int32x4.greaterThan()
- Renvoie un masque de sélection selon le résultat de
a > b
. SIMD.Int32x4.greaterThanOrEqual()
- Renvoie un masque de sélection selon le résultat de
a >= b
.
Opérations logiques
SIMD.Int32x4.and()
- Renvoie un nouvel
Int32x4
dont les voies sont le résultat d'un ET logique sur les voies des instances fournies (a & b
). SIMD.Int32x4.or()
- Renvoie un nouvel
Int32x4
dont les voies sont le résultat d'un OU logique sur les voies des instances fournies (a | b
). SIMD.Int32x4.xor()
- Renvoie un nouvel
Int32x4
dont les voies sont le résultat d'un XOR logique sur les voies des instances fournies (a ^ b
). SIMD.Int32x4.not()
- Renvoie un nouvel
Int32x4
dont les voies sont le résultat d'un NON logique sur les voies des instances fournies (~a
).
Opérations de décalage
SIMD.Int32x4.shiftLeftByScalar()
- Renvoie un nouvel
Int32x4
dont les valeurs des voies sont décalées à gauche d'un certain nombre de bits (a << bits
). SIMD.Int32x4.shiftRightByScalar()
- Renvoie un nouvel
Int32x4
dont les valeurs des voies sont décalées à droite d'un certain nombre de bits.
Conversion
SIMD.Int32x4.fromFloat32x4()
- Crée un nouveau type de donnée
Int32x4
avec une conversion en flottant à partir d'unFloat32x4
. SIMD.Int32x4.fromFloat32x4Bits()
- Crée un nouveau type de donnée
Int32x4
avec une copie binaire à partir d'unFloat32x4
. SIMD.Int32x4.fromFloat64x2Bits()
- Crée un nouveau type de donnée
Int32x4
avec une copie binaire à partir d'unFloat64x2
. SIMD.Int32x4.fromInt16x8Bits()
- Crée un nouveau type de donnée
Int32x4
avec une copie binaire à partir d'unInt16x8
. SIMD.Int32x4.fromInt8x16Bits()
- Crée un nouveau type de donnée
Int32x4
avec une copie binaire à partir d'unInt8x16
.
Prototype du SIMD
Les méthodes et propriétés suivantes sont rattachées à SIMD.Int32x4.prototype
.
SIMD.Int32x4.prototype.constructor
- Définit la fonction qui crée le prototype de l'objet SIMD
SIMD.Int<code>32x4</code>.prototype.toLocaleString()
- Renvoie une chaîne localisée représentant le type SIMD et ses éléments. Elle surcharge la méthode
Object.prototype.toLocaleString()
. SIMD.Int<code>32x4</code>.prototype.toString()
- Renvoie une chaîne représentant le type SIMD et ses éléments. Elle surcharge la méthode
Object.prototype.toString()
. SIMD.Int<code>32x4</code>.prototype.valueOf()
- Renvoie la valeur primitive de l'objet SIMD.
SIMD.Int<code>32x4</code>.prototype.toSource()
- Renvoie une chaîne de caractère représentant le code source. Elle surcharge la méthode
Object.prototype.toSource()
.
Exemples
SIMD.Int32x4(1, 2, 3, 4); // Int32x4[1,2,3,4] SIMD.Int32x4(1, 2); // Int32x4[1,2,0,0] SIMD.Int32x4(); // Int32x4[0,0,0,0]
Spécifications
Spécification | Statut | Commentaires |
---|---|---|
SIMD La définition de 'Int32x4' dans cette spécification. |
Projet | Définition initiale. |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | Pas de support | Nightly build | Pas de support | Pas de support | Pas de support |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | Pas de support | Pas de support | Nightly build | Pas de support | Pas de support | Pas de support |