User's Manual

MediaScript Objects and Methods 77
•
•
•
•
•
Syntax
ellipse(
X @ <pixel>
Y @ <pixel>
Rx @ <value>
Ry @ <value>
[Opacity @ <value 0..255>]
[Unlock @ <color in hexadecimal or rgb>]
[Color @ <color in hexadecimal or rgb>]
[Index @ <value 0..16777215>]
[Saturation @ <value 0..255>]
[PreserveAlpha @ <true, false>]
[Blend @ <"blend-type">]
[Width @ <value>]
[Smooth @ <true, false>]
[Fill @ <true, false>]
);
Parameters
X - specifies (in pixels) the x axis coordinate for the center point of the ellipse. This
parameter is required and has no default value.
Y - specifies (in pixels) the y axis coordinate for the center point of the ellipse. This
parameter is required and has no default value.
Rx - specifies (in pixels) the radius of the ellipse on the x axis. This parameter is required
and has no default value.
Ry - specifies (in pixels) the radius of the ellipse on the y axis. This parameter is required
and has no default value.
Opacity - specifies opacity of the drawn object. The default value is 255 (completely
solid).
Unlock - if set to true, causes the ellipse to display only where the specified color value
appears in the current (background) image. The default is false.
Color - specifies the color to be used for the ellipse. The default is the foreground color.
Index - colorizes the ellipse using the available color palette for the source image (as an
alternative to the Color parameter).
NOTE: You cannot specify values for both the Color and Index parameters.
Saturation - specifies a value used for weighting for the change in saturation for
destination pixels. A value of 255 changes the saturation of pixels to the specified color. A
value of 128 changes the saturation of a pixel to a mid-value between the pixel’s current
color and the specified color.
NOTE: The Saturation parameter only functions when the Blend parameter is set to
“colorize.”