===============================
NSI Shader System Documentation
===============================

Notes
-----
  - Shader files use the ".nsa" extension (Nihilistic Shader Archive)
  - Shader files must be stored in the "Materials\" directory
  - Shader filenames must be listed in "Materials\shaderlist.txt" to be loaded
  - Shader filenames must corespond to a directory name for editor compatibility. e.g.:
      "Materials\metal.nsa" specifies shaders in the "Materials\metal" directory


Shader Format
-------------

shadername
{
    parameters
    ...
}


Parameters
----------

  Editor Only Parameters:

    qer_nocarve
    qer_trans
    qer_editorimage <filename>
    qer_description <string>
    qer_light_intensity <float>
    qer_light_color <floatR> <floatG> <floatB>
    qer_light_image <filename>
    qer_surfaceparm <parm>
        noDraw
        noMarks
        noLightmap
        noLightblock
        noMipmap
        noCull
        vertexLight
        nonSolid
        playerClip
        aiClip
        cameraClip
        decal
        sky
        slick
        mirror
        skip
        water
        terrain
        trans <float>

  General Parameters:

    surfflag <int>
	0x0001  (TWo Sided)
	0x0002  (No Marks)
	0x0004  (No Shadow)
	0x0008	(No Draw)
	        

  Shader Types/Parameters:

  4bit Alpha
  ----------
    shader alpha
    texture <filename>

  1bit Alpha
  ----------
    shader masked
    texture <filename>

  Terrain
  -------
    shader terrain
    texture <filename>
    detail <filename>
    detailscale <float>
    detail2 <filename>
    detail2scale <float>
    cloudmap <filename>
    cloudscale <float>
    cloudspeed <float>

  Detail/Macro
  ------------
    shader detail
    texture <filename>
    detail <filename>
    detailscale <float>

  Environment Map
  ---------------
    shader envmap
    texture <filename>
    envmap <filename>
    intensity <float>

  Gloss Map
  --------
    shader glossenvmap
    texture <filename>
    envmap <filename>
    intensity <float>
    
  Glass
  -----
    shader glass
    texture <filename>
    envmap <filename>
    alpha <float>

  Etched Glass
  ------------
    shader etchedglass
    texture <filename>
    envmap <filename>
    glossmap <filename>
    
  Glow
  ----
    shader glow
    texture <filename>
    glow <filename>
    intensity <float>
        
  Keyhole
  -------
    shader keyhole
    texture <filename>
    glow <filename>

  Scanline
  --------
    shader scanline
    texture <filename>
    envmap <filename>
    detail <filename>
    detailscale <float>
    speed <float>
    reflect <float>

  Add Blend
  ---------
    shader add
    texture <filename>
    lightstyle <float>

  Fullbright
  ----------
    shader fullbright
    texture <filename>
    
  Water
  ----- 
    shader water
    texture <filename>
    envmap <filename>
    texturescale <float>
    alpha <float>
    reflect <float>

  Blend
  -----
    shader blend
    texture <filename>
    texture2 <filename>
    blendfactor <float>