blob: 58dd84823781cbb294de0dc49d938bfe0e9a5437 [file] [log] [blame]
// Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
/// Lists that efficiently handle fixed sized data
/// (for example, unsigned 8 byte integers) and SIMD numeric types.
///
/// To use this library in your code:
///
/// import 'dart:typed_data';
library dart.typed_data;
import 'dart:collection';
import 'dart:math' show Random;
import "dart:collection" show ListBase;
import "dart:_internal" hide Symbol;
/**
* A sequence of bytes underlying a typed data object.
*
* Used to process large quantities of binary or numerical data
* more efficiently using a typed view.
*/
abstract class ByteBuffer {
/**
* Returns the length of this byte buffer, in bytes.
*/
int get lengthInBytes;
/**
* Creates a [Uint8List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Uint8List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes] and contains [length] bytes.
* If [length] is omitted, the range extends to the end of the buffer.
*
* The start index and length must describe a valid range of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `length` must not be negative, and
* * `offsetInBytes + length` must not be greater than [lengthInBytes].
*/
Uint8List asUint8List([int offsetInBytes = 0, int length]);
/**
* Creates a [Int8List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Int8List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes] and contains [length] bytes.
* If [length] is omitted, the range extends to the end of the buffer.
*
* The start index and length must describe a valid range of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `length` must not be negative, and
* * `offsetInBytes + length` must not be greater than [lengthInBytes].
*/
Int8List asInt8List([int offsetInBytes = 0, int length]);
/**
* Creates a [Uint8ClampedList] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Uint8ClampedList` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes] and contains [length] bytes.
* If [length] is omitted, the range extends to the end of the buffer.
*
* The start index and length must describe a valid range of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `length` must not be negative, and
* * `offsetInBytes + length` must not be greater than [lengthInBytes].
*/
Uint8ClampedList asUint8ClampedList([int offsetInBytes = 0, int length]);
/**
* Creates a [Uint16List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Uint16List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 16-bit aligned,
* and contains [length] 16-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not even, the last byte can't be part of the view.
*
* The start index and length must describe a valid 16-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by two,
* * `length` must not be negative, and
* * `offsetInBytes + length * 2` must not be greater than [lengthInBytes].
*/
Uint16List asUint16List([int offsetInBytes = 0, int length]);
/**
* Creates a [Int16List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Int16List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 16-bit aligned,
* and contains [length] 16-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not even, the last byte can't be part of the view.
*
* The start index and length must describe a valid 16-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by two,
* * `length` must not be negative, and
* * `offsetInBytes + length * 2` must not be greater than [lengthInBytes].
*/
Int16List asInt16List([int offsetInBytes = 0, int length]);
/**
* Creates a [Uint32List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Uint32List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 32-bit aligned,
* and contains [length] 32-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by four, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 32-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by four,
* * `length` must not be negative, and
* * `offsetInBytes + length * 4` must not be greater than [lengthInBytes].
*/
Uint32List asUint32List([int offsetInBytes = 0, int length]);
/**
* Creates a [Int32List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Int32List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 32-bit aligned,
* and contains [length] 32-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by four, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 32-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by four,
* * `length` must not be negative, and
* * `offsetInBytes + length * 4` must not be greater than [lengthInBytes].
*/
Int32List asInt32List([int offsetInBytes = 0, int length]);
/**
* Creates a [Uint64List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Uint64List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 64-bit aligned,
* and contains [length] 64-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by eight, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 64-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by eight,
* * `length` must not be negative, and
* * `offsetInBytes + length * 8` must not be greater than [lengthInBytes].
*/
Uint64List asUint64List([int offsetInBytes = 0, int length]);
/**
* Creates a [Int64List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Int64List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 64-bit aligned,
* and contains [length] 64-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by eight, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 64-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by eight,
* * `length` must not be negative, and
* * `offsetInBytes + length * 8` must not be greater than [lengthInBytes].
*/
Int64List asInt64List([int offsetInBytes = 0, int length]);
/**
* Creates a [Int32x4List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Int32x4List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 128-bit aligned,
* and contains [length] 128-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by 16, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 128-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by sixteen,
* * `length` must not be negative, and
* * `offsetInBytes + length * 16` must not be greater than [lengthInBytes].
*/
Int32x4List asInt32x4List([int offsetInBytes = 0, int length]);
/**
* Creates a [Float32List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Float32List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 32-bit aligned,
* and contains [length] 32-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by four, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 32-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by four,
* * `length` must not be negative, and
* * `offsetInBytes + length * 4` must not be greater than [lengthInBytes].
*/
Float32List asFloat32List([int offsetInBytes = 0, int length]);
/**
* Creates a [Float64List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Float64List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 64-bit aligned,
* and contains [length] 64-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by eight, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 64-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by eight,
* * `length` must not be negative, and
* * `offsetInBytes + length * 8` must not be greater than [lengthInBytes].
*/
Float64List asFloat64List([int offsetInBytes = 0, int length]);
/**
* Creates a [Float32x4List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Float32x4List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 128-bit aligned,
* and contains [length] 128-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by 16, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 128-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by sixteen,
* * `length` must not be negative, and
* * `offsetInBytes + length * 16` must not be greater than [lengthInBytes].
*/
Float32x4List asFloat32x4List([int offsetInBytes = 0, int length]);
/**
* Creates a [Float64x2List] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `Float64x2List` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes], which must be 128-bit aligned,
* and contains [length] 128-bit integers.
* If [length] is omitted, the range extends as far towards the end of
* the buffer as possible -
* if [lengthInBytes] is not divisible by 16, the last bytes can't be part
* of the view.
*
* The start index and length must describe a valid 128-bit aligned range
* of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `offsetInBytes` must be divisible by sixteen,
* * `length` must not be negative, and
* * `offsetInBytes + length * 16` must not be greater than [lengthInBytes].
*/
Float64x2List asFloat64x2List([int offsetInBytes = 0, int length]);
/**
* Creates a [ByteData] _view_ of a region of this byte buffer.
*
* The view is backed by the bytes of this byte buffer.
* Any changes made to the `ByteData` will also change the buffer,
* and vice versa.
*
* The viewed region start at [offsetInBytes] and contains [length] bytes.
* If [length] is omitted, the range extends to the end of the buffer.
*
* The start index and length must describe a valid range of the buffer:
*
* * `offsetInBytes` must not be negative,
* * `length` must not be negative, and
* * `offsetInBytes + length` must not be greater than [lengthInBytes].
*/
ByteData asByteData([int offsetInBytes = 0, int length]);
}
/**
* A typed view of a sequence of bytes.
*/
abstract class TypedData {
/**
* Returns the number of bytes in the representation of each element in this
* list.
*/
int get elementSizeInBytes;
/**
* Returns the offset in bytes into the underlying byte buffer of this view.
*/
int get offsetInBytes;
/**
* Returns the length of this view, in bytes.
*/
int get lengthInBytes;
/**
* Returns the byte buffer associated with this object.
*/
ByteBuffer get buffer;
}
/**
* Describes endianness to be used when accessing or updating a
* sequence of bytes.
*/
class Endianness {
const Endianness._(this._littleEndian);
static const Endianness BIG_ENDIAN = const Endianness._(false);
static const Endianness LITTLE_ENDIAN = const Endianness._(true);
static final Endianness HOST_ENDIAN =
(new ByteData.view(new Uint16List.fromList([1]).buffer)).getInt8(0) == 1
? LITTLE_ENDIAN
: BIG_ENDIAN;
final bool _littleEndian;
}
/**
* A fixed-length, random-access sequence of bytes that also provides random
* and unaligned access to the fixed-width integers and floating point
* numbers represented by those bytes.
*
* `ByteData` may be used to pack and unpack data from external sources
* (such as networks or files systems), and to process large quantities
* of numerical data more efficiently than would be possible
* with ordinary [List] implementations.
* `ByteData` can save space, by eliminating the need for object headers,
* and time, by eliminating the need for data copies.
* Finally, `ByteData` may be used to intentionally reinterpret the bytes
* representing one arithmetic type as another.
* For example this code fragment determine what 32-bit signed integer
* is represented by the bytes of a 32-bit floating point number:
*
* var buffer = new Uint8List(8).buffer;
* var bdata = new ByteData.view(buffer);
* bdata.setFloat32(0, 3.04);
* int huh = bdata.getInt32(0);
*/
abstract class ByteData implements TypedData {
/**
* Creates a [ByteData] of the specified length (in elements), all of
* whose bytes are initially zero.
*/
factory ByteData(int length) {
var list = new Uint8List(length);
return new _ByteDataView(list, 0, length);
}
/**
* Creates an [ByteData] _view_ of the specified region in [buffer].
*
* Changes in the [ByteData] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*/
factory ByteData.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asByteData(offsetInBytes, length);
}
/**
* Returns the (possibly negative) integer represented by the byte at the
* specified [byteOffset] in this object, in two's complement binary
* representation.
*
* The return value will be between -128 and 127, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* greater than or equal to the length of this object.
*/
int getInt8(int byteOffset);
/**
* Sets the byte at the specified [byteOffset] in this object to the
* two's complement binary representation of the specified [value], which
* must fit in a single byte.
*
* In other words, [value] must be between -128 and 127, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* greater than or equal to the length of this object.
*/
void setInt8(int byteOffset, int value);
/**
* Returns the positive integer represented by the byte at the specified
* [byteOffset] in this object, in unsigned binary form.
*
* The return value will be between 0 and 255, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* greater than or equal to the length of this object.
*/
int getUint8(int byteOffset);
/**
* Sets the byte at the specified [byteOffset] in this object to the
* unsigned binary representation of the specified [value], which must fit
* in a single byte.
*
* In other words, [value] must be between 0 and 255, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative,
* or greater than or equal to the length of this object.
*/
void setUint8(int byteOffset, int value);
/**
* Returns the (possibly negative) integer represented by the two bytes at
* the specified [byteOffset] in this object, in two's complement binary
* form.
*
* The return value will be between 2<sup>15</sup> and 2<sup>15</sup> - 1,
* inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 2` is greater than the length of this object.
*/
int getInt16(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the two bytes starting at the specified [byteOffset] in this
* object to the two's complement binary representation of the specified
* [value], which must fit in two bytes.
*
* In other words, [value] must lie
* between 2<sup>15</sup> and 2<sup>15</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 2` is greater than the length of this object.
*/
void setInt16(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the positive integer represented by the two bytes starting
* at the specified [byteOffset] in this object, in unsigned binary
* form.
*
* The return value will be between 0 and 2<sup>16</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 2` is greater than the length of this object.
*/
int getUint16(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the two bytes starting at the specified [byteOffset] in this object
* to the unsigned binary representation of the specified [value],
* which must fit in two bytes.
*
* In other words, [value] must be between
* 0 and 2<sup>16</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 2` is greater than the length of this object.
*/
void setUint16(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the (possibly negative) integer represented by the four bytes at
* the specified [byteOffset] in this object, in two's complement binary
* form.
*
* The return value will be between 2<sup>31</sup> and 2<sup>31</sup> - 1,
* inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
int getInt32(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the four bytes starting at the specified [byteOffset] in this
* object to the two's complement binary representation of the specified
* [value], which must fit in four bytes.
*
* In other words, [value] must lie
* between 2<sup>31</sup> and 2<sup>31</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
void setInt32(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the positive integer represented by the four bytes starting
* at the specified [byteOffset] in this object, in unsigned binary
* form.
*
* The return value will be between 0 and 2<sup>32</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
int getUint32(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the four bytes starting at the specified [byteOffset] in this object
* to the unsigned binary representation of the specified [value],
* which must fit in four bytes.
*
* In other words, [value] must be between
* 0 and 2<sup>32</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
void setUint32(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the (possibly negative) integer represented by the eight bytes at
* the specified [byteOffset] in this object, in two's complement binary
* form.
*
* The return value will be between 2<sup>63</sup> and 2<sup>63</sup> - 1,
* inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
int getInt64(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the eight bytes starting at the specified [byteOffset] in this
* object to the two's complement binary representation of the specified
* [value], which must fit in eight bytes.
*
* In other words, [value] must lie
* between 2<sup>63</sup> and 2<sup>63</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
void setInt64(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the positive integer represented by the eight bytes starting
* at the specified [byteOffset] in this object, in unsigned binary
* form.
*
* The return value will be between 0 and 2<sup>64</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
int getUint64(int byteOffset, [Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the eight bytes starting at the specified [byteOffset] in this object
* to the unsigned binary representation of the specified [value],
* which must fit in eight bytes.
*
* In other words, [value] must be between
* 0 and 2<sup>64</sup> - 1, inclusive.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
void setUint64(int byteOffset, int value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the floating point number represented by the four bytes at
* the specified [byteOffset] in this object, in IEEE 754
* single-precision binary floating-point format (binary32).
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
double getFloat32(int byteOffset,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the four bytes starting at the specified [byteOffset] in this
* object to the IEEE 754 single-precision binary floating-point
* (binary32) representation of the specified [value].
*
* **Note that this method can lose precision.** The input [value] is
* a 64-bit floating point value, which will be converted to 32-bit
* floating point value by IEEE 754 rounding rules before it is stored.
* If [value] cannot be represented exactly as a binary32, it will be
* converted to the nearest binary32 value. If two binary32 values are
* equally close, the one whose least significant bit is zero will be used.
* Note that finite (but large) values can be converted to infinity, and
* small non-zero values can be converted to zero.
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 4` is greater than the length of this object.
*/
void setFloat32(int byteOffset, double value,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Returns the floating point number represented by the eight bytes at
* the specified [byteOffset] in this object, in IEEE 754
* double-precision binary floating-point format (binary64).
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
double getFloat64(int byteOffset,
[Endianness endian = Endianness.BIG_ENDIAN]);
/**
* Sets the eight bytes starting at the specified [byteOffset] in this
* object to the IEEE 754 double-precision binary floating-point
* (binary64) representation of the specified [value].
*
* Throws [RangeError] if [byteOffset] is negative, or
* `byteOffset + 8` is greater than the length of this object.
*/
void setFloat64(int byteOffset, double value,
[Endianness endian = Endianness.BIG_ENDIAN]);
factory ByteData._view(TypedData typedData, int offsetInBytes, int length) {
return new _ByteDataView(typedData, offsetInBytes, length);
}
}
/**
* A fixed-length list of 8-bit signed integers.
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low eight bits,
* interpreted as a signed 8-bit two's complement integer with values in the
* range -128 to +127.
*/
abstract class Int8List implements List<int>, TypedData {
/**
* Creates an [Int8List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Int8List(int length) native "TypedData_Int8Array_new";
/**
* Creates a [Int8List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Int8List.fromList(List<int> elements) {
return new Int8List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates an [Int8List] _view_ of the specified region in [buffer].
*
* Changes in the [Int8List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*/
factory Int8List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asInt8List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 1;
}
/**
* A fixed-length list of 8-bit unsigned integers.
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low eight bits,
* interpreted as an unsigned 8-bit integer with values in the
* range 0 to 255.
*/
abstract class Uint8List implements List<int>, TypedData {
/**
* Creates a [Uint8List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Uint8List(int length) native "TypedData_Uint8Array_new";
/**
* Creates a [Uint8List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Uint8List.fromList(List<int> elements) {
return new Uint8List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Uint8List] _view_ of the specified region in [buffer].
*
* Changes in the [Uint8List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*/
factory Uint8List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asUint8List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 1;
}
/**
* A fixed-length list of 8-bit unsigned integers.
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are clamped to an unsigned eight bit value.
* That is, all values below zero are stored as zero
* and all values above 255 are stored as 255.
*/
abstract class Uint8ClampedList implements List<int>, TypedData {
/**
* Creates a [Uint8ClampedList] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Uint8ClampedList(int length) native "TypedData_Uint8ClampedArray_new";
/**
* Creates a [Uint8ClampedList] of the same size as the [elements]
* list and copies over the values clamping when needed.
*
* Values are clamped to fit in the list when they are copied,
* the same way storing values clamps them.
*/
factory Uint8ClampedList.fromList(List<int> elements) {
return new Uint8ClampedList(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Uint8ClampedList] _view_ of the specified region in the
* specified byte [buffer].
*
* Changes in the [Uint8List] will be visible in the byte buffer
* and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*/
factory Uint8ClampedList.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asUint8ClampedList(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 1;
}
/**
* A fixed-length list of 16-bit signed integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 16 bits,
* interpreted as a signed 16-bit two's complement integer with values in the
* range -32768 to +32767.
*/
abstract class Int16List implements List<int>, TypedData {
/**
* Creates an [Int16List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Int16List(int length) native "TypedData_Int16Array_new";
/**
* Creates a [Int16List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Int16List.fromList(List<int> elements) {
return new Int16List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates an [Int16List] _view_ of the specified region in [buffer].
*
* Changes in the [Int16List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Int16List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asInt16List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 2;
}
/**
* A fixed-length list of 16-bit unsigned integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 16 bits,
* interpreted as an unsigned 16-bit integer with values in the
* range 0 to 65536.
*/
abstract class Uint16List implements List<int>, TypedData {
/**
* Creates a [Uint16List] of the specified length (in elements), all
* of whose elements are initially zero.
*/
factory Uint16List(int length) native "TypedData_Uint16Array_new";
/**
* Creates a [Uint16List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Uint16List.fromList(List<int> elements) {
return new Uint16List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Uint16List] _view_ of the specified region in
* the specified byte buffer.
*
* Changes in the [Uint16List] will be visible in the byte buffer
* and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Uint16List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asUint16List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 2;
}
/**
* A fixed-length list of 32-bit signed integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 32 bits,
* interpreted as a signed 32-bit two's complement integer with values in the
* range -2147483648 to 2147483647.
*/
abstract class Int32List implements List<int>, TypedData {
/**
* Creates an [Int32List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Int32List(int length) native "TypedData_Int32Array_new";
/**
* Creates a [Int32List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Int32List.fromList(List<int> elements) {
return new Int32List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates an [Int32List] _view_ of the specified region in [buffer].
*
* Changes in the [Int32List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Int32List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asInt32List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 4;
}
/**
* A fixed-length list of 32-bit unsigned integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 32 bits,
* interpreted as an unsigned 32-bit integer with values in the
* range 0 to 4294967295.
*/
abstract class Uint32List implements List<int>, TypedData {
/**
* Creates a [Uint32List] of the specified length (in elements), all
* of whose elements are initially zero.
*/
factory Uint32List(int length) native "TypedData_Uint32Array_new";
/**
* Creates a [Uint32List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Uint32List.fromList(List<int> elements) {
return new Uint32List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Uint32List] _view_ of the specified region in
* the specified byte buffer.
*
* Changes in the [Uint32List] will be visible in the byte buffer
* and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Uint32List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asUint32List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 4;
}
/**
* A fixed-length list of 64-bit signed integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 64 bits,
* interpreted as a signed 64-bit two's complement integer with values in the
* range -9223372036854775808 to +9223372036854775807.
*/
abstract class Int64List implements List<int>, TypedData {
/**
* Creates an [Int64List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Int64List(int length) native "TypedData_Int64Array_new";
/**
* Creates a [Int64List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Int64List.fromList(List<int> elements) {
return new Int64List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates an [Int64List] _view_ of the specified region in [buffer].
*
* Changes in the [Int64List] will be visible in the byte buffer
* and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Int64List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asInt64List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 8;
}
/**
* A fixed-length list of 64-bit unsigned integers that is viewable as a
* [TypedData].
*
* For long lists, this implementation can be considerably
* more space- and time-efficient than the default [List] implementation.
*
* Integers stored in the list are truncated to their low 64 bits,
* interpreted as an unsigned 64-bit integer with values in the
* range 0 to 18446744073709551616.
*/
abstract class Uint64List implements List<int>, TypedData {
/**
* Creates a [Uint64List] of the specified length (in elements), all
* of whose elements are initially zero.
*/
factory Uint64List(int length) native "TypedData_Uint64Array_new";
/**
* Creates a [Uint64List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Uint64List.fromList(List<int> elements) {
return new Uint64List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates an [Uint64List] _view_ of the specified region in
* the specified byte buffer.
*
* Changes in the [Uint64List] will be visible in the byte buffer
* and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Uint64List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asUint64List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 8;
}
/**
* A fixed-length list of IEEE 754 single-precision binary floating-point
* numbers that is viewable as a [TypedData].
*
* For long lists, this
* implementation can be considerably more space- and time-efficient than
* the default [List] implementation.
*
* Double values stored in the list are converted to the nearest
* single-precision value. Values read are converted to a double
* value with the same value.
*/
abstract class Float32List implements List<double>, TypedData {
/**
* Creates a [Float32List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Float32List(int length) native "TypedData_Float32Array_new";
/**
* Creates a [Float32List] with the same length as the [elements] list
* and copies over the elements.
*
* Values are truncated to fit in the list when they are copied,
* the same way storing values truncates them.
*/
factory Float32List.fromList(List<double> elements) {
return new Float32List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Float32List] _view_ of the specified region in [buffer].
*
* Changes in the [Float32List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Float32List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asFloat32List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 4;
}
/**
* A fixed-length list of IEEE 754 double-precision binary floating-point
* numbers that is viewable as a [TypedData].
*
* For long lists, this
* implementation can be considerably more space- and time-efficient than
* the default [List] implementation.
*/
abstract class Float64List implements List<double>, TypedData {
/**
* Creates a [Float64List] of the specified length (in elements), all of
* whose elements are initially zero.
*/
factory Float64List(int length) native "TypedData_Float64Array_new";
/**
* Creates a [Float64List] with the same length as the [elements] list
* and copies over the elements.
*/
factory Float64List.fromList(List<double> elements) {
return new Float64List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Float64List] _view_ of the specified region in [buffer].
*
* Changes in the [Float64List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Float64List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asFloat64List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 8;
}
/**
* A fixed-length list of Float32x4 numbers that is viewable as a
* [TypedData].
*
* For long lists, this implementation will be considerably more
* space- and time-efficient than the default [List] implementation.
*/
abstract class Float32x4List implements List<Float32x4>, TypedData {
/**
* Creates a [Float32x4List] of the specified length (in elements),
* all of whose elements are initially zero.
*/
factory Float32x4List(int length) native "TypedData_Float32x4Array_new";
/**
* Creates a [Float32x4List] with the same length as the [elements] list
* and copies over the elements.
*/
factory Float32x4List.fromList(List<Float32x4> elements) {
return new Float32x4List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Float32x4List] _view_ of the specified region in [buffer].
*
* Changes in the [Float32x4List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Float32x4List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asFloat32x4List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 16;
}
/**
* A fixed-length list of Int32x4 numbers that is viewable as a
* [TypedData].
*
* For long lists, this implementation will be considerably more
* space- and time-efficient than the default [List] implementation.
*/
abstract class Int32x4List implements List<Int32x4>, TypedData {
/**
* Creates a [Int32x4List] of the specified length (in elements),
* all of whose elements are initially zero.
*/
factory Int32x4List(int length) native "TypedData_Int32x4Array_new";
/**
* Creates a [Int32x4List] with the same length as the [elements] list
* and copies over the elements.
*/
factory Int32x4List.fromList(List<Int32x4> elements) {
return new Int32x4List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Int32x4List] _view_ of the specified region in [buffer].
*
* Changes in the [Int32x4List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Int32x4List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asInt32x4List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 16;
}
/**
* A fixed-length list of Float64x2 numbers that is viewable as a
* [TypedData].
*
* For long lists, this implementation will be considerably more
* space- and time-efficient than the default [List] implementation.
*/
abstract class Float64x2List implements List<Float64x2>, TypedData {
/**
* Creates a [Float64x2List] of the specified length (in elements),
* all of whose elements have all lanes set to zero.
*/
factory Float64x2List(int length) native "TypedData_Float64x2Array_new";
/**
* Creates a [Float64x2List] with the same length as the [elements] list
* and copies over the elements.
*/
factory Float64x2List.fromList(List<Float64x2> elements) {
return new Float64x2List(elements.length)
..setRange(0, elements.length, elements);
}
/**
* Creates a [Float64x2List] _view_ of the specified region in [buffer].
*
* Changes in the [Float64x2List] will be visible in the byte
* buffer and vice versa.
* If the [offsetInBytes] index of the region is not specified,
* it defaults to zero (the first byte in the byte buffer).
* If the length is not specified, it defaults to `null`,
* which indicates that the view extends to the end of the byte buffer.
*
* Throws [RangeError] if [offsetInBytes] or [length] are negative, or
* if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
* the length of [buffer].
*
* Throws [ArgumentError] if [offsetInBytes] is not a multiple of
* [BYTES_PER_ELEMENT].
*/
factory Float64x2List.view(ByteBuffer buffer,
[int offsetInBytes = 0, int length]) {
return buffer.asFloat64x2List(offsetInBytes, length);
}
static const int BYTES_PER_ELEMENT = 16;
}
/**
* Float32x4 immutable value type and operations.
*
* Float32x4 stores 4 32-bit floating point values in "lanes".
* The lanes are "x", "y", "z", and "w" respectively.
*/
abstract class Float32x4 {
factory Float32x4(double x, double y, double z, double w)
native "Float32x4_fromDoubles";
factory Float32x4.splat(double v) native "Float32x4_splat";
factory Float32x4.zero() native "Float32x4_zero";
factory Float32x4.fromInt32x4Bits(Int32x4 x)
native "Float32x4_fromInt32x4Bits";
/// Sets the x and y lanes to their respective values in [v] and sets the z
/// and w lanes to 0.0.
factory Float32x4.fromFloat64x2(Float64x2 v) native "Float32x4_fromFloat64x2";
/// Addition operator.
Float32x4 operator +(Float32x4 other);
/// Negate operator.
Float32x4 operator -();
/// Subtraction operator.
Float32x4 operator -(Float32x4 other);
/// Multiplication operator.
Float32x4 operator *(Float32x4 other);
/// Division operator.
Float32x4 operator /(Float32x4 other);
/// Relational less than.
Int32x4 lessThan(Float32x4 other);
/// Relational less than or equal.
Int32x4 lessThanOrEqual(Float32x4 other);
/// Relational greater than.
Int32x4 greaterThan(Float32x4 other);
/// Relational greater than or equal.
Int32x4 greaterThanOrEqual(Float32x4 other);
/// Relational equal.
Int32x4 equal(Float32x4 other);
/// Relational not-equal.
Int32x4 notEqual(Float32x4 other);
/// Returns a copy of [this] each lane being scaled by [s].
/// Equivalent to this * new Float32x4.splat(s)
Float32x4 scale(double s);
/// Returns the lane-wise absolute value of this [Float32x4].
Float32x4 abs();
/// Lane-wise clamp [this] to be in the range [lowerLimit]-[upperLimit].
Float32x4 clamp(Float32x4 lowerLimit, Float32x4 upperLimit);
/// Extracted x value.
double get x;
/// Extracted y value.
double get y;
/// Extracted z value.
double get z;
/// Extracted w value.
double get w;
/// Extract the sign bits from each lane return them in the first 4 bits.
/// "x" lane is bit 0.
/// "y" lane is bit 1.
/// "z" lane is bit 2.
/// "w" lane is bit 3.
int get signMask;
/// Mask passed to [shuffle] or [shuffleMix].
static const int XXXX = 0x0;
static const int XXXY = 0x40;
static const int XXXZ = 0x80;
static const int XXXW = 0xC0;
static const int XXYX = 0x10;
static const int XXYY = 0x50;
static const int XXYZ = 0x90;
static const int XXYW = 0xD0;
static const int XXZX = 0x20;
static const int XXZY = 0x60;
static const int XXZZ = 0xA0;
static const int XXZW = 0xE0;
static const int XXWX = 0x30;
static const int XXWY = 0x70;
static const int XXWZ = 0xB0;
static const int XXWW = 0xF0;
static const int XYXX = 0x4;
static const int XYXY = 0x44;
static const int XYXZ = 0x84;
static const int XYXW = 0xC4;
static const int XYYX = 0x14;
static const int XYYY = 0x54;
static const int XYYZ = 0x94;
static const int XYYW = 0xD4;
static const int XYZX = 0x24;
static const int XYZY = 0x64;
static const int XYZZ = 0xA4;
static const int XYZW = 0xE4;
static const int XYWX = 0x34;
static const int XYWY = 0x74;
static const int XYWZ = 0xB4;
static const int XYWW = 0xF4;
static const int XZXX = 0x8;
static const int XZXY = 0x48;
static const int XZXZ = 0x88;
static const int XZXW = 0xC8;
static const int XZYX = 0x18;
static const int XZYY = 0x58;
static const int XZYZ = 0x98;
static const int XZYW = 0xD8;
static const int XZZX = 0x28;
static const int XZZY = 0x68;
static const int XZZZ = 0xA8;
static const int XZZW = 0xE8;
static const int XZWX = 0x38;
static const int XZWY = 0x78;
static const int XZWZ = 0xB8;
static const int XZWW = 0xF8;
static const int XWXX = 0xC;
static const int XWXY = 0x4C;
static const int XWXZ = 0x8C;
static const int XWXW = 0xCC;
static const int XWYX = 0x1C;
static const int XWYY = 0x5C;
static const int XWYZ = 0x9C;
static const int XWYW = 0xDC;
static const int XWZX = 0x2C;
static const int XWZY = 0x6C;
static const int XWZZ = 0xAC;
static const int XWZW = 0xEC;
static const int XWWX = 0x3C;
static const int XWWY = 0x7C;
static const int XWWZ = 0xBC;
static const int XWWW = 0xFC;
static const int YXXX = 0x1;
static const int YXXY = 0x41;
static const int YXXZ = 0x81;
static const int YXXW = 0xC1;
static const int YXYX = 0x11;
static const int YXYY = 0x51;
static const int YXYZ = 0x91;
static const int YXYW = 0xD1;
static const int YXZX = 0x21;
static const int YXZY = 0x61;
static const int YXZZ = 0xA1;
static const int YXZW = 0xE1;
static const int YXWX = 0x31;
static const int YXWY = 0x71;
static const int YXWZ = 0xB1;
static const int YXWW = 0xF1;
static const int YYXX = 0x5;
static const int YYXY = 0x45;
static const int YYXZ = 0x85;
static const int YYXW = 0xC5;
static const int YYYX = 0x15;
static const int YYYY = 0x55;
static const int YYYZ = 0x95;
static const int YYYW = 0xD5;
static const int YYZX = 0x25;
static const int YYZY = 0x65;
static const int YYZZ = 0xA5;
static const int YYZW = 0xE5;
static const int YYWX = 0x35;
static const int YYWY = 0x75;
static const int YYWZ = 0xB5;
static const int YYWW = 0xF5;
static const int YZXX = 0x9;
static const int YZXY = 0x49;
static const int YZXZ = 0x89;
static const int YZXW = 0xC9;
static const int YZYX = 0x19;
static const int YZYY = 0x59;
static const int YZYZ = 0x99;
static const int YZYW = 0xD9;
static const int YZZX = 0x29;
static const int YZZY = 0x69;
static const int YZZZ = 0xA9;
static const int YZZW = 0xE9;
static const int YZWX = 0x39;
static const int YZWY = 0x79;
static const int YZWZ = 0xB9;
static const int YZWW = 0xF9;
static const int YWXX = 0xD;
static const int YWXY = 0x4D;
static const int YWXZ = 0x8D;
static const int YWXW = 0xCD;
static const int YWYX = 0x1D;
static const int YWYY = 0x5D;
static const int YWYZ = 0x9D;
static const int YWYW = 0xDD;
static const int YWZX = 0x2D;
static const int YWZY = 0x6D;
static const int YWZZ = 0xAD;
static const int YWZW = 0xED;
static const int YWWX = 0x3D;
static const int YWWY = 0x7D;
static const int YWWZ = 0xBD;
static const int YWWW = 0xFD;
static const int ZXXX = 0x2;
static const int ZXXY = 0x42;
static const int ZXXZ = 0x82;
static const int ZXXW = 0xC2;
static const int ZXYX = 0x12;
static const int ZXYY = 0x52;
static const int ZXYZ = 0x92;
static const int ZXYW = 0xD2;
static const int ZXZX = 0x22;
static const int ZXZY = 0x62;
static const int ZXZZ = 0xA2;
static const int ZXZW = 0xE2;
static const int ZXWX = 0x32;
static const int ZXWY = 0x72;
static const int ZXWZ = 0xB2;
static const int ZXWW = 0xF2;
static const int ZYXX = 0x6;
static const int ZYXY = 0x46;
static const int ZYXZ = 0x86;
static const int ZYXW = 0xC6;
static const int ZYYX = 0x16;
static const int ZYYY = 0x56;
static const int ZYYZ = 0x96;
static const int ZYYW = 0xD6;
static const int ZYZX = 0x26;
static const int ZYZY = 0x66;
static const int ZYZZ = 0xA6;
static const int ZYZW = 0xE6;
static const int ZYWX = 0x36;
static const int ZYWY = 0x76;
static const int ZYWZ = 0xB6;
static const int ZYWW = 0xF6;
static const int ZZXX = 0xA;
static const int ZZXY = 0x4A;
static const int ZZXZ = 0x8A;
static const int ZZXW = 0xCA;
static const int ZZYX = 0x1A;
static const int ZZYY = 0x5A;
static const int ZZYZ = 0x9A;
static const int ZZYW = 0xDA;
static const int ZZZX = 0x2A;
static const int ZZZY = 0x6A;
static const int ZZZZ = 0xAA;
static const int ZZZW = 0xEA;
static const int ZZWX = 0x3A;
static const int ZZWY = 0x7A;
static const int ZZWZ = 0xBA;
static const int ZZWW = 0xFA;
static const int ZWXX = 0xE;
static const int ZWXY = 0x4E;
static const int ZWXZ = 0x8E;
static const int ZWXW = 0xCE;
static const int ZWYX = 0x1E;
static const int ZWYY = 0x5E;
static const int ZWYZ = 0x9E;
static const int ZWYW = 0xDE;
static const int ZWZX = 0x2E;
static const int ZWZY = 0x6E;
static const int ZWZZ = 0xAE;
static const int ZWZW = 0xEE;
static const int ZWWX = 0x3E;
static const int ZWWY = 0x7E;
static const int ZWWZ = 0xBE;
static const int ZWWW = 0xFE;
static const int WXXX = 0x3;
static const int WXXY = 0x43;
static const int WXXZ = 0x83;
static const int WXXW = 0xC3;
static const int WXYX = 0x13;
static const int WXYY = 0x53;
static const int WXYZ = 0x93;
static const int WXYW = 0xD3;
static const int WXZX = 0x23;
static const int WXZY = 0x63;
static const int WXZZ = 0xA3;
static const int WXZW = 0xE3;
static const int WXWX = 0x33;
static const int WXWY = 0x73;
static const int WXWZ = 0xB3;
static const int WXWW = 0xF3;
static const int WYXX = 0x7;
static const int WYXY = 0x47;
static const int WYXZ = 0x87;
static const int WYXW = 0xC7;
static const int WYYX = 0x17;
static const int WYYY = 0x57;
static const int WYYZ = 0x97;
static const int WYYW = 0xD7;
static const int WYZX = 0x27;
static const int WYZY = 0x67;
static const int WYZZ = 0xA7;
static const int WYZW = 0xE7;
static const int WYWX = 0x37;
static const int WYWY = 0x77;
static const int WYWZ = 0xB7;
static const int WYWW = 0xF7;
static const int WZXX = 0xB;
static const int WZXY = 0x4B;
static const int WZXZ = 0x8B;
static const int WZXW = 0xCB;
static const int WZYX = 0x1B;
static const int WZYY = 0x5B;
static const int WZYZ = 0x9B;
static const int WZYW = 0xDB;
static const int WZZX = 0x2B;
static const int WZZY = 0x6B;
static const int WZZZ = 0xAB;
static const int WZZW = 0xEB;
static const int WZWX = 0x3B;
static const int WZWY = 0x7B;
static const int WZWZ = 0xBB;
static const int WZWW = 0xFB;
static const int WWXX = 0xF;
static const int WWXY = 0x4F;
static const int WWXZ = 0x8F;
static const int WWXW = 0xCF;
static const int WWYX = 0x1F;
static const int WWYY = 0x5F;
static const int WWYZ = 0x9F;
static const int WWYW = 0xDF;
static const int WWZX = 0x2F;
static const int WWZY = 0x6F;
static const int WWZZ = 0xAF;
static const int WWZW = 0xEF;
static const int WWWX = 0x3F;
static const int WWWY = 0x7F;
static const int WWWZ = 0xBF;
static const int WWWW = 0xFF;
/// Shuffle the lane values. [mask] must be one of the 256 shuffle constants.
Float32x4 shuffle(int mask);
/// Shuffle the lane values in [this] and [other]. The returned
/// Float32x4 will have XY lanes from [this] and ZW lanes from [other].
/// Uses the same [mask] as [shuffle].
Float32x4 shuffleMix(Float32x4 other, int mask);
/// Returns a new [Float32x4] copied from [this] with a new x value.
Float32x4 withX(double x);
/// Returns a new [Float32x4] copied from [this] with a new y value.
Float32x4 withY(double y);
/// Returns a new [Float32x4] copied from [this] with a new z value.
Float32x4 withZ(double z);
/// Returns a new [Float32x4] copied from [this] with a new w value.
Float32x4 withW(double w);
/// Returns the lane-wise minimum value in [this] or [other].
Float32x4 min(Float32x4 other);
/// Returns the lane-wise maximum value in [this] or [other].
Float32x4 max(Float32x4 other);
/// Returns the square root of [this].
Float32x4 sqrt();
/// Returns the reciprocal of [this].
Float32x4 reciprocal();
/// Returns the square root of the reciprocal of [this].
Float32x4 reciprocalSqrt();
}
/**
* Int32x4 and operations.
*
* Int32x4 stores 4 32-bit bit-masks in "lanes".
* The lanes are "x", "y", "z", and "w" respectively.
*/
abstract class Int32x4 {
factory Int32x4(int x, int y, int z, int w) native "Int32x4_fromInts";
factory Int32x4.bool(bool x, bool y, bool z, bool w)
native "Int32x4_fromBools";
factory Int32x4.fromFloat32x4Bits(Float32x4 x)
native "Int32x4_fromFloat32x4Bits";
/// The bit-wise or operator.
Int32x4 operator |(Int32x4 other);
/// The bit-wise and operator.
Int32x4 operator &(Int32x4 other);
/// The bit-wise xor operator.
Int32x4 operator ^(Int32x4 other);
/// Addition operator.
Int32x4 operator +(Int32x4 other);
/// Subtraction operator.
Int32x4 operator -(Int32x4 other);
/// Extract 32-bit mask from x lane.
int get x;
/// Extract 32-bit mask from y lane.
int get y;
/// Extract 32-bit mask from z lane.
int get z;
/// Extract 32-bit mask from w lane.
int get w;
/// Extract the top bit from each lane return them in the first 4 bits.
/// "x" lane is bit 0.
/// "y" lane is bit 1.
/// "z" lane is bit 2.
/// "w" lane is bit 3.
int get signMask;
/// Mask passed to [shuffle] or [shuffleMix].
static const int XXXX = 0x0;
static const int XXXY = 0x40;
static const int XXXZ = 0x80;
static const int XXXW = 0xC0;
static const int XXYX = 0x10;
static const int XXYY = 0x50;
static const int XXYZ = 0x90;
static const int XXYW = 0xD0;
static const int XXZX = 0x20;
static const int XXZY = 0x60;
static const int XXZZ = 0xA0;
static const int XXZW = 0xE0;
static const int XXWX = 0x30;
static const int XXWY = 0x70;
static const int XXWZ = 0xB0;
static const int XXWW = 0xF0;
static const int XYXX = 0x4;
static const int XYXY = 0x44;
static const int XYXZ = 0x84;
static const int XYXW = 0xC4;
static const int XYYX = 0x14;
static const int XYYY = 0x54;
static const int XYYZ = 0x94;
static const int XYYW = 0xD4;
static const int XYZX = 0x24;
static const int XYZY = 0x64;
static const int XYZZ = 0xA4;
static const int XYZW = 0xE4;
static const int XYWX = 0x34;
static const int XYWY = 0x74;
static const int XYWZ = 0xB4;
static const int XYWW = 0xF4;
static const int XZXX = 0x8;
static const int XZXY = 0x48;
static const int XZXZ = 0x88;
static const int XZXW = 0xC8;
static const int XZYX = 0x18;
static const int XZYY = 0x58;
static const int XZYZ = 0x98;
static const int XZYW = 0xD8;
static const int XZZX = 0x28;
static const int XZZY = 0x68;
static const int XZZZ = 0xA8;
static const int XZZW = 0xE8;
static const int XZWX = 0x38;
static const int XZWY = 0x78;
static const int XZWZ = 0xB8;
static const int XZWW = 0xF8;
static const int XWXX = 0xC;
static const int XWXY = 0x4C;
static const int XWXZ = 0x8C;
static const int XWXW = 0xCC;
static const int XWYX = 0x1C;
static const int XWYY = 0x5C;
static const int XWYZ = 0x9C;
static const int XWYW = 0xDC;
static const int XWZX = 0x2C;
static const int XWZY = 0x6C;
static const int XWZZ = 0xAC;
static const int XWZW = 0xEC;
static const int XWWX = 0x3C;
static const int XWWY = 0x7C;
static const int XWWZ = 0xBC;
static const int XWWW = 0xFC;
static const int YXXX = 0x1;
static const int YXXY = 0x41;
static const int YXXZ = 0x81;
static const int YXXW = 0xC1;
static const int YXYX = 0x11;
static const int YXYY = 0x51;
static const int YXYZ = 0x91;
static const int YXYW = 0xD1;
static const int YXZX = 0x21;
static const int YXZY = 0x61;
static const int YXZZ = 0xA1;
static const int YXZW = 0xE1;
static const int YXWX = 0x31;
static const int YXWY = 0x71;
static const int YXWZ = 0xB1;
static const int YXWW = 0xF1;
static const int YYXX = 0x5;
static const int YYXY = 0x45;
static const int YYXZ = 0x85;
static const int YYXW = 0xC5;
static const int YYYX = 0x15;
static const int YYYY = 0x55;
static const int YYYZ = 0x95;
static const int YYYW = 0xD5;
static const int YYZX = 0x25;
static const int YYZY = 0x65;
static const int YYZZ = 0xA5;
static const int YYZW = 0xE5;
static const int YYWX = 0x35;
static const int YYWY = 0x75;
static const int YYWZ = 0xB5;
static const int YYWW = 0xF5;
static const int YZXX = 0x9;
static const int YZXY = 0x49;
static const int YZXZ = 0x89;
static const int YZXW = 0xC9;
static const int YZYX = 0x19;
static const int YZYY = 0x59;
static const int YZYZ = 0x99;
static const int YZYW = 0xD9;
static const int YZZX = 0x29;
static const int YZZY = 0x69;
static const int YZZZ = 0xA9;
static const int YZZW = 0xE9;
static const int YZWX = 0x39;
static const int YZWY = 0x79;
static const int YZWZ = 0xB9;
static const int YZWW = 0xF9;
static const int YWXX = 0xD;
static const int YWXY = 0x4D;
static const int YWXZ = 0x8D;
static const int YWXW = 0xCD;
static const int YWYX = 0x1D;
static const int YWYY = 0x5D;
static const int YWYZ = 0x9D;
static const int YWYW = 0xDD;
static const int YWZX = 0x2D;
static const int YWZY = 0x6D;
static const int YWZZ = 0xAD;
static const int YWZW = 0xED;
static const int YWWX = 0x3D;
static const int YWWY = 0x7D;
static const int YWWZ = 0xBD;
static const int YWWW = 0xFD;
static const int ZXXX = 0x2;
static const int ZXXY = 0x42;
static const int ZXXZ = 0x82;
static const int ZXXW = 0xC2;
static const int ZXYX = 0x12;
static const int ZXYY = 0x52;
static const int ZXYZ = 0x92;
static const int ZXYW = 0xD2;
static const int ZXZX = 0x22;
static const int ZXZY = 0x62;
static const int ZXZZ = 0xA2;
static const int ZXZW = 0xE2;
static const int ZXWX = 0x32;
static const int ZXWY = 0x72;
static const int ZXWZ = 0xB2;
static const int ZXWW = 0xF2;
static const int ZYXX = 0x6;
static const int ZYXY = 0x46;
static const int ZYXZ = 0x86;
static const int ZYXW = 0xC6;
static const int ZYYX = 0x16;
static const int ZYYY = 0x56;
static const int ZYYZ = 0x96;
static const int ZYYW = 0xD6;
static const int ZYZX = 0x26;
static const int ZYZY = 0x66;
static const int ZYZZ = 0xA6;
static const int ZYZW = 0xE6;
static const int ZYWX = 0x36;
static const int ZYWY = 0x76;
static const int ZYWZ = 0xB6;
static const int ZYWW = 0xF6;
static const int ZZXX = 0xA;
static const int ZZXY = 0x4A;
static const int ZZXZ = 0x8A;
static const int ZZXW = 0xCA;
static const int ZZYX = 0x1A;
static const int ZZYY = 0x5A;
static const int ZZYZ = 0x9A;
static const int ZZYW = 0xDA;
static const int ZZZX = 0x2A;
static const int ZZZY = 0x6A;
static const int ZZZZ = 0xAA;
static const int ZZZW = 0xEA;
static const int ZZWX = 0x3A;
static const int ZZWY = 0x7A;
static const int ZZWZ = 0xBA;
static const int ZZWW = 0xFA;
static const int ZWXX = 0xE;
static const int ZWXY = 0x4E;
static const int ZWXZ = 0x8E;
static const int ZWXW = 0xCE;
static const int ZWYX = 0x1E;
static const int ZWYY = 0x5E;
static const int ZWYZ = 0x9E;
static const int ZWYW = 0xDE;
static const int ZWZX = 0x2E;
static const int ZWZY = 0x6E;
static const int ZWZZ = 0xAE;
static const int ZWZW = 0xEE;
static const int ZWWX = 0x3E;
static const int ZWWY = 0x7E;
static const int ZWWZ = 0xBE;
static const int ZWWW = 0xFE;
static const int WXXX = 0x3;
static const int WXXY = 0x43;
static const int WXXZ = 0x83;
static const int WXXW = 0xC3;
static const int WXYX = 0x13;
static const int WXYY = 0x53;
static const int WXYZ = 0x93;
static const int WXYW = 0xD3;
static const int WXZX = 0x23;
static const int WXZY = 0x63;
static const int WXZZ = 0xA3;
static const int WXZW = 0xE3;
static const int WXWX = 0x33;
static const int WXWY = 0x73;
static const int WXWZ = 0xB3;
static const int WXWW = 0xF3;
static const int WYXX = 0x7;
static const int WYXY = 0x47;
static const int WYXZ = 0x87;
static const int WYXW = 0xC7;
static const int WYYX = 0x17;
static const int WYYY = 0x57;
static const int WYYZ = 0x97;
static const int WYYW = 0xD7;
static const int WYZX = 0x27;
static const int WYZY = 0x67;
static const int WYZZ = 0xA7;
static const int WYZW = 0xE7;
static const int WYWX = 0x37;
static const int WYWY = 0x77;
static const int WYWZ = 0xB7;
static const int WYWW = 0xF7;
static const int WZXX = 0xB;
static const int WZXY = 0x4B;
static const int WZXZ = 0x8B;
static const int WZXW = 0xCB;
static const int WZYX = 0x1B;
static const int WZYY = 0x5B;
static const int WZYZ = 0x9B;
static const int WZYW = 0xDB;
static const int WZZX = 0x2B;
static const int WZZY = 0x6B;
static const int WZZZ = 0xAB;
static const int WZZW = 0xEB;
static const int WZWX = 0x3B;
static const int WZWY = 0x7B;
static const int WZWZ = 0xBB;
static const int WZWW = 0xFB;
static const int WWXX = 0xF;
static const int WWXY = 0x4F;
static const int WWXZ = 0x8F;
static const int WWXW = 0xCF;
static const int WWYX = 0x1F;
static const int WWYY = 0x5F;
static const int WWYZ = 0x9F;
static const int WWYW = 0xDF;
static const int WWZX = 0x2F;
static const int WWZY = 0x6F;
static const int WWZZ = 0xAF;
static const int WWZW = 0xEF;
static const int WWWX = 0x3F;
static const int WWWY = 0x7F;
static const int WWWZ = 0xBF;
static const int WWWW = 0xFF;
/// Shuffle the lane values. [mask] must be one of the 256 shuffle constants.
Int32x4 shuffle(int mask);
/// Shuffle the lane values in [this] and [other]. The returned
/// Int32x4 will have XY lanes from [this] and ZW lanes from [other].
/// Uses the same [mask] as [shuffle].
Int32x4 shuffleMix(Int32x4 other, int mask);
/// Returns a new [Int32x4] copied from [this] with a new x value.
Int32x4 withX(int x);
/// Returns a new [Int32x4] copied from [this] with a new y value.
Int32x4 withY(int y);
/// Returns a new [Int32x4] copied from [this] with a new z value.
Int32x4 withZ(int z);
/// Returns a new [Int32x4] copied from [this] with a new w value.
Int32x4 withW(int w);
/// Extracted x value. Returns false for 0, true for any other value.
bool get flagX;
/// Extracted y value. Returns false for 0, true for any other value.
bool get flagY;
/// Extracted z value. Returns false for 0, true for any other value.
bool get flagZ;
/// Extracted w value. Returns false for 0, true for any other value.
bool get flagW;
/// Returns a new [Int32x4] copied from [this] with a new x value.
Int32x4 withFlagX(bool x);
/// Returns a new [Int32x4] copied from [this] with a new y value.
Int32x4 withFlagY(bool y);
/// Returns a new [Int32x4] copied from [this] with a new z value.
Int32x4 withFlagZ(bool z);
/// Returns a new [Int32x4] copied from [this] with a new w value.
Int32x4 withFlagW(bool w);
/// Merge [trueValue] and [falseValue] based on [this]' bit mask:
/// Select bit from [trueValue] when bit in [this] is on.
/// Select bit from [falseValue] when bit in [this] is off.
Float32x4 select(Float32x4 trueValue, Float32x4 falseValue);
}
/**
* Float64x2 immutable value type and operations.
*
* Float64x2 stores 2 64-bit floating point values in "lanes".
* The lanes are "x" and "y" respectively.
*/
abstract class Float64x2 {
factory Float64x2(double x, double y) native "Float64x2_fromDoubles";
factory Float64x2.splat(double v) native "Float64x2_splat";
factory Float64x2.zero() native "Float64x2_zero";
/// Uses the "x" and "y" lanes from [v].
factory Float64x2.fromFloat32x4(Float32x4 v) native "Float64x2_fromFloat32x4";
/// Addition operator.
Float64x2 operator +(Float64x2 other);
/// Negate operator.
Float64x2 operator -();
/// Subtraction operator.
Float64x2 operator -(Float64x2 other);
/// Multiplication operator.
Float64x2 operator *(Float64x2 other);
/// Division operator.
Float64x2 operator /(Float64x2 other);
/// Returns a copy of [this] each lane being scaled by [s].
/// Equivalent to this * new Float64x2.splat(s)
Float64x2 scale(double s);
/// Returns the lane-wise absolute value of this [Float64x2].
Float64x2 abs();
/// Lane-wise clamp [this] to be in the range [lowerLimit]-[upperLimit].
Float64x2 clamp(Float64x2 lowerLimit, Float64x2 upperLimit);
/// Extracted x value.
double get x;
/// Extracted y value.
double get y;
/// Extract the sign bits from each lane return them in the first 2 bits.
/// "x" lane is bit 0.
/// "y" lane is bit 1.
int get signMask;
/// Returns a new [Float64x2] copied from [this] with a new x value.
Float64x2 withX(double x);
/// Returns a new [Float64x2] copied from [this] with a new y value.
Float64x2 withY(double y);
/// Returns the lane-wise minimum value in [this] or [other].
Float64x2 min(Float64x2 other);
/// Returns the lane-wise maximum value in [this] or [other].
Float64x2 max(Float64x2 other);
/// Returns the lane-wise square root of [this].
Float64x2 sqrt();
}
class _ExternalUint8ClampedArray extends _TypedList
with _IntListMixin
implements Uint8ClampedList {
// Method(s) implementing the List interface.
int operator [](int index) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
return _getUint8(index);
}
void operator []=(int index, int value) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
_setUint8(index, _toClampedUint8(value));
}
// Method(s) implementing the TypedData interface.
int get elementSizeInBytes {
return Uint8List.BYTES_PER_ELEMENT;
}
// Internal utility methods.
Uint8ClampedList _createList(int length) {
return new Uint8ClampedList(length);
}
}
class _IntListMixin implements List<int> {
Iterable<int> where(bool f(int element)) => new WhereIterable<int>(this, f);
Iterable<int> take(int n) => new SubListIterable<int>(this, 0, n);
Iterable<int> takeWhile(bool test(int element)) =>
new TakeWhileIterable<int>(this, test);
Iterable<int> skip(int n) => new SubListIterable<int>(this, n, SubListIterable.UpToLength);
Iterable<int> skipWhile(bool test(element)) =>
new SkipWhileIterable<int>(this, test);
Iterable<int> get reversed => new ReversedListIterable<int>(this);
Map<int, int> asMap() => new ListMapView<int>(this);
Iterable<int> getRange(int start, [int end]) {
RangeError.checkValidRange(start, end, this.length);
return new SubListIterable<int>(this, start, end);
}
Iterator<int> get iterator => new _TypedListIterator<int>(this);
List<int> toList({bool growable: true}) {
return new List<int>.from(this, growable: growable);
}
Set<int> toSet() {
return new Set<int>.from(this);
}
}
class _DoubleListMixin {
Iterable<double> where(bool f(int element)) =>
new WhereIterable<double>(this, f);
Iterable<double> take(int n) => new SubListIterable<double>(this, 0, n);
Iterable<double> takeWhile(bool test(int element)) =>
new TakeWhileIterable<double>(this, test);
Iterable<double> skip(int n) => new SubListIterable<double>(this, n, SubListIterable.UpToLength);
Iterable<double> skipWhile(bool test(element)) =>
new SkipWhileIterable<double>(this, test);
Iterable<double> get reversed => new ReversedListIterable<double>(this);
Map<int, double> asMap() => new ListMapView<double>(this);
Iterable<double> getRange(int start, [int end]) {
RangeError.checkValidRange(start, end, this.length);
return new SubListIterable<double>(this, start, end);
}
Iterator<double> get iterator => new _TypedListIterator<double>(this);
List<double> toList({bool growable: true}) {
return new List<double>.from(this, growable: growable);
}
Set<double> toSet() {
return new Set<double>.from(this);
}
}
class _Float32x4ListMixin {
Iterable<Float32x4> where(bool f(int element)) =>
new WhereIterable<Float32x4>(this, f);
Iterable<Float32x4> take(int n) => new SubListIterable<Float32x4>(this, 0, n);
Iterable<Float32x4> takeWhile(bool test(int element)) =>
new TakeWhileIterable<Float32x4>(this, test);
Iterable<Float32x4> skip(int n) =>
new SubListIterable<Float32x4>(this, n, SubListIterable.UpToLength);
Iterable<Float32x4> skipWhile(bool test(element)) =>
new SkipWhileIterable<Float32x4>(this, test);
Iterable<Float32x4> get reversed => new ReversedListIterable<Float32x4>(this);
Map<int, Float32x4> asMap() => new ListMapView<Float32x4>(this);
Iterable<Float32x4> getRange(int start, [int end]) {
RangeError.checkValidRange(start, end, this.length);
return new SubListIterable<Float32x4>(this, start, end);
}
Iterator<Float32x4> get iterator => new _TypedListIterator<Float32x4>(this);
List<Float32x4> toList({bool growable: true}) {
return new List<Float32x4>.from(this, growable: growable);
}
Set<Float32x4> toSet() {
return new Set<Float32x4>.from(this);
}
}
class _Int32x4ListMixin {
Iterable<Int32x4> where(bool f(int element)) =>
new WhereIterable<Int32x4>(this, f);
Iterable<Int32x4> take(int n) => new SubListIterable<Int32x4>(this, 0, n);
Iterable<Int32x4> takeWhile(bool test(int element)) =>
new TakeWhileIterable<Int32x4>(this, test);
Iterable<Int32x4> skip(int n) => new SubListIterable<Int32x4>(this, n, SubListIterable.UpToLength);
Iterable<Int32x4> skipWhile(bool test(element)) =>
new SkipWhileIterable<Int32x4>(this, test);
Iterable<Int32x4> get reversed => new ReversedListIterable<Int32x4>(this);
Map<int, Int32x4> asMap() => new ListMapView<Int32x4>(this);
Iterable<Int32x4> getRange(int start, [int end]) {
RangeError.checkValidRange(start, end, this.length);
return new SubListIterable<Int32x4>(this, start, end);
}
Iterator<Int32x4> get iterator => new _TypedListIterator<Int32x4>(this);
List<Int32x4> toList({bool growable: true}) {
return new List<Int32x4>.from(this, growable: growable);
}
Set<Int32x4> toSet() {
return new Set<Int32x4>.from(this);
}
}
class _Float64x2ListMixin {
Iterable<Float64x2> where(bool f(int element)) =>
new WhereIterable<Float64x2>(this, f);
Iterable<Float64x2> take(int n) => new SubListIterable<Float64x2>(this, 0, n);
Iterable<Float64x2> takeWhile(bool test(int element)) =>
new TakeWhileIterable<Float64x2>(this, test);
Iterable<Float64x2> skip(int n) =>
new SubListIterable<Float64x2>(this, n, SubListIterable.UpToLength);
Iterable<Float64x2> skipWhile(bool test(element)) =>
new SkipWhileIterable<Float64x2>(this, test);
Iterable<Float64x2> get reversed => new ReversedListIterable<Float64x2>(this);
Map<int, Float64x2> asMap() => new ListMapView<Float64x2>(this);
Iterable<Float64x2> getRange(int start, [int end]) {
RangeError.checkValidRange(start, end, this.length);
return new SubListIterable<Float64x2>(this, start, end);
}
Iterator<Float64x2> get iterator => new _TypedListIterator<Float64x2>(this);
List<Float64x2> toList({bool growable: true}) {
return new List<Float64x2>.from(this, growable: growable);
}
Set<Float64x2> toSet() {
return new Set<Float64x2>.from(this);
}
}
class _ByteBuffer implements ByteBuffer {
final _TypedList _data;
_ByteBuffer(this._data);
factory _ByteBuffer._New(data) => new _ByteBuffer(data);
// Forward calls to _data.
int get lengthInBytes => _data.lengthInBytes;
int get hashCode => _data.hashCode;
bool operator ==(Object other) =>
(other is _ByteBuffer) && identical(_data, other._data);
ByteData asByteData([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = this.lengthInBytes - offsetInBytes;
}
return new _ByteDataView(this._data, offsetInBytes, length);
}
Int8List asInt8List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = this.lengthInBytes - offsetInBytes;
}
return new _Int8ArrayView(this, offsetInBytes, length);
}
Uint8List asUint8List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = this.lengthInBytes - offsetInBytes;
}
return new _Uint8ArrayView(this, offsetInBytes, length);
}
Uint8ClampedList asUint8ClampedList([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = this.lengthInBytes - offsetInBytes;
}
return new _Uint8ClampedArrayView(this, offsetInBytes, length);
}
Int16List asInt16List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Int16List.BYTES_PER_ELEMENT;
}
return new _Int16ArrayView(this, offsetInBytes, length);
}
Uint16List asUint16List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Uint16List.BYTES_PER_ELEMENT;
}
return new _Uint16ArrayView(this, offsetInBytes, length);
}
Int32List asInt32List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Int32List.BYTES_PER_ELEMENT;
}
return new _Int32ArrayView(this, offsetInBytes, length);
}
Uint32List asUint32List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Uint32List.BYTES_PER_ELEMENT;
}
return new _Uint32ArrayView(this, offsetInBytes, length);
}
Int64List asInt64List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Int64List.BYTES_PER_ELEMENT;
}
return new _Int64ArrayView(this, offsetInBytes, length);
}
Uint64List asUint64List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Uint64List.BYTES_PER_ELEMENT;
}
return new _Uint64ArrayView(this, offsetInBytes, length);
}
Float32List asFloat32List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Float32List.BYTES_PER_ELEMENT;
}
return new _Float32ArrayView(this, offsetInBytes, length);
}
Float64List asFloat64List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Float64List.BYTES_PER_ELEMENT;
}
return new _Float64ArrayView(this, offsetInBytes, length);
}
Float32x4List asFloat32x4List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = (this.lengthInBytes - offsetInBytes) ~/
Float32x4List.BYTES_PER_ELEMENT;
}
return new _Float32x4ArrayView(this, offsetInBytes, length);
}
Int32x4List asInt32x4List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length =
(this.lengthInBytes - offsetInBytes) ~/ Int32x4List.BYTES_PER_ELEMENT;
}
return new _Int32x4ArrayView(this, offsetInBytes, length);
}
Float64x2List asFloat64x2List([int offsetInBytes = 0, int length = -1]) {
if (length == -1) {
length = (this.lengthInBytes - offsetInBytes) ~/
Float64x2List.BYTES_PER_ELEMENT;
}
return new _Float64x2ArrayView(this, offsetInBytes, length);
}
}
abstract class _TypedList<E> extends _TypedListBase<E> {
// Default method implementing parts of the TypedData interface.
int get offsetInBytes {
return 0;
}
int get lengthInBytes {
return length * elementSizeInBytes;
}
_ByteBuffer get buffer => new _ByteBuffer(this);
// Methods implementing the collection interface.
int get length native "TypedData_length";
// Internal utility methods.
int _getInt8(int offsetInBytes) native "TypedData_GetInt8";
void _setInt8(int offsetInBytes, int value) native "TypedData_SetInt8";
int _getUint8(int offsetInBytes) native "TypedData_GetUint8";
void _setUint8(int offsetInBytes, int value) native "TypedData_SetUint8";
int _getInt16(int offsetInBytes) native "TypedData_GetInt16";
void _setInt16(int offsetInBytes, int value) native "TypedData_SetInt16";
int _getUint16(int offsetInBytes) native "TypedData_GetUint16";
void _setUint16(int offsetInBytes, int value) native "TypedData_SetUint16";
int _getInt32(int offsetInBytes) native "TypedData_GetInt32";
void _setInt32(int offsetInBytes, int value) native "TypedData_SetInt32";
int _getUint32(int offsetInBytes) native "TypedData_GetUint32";
void _setUint32(int offsetInBytes, int value) native "TypedData_SetUint32";
int _getInt64(int offsetInBytes) native "TypedData_GetInt64";
void _setInt64(int offsetInBytes, int value) native "TypedData_SetInt64";
int _getUint64(int offsetInBytes) native "TypedData_GetUint64";
void _setUint64(int offsetInBytes, int value) native "TypedData_SetUint64";
double _getFloat32(int offsetInBytes) native "TypedData_GetFloat32";
void _setFloat32(int offsetInBytes, double value)
native "TypedData_SetFloat32";
double _getFloat64(int offsetInBytes) native "TypedData_GetFloat64";
void _setFloat64(int offsetInBytes, double value)
native "TypedData_SetFloat64";
Float32x4 _getFloat32x4(int offsetInBytes) native "TypedData_GetFloat32x4";
void _setFloat32x4(int offsetInBytes, Float32x4 value)
native "TypedData_SetFloat32x4";
Int32x4 _getInt32x4(int offsetInBytes) native "TypedData_GetInt32x4";
void _setInt32x4(int offsetInBytes, Int32x4 value)
native "TypedData_SetInt32x4";
Float64x2 _getFloat64x2(int offsetInBytes) native "TypedData_GetFloat64x2";
void _setFloat64x2(int offsetInBytes, Float64x2 value)
native "TypedData_SetFloat64x2";
/**
* Stores the [CodeUnits] as UTF-16 units into this TypedData at
* positions [start]..[end] (uint16 indices).
*/
void _setCodeUnits(
CodeUnits units, int byteStart, int length, int skipCount) {
assert(byteStart + length * Uint16List.BYTES_PER_ELEMENT <= lengthInBytes);
String string = CodeUnits.stringOf(units);
int sliceEnd = skipCount + length;
RangeError.checkValidRange(
skipCount, sliceEnd, string.length, "skipCount", "skipCount + length");
for (int i = 0; i < length; i++) {
_setUint16(byteStart + i * Uint16List.BYTES_PER_ELEMENT,
string.codeUnitAt(skipCount + i));
}
}
}
class _Int8List extends _TypedList<int> with _IntListMixin implements Int8List {
// Method(s) implementing List interface.
int operator [](int index) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
return _getInt8(index);
}
void operator []=(int index, int value) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
_setInt8(index, _toInt8(value));
}
// Method(s) implementing TypedData interface.
int get elementSizeInBytes {
return Int8List.BYTES_PER_ELEMENT;
}
// Internal utility methods.
Int8List _createList(int length) {
return new Int8List(length);
}
}
class _Uint8List extends _TypedList<int> with _IntListMixin implements Uint8List {
// Methods implementing List interface.
int operator [](int index) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
return _getUint8(index);
}
void operator []=(int index, int value) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
_setUint8(index, _toUint8(value));
}
// Methods implementing TypedData interface.
int get elementSizeInBytes {
return Uint8List.BYTES_PER_ELEMENT;
}
// Internal utility methods.
Uint8List _createList(int length) {
return new Uint8List(length);
}
}
class _Uint8ClampedList extends _TypedList<int>
with _IntListMixin
implements Uint8ClampedList {
// Methods implementing List interface.
int operator [](int index) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
return _getUint8(index);
}
void operator []=(int index, int value) {
if (index < 0 || index >= length) {
throw new RangeError.index(index, this, "index");
}
_setUint8(index, _toClampedUint8(value));
}
// Methods implementing TypedData interface.
int get elementSizeInBytes {
return Uint8List.BYTES_PER_ELEMENT;
}