DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_rectangle - creates a rectangle object

LIBRARY CALL

xvobject xvw_create_rectangle(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The rectangle object on success, NULL on failure

DESCRIPTION

A rectangle visual object supports the display of a rectangle.

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

Alternatively, the size and location of the rectangle may be specified using device coordinates. As when using world coordinates, specify the (x,y) location of the upper left hand corner of the rectangle, as well as the width and height of the rectangle.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

xvisual(3)

COPYRIGHT

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