Name
Ellipse -- draw an ellipse
Synopsis
Ellipse(x, y, xradius, yradius[[, color], table])
Function
This function draws an ellipse at the position specified by x and y using the specified radii and color (RGB value). The ellipse will be drawn in the form style specified using SetFormStyle() and will be filled according to the configuration selected with SetFillStyle().

The width of the ellipse will be xradius * 2 + 1 (center point) and the height will be yradius * 2 + 1 (center point).

If layers are enabled, this command will add a new layer of the type #ELLIPSE to the layer stack.

New in Hollywood 2.0: Color can also be an ARGB value for alpha-blended drawing.

Starting with Hollywood 4.5, this function accepts a new optional table argument that can be used to specify one or more of the standard tags for all of Hollywood's draw commands. See Standard drawing tags for more information about the standard tags that nearly all Hollywood drawing commands support.

Please note that due to historical reasons the position that has to be passed to this function in the first two arguments is really the top-left corner of the ellipse's bounding rectangle. This might be confusing since traditionally ellipses are drawn relative to their center point. Due to a design mistake in Hollywood 1.0, however, Hollywood unfortunately deviates from this standard.

Note that when drawing to a palette-based target and the palette mode is set to #PALETTEMODE_PEN, this function will draw using the pen set via SetDrawPen() instead of the color passed to the function.

Inputs
x
x offset
y
y offset
xradius
x radius of your ellipse
yradius
y radius of your ellipse
color
optional: RGB or ARGB color (defaults to #BLACK) color is optional because it is not required when you render to a mask or alpha channel
table
optional: table containing further arguments; can be any from the ones listed above and from the standard tags (V4.5)

Show TOC