_Matrix3D

忽略父矩阵。

• 示例

   mat.ignoreParent = true
  

忽略本级旋转。

• 示例

   mat.ignoreRotation = true
  

忽略本级缩放。

• 示例

   mat.ignoreScaling = true
  

忽略本级位移。

• 示例

   mat.ignoreTranslation = true
  

忽略世界矩阵。

• 示例

   mat.ignoreWorld = true
  

矩阵名。

• 示例

   mat.name = 'mat1'
  

父矩阵，默认为nil。

• 示例

  mat1 = _Matrix3D.new()
  mat2 = _Matrix3D.new()
  mat1.parent = mat2
  

根矩阵，默认为nil。

• 示例

   mat1 = _Matrix3D.new()
   mat2 = _Matrix3D.new()
   mat1.root = mat2
  

• 示例

   mat = _Matrix3D.new()
  

矩阵左乘向量。若有out参数则不构造新_Vector3。

• 返回
• 左乘的结果。

• 示例

   v = _Vector3.new(1, 1, 1)
   mat = _Matrix3D.new()
   mat:apply(v)
  

矩阵左乘向量。若有out参数则不构造新_Vector3。

• 返回
• 左乘的结果。

• 示例

   mat = _Matrix3D.new()
   mat:apply(1, 1, 1)
  

创建一个新的矩阵，并把原矩阵设置为父。例如 c = p:child() 相当于 c = _Matrix3D.new() c.parent = p。

• 示例

   matp = _Matrix3D.new()
   matc = matp:child()
  

复制自己及父的值并构造一个新_Matrix3D返回。

• 示例

   mat = _Matrix3D.new()
   mat:mulScalingRight(1, 1, 1)
   mat:clone()
  

返回当前矩阵的旋转。此旋转是当前矩阵按照缩放，旋转，位移的顺序组合，分解得到的其中旋转分量。若有out参数则不构造新_Vector4。

• 返回
• 旋转分量，类型是object，有四个属性x, y, z, r。其中(x, y, z)表示旋转轴，r表示转动的弧度。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationRight(0, 0, 10, 0.01)
   object = mat:getRotation()
  

获取矩阵绕x轴旋转的弧度值。

• 返回
• r : 旋转的弧度值。

• 示例

   mat = _Matrix3D.new()
   r = mat:getRotationX()
  

获取矩阵绕y轴旋转的弧度值。

• 返回
• r : 旋转的弧度值。

• 示例

   mat = _Matrix3D.new()
   r = mat:getRotationY()
  

获取矩阵绕z轴旋转的弧度值。

• 返回
• r : 旋转的弧度值。

• 示例

   mat = _Matrix3D.new()
   r = mat:getRotationZ()
  

返回当前矩阵的缩放。此位移是当前矩阵按照缩放，旋转，位移的顺序组合，分解得到的其中缩放分量。若有out参数则不构造新_Vector3。

• 返回
• 缩放分量。属性的x, y, z分别表现相对于x轴，y轴，z轴的缩放。

• 示例

   mat = _Matrix3D.new()
   vec = _Vector3.new()
   mat:mulScalingRight(1, 1, 1)
   vec = mat:getScaling()
  

返回当前矩阵的位移。此位移是当前矩阵按照缩放，旋转，位移的顺序组合，分解得到的其中位移分量。若有out参数则不构造新_Vector3。

• 返回
• 位移向量。

• 示例

   mat = _Matrix3D.new()
   vec = _Vector3.new()
   mat:mulTranslationRight(1, 1, 1)
   vec = mat:getTranslation()
  

矩阵归一化。

• 示例

   mat = _Matrix3D.new()
   mat:mulScalingRight(1, 1, 1)
   mat:identity()
  

矩阵求逆。

• 示例

   mat = _Matrix3D.new()
   mat:mulScalingRight(1, 1, 1)
   mat:inverse()
  

使用传入的4个向量组成一个指定目标坐标系的旋转矩阵, 用它左乘当前矩阵。

• 参数
• x : 目标坐标系的X轴
• y : 目标坐标系的Y轴
• z : 目标坐标系的Z轴

• o : 目标坐标系的原点

• 示例

使用传入的4个向量组成一个指定目标坐标系的旋转矩阵, 用它右乘当前矩阵。

• 参数
• x : 目标坐标系的X轴
• y : 目标坐标系的Y轴
• z : 目标坐标系的Z轴

• o : 目标坐标系的原点

• 示例

矩阵左乘旋转。该旋转定义为将向量v1(x1, y1, z1)旋转到向量v2(x2, y2, z2)。

• 参数
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v1 = _Vector3.new(0, 0, 0)
   v2 = _Vector3.new(1, 1, 1)
   mat : mulFaceToLeft(0, 0, 0, 1, 1, 1)
   mat : mulFaceToLeft(v1, v2)
  

矩阵右乘旋转。该旋转定义为将向量v1(x1, y1, z1)旋转到向量v2(x2, y2, z2)。

• 参数
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v1 = _Vector3.new(0, 0, 0)
   v2 = _Vector3.new(1, 1, 1)
   mat : mulFaceToRight(0, 0, 0, 1, 1, 1)
   mat : mulFaceToRight(v1, v2)
  

矩阵左乘mat矩阵。

• 示例

   mat1 = _Matrix3D.new()
   mat2 = _Matrix3D.new()
   mat1:mulScalingRight(1, 1, 1)
   mat2 = mat2:mulLeft(mat1)
  

左乘一个镜像矩阵，达到绕X轴翻转的效果。

• 示例

   mat = _Matrix3D.new()
   mat:mulMirrorX()
  

