# transform - method of object CanvasCtx

###### Description:
Replaces the current transformation matrix with another.
###### Syntax:
transform(a As Long, b As Long, c As Long, d As Long, e As Long, f As Long) As Object
###### Calling:
`ctx.transform(a, b, c, d, e, f);`
###### Parameters:
a (Long) (default 1) Horizontal drawing ratio (Long) (default 0) Horizontal drawing skew (Long) (default 0) Vertical drawing skew (Long) (default 1) Vertical drawing ratio (Long) (default 0) Horizontal drawing shift (Long) (default 0) Vertical drawing shift
###### Note:
The transformation allows to map the positions from one co-ordinate system to another. It can be used for drawing a shape into a magnified/reduced, rotated, shifted, mirrored 2D space. It is easier to transform the 2D space co-ordinates than recalculating the co-ordinates of all objects. All position stransformations are defined by 6 variables a, b, c, d, e, f (out of 9) of the 2D space transformation matrix. The default value of non-transformed 2D space is 1, 0, 0, 1, 0, 0 (so-called unit matrix). The transformation matrix is a part of the drawing area. The save and restore methods can save this matrix.

The transformation methods transform, translate, scale or rotate modify some (or all) values of the transformation matrix. Each method saves the current state of the transformation matrix and then applies the modification(s). It means that these modifications are cumulative.

By contrast, the setTransform transformation method first sets the currently valid transformation matrix to the default value and then executes the transform transformation. This makes it the only transformation method that cen reset all cumulated transformations and set new transformation that is not cumulated.

The method can also be called in the graphic item events for Web panels.
###### Example1:
The ctx variable represents the drawing canvas (CanvasCtx). The setup is done on Draw page at the beginning of the script of drawing event onDraw as follows:

var ctx = pEvent.GetCtx(1);
JavaScriptSelect and copy to clipboard
`ctx.fillStyle = "yellow";ctx.fillRect(0, 0, 250, 100);ctx.transform(1, 0.5, -0.5, 1, 30, 10);ctx.fillStyle = "red";ctx.fillRect(0, 0, 250, 100);ctx.transform(1, 0.5, -0.5, 1, 30, 10);ctx.fillStyle = "blue";ctx.fillRect(0, 0, 250, 100);`
###### do not rotate:
JavaScriptSelect and copy to clipboard
`ctx.transform(1, 0, 0, 1, 0, 0);`
###### left:
JavaScriptSelect and copy to clipboard
`ctx.transform(0, -1, 1, 0, 0, dy);`
###### down:
JavaScriptSelect and copy to clipboard
`ctx.transform(-1, 0, 0, -1, dx, dy);`
###### Right:
JavaScriptSelect and copy to clipboard
`ctx.transform(0, 1, -1, 0, dx, 0);`
###### flip:
JavaScriptSelect and copy to clipboard
`ctx.transform(-1, 0, 0, 1, dx, 0);`
###### left and flip:
JavaScriptSelect and copy to clipboard
`ctx.transform(0, 1, 1, 0, 0, 0);`
###### down and flip:
JavaScriptSelect and copy to clipboard
`ctx.transform(1, 0, 0, -1, 0, dy);`
###### Right and flip:
JavaScriptSelect and copy to clipboard
`ctx.transform(0, -1, -1, 0, dx, dy);`
PROMOTIC 9.0.0 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person