---
name: "Animation.matrix3d"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "Animation.matrix3d - 同 CSS transform matrix3d"
---

## Animation.matrix3d

> [VERSION] 基础库 >= 2.21.8

### 描述

同 CSS transform matrix3d

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `a1` | `number` | 否 | 4x4 矩阵第 1 行第 1 列的值 |
| `b1` | `number` | 否 | 4x4 矩阵第 1 行第 2 列的值 |
| `c1` | `number` | 否 | 4x4 矩阵第 1 行第 3 列的值 |
| `d1` | `number` | 否 | 4x4 矩阵第 1 行第 4 列的值 |
| `a2` | `number` | 否 | 4x4 矩阵第 2 行第 1 列的值 |
| `b2` | `number` | 否 | 4x4 矩阵第 2 行第 2 列的值 |
| `c2` | `number` | 否 | 4x4 矩阵第 2 行第 3 列的值 |
| `d2` | `number` | 否 | 4x4 矩阵第 2 行第 4 列的值 |
| `a3` | `number` | 否 | 4x4 矩阵第 3 行第 1 列的值 |
| `b3` | `number` | 否 | 4x4 矩阵第 3 行第 2 列的值 |
| `c3` | `number` | 否 | 4x4 矩阵第 3 行第 3 列的值 |
| `d3` | `number` | 否 | 4x4 矩阵第 3 行第 4 列的值 |
| `a4` | `number` | 否 | 4x4 矩阵第 4 行第 1 列的值 |
| `b4` | `number` | 否 | 4x4 矩阵第 4 行第 2 列的值 |
| `c4` | `number` | 否 | 4x4 矩阵第 4 行第 3 列的值 |
| `d4` | `number` | 否 | 4x4 矩阵第 4 行第 4 列的值 |

### 返回值

类型: `Animation`

Animation 实例

### 示例代码

#### 使用 matrix3d 变换

```ts
Page({
  data: {
    animationData: {},
  },
  onReady() {
    const animation = ty.createAnimation({ duration: 500 });
    animation.matrix3d(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 50, 50, 0, 1).step();
    this.setData({ animationData: animation.export() });
  },
});
```