---
name: "ggiGetRayPos"
section: "3ggi"
platform: "linux"
package: "libggimisc2-dev"
version: "2.0.2-1.2"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/ggiGetRayPos/3ggi"
---

# ggiGetRayPos(3ggi)

Find out where the raster beam is.

## NAME

ggiGetRayPos - Find out where the raster beam is.

## SYNOPSIS

**#include \<ggi/misc.h\>**

**int ggiGetRayPos(ggi\_visual\_t** *vis***,**  **sint32\*** *x***, sint32\*** *y***);** .SH "DESCRIPTION"

Though currently only implemented via matroxfb, this function will retrieve the current position of the raster beam on a display that uses a cathode ray tube, or resembles such internally. Because it has not been implemented and put into widespread use, there may be API fluctuation as to exactly what units *x*,*y* are in, especially on displays using doublescanning modes. In addition to numerical values, the following values can be returned in either dimension:  **GGI\_RP\_BORDER** means the raster is in the border of the screen; **GGI\_RP\_BLANK** means the raster is past the border and is turned off; **GGI\_RP\_SYNC** means the raster is retracing to the top of the screen.

## RETURN VALUE

0 for OK, otherwise an error code.

## SEE ALSO

\[XRef to GGIWAITRAYPOS\]