SIMD.%type%.addSaturate()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The static SIMD.%type%.addSaturate()
method returns a new instance with the lane values added (a + b
) and saturating behavior on overflow.
Note: This operation is not defined on Uint32x4
and Int32x4
, because it is not accelerated by current hardware on those types.
Syntax
SIMD.Int8x16.addSaturate(a, b) SIMD.Int16x8.addSaturate(a, b) SIMD.Uint8x16.addSaturate(a, b) SIMD.Uint16x8.addSaturate(a, b)
Parameters
- a
- An instance of a SIMD type.
b
- Another instance of a SIMD type.
Return value
A new corresponding SIMD data type with the lane values of a
and b
added (a + b
).
Examples
The following example demonstrates the saturating behavior for Uint16 (maximum value 65535) and Int16 (maximum value 32767). If the addition overflows, the lanes will have the maximum possible value.
var a = SIMD.Uint16x8(65533, 65534, 65535, 65535, 1, 1, 1, 1); var b = SIMD.Uint16x8(1, 1, 1, 5000, 1, 1, 1, 1); SIMD.Uint16x8.addSaturate(a, b); // Uint16x8[65534, 65535, 65535, 65535, 2, 2, 2, 2] var c = SIMD.Int16x8(32765, 32766, 32767, 32767, 1, 1, 1, 1); var d = SIMD.Int16x8(1, 1, 1, 5000, 1, 1, 1, 1); SIMD.Int16x8.addSaturate(c, d); // Int16x8[32766, 32767, 32767, 32767, 2, 2, 2, 2]
Specifications
Specification | Status | Comment |
---|---|---|
SIMD The definition of 'SIMDConstructor.addSaturate' in that specification. |
Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | No support | Nightly build | No support | No support | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | No support | Nightly build | No support | No support | No support |
See also
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/javascript/reference/global_objects/simd/addsaturate