.TH "ggiWaitRayPos" 3 "2006-12-30" "libggimisc-2.2.x" GGI
.SH NAME
\fBggiWaitRayPos\fR : Wait for the raster to reach a point
.SH SYNOPSIS
.nb
.nf
#include <ggi/misc.h>

int ggiWaitRayPos(ggi_visual_t src, int32_t* x, int32_t* y);
.fi

.SH DESCRIPTION
\fBggiWaitRayPos\fR will wait, as best supported by the target, until the
raster reaches a certain point on the screen.  Actual integer
coordinates don't mean anything under current implementations, and the
units the coordinates are provided in haven't been firmly
decided. Instead, use one of the following macros: \fBGGI_RP_BORDER\fR
means the raster is in the border of the screen; \fBGGI_RP_BLANK\fR means
the raster is past the border and is turned off; \fBGGI_RP_SYNC\fR means
the raster is retracing to the top of the screen; \fBGGI_RP_DONTCARE\fR
means you don't care where the raster is in this direction.
.SH RETURN VALUE
\fB0\fR for OK, otherwise an \f(CWggi-error(3)\fR code.  In the event that
there is an error, it is most likely that the implementation on the
given target is limited.  In this case, the parameters \fIx\fR, \fIy\fR
will be assigned values equal to one of the above macros, which should
work on the target, supposing using those values actually accomplishes
what you want to do.
.SH SEE ALSO
\f(CWggiGetRayPos(3)\fR