CanvasRenderingContext2D.translate

The CanvasRenderingContext2D.translate() method of the Canvas 2D API adds a translation transformation by moving the canvas and its origin x horizontally and y vertically on the grid.

Syntax

void ctx.translate(x, y);

Parameters

x

Distance to move in the horizontal direction.

y

Distance to move in the vertical direction.

Examples

Using the translate method

This is just a simple code snippet which uses the translate method.

HTML

<canvas id="canvas"></canvas>

JavaScript

var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');

ctx.translate(50, 50);
ctx.fillRect(0, 0, 100, 100);

// reset current transformation matrix to the identity matrix
ctx.setTransform(1, 0, 0, 1, 0, 0);

Edit the code below and see your changes update live in the canvas:

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also

• The interface defining it, CanvasRenderingContext2D