Matrix2

A 2x2 matrix, indexable as a column-major order array. Constructor parameters are in row-major order for code readability.

new Cesium.Matrix2(column0Row0, column1Row0, column0Row1, column1Row1)

Name Type Default Description
column0Row0 number 0.0 optional 第 0 列第 0 行的值。
column1Row0 number 0.0 optional 第 1 列第 0 行的值。
column0Row1 number 0.0 optional 第 0 列第 1 行的值。
column1Row1 number 0.0 optional 第 1 列第 1 行的值。
See:

Members

获取集合中项的数量。

static constant Cesium.Matrix2.COLUMN0ROW0 : number

Matrix2 中第 0 列第 0 行的索引。
Example:
const matrix = new Cesium.Matrix2();
matrix[Cesium.Matrix2.COLUMN0ROW0] = 5.0; // set column 0, row 0 to 5.0

static constant Cesium.Matrix2.COLUMN0ROW1 : number

Matrix2 中第 0 列第 1 行的索引。
Example:
const matrix = new Cesium.Matrix2();
matrix[Cesium.Matrix2.COLUMN0ROW1] = 5.0; // set column 0, row 1 to 5.0

static constant Cesium.Matrix2.COLUMN1ROW0 : number

Matrix2 中第 1 列第 0 行的索引。
Example:
const matrix = new Cesium.Matrix2();
matrix[Cesium.Matrix2.COLUMN1ROW0] = 5.0; // set column 1, row 0 to 5.0

static constant Cesium.Matrix2.COLUMN1ROW1 : number

Matrix2 中第 1 列第 1 行的索引。
Example:
const matrix = new Cesium.Matrix2();
matrix[Cesium.Matrix2.COLUMN1ROW1] = 5.0; // set column 1, row 1 to 5.0

static constant Cesium.Matrix2.IDENTITY : Matrix2

初始化为单位矩阵的不可变 Matrix2 实例。

static Cesium.Matrix2.packedLength : number

用于将对象打包进数组的元素数量。

static constant Cesium.Matrix2.ZERO : Matrix2

初始化为零矩阵的不可变 Matrix2 实例。

Methods

复制所提供 Matrix2 实例。
Name Type Description
result Matrix2 optional 用于存储结果的物体。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。

equals(right)boolean

将此矩阵与所提供的矩阵逐分量比较,如果它们相等则返回 true,否则返回 false
Name Type Description
right Matrix2 optional 右侧矩阵。
Returns:
true 如果它们相等,否则为 false

equalsEpsilon(right, epsilon)boolean

将此矩阵与所提供的矩阵逐分量比较,如果它们在所提供的 epsilon 范围内则返回 true,否则返回 false
Name Type Default Description
right Matrix2 optional 右侧矩阵。
epsilon number 0 optional 用于相等性测试的 epsilon。
Returns:
true 如果它们在给定的 epsilon 范围内,否则为 false

toString()string

创建一个表示此 Matrix 的字符串,其中每一行 单独占一行,格式为 '(column0, column1)'。
Returns:
表示所提供 Matrix 的字符串,其中每一行单独占一行,格式为 '(column0, column1)'。

static Cesium.Matrix2.abs(matrix, result)Matrix2

计算一个矩阵,其中包含所提供矩阵各元素的绝对(无符号)值。
Name Type Description
matrix Matrix2 具有有符号元素的矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.add(left, right, result)Matrix2

计算两个矩阵的和。
Name Type Description
left Matrix2 第一个矩阵。
right Matrix2 第二个矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.clone(matrix, result)Matrix2

复制一个 Matrix2 实例。
Name Type Description
matrix Matrix2 要复制的矩阵。
result Matrix2 optional 用于存储结果的物体。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。(如果 matrix 未定义则返回 undefined)

static Cesium.Matrix2.equals(left, right)boolean

将给定的矩阵逐分量比较,如果它们相等则返回 true,否则返回 false
Name Type Description
left Matrix2 optional 第一个矩阵。
right Matrix2 optional 第二个矩阵。
Returns:
true 如果 left 和 right 相等,否则为 false

static Cesium.Matrix2.equalsEpsilon(left, right, epsilon)boolean

将给定的矩阵逐分量比较,如果它们在所提供的 epsilon 范围内则返回 true,否则返回 false
Name Type Default Description
left Matrix2 optional 第一个矩阵。
right Matrix2 optional 第二个矩阵。
epsilon number 0 optional 用于相等性测试的 epsilon。
Returns:
true 如果 left 和 right 在给定的 epsilon 范围内,否则为 false

static Cesium.Matrix2.fromArray(array, startingIndex, result)Matrix2

从数组中的 4 个连续元素创建一个 Matrix2。
Name Type Default Description
array Array.<number> 其 4 个连续元素对应矩阵各位置的数组。假定为列主序。
startingIndex number 0 optional 数组第一个元素的偏移量,对应矩阵中第一列第一行的位置。
result Matrix2 optional 用于存储结果的物体。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。
Example:
// Create the Matrix2:
// [1.0, 2.0]
// [1.0, 2.0]

