DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_ellipse - create a ellipse object.

LIBRARY CALL

xvobject xvw_create_ellipse(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The ellipse xvobject on success, NULL on failure

DESCRIPTION

An ellipse visual object supports the display of an ellipse.

The (x, y) location of the ellipse center, its width and height may be specified in world coordinates, where the world coordinate range is dictated by the "controlling" visual object. By default, the parent of the ellipse object is its controlling visual object; this may be changed using the XVW_GRAPHICS_ATTACH attribute.

Alternatively, the size and location of the ellipse may be specified using device coordinates. When device coordinates are used, they are with respect to the bounding box surrounding the ellipse; specify the (x,y) location of the upper left hand corner of the bounding box, as well as the width and height of the bounding box.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvisual/src/Ellipse.c

SEE ALSO

xvisual(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.