DISPLAY-MEMORY(Y)     LibGGI Reference    DISPLAY-MEMORY(Y)



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  frame-
       buffer  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 inde-
              pendent.  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.



GGI                       22 August 2001     DISPLAY-MEMORY(Y)