const v = [1.0, 1.0, 2.0, 2.0];
const m = Cesium.Matrix2.fromArray(v);

// Create same Matrix2 with using an offset into an array
const v2 = [0.0, 0.0, 1.0, 1.0, 2.0, 2.0];
const m2 = Cesium.Matrix2.fromArray(v2, 2);

static Cesium.Matrix2.fromColumnMajorArray(values, result)Matrix2

从列主序数组创建一个 Matrix2 实例。
Name Type Description
values Array.<number> 列主序数组。
result Matrix2 optional 结果将存储到的物体中,如果未定义则会创建一个新实例。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。

static Cesium.Matrix2.fromRotation(angle, result)Matrix2

创建一个旋转矩阵。
Name Type Description
angle number 旋转的角度(以弧度为单位)。正角度为逆时针方向。
result Matrix2 optional 结果将存储到的物体中,如果未定义则会创建一个新实例。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。
Example:
// Rotate a point 45 degrees counterclockwise.
const p = new Cesium.Cartesian2(5, 6);
const m = Cesium.Matrix2.fromRotation(Cesium.Math.toRadians(45.0));
const rotated = Cesium.Matrix2.multiplyByVector(m, p, new Cesium.Cartesian2());

static Cesium.Matrix2.fromRowMajorArray(values, result)Matrix2

从行主序数组创建一个 Matrix2 实例。 结果矩阵将为列主序。
Name Type Description
values Array.<number> 行主序数组。
result Matrix2 optional 结果将存储到的物体中,如果未定义则会创建一个新实例。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。

static Cesium.Matrix2.fromScale(scale, result)Matrix2

计算表示非均匀缩放的 Matrix2 实例。
Name Type Description
scale Cartesian2 x 和 y 缩放因子。
result Matrix2 optional 结果将存储到的物体中,如果未定义则会创建一个新实例。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。
Example:
// Creates
//   [7.0, 0.0]
//   [0.0, 8.0]
const m = Cesium.Matrix2.fromScale(new Cesium.Cartesian2(7.0, 8.0));

static Cesium.Matrix2.fromUniformScale(scale, result)Matrix2

计算表示均匀缩放的 Matrix2 实例。
Name Type Description
scale number 均匀缩放因子。
result Matrix2 optional 结果将存储到的物体中,如果未定义则会创建一个新实例。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。
Example:
// Creates
//   [2.0, 0.0]
//   [0.0, 2.0]
const m = Cesium.Matrix2.fromUniformScale(2.0);

static Cesium.Matrix2.getColumn(matrix, index, result)Cartesian2

以 Cartesian2 实例的形式,获取所提供索引处矩阵列的副本。
Name Type Description
matrix Matrix2 要使用的矩阵。
index number 要获取列的从零开始的索引。
result Cartesian2 用于存储结果的物体。
Returns:
修改后的结果参数。
Throws:

static Cesium.Matrix2.getElementIndex(row, column)number

计算所提供行和列处元素的数组索引。
Name Type Description
row number 行的从零开始的索引。
column number 列的从零开始的索引。
Returns:
所提供行和列处元素的索引。
Throws:
Example:
const myMatrix = new Cesium.Matrix2();
const column1Row0Index = Cesium.Matrix2.getElementIndex(1, 0);
const column1Row0 = myMatrix[column1Row0Index]
myMatrix[column1Row0Index] = 10.0;

static Cesium.Matrix2.getMaximumScale(matrix)number

假设矩阵是一个仿射变换,计算最大缩放。 最大缩放即列向量的最大长度。
Name Type Description
matrix Matrix2 矩阵。
Returns:
最大缩放。

static Cesium.Matrix2.getRotation(matrix, result)Matrix2

假设矩阵是一个仿射变换,提取其旋转矩阵。
Name Type Description
matrix Matrix2 矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
See:

static Cesium.Matrix2.getRow(matrix, index, result)Cartesian2

以 Cartesian2 实例的形式,获取所提供索引处矩阵行的副本。
Name Type Description
matrix Matrix2 要使用的矩阵。
index number 要获取行的从零开始的索引。
result Cartesian2 用于存储结果的物体。
Returns:
修改后的结果参数。
Throws:

static Cesium.Matrix2.getScale(matrix, result)Cartesian2

假设矩阵是一个仿射变换,提取其非均匀缩放。
Name Type Description
matrix Matrix2 矩阵。
result Cartesian2 用于存储结果的物体。
Returns:
修改后的结果参数。
See:

static Cesium.Matrix2.multiply(left, right, result)Matrix2

计算两个矩阵的乘积。
Name Type Description
left Matrix2 第一个矩阵。
right Matrix2 第二个矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.multiplyByScalar(matrix, scalar, result)Matrix2

计算矩阵与标量的乘积。
Name Type Description
matrix Matrix2 矩阵。
scalar number 要乘的数。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.multiplyByScale(matrix, scale, result)Matrix2

