DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_timer - create a timer object.

LIBRARY CALL

xvobject xvw_create_timer(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The timer object on success, NULL on failure

DESCRIPTION

The timer object was designed for use as a stopwatch. It displays the current time (including seconds) according to the system clock of the computer. It can be started and stopped as desired, and the update time can be specified to fractions of a second.

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

Alternatively, the location of the timer may be specified using device coordinates. As when using world coordinates, specify the upper left hand corner of the timer.

The amount of space used by the text displaying the time cannot be explicitly set by the application; this is automatically calculated according to the font that is used. Specification of a width and height simply provides a buffer of space around the time; note that justification will have no effect unless the width and height are specified to be larger than what is actually needed by the text displaying the time. Width and height may be specified in characters or in pixels.

In addition to font specification, the timer object also supports multiple styles in which the string displaying the time can appear: available styles include plain, emphasized, embossed in, and embossed out.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

xvisual(3)

COPYRIGHT

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