左乘一个镜像矩阵，达到绕Y轴翻转的效果。

• 示例

   mat = _Matrix3D.new()
   mat:mulMirrorY()
  

左乘一个镜像矩阵，达到绕Z轴翻转的效果。

• 示例

   mat = _Matrix3D.new()
   mat:mulMirrorZ()
  

矩阵右乘mat矩阵。

• 示例

   mat1 = _Matrix3D.new()
   mat2 = _Matrix3D.new()
   mat1:mulScalingRight(1, 1, 1)
   mat2 = mat2:mulRight(mat1)
  

矩阵左乘旋转。

• 参数
• v(x, y, z) : 旋转所绕的轴。
• r : 旋转的弧度值。
• a :可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(1, 1, 1)
   mat:mulRotationLeft(0, 0, 10, 0.01)
   mat:mulRotationLeft(v, 0.1)
  

矩阵右乘旋转。

• 参数
• v(x, y, z) : 旋转所绕的轴。
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(1, 1, 1)
   mat:mulRotationRight(0, 0, 10, 0.01)
   mat:mulRotationRight(v, 0.1)
  

矩阵左乘绕x轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationXLeft(0.01)
  

矩阵右乘绕x轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationXRight(0.01)
  

矩阵左乘绕y轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationYLeft(0.01)
  

矩阵右乘绕y轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationYRight(0.01)
  

矩阵左乘绕z轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationZLeft(0.01)
  

矩阵右乘绕z轴的旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:mulRotationZRight(0.01)
  

矩阵左乘缩放。

• 参数
• v(x, y, z) : 分别为沿x轴,y轴,z轴的缩放值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   vec = _Vector3.new(2, 2, 2)
   mat:mulScalingLeft(1, 1, 1)
   mat:mulScalingLeft(vec)
  

矩阵右乘缩放。

• 参数
• v(x, y, z) : 分别为沿x轴,y轴,z轴的缩放值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   vec = _Vector3.new(2, 2, 2)
   mat:mulScalingRight(1, 1, 1)
   mat:mulScalingRight(vec)
  

矩阵左乘位移。

• 参数
• v(x, y, z) : 位移。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(1, 1, 1)
   mat:mulTranslationLeft(0, 0, 10)
   mat:mulTranslationLeft(v)
  

矩阵右乘位移。

• 参数
• v(x, y, z) : 位移。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(1, 1, 1)
   mat:mulTranslationRight(0, 0, 10)
   mat:mulTranslationRight(v)
  

赋值。

• 示例

   mat1 = _Matrix3D.new()
   mat2 = _Matrix3D.new()
   mat1:mulScalingRight(1, 1, 1)
   mat2:set(mat1)
  

使用传入的4个向量组成一个指定目标坐标系的旋转矩阵。

• 参数
• x : 目标坐标系的X轴
• y : 目标坐标系的Y轴
• z : 目标坐标系的Z轴

• o : 目标坐标系的原点

• 示例

设置矩阵的旋转。该旋转定义为将向量v1(x1, y1, z1)旋转到向量v2(x2, y2, z2)。

• 参数
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v1 = _Vector3.new(0, 0, 0)
   v2 = _Vector3.new(1, 1, 1)
   mat : setFaceTo(v1, v2)
  

设置矩阵的旋转。该旋转定义为将向量v1(x1, y1, z1)旋转到向量v2(x2, y2, z2)。

• 参数
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:setFaceTo(0, 0, 0, 1, 1, 1)
  

设置矩阵旋转。

• 参数
• v(x, y, z) : 旋转所绕的轴。
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(0, 0, 1)
   mat:setRotation(v, 0.1)
  

设置矩阵旋转。

• 参数
• (x, y, z) :旋转轴。
• r : 转动的弧度。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat : setRotation(0, 0, 1, 0.01)
  

设置矩阵为绕x轴旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:setRotationX(0.01)
  

设置矩阵为绕y轴旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:setRotationY(0.01)
  

设置矩阵为绕z轴旋转。

• 参数
• r : 旋转的弧度值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:setRotationZ(0.01)
  

设置矩阵的缩放。

• 参数
• v(x, y, z) : 分别为沿x轴,y轴,z轴的缩放值。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   vec = _Vector3.new(2, 2, 2)
   mat:setScaling(1, 1, 1)
   mat:setScaling(vec)
  

设置矩阵的位移。

• 参数
• v(x, y, z) : 位移。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   v = _Vector3.new(1, 1, 1)
   mat:setTranslation(v)
  

设置矩阵的位移。

• 参数
• x : 沿x轴方向的位移。
• y : 沿y轴方向的位移。
• z : 沿z轴方向的位移。
• a : 可选参数，持续时间，默认值为0。

• 示例

   mat = _Matrix3D.new()
   mat:setTranslation(1, 1, 1)
  

矩阵转置。

• 示例

   mat = _Matrix3D.new()
   mat:mulScalingRight(1, 1, 1)
   mat:transpose()
  

求两个矩阵的插值。 若有out参数则不构造新_Matrix3D。

• 参数
• object1 : 第一个矩阵。
• object2 : 第二个矩阵。
• a : 插值系数。

• out : 插值结果矩阵。

• 返回

• 插值的结果。

• 示例

  mat1 = _Matrix3D.new()
  mat1:setRotationZ(2)
  mat1:mulScalingRight(2, 2, 2)
  mat1:mulTranslationRight(5,0,0)
  
  mat2 = _Matrix3D.new()
  mat2:setRotationZ(3)
  mat2:mulTranslationRight(0,5,0)
  
  mat0 = _Matrix3D.lerp(mat1, mat2, factor, mat0)