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.Float32x4
est un vecteur sur 128 bits, divisé en 4 voies, chacune stockant une valeur flottante à précision simple (Float32).
SIMD.Float32x4
dans un registre SIMD sur 128 bits
Syntaxe
SIMD.Float32x4(x, y, z, w);
Paramètres
Les valeurs passées en argument sont fournies comme des nombres flottants à précision double et sont convertis en nombres flottants à précision simple avant d'être stockés.
x
Facultatif- Un double qui définit la valeur à utiliser pour la première voie, la valeur par défaut est
NaN
. y
Facultatif- Un double qui définit la valeur à utiliser pour la deuxième voie, la valeur par défaut est
NaN
. z
Facultatif- Un double qui définit la valeur à utiliser pour la troisième voie, la valeur par défaut est
NaN
. w
Facultatif- Un double qui définit la valeur à utiliser pour la quatrième voie, la valeur par défaut est
NaN
.
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 Float32x4.
SIMD.Float32x4.splat()
- Crée un
Float32x4
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.Float32x4(0,1,2,3); // TypeError: SIMD.Float32x4 is not a constructor var w = new SIMD.Float32x4.splat(3); // TypeError: SIMD.Float32x4.splat is not a constructor
Il faut écrire :
var v = SIMD.Float32x4(0,1,2,3); var w = SIMD.Float32x4.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.Float32x4.check()
- Renvoie un nouveau
Float32x4
si le paramètre passé est un type de donnée SIMD valide et si c'est le même queFloat32x4
. Sinon, cette méthode lèvera une exceptionTypeError
.
Accéder aux voies et les modifier
SIMD.Float32x4.extractLane()
- Renvoie la valeur d'une voie donnée.
SIMD.Float32x4.replaceLane()
- Renvoie un nouveau vecteur
Float32x4
dont la voie donnée a été remplacée par la valeur fournie.
Chargement et enregistrement des données depuis des tableaux typés
SIMD.Float32x4.load()
SIMD.Float32x4.load1()
SIMD.Float32x4.load2()
SIMD.Float32x4.load3()
- Renvoie une nouvelle instance
Float32x4
dont les voies sont chargées avec les valeurs d'un tableau typé. SIMD.Float32x4.store()
SIMD.Float32x4.store1()
SIMD.Float32x4.store2()
SIMD.Float32x4.store3()
- Enregistre un
Float32x4
dans un tableau typé.
Opérations arithmétiques
SIMD.Float32x4.abs()
- Renvoie un nouveau
Float32x4
avec les valeurs absolues des voies. SIMD.Float32x4.add()
- Renvoie un nouveau
Float32x4
avec la somme des voies (a + b
). SIMD.Float32x4.div()
- Renvoie un nouveau
Float32x4
dont les valeurs des voies sont les résultats de la division des voies (a / b
). SIMD.Float32x4.mul()
- Renvoie un nouveau
Float32x4
avec la multiplication des voies (a * b
). SIMD.Float32x4.neg()
- Renvoie un nouveau
Float32x4
avec les valeurs opposées des voies. SIMD.Float32x4.reciprocalApproximation()
- Renvoie un nouveau
Float32x4
avec une approximation des inverses des valeurs des voies. SIMD.Float32x4.reciprocalSqrtApproximation()
- Renvoie un nouveau
Float32x4
avec une approximation des inverses des racines carrées des valeurs des voies. SIMD.Float32x4.sub()
- Renvoie un nouveau
Float32x4
avec la soustraction des voies (a - b
). SIMD.Float32x4.sqrt()
- Renvoie un nouveau
Float32x4
avec la racine carrée des valeurs des voies.
Mélange et permutation
SIMD.Float32x4.shuffle()
- Renvoie un nouveau
Float32x4
dont les valeurs des voies ont été mélangées à partir de deux vecteurs. SIMD.Float32x4.swizzle()
- Renvoie un nouveau
Float32x4
dont les valeurs des voies ont été permutées.
Minimum, maximum et encadrement
SIMD.Float32x4.max()
- Renvoie un nouveau
Float32x4
qui contient les maximums des valeurs des voies. SIMD.Float32x4.maxNum()
- Renvoie un nouveau
Float32x4
qui contient les maximums des valeurs des voies et qui privilégie les nombres par rapport àNaN
. SIMD.Float32x4.min()
- Renvoie un nouveau
Float32x4
avec les minimums des valeurs des voies. SIMD.Float32x4.minNum()
- Renvoie un nouveau
Float32x4
qui contient les minimums des valeurs des voies et qui privilégie les nombres par rapport àNaN
. -
Sélections
SIMD.Float32x4.select()
- Renvoie une nouvelle instance
Float32x4
dont les valeurs des voies sont un mélange des différentes voies en fonction d'un masque de sélection.
Comparaisons
SIMD.Float32x4.equal()
- Renvoie un masque de sélection selon le résultat de
a == b
. SIMD.Float32x4.notEqual()
- Renvoie un masque de sélection selon le résultat de
a != b
. SIMD.Float32x4.lessThan()
- Renvoie un masque de sélection selon le résultat de
a < b
. SIMD.Float32x4.lessThanOrEqual()
- Renvoie un masque de sélection selon le résultat de
a <= b
. SIMD.Float32x4.greaterThan()
- Renvoie un masque de sélection selon le résultat de
a > b
. SIMD.Float32x4.greaterThanOrEqual()
- Renvoie un nouveau
Float32x4
avectrue
oufalse
pour chaque voie selon le résultat dea >= b
.
Conversion
SIMD.Float32x4.fromFloat64x2Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauFloat64x2
. SIMD.Float32x4.fromInt32x4()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion flottante d'un tableauInt32x4
. SIMD.Float32x4.fromInt32x4Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauInt32x4
. SIMD.Float32x4.fromInt16x8Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauInt16x8
. SIMD.Float32x4.fromInt8x16Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauInt8x16
. SIMD.Float32x4.fromUint32x4()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion flottante d'un tableauUint32x4
. SIMD.Float32x4.fromUint32x4Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauUint32x4
. SIMD.Float32x4.fromUint16x8Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauUint16x8
. SIMD.Float32x4.fromUint8x16Bits()
- Crée un nouveau type de données
Float32x4
à partir d'une conversion binaire d'un tableauUint8x16
.
Prototype SIMD
Les méthodes et propriétés suivantes sont rattachées à SIMD.Float32x4.prototype
.
SIMD.Float32x4.prototype.constructor
- Définit la fonction qui crée le prototype de l'objet SIMD
SIMD.Float32x4.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.Float32x4.prototype.toString()
- Renvoie une chaîne représentant le type SIMD et ses éléments. Elle surcharge la méthode
Object.prototype.toString()
. SIMD.Float32x4.prototype.valueOf()
- Renvoie la valeur primitive de l'objet SIMD.
SIMD.Float32x4.prototype.toSource()
- Renvoie une chaîne de caractère représentant le code source. Elle surcharge la méthode
Object.prototype.toSource()
.
Exemples
SIMD.Float32x4(1, 2, 3, 4); // Float32x4[1, 2, 3, 4] SIMD.Float32x4(1, 2); // Float32x4[1, 2, NaN, NaN] SIMD.Float32x4(); // Float32x4[NaN, NaN, NaN, NaN]
Specifications
Spécification | Statut | Commentaires |
---|---|---|
SIMD La définition de 'Float32x4' 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 |