README.QNX
changeset 3092 cad1aefa2ed9
parent 3083 0bc41e0361d3
child 3099 82e60908fab1
equal deleted inserted replaced
3091:32efcc94b3da 3092:cad1aefa2ed9
     1 README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
     1 README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
     2 Last changed at 02 Mar 2009.
     2 Last changed at 10 Mar 2009.
     3 
     3 
     4 QNX Photon and GF drivers are under construction. Please be patient.
     4 QNX Photon and GF drivers are under construction. Please be patient.
       
     5 
       
     6 ---------------------
       
     7  -- SDL GF driver --
       
     8 ---------------------
       
     9 
       
    10 Here is an additional information about SDL GF driver:
       
    11  * 0. Introduction.
       
    12  * 1. Environment variables which SDL GF driver supports.
       
    13  * 2. Custom video modes.
       
    14  * 3. Limitations.
       
    15 
       
    16 0. Introduction.
       
    17 
       
    18    SDL GF driver is a layer between SDL and QNX Graphics Framework (GF). Hardware
       
    19 accelerated features which SDL could support depends on real hardware capabilities.
       
    20 
       
    21 1. Environment variables which GF driver supports.
       
    22 
       
    23    GF driver supports the following environment variables for QNX GF specific
       
    24 customization options:
       
    25    a) SDL_VIDEO_GF_REFRESH_RATE - refresh rate of video output in Hz. Without
       
    26       this environment variable declaration SDL controls refresh rate of your
       
    27       display. If this enironment variable is set to 0, SDL will control refresh
       
    28       rate of display, otherwise value of SDL_VIDEO_GF_REFRESH_RATE is used for
       
    29       all screen resolutions as refresh rate. This example will set 60Hz refresh
       
    30       rate as refresh rate for all graphics modes:
       
    31 
       
    32       export SDL_VIDEO_GF_REFRESH_RATE=60
       
    33 
       
    34 2. Custom video modes.
       
    35 
       
    36    Since most QNX graphics drivers supports GENERIC video modes, i.e. you could
       
    37 specify any horizontal and vertical resolution and any refresh rate, SDL GF
       
    38 driver uses its own fullscreen modes list, which could be incomplete. You could
       
    39 add any custom video mode, which your QNX graphics driver supports by editing
       
    40 file ./src/video/qnxgf/SDL_qnxgf.c. Custom graphics mode definition looks like
       
    41 
       
    42    {0, 1024, 640, 60, NULL},   /* 1024x640 mode is 60Hz only               */
       
    43 
       
    44 You must specify horizontal resolution as second parameter, vertical resolution
       
    45 as third parameter and refresh rate as fourth parameter. Please leave first and
       
    46 last parameters as 0 and NULL. Then please send me your changes to e-mail address
       
    47 which is specified in the header of this document.
       
    48 
       
    49 3. Limitations.
       
    50 
       
    51    There are few limitations while using SDL GF driver:
       
    52 
       
    53    a) Since GF driver supports fullscreen modes only, when you are not specifing
       
    54 SDL_WINDOW_FULLSCREEN flag, an SDL GF driver will try to find the fullscreen
       
    55 graphics mode which corresponds to SDL window size. Refresh rate will be the
       
    56 lowest available, if SDL_VIDEO_GF_REFRESH_RATE environment variable is not set.
       
    57