DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_circle - create a circle object.

LIBRARY CALL

xvobject xvw_create_circle(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The circle xvobject on success, NULL on failure

DESCRIPTION

A circle visual object supports the display of a circle.

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

Alternatively, the size and location of the circle may be specified using device coordinates. When device coordinates are used, they are with respect to the bounding box surrounding the circle; 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/Circle.c

SEE ALSO

xvisual(3)

COPYRIGHT

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