
NONE: The information contained in this file is only relevant when using
      the old rasterizer. The new rasterizer does not use these concepts
      anymore...


This file describes how to activate and deactivate several rasterization
functions in SoftGL.

For optimal performance SoftGL uses a separate function for each combination
of rasterization features. e.g.: there is a function DrawScanLine_ZW_ZTl_Cg
which does z-writing, z-testing with "less than" and gouraud shading,
but no texturing, no fog and no blending.

Combining all current features usefully yields 735 functions. All these
combinations are created with a Python script ("GenerateRasterFuncs.py")
in the file "BackBuffer_RasterizeFuncs.cxx".
Since this is quite a lot of functions and creates a large DLL, it's possible
to remove several features from the list in order to reduce the number
of created functions.

This distribution comes with 315 functions (several z-tests disabled). If you
try to use a feature combination that's not enabled, SoftGL will complain at runtime.
To enable/disable features, comment them out in the Python script by adding
a hash character.

Note: VC6, EVC3 and EVC4 won't compile the DLL anymore with that many functions
in a single file, when using the default settings. In order to fix it you have to
enlarge the compiler heap by adding /Zm800 (or larger) to the compiler settings.
See the MSDN for more information on this issue.

For any questions send an email to klimt@ims.tuwien.ac.at