计算矩阵与非均匀缩放的乘积,如同该缩放是一个缩放矩阵。
Name Type Description
matrix Matrix2 左侧的矩阵。
scale Cartesian2 右侧的非均匀缩放。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
Example:
// Instead of Cesium.Matrix2.multiply(m, Cesium.Matrix2.fromScale(scale), m);
Cesium.Matrix2.multiplyByScale(m, scale, m);
See:

static Cesium.Matrix2.multiplyByUniformScale(matrix, scale, result)Matrix2

计算矩阵与均匀缩放的乘积,如同该缩放是一个缩放矩阵。
Name Type Description
matrix Matrix2 左侧的矩阵。
scale number 右侧的均匀缩放。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
Example:
// Instead of Cesium.Matrix2.multiply(m, Cesium.Matrix2.fromUniformScale(scale), m);
Cesium.Matrix2.multiplyByUniformScale(m, scale, m);
See:

static Cesium.Matrix2.multiplyByVector(matrix, cartesian, result)Cartesian2

计算矩阵与列向量的乘积。
Name Type Description
matrix Matrix2 矩阵。
cartesian Cartesian2 列向量。
result Cartesian2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.negate(matrix, result)Matrix2

创建所提供矩阵的取反副本。
Name Type Description
matrix Matrix2 要取反的矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.pack(value, array, startingIndex)Array.<number>

将所提供的实例存入所提供的数组。
Name Type Default Description
value Matrix2 要打包的值。
array Array.<number> 要打包到的数组。
startingIndex number 0 optional 数组中开始打包元素的索引位置。
Returns:
被打包到的数组

static Cesium.Matrix2.packArray(array, result)Array.<number>

将一个 Matrix2 数组展平为分量数组。这些分量 以列主序存储。
Name Type Description
array Array.<Matrix2> 要打包的矩阵数组。
result Array.<number> optional 用于存储结果的数组。如果这是一个类型化数组,它必须具有 array.length * 4 个分量,否则将抛出 DeveloperError。如果它是一个常规数组,它将被调整为具有 (array.length * 4) 个元素。
Returns:
打包后的数组。

static Cesium.Matrix2.setColumn(matrix, index, cartesian, result)Matrix2

计算一个新矩阵,用所提供的 Cartesian2 实例替换所提供矩阵中指定的列。
Name Type Description
matrix Matrix2 要使用的矩阵。
index number 要设置的列的从零开始的索引。
cartesian Cartesian2 其值将被赋给指定列的 Cartesian。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
Throws:

static Cesium.Matrix2.setRotation(matrix, rotation, result)Matrix2

假设矩阵是一个仿射变换,设置其旋转。
Name Type Description
matrix Matrix2 矩阵。
rotation Matrix2 旋转矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
See:

static Cesium.Matrix2.setRow(matrix, index, cartesian, result)Matrix2

计算一个新矩阵,用所提供的 Cartesian2 实例替换所提供矩阵中指定的行。
Name Type Description
matrix Matrix2 要使用的矩阵。
index number 要设置的行的从零开始的索引。
cartesian Cartesian2 其值将被赋给指定行的 Cartesian。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
Throws:

static Cesium.Matrix2.setScale(matrix, scale, result)Matrix2

计算一个新矩阵,用所提供的缩放替换原缩放。 这假定矩阵是一个仿射变换。
Name Type Description
matrix Matrix2 要使用的矩阵。
scale Cartesian2 用于替换所提供矩阵缩放的缩放。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
See:

static Cesium.Matrix2.setUniformScale(matrix, scale, result)Matrix2

计算一个新矩阵,用所提供的均匀缩放替换原缩放。 这假定矩阵是一个仿射变换。
Name Type Description
matrix Matrix2 要使用的矩阵。
scale number 用于替换所提供矩阵缩放的均匀缩放。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。
See:

static Cesium.Matrix2.subtract(left, right, result)Matrix2

计算两个矩阵的差。
Name Type Description
left Matrix2 第一个矩阵。
right Matrix2 第二个矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.toArray(matrix, result)Array.<number>

从所提供的 Matrix2 实例创建一个 Array。 该数组将为列主序。
Name Type Description
matrix Matrix2 要使用的矩阵。
result Array.<number> optional 用于存储结果的 Array。
Returns:
修改后的 Array 参数;如果未提供,则为新的 Array 实例。

static Cesium.Matrix2.transpose(matrix, result)Matrix2

计算所提供矩阵的转置。
Name Type Description
matrix Matrix2 要转置的矩阵。
result Matrix2 用于存储结果的物体。
Returns:
修改后的结果参数。

static Cesium.Matrix2.unpack(array, startingIndex, result)Matrix2

从打包后的数组中检索一个实例。
Name Type Default Description
array Array.<number> 打包后的数组。
startingIndex number 0 optional 要解包元素的起始索引。
result Matrix2 optional 结果将存入其中的物体。
Returns:
修改后的结果参数;如果未提供,则为新的 Matrix2 实例。

static Cesium.Matrix2.unpackArray(array, result)Array.<Matrix2>

将列主序矩阵分量数组解包为 Matrix2 数组。
Name Type Description
array Array.<number> 要解包的分量数组。
result Array.<Matrix2> optional 用于存储结果的数组。
Returns:
解包后的数组。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。