home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / oglgold.zip / README.FYI
Text File  |  1997-10-02  |  4KB  |  86 lines
  1.  
  2. This is the "gold" release of OpenGL 1.1 for OS2.  Please forwared any
  3. problems to IBM support or mail a description of the problem and a 
  4. testcase to - os2-opengl@utsi.com.
  5.  
  6.  
  7.    Important Troubleshooting Tips
  8.    ------------------------------
  9.  
  10.    OpenGL makes a lot of demands on the setup of your system, and when
  11.    the setup reported by the graphics device driver does not exactly
  12.    match the actual one, problems can arise. If OpenGL does not render,
  13.    or if the image looks incorrect, one of the following items may help.
  14.    These settings will override whatever OpenGL queries from your graphics
  15.    device, so do not use them unless you are having trouble.
  16.  
  17.    - A "squished" OpenGL image is most likely the result of an incorrect
  18.      bits-per-pixel report from your OS/2 graphics device driver when
  19.      running in 24 bit. In this case, setting  OGL_BIT_COUNT=32 in your
  20.      environment by adding "SET OGL_BIT_COUNT=32" to the config.sys should
  21.      correct the image. Please be aware that this statement should not be used
  22.      when in 8 or 16 bit.
  23.  
  24.    - An OpenGL rendering that has a repeated image that goes beyond the bounds
  25.      of the window is probably the result of an incorrect scanline size report.
  26.      Scanline sizes are usually the product of the horizontal screen resolution
  27.      and the screen depth in bytes-per-pixel (a 1024x768x64k setting may use a
  28.      scanline size of 2048, since 64K is 2**16 which means every pixel is
  29.      comprised of 2 bytes). In this case, adding "SET OGL_SCANLINE_SIZE=2048"
  30.      to the config.sys should correct the problem. Please be aware that a
  31.      OGL_SCANLINE_SIZE setting that works in one screen resolution and depth
  32.      setting will not work in another.
  33.  
  34.    - When running with a color depth of 8 bit, OpenGL will attempt to preserve
  35.      the PM colors used on the desktop, but as a result, OpenGL may not receive
  36.      all of the colors in its palette. The results obtained are very graphic
  37.      card dependent. If OpenGL is not receiving all of the colors it needs
  38.      for an image, OpenGL can force PM to use the OpenGL colors by setting
  39.      "OGL_OVERRIDE_COLORS=1" in your environment. Be aware that the PM desktop
  40.      will flash and the PM colors may not be preserved when the OpenGL window
  41.      has focus, but the OpenGL window will obtain all of its colors.  Setting
  42.      "OGL_OVERRIDE_COLORS=" will reset the overriding of PM colors. But in all
  43.      cases the best visual results will be obtained when 
  44.      "System Setup->System->256 Colors->Workplace shell palette aware" is
  45.      checked (see Helpful Information).
  46.  
  47.  
  48.    Helpful Information
  49.    -------------------
  50.  
  51.    When running in 256 color mode, the following check box should be selected
  52.    for optimal visual results:
  53.        "System Setup->System->256 Colors->Workplace shell palette aware"
  54.  
  55.    The best OpenGL performance will be attained with a PCI graphics card that
  56.    is not bank-switched at the desired screen resolution and depth. When
  57.    running in 24 bit, a non packed pixel (32 bot) device driver and graphics
  58.    card combination will yield better performance then a packed pixel (24 bit)
  59.    one.
  60.  
  61.    Running OpenGL on a Matrox Millennium in 24 bit requires that DIVE support
  62.    is enabled. See the documentation that came your Matrox for information on
  63.    how to enable DIVE support in 24 bit.
  64.  
  65.    Summary of Settable Environment Variables
  66.    -----------------------------------------
  67.  
  68.    The following strings are scanned for in the current environment by OpenGL,
  69.    these can be set by using the "SET" command in OS/2 (issue "help set" in an
  70.    OS/2 Window for information on the "SET" command). may help. These settings
  71.    will override whatever OpenGL queries from your graphics device, so do not
  72.    use them unless you are having trouble.
  73.  
  74.  
  75.    OGL_BIT_COUNT - used by OpenGL to replace the bits-per-pixel report from the
  76.    graphics device driver. Primary use is for when 32 bpp(non-packed)
  77.    setup actually reports 24 bpp (packed). See "Important Troubleshooting Tips"
  78.    section.
  79.  
  80.    OGL_SCANLINE_SIZE - used by OpenGL to replace the scanline size report from
  81.    the graphics device driver. See "Important Troubleshooting Tips" section.
  82.  
  83.    OGL_OVERRIDE_COLORS - used by OpenGL to override the PM colors in the color
  84.    palette. Only applicable when running in 8 bit. See "Important
  85.    Troubleshooting Tips" section.
  86.