==========================================================================
Copyright (C) 1995 - 2006 Autodesk, Inc. and/or its licensors.  All 
rights reserved.

The coded instructions, statements, computer programs, and/or related 
material (collectively the "Data") in these files contain unpublished 
information proprietary to Autodesk, Inc. ("Autodesk") and/or its 
licensors, which is protected by U.S. and Canadian federal copyright 
law and by international treaties.

The Data is provided for use exclusively by You. You have the right 
to use, modify, and incorporate this Data into other products for 
purposes authorized by the Autodesk software license agreement, 
without fee.

The copyright notices in the Software and this entire statement, 
including the above license grant, this restriction and the 
following disclaimer, must be included in all copies of the 
Software, in whole or in part, and all derivative works of 
the Software, unless such copies or derivative works are solely 
in the form of machine-executable object code generated by a 
source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. 
AUTODESK DOES NOT MAKE AND HEREBY DISCLAIMS ANY EXPRESS OR IMPLIED 
WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF 
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR 
PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE, OR 
TRADE PRACTICE. IN NO EVENT WILL AUTODESK AND/OR ITS LICENSORS 
BE LIABLE FOR ANY LOST REVENUES, DATA, OR PROFITS, OR SPECIAL, 
DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES, EVEN IF AUTODESK 
AND/OR ITS LICENSORS HAS BEEN ADVISED OF THE POSSIBILITY 
OR PROBABILITY OF SUCH DAMAGES.

==========================================================================


CONTENTS
   - README (this file)
   - include 
     - mi_version.h
     - shader.h
     - geoshader.h     
     - mayaapi.h
   - lib 
     - nt
       - shader.lib
       - mayabase.lib
   - shaders 
     - public-baseshaders
	 - public-contourshaders
     - public-physicsshaders
   - docs
     - writingShaders   


NOTES
   - include
   This directory contains header files for custom shaders.
   The three header files in the include directory are 
   : "mi_version.h", "geoshader.h" and "shader.h" 
   are for generic mental ray shaders. 
   "mayaapi.h" is for mental ray shader that only works for maya.
   This file provides access to maya specific information
   such as light linking, render pass.
   Please see devkit/mentalray/docs/writingShaders for more detail.
   
   - lib
   The file "shader.lib" is for the Windows platform only. This prevents 
   hard-to-find bugs from occuring when compiling custom shaders on Windows. 
   No equivalent file is needed to compile a custom shader for the 
   other platforms.
   "mayabase.lib" is for the Windows platform only, and used for
   mental ray for maya shaders.
   
   - shaders
   public mental ray shader source code

   - docs
     - gettingStarted
	 This is a tutorial for how to use mental ray shaders in maya.
	 It contains html file explaining the workflow for each type of shaders,
	 and example scenes.
	 - writingShaders
	 The simple code demonstrates how to write a mental ray shader
	 so that maya light linking is repected.
     - writingShaders
         This section describes how to write a maya specific mental ray shader.
       - lightlink
           material shader using light linking.
       - lightEmit
	       light shader and material shader example that uses 
	       "emit diffuse", "emit specular" attributes on light.
   
USAGE
   - Include the following statements at the beginning of the custom 
   shader source code (among the other #include statements):

        #include <mi_version.h>
        #include <shader.h>
        #include <geoshader.h>        

   - Please consult your compiler's documentation on how to add 
   header and library paths so that the compiler can find the 
   mental ray for Maya headers (and shader.lib if needed).

   - Please consult the mental ray custom shader documentation 
   also for further details on usage.