DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_line - create a line object.

LIBRARY CALL

xvobject xvw_create_line(
   xvobject parent,
   char   *name)

INPUT

OUTPUT

none

RETURN VALUE

The line object on success, NULL on failure

DESCRIPTION

A line visual object supports the display of a line.

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

While not recommended, the size and location of the line may be specified using device coordinates. When device coordinates are used, they are with respect to the bounding box surrounding the line; 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. Due to lack of directional information, the line in this case will be drawn from the upper left hand corner of the bounding box to the lower right of the bounding box.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

xvisual(3)

COPYRIGHT

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