home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Graphics / MysticView / Prefs / env-variables < prev    next >
Encoding:
Text File  |  1999-05-29  |  3.1 KB  |  95 lines

  1.  
  2. guigfx environment variables
  3. ----------------------------
  4.  
  5.   these environment variables may help you to improve
  6.   MysticView's rendering speed and/or quality.
  7.   
  8.  
  9. > guigfx/USESCALEPIXELARRAY
  10.   internal default: 0 (disabled)
  11.  
  12.     short: use ScalePixelArray() / cybergraphics v41
  13.  
  14.     if you have cybergraphics v41 (or later) installed to
  15.     your system, this flag tells guigfx.library to use
  16.     cybergraphics.library/ScalePixelArray() for scaling
  17.     truecolor data to truecolor displays.
  18.     
  19.     ScalePixelArray() can scale inside the graphics card's
  20.     memory at very high speed. it is NOT used by default,
  21.     due to a number of problems. ScalePixelArray() (v41)
  22.     
  23.     - uses an incorrect bresenham algorithm
  24.     - overwrites areas outside the specified rectangle
  25.     - overwrites areas outside the specified rastport
  26.     - causes annoying flickering
  27.     - behaves very uncomfortable when a ClipRegion is
  28.       installed inside a rastport's layer.
  29.  
  30.     the internal scaling routines of guigfx.library are
  31.     highly accurate and also very fast, but the scaled
  32.     data must still be transferred over the bus.
  33.  
  34.     set this flag to 1 if you prefer higher performance.
  35.     
  36.     notes:
  37.  
  38.     - meaningless on native screens.
  39.     - meaningless on non-hicolor/truecolor screens.
  40.     - newer versions of the Picasso96 emulation support
  41.       this function as well.
  42.     - the quality/performance of ScalePixelArray() on
  43.       cybergraphics 4.0 (or later) is unknown to the author.
  44.     - ScalePixelArray() cannot be interrupted. this might
  45.       result in an uncomfortable behavior in MysticView's
  46.       'Grid Preview' mode.
  47.  
  48.  
  49.  
  50. > guigfx/USEWPA8
  51.   internal default: 0 (disabled)
  52.  
  53.     short: use WritePixelArray8() on native Amiga screenmodes
  54.  
  55.     the OS functions WriteChunkyPixels(), WritePixelArray8() and
  56.     WritePixelLine8() are awfully slow on native Amiga displays.
  57.     therefore guigfx.library is using an internal chunky-2-planar
  58.     conversion by default. unfortunately the planar data still
  59.     has to be rendered to the display via graphics.library
  60.     functions. in addition to that, render.library's
  61.     chunky-2-planar routines are everything but state-of-the-art.
  62.  
  63.     there are very fast third-party patches available to
  64.     improve the performance of WritePixelArray() and
  65.     WriteChunkyPixels(). 
  66.     
  67.     set this flag to 1 if you have no graphics card, and you
  68.     installed a patch for WritePixelArray8().
  69.     
  70.     note:
  71.     - this flag is meaningless for graphics card displays.
  72.  
  73.  
  74.   
  75. > guigfx/AUTODITHERTHRESHOLD
  76.   internal default: 250
  77.  
  78.     short: set global default autodither threshold
  79.   
  80.     this variable allows you to set a global default for
  81.     guigfx.library's autodither feature. the lower, the
  82.     earlier dithering is activated.
  83.     
  84.     in autodither mode, guigfx.library performs a quick
  85.     evaluation of the expected quality loss for
  86.     rendering without dither. if the bias is above the
  87.     autodither threshold, dithering will be activated.
  88.  
  89.     notes:
  90.  
  91.     - meaningless on truecolor and hicolor displays.
  92.     - the bias is not computed for HAM modes.
  93.     - applications using guigfx.library may override
  94.       this global default value. (MysticView doesn't.)
  95.