---
name: "CanvasContext.translate"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "translate - 对当前坐标系的原点进行变换"
---

## CanvasContext.translate

> [VERSION] 基础库 >= 2.21.8

### 描述

对当前坐标系的原点 (0, 0) 进行变换

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `x` | `number` | 是 | 水平坐标平移量 |
| `y` | `number` | 是 | 竖直坐标平移量 |

### 返回值

无


### 示例代码

#### 平移坐标系

```ts
const ctx = ty.createCanvasContext('myCanvas');
ctx.translate(50, 50);
ctx.fillRect(0, 0, 100, 50);
ctx.draw();
```