display-memory

Name

display-memory -- Display on buffer in main memory

Synopsis

display-memory : [-input] [-physz=sizex,sizeydpi] [shmid:sid | keyfile:size:id:fname | pointer]

Description

Emulates a linear framebuffer in main memory. The framebuffer can be a shared memory segment, an area specified by the application, or an area allocated by display-memory itself.

Options

-input

If the -input option is set, an input buffer of INPBUFSIZE (default is 8192 bytes) as #define'd in ggi/display/memory.h is allocated at the start of the requested memory area.

When running on shared memory, this option enables you to to give input (using giiSendEvent) to other processes sharing that segment. This technique is demonstrated in cube3d and can be used for things like GGI multiplexers.

-physz=sizex,sizeydpi

This option will provide a physical screen size for applications which wish to remain resolution independent. sizex,sizey are the x,y size of the screen in millimeters, unless the optional dpi string is affixed, in which case, they represent resolution in dots-per-inch.

shmid:sid

use existing shared memory ID sid

keyfile:size:id:fname

create a new shm segment with id ftok(fname, id) of size size (preferred method !)

pointer

use the memory pointed to by argptr (only available to applications calling ggiOpen).

Important: If you specify a memory area to use - be sure it's big enough as no checks can or will be made that a certain mode fits into it.

Features

DirectBuffer support always available.
Unaccelerated.