DISPLAY-MEMORY(7ggi)

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.