MediaScript Objects and Methods 123
•
•
•
•
rotate3d()
Rotates the image in 3D along either the x-axis or y-axis. A positive angle rotates away from
the viewer about the top or left edge, a negative angle rotates away from the viewer about
the bottom or right edge.
This function fully supports media objects within the CMYK color-space.
Syntax
rotate3d(
[alg @ <"Fast, Smooth, Best">]
[anglex @ <angle ±89>]
[angley @ <angle ±89>]
[distance @ <value>]
[layers @ <"layer list">] // (PSD files only)
);
Parameters
alg - specifies the algorithm that will be used. The default algorithm is fast. The effect of
the best algorithm is most apparent when scaling upward -- it uses a spline algorithm,
giving superior results, but is slower than both the fast and smooth algorithms.
anglex - specifies the number of degrees the image will be rotated around the x axis. A
positive angle rotates away from the viewer about the top or left edge. A negative angle
rotates away from the viewer about the bottom or right edge.
angley - specifies the number of degrees the image will be rotated around the y axis. A
positive angle rotates away from the viewer about the top or left edge. A negative angle
rotates away from the viewer about the bottom or right edge.
NOTE: You can specify a value for only one of the Anglex or Angley parameters, and only values
between -89 and +89 are permitted.)
distance - gives the distance in pixels the viewer is away from the image. The default
value is twice the longest dimension of the image (which gives a nice look). If a more
extreme perspective is required, use a smaller value for distance. If a less extreme
perspective is required, use a larger value.
NOTE: The value of distance must be greater than zero.
layers - for PSD files, specifies the layers to be affected. The layer numbers begin at 0
(background) and go up. For more information see “load()” on page 101.
