---
name: "ggiGetRayPos"
section: "3"
platform: "linux"
package: "libggimisc2-dev"
version: "2.2.2-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/ggiGetRayPos"
---

# ggiGetRayPos(3)

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, int32_t* x, int32_t* y);
```

## 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 `ggi-error(3)` code.

## SEE ALSO

`ggiWaitRayPos(3)`