DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_marker - create a marker object

LIBRARY CALL

xvobject xvw_create_marker(
   xvobject parent,
   char   *name)

INPUT

OUTPUT

none

RETURN VALUE

The marker object on success, NULL on failure

DESCRIPTION

A marker visual object supports the display of a marker; A wide variety of marker types are supported.

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

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

Because the size of a marker is automatically determined according to the scale, width and height should not be specified; instead, to increase the size of the marker, provide the desired scale value as an integer multiple of the original (default) size.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

xvisual(3)

COPYRIGHT

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