h = hgtransform()
h = hgtransform(..., propertyName, propertyValue, ...)
h = hgtransform(ax, ...)
| Parameter | Description |
|---|---|
| ax | graphics object: axes, hggroup or hgtransform. |
| propertyName | a scalar string or row vector character. |
| propertyValue | a value. |
| Parameter | Description |
|---|---|
| h | a graphics object of type: hgtransform |
hgtransform creates a transform object as a child of the current axes and returns its handle, h.
A transform object groups graphics objects, like an hggroup, and in addition applies its Matrix property, a 4-by-4 homogeneous transformation matrix, to all of its children. The transformation also propagates to nested transform objects, so a transform placed under another transform is affected by both matrices.
Build the Matrix value with makehgtform. Setting the Matrix property translates, rotates or scales the whole group at once, which makes transform objects convenient for animation.
The default Matrix is the 4-by-4 identity matrix (no transformation).
figure();
ax = gca();
t = hgtransform('Parent', ax);
line([0 1 1 0 0], [0 0 1 1 0], 'Parent', t, 'Color', 'r');
t.Matrix = makehgtform('zrotate', pi / 6);
axis equalfigure();
x = linspace(0, 4 * pi, 200);
root = hgtransform();
for i = 1:12
t = hgtransform('Parent', root);
line(x, 1 / 3 * x .* sin(x + i / 2), 'Parent', t, 'Color', 'y');
set(t, 'Matrix', makehgtform('zrotate', 2 * pi * i / 12));
end
axis equal
axis(12 * [-1 1 -1 1])
set(root, 'Matrix', makehgtform('zrotate', pi / 4));| Version | Description |
|---|---|
| 2.0.0 | initial version |