DESIGN (xvwidgets) functions


LIBRARY ROUTINE

xvw_translate_coords - translates the coordinates of an object to those of the root window

LIBRARY CALL

int xvw_translate_coords(
    xvobject object,
    int      x,
    int      y,
    int      *xpos,
    int      *ypos)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

Returns the device coordinates of a object with respect to those of the root window. If x and y are both passed as 0, then the device coordinates returned are with respect to the upper left hand corner of the root window. If x and y are passed as greater than 0, then the device coordinates returned will be relative to the (x, y) position specified. Note that it is an error to specify an x value larger then the screen width, or a y value larger than the screen height.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvwidgets/src/general.c

SEE ALSO

xvwidgets(3)

COPYRIGHT

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