方法接受一个 SIMD 值作为参数,将它的每个通道都转成绝对值,作为一个新的 SIMD 值返回。
neg
方法接受一个 SIMD 值作为参数,将它的每个通道都转成负值,作为一个新的 SIMD 值返回。
var a = SIMD.Float32x4(-1, -2, 3, 0);
SIMD.Float32x4.neg(a)
// Float32x4[1, 2, -3, -0]
var b = SIMD.Float64x2(NaN, Infinity);
SIMD.Float64x2.neg(b)
// Float64x2[NaN, -Infinity]
SIMD.%type%.add(),SIMD.%type%.addSaturate()
add
方法接受两个 SIMD 值作为参数,将它们的每个通道相加,作为一个新的 SIMD 值返回。
var a = SIMD.Float32x4(1.0, 2.0, 3.0, 4.0);
var b = SIMD.Float32x4(5.0, 10.0, 15.0, 20.0);
var c = SIMD.Float32x4.add(a, b);
上面代码中,经过加法运算,新的 SIMD 值为(6.0, 12.0, 18.0. 24.0)
。
addSaturate
方法跟add
方法的作用相同,都是两个通道相加,但是溢出的处理不一致。对于add
方法,如果两个值相加发生溢出,溢出的二进制位会被丢弃; addSaturate
方法则是返回该数据类型的最大值。
var a = SIMD.Uint16x8(65533, 65534, 65535, 65535, 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]
上面代码中,Uint16
的最大值是 65535,Int16
的最大值是 32767。一旦发生溢出,就返回这两个值。
注意,和Int32x4
这两种数据类型没有addSaturate
方法。
var a = SIMD.Float32x4(-1, -2, 3, 4);
var b = SIMD.Float32x4(3, 3, 3, 3);
SIMD.Float32x4.sub(a, b)
// Float32x4[-4, -5, 0, 1]
subSaturate
方法跟sub
方法的作用相同,都是两个通道相减,但是溢出的处理不一致。对于sub
方法,如果两个值相减发生溢出,溢出的二进制位会被丢弃; subSaturate
方法则是返回该数据类型的最小值。
上面代码中,Uint16
的最小值是0
,Int16
的最小值是-32678
。一旦运算发生溢出,就返回最小值。
SIMD.%type%.mul(),SIMD.%type%.div(),SIMD.%type%.sqrt()
mul
方法接受两个 SIMD 值作为参数,将它们的每个通道相乘,作为一个新的 SIMD 值返回。
var a = SIMD.Float32x4(-1, -2, 3, 4);
var b = SIMD.Float32x4(3, 3, 3, 3);
SIMD.Float32x4.mul(a, b)
// Float32x4[-3, -6, 9, 12]
div
方法接受两个 SIMD 值作为参数,将它们的每个通道相除,作为一个新的 SIMD 值返回。
var a = SIMD.Float32x4(2, 2, 2, 2);
var b = SIMD.Float32x4(4, 4, 4, 4);
SIMD.Float32x4.div(a, b)
sqrt
方法接受一个 SIMD 值作为参数,求出每个通道的平方根,作为一个新的 SIMD 值返回。
var b = SIMD.Float64x2(4, 8);
SIMD.Float64x2.sqrt(b)
reciprocalApproximation
方法接受一个 SIMD 值作为参数,求出每个通道的倒数(1 / x
),作为一个新的 SIMD 值返回。
var a = SIMD.Float32x4(1, 2, 3, 4);
SIMD.Float32x4.reciprocalApproximation(a);
// Float32x4[1, 0.5, 0.3333333432674408, 0.25]
reciprocalSqrtApproximation
方法接受一个 SIMD 值作为参数,求出每个通道的平方根的倒数(1 / (x^0.5)
),作为一个新的 SIMD 值返回。
SIMD.%IntegerType%.shiftLeftByScalar()
shiftLeftByScalar
方法接受一个 SIMD 值作为参数,然后将每个通道的值左移指定的位数,作为一个新的 SIMD 值返回。
var a = SIMD.Int32x4(1, 2, 4, 8);
SIMD.Int32x4.shiftLeftByScalar(a, 1);
// Int32x4[2, 4, 8, 16]
如果左移后,新的值超出了当前数据类型的位数,溢出的部分会被丢弃。
var ix4 = SIMD.Int32x4(1, 2, 3, 4);
var jx4 = SIMD.Int32x4.shiftLeftByScalar(ix4, 32);
// Int32x4[0, 0, 0, 0]
注意,只有整数的数据类型才有这个方法。
shiftRightByScalar
方法接受一个 SIMD 值作为参数,然后将每个通道的值右移指定的位数,返回一个新的 SIMD 值。
var a = SIMD.Int32x4(1, 2, 4, -8);
SIMD.Int32x4.shiftRightByScalar(a, 1);
// Int32x4[0, 1, 2, -4]
如果原来通道的值是带符号的值,则符号位保持不变,不受右移影响。如果是不带符号位的值,则右移后头部会补0
。
var a = SIMD.Uint32x4(1, 2, 4, -8);
SIMD.Uint32x4.shiftRightByScalar(a, 1);
// Uint32x4[0, 1, 2, 2147483644]
上面代码中,-8
右移一位变成了2147483644
,是因为对于 32 位无符号整数来说,-8
的二进制形式是11111111111111111111111111111000
,右移一位就变成了01111111111111111111111111111100
,相当于2147483644
。
注意,只有整数的数据类型才有这个方法。