• entries
    31
  • comments
    43
  • views
    61188

ShaderMap 2 SDK Tutorial - Creating Materials

Sign in to follow this  
RSI

2911 views

ShaderMap 2 allows users to create materials using the ShaderMap 2 SDK. A material can use any map in the ShaderMap project or load external image files such as cube maps. The material also provides a user interface wtih associated HLSL constants. To get started let's look at the basic structure of the ShaderMap 2 material file.

Each material file is an XML file. It is made of two parts: Setup and FX.

Material File Structure:





... SETUP ELEMENTS HERE ...






... OPTIONAL EFFECT SCRIPT HERE ...

]]>





The Setup Section

The first section of the XML is the SETUP section. Information in this section defines the maps and properties that the material will use.

The "setup" element requires 2 attributes: "name" and "description".

There are 4 types of elements that can be added to the Setup Section: lighting, world, input, and texture.


Lighting Element

The lighting element takes the form:
If lighting is set to 1 then the following constants will be sent to the shader:


// Light data
int g_light_count;
float3 g_light_vector_array[4];
float3 g_light_color_array[4];
float g_light_specular_array[4];
float3 g_light_ambient_color;



World Element



The "world" element can be of type "matrix", "vector", or "position". This element tells ShaderMap to send world information about the object it is rendering.

  • Matrix types are sent to the fx_name as float4x4.
  • Vector types are sent to the fx_name as float3.
  • Position types are sent to the fx_name as float3.


    1. The "matrix" type has the additional attribute "define" which defines the matrix to be sent to the fx_name constant. It can be any combination of the following characters:

    • 'w' - World matrix
    • 'v' - View matrix
    • 'p' - Projection matrix
    • 'r' - Rotation matrix
    • 'i' - Inverse of matrix
    • 't' - Transpose of matrix


      Ex.

      Each matrix is multiplied by the next. The inverse and transpose are applied to whatever matrix has previously been created.

      A string of "wit" sends the world_inverse_transpose matrix
      A string of "wvp" sends the world_view_projection matrix
      A string of "ri" sends the inversed rotation matrix

      There is no scaling in ShaderMap or rather all matrices have a scale of 1.0.

      2. The "vector" type has the additional attribute "define" which can be any one of the following values:

      • "view" - The view vector in world space


        Ex.

        3. The "position" type has the additional attribute "define" which can be on of the following values:

        • "eye" - The eye position in world space
        • "target" - The eye target position in world space
        • "object" - The object position in world space


          Ex.


          Input Element



          The "input" element defines a property control that will appear in the map properties section when that map is selected. This element can be a "list", "slider", "checkbox" or "color" control. Each type has additional attributes specific to the type.

          Values of the current input are sent to the FX constant defined in "fx_name".

          List types are sent to the fx_name as int
          Slider types are sent to the fx_name as int
          Checkbox types are sent to the fx_name as bool
          Color types are sent to the fx_name as float3

          1. The "list" type has the additional attributes: "prefix", "items", and "default".

          • "prefix" - A prefix to the list. A list of colors might use "color: "
          • "items" - A list of strings divided by the ; character. "A;B;C"
          • "default" - The default item in the list. A zero based index (integer).


            Ex.

            2. The "slider" type has the additional attributes: "name", "min", "max", and "default".

            • "name" - The name shown next to the slider control
            • "min" - The minimum value of the slider (integer)
            • "max" - The maximum value of the slider (integer)
            • "default" - The default value of the slider (integer)



              3. The "checkbox" type has the additional attributes: "name" and "default"

              • "name" - The name shown next to the checkbox control
              • "default" - The default state 1 or 0.

                Ex.

                4. The "color" type has the additional attributes: "name" and "default"

                • "name" - The name shown next to the color control
                • "default" - The default color of the control in HEX format.


                  Ex.


                  Texture Element



                  The "texture" element tells ShaderMap to send a texture to ShaderMap. The texture can be from a Map or an image file. Two types of image files are allowed and they are standard images (jpeg, bmp, etc.) and cube maps (always dds).

                  If any texture is sent to the shader then the tile constant is sent as well. It is a float2 and is always named g_uv_tile. Multiply this by all texture coords to get proper tiling.

                  1. The "map" type texture sends a user defined map to the shader. It has the additional attributes: "name", "desc", "is_normal", and "is_checkbox".

                  • "name" - The name of the map required by the shader.
                  • "desc" - A description of the map required by the shader.
                  • "is_normal" - Can be either 1 or 0. If set to 1 then the map sent should be a normal map. An additional constant is sent the the FX shader which contains the coordinate system of the normal map. It will take the form _coordsys. It is a float3 vector. It represents the coordinate system relative to the default tangent space used by ShaderMap. A vector of (1,1,1) means it is in X = +Right, Y = +Down, Z = +Near. A value of (1,1,-1) means that Y = +Up
                  • "is_checkbox" - Can be 1 or 0. If 1 then a checkbox control will be added to the properties that allows the user to disable sendingthis texture.


                    Ex.

                    2. The "image" type texture sends an image from file to the shader. It has the additional attributes: "name", "file", and "is_checkbox".

                    • "name" - The name of the image shown only if is_checkbox is 1.
                    • "file" - The filename of the image to load as a texture. It is relative to the location of the material file.
                    • "is_checkbox" - Can be 1 or 0. If 1 then a checkbox control will be added to the properties that allows the user to disable sending this texture.




                      3. The "cube" type texture sends a DDS cube map from file to the shader. It has the additional attributes: "file" and "is_checkbox".

                      • "name" - The name of the cube map shown only if is_checkbox is 1.
                      • "file" - The filename of the cube map to load as a texture. It is relative to the location of the material file.
                      • "is_checkbox" - Can be 1 or 0. If 1 then a checkbox control will be added to the properties that allows the user to disable sending this texture.


                        Ex.


                        Ex. A Diffuse Lighting Material Setup:


















                        The FX Section

                        The second section of the XML is the FX section. This section can include an entire Direct3D effect script enclosed in the CDATA section or can just be a link to a file in the same directory as the XML.

                        Attributes for the "fx" element are "vsm", "psm", and "file". vsm is the maximum vertex shader model required by the material. psm is the maximum pixel shader model required. The file attribute is optional, if set the fx is loaded from an external file rather than from the CDATA section. Ex. file="external_shader.fx"

                        Because ShaderMap uses DirectX 9c the maximum shader model supported is SHADER MODEL 3.

                        To learn more about DirectX Effect files see the Direct3D9c documentation:

                        http://msdn.microsof...9(v=vs.85).aspx
                        http://msdn.microsof...8(v=vs.85).aspx

                        or just google it: http://www.google.co...rect3D9 Effects


                        Diffuse Lighting Material

                        Here is a complete material example. It serves as a good starting point for creating your own materials. It takes one map as diffuse and uses per-pixel n dot l lighting for each of the project directional lights.





















                        // ==============================================================

                        // Light data
                        int g_light_count;
                        float3 g_light_vector_array[4];
                        float3 g_light_color_array[4];
                        float g_light_specular_array[4];
                        float3 g_light_ambient_color;

                        // World data
                        float4x4 g_world_matrix;
                        float4x4 g_world_view_projection;
                        float4x4 g_world_inverse_transpose;

                        // Input data
                        int g_multiplier;

                        // Map data
                        float2 g_uv_tile;
                        texture g_diffuse_texture;

                        // Samplers
                        sampler g_diffuse_sampler =
                        sampler_state
                        {
                        Texture = ;
                        };


                        // I/O structs
                        struct VS_INPUT
                        {
                        float3 position : POSITION;
                        float3 normal : NORMAL;
                        float2 uv : TEXCOORD0;
                        float4 tangent : TANGENT;
                        };

                        struct VS_OUTPUT
                        {
                        float4 position : POSITION;
                        float2 uv : TEXCOORD0;
                        float3 normal : TEXCOORD1;
                        };

                        // ==============================================================


                        // Vertex shader
                        VS_OUTPUT vs_main(VS_INPUT IN)
                        {
                        // Local data
                        VS_OUTPUT OUT;


                        // Store output position, UV, and normal
                        OUT.position = mul(float4(IN.position, 1.0f), g_world_view_projection);
                        OUT.uv = IN.uv * g_uv_tile;
                        OUT.normal = mul(IN.normal, (float3x3)g_world_inverse_transpose);

                        return OUT;
                        }

                        // Pixel (fragment) shader
                        float4 ps_main(VS_OUTPUT IN) : COLOR
                        {
                        // Local data
                        int i;
                        float n_dot_l;
                        float3 n, d, l;
                        float4 c;


                        // Get texture color
                        c = tex2D(g_diffuse_sampler, IN.uv);

                        // Get normal
                        n = normalize(IN.normal);

                        // Base light color
                        d = float3(0.0f, 0.0f, 0.0f);

                        // Calculate diffuse light color
                        for(i=0; i {
                        // Light vector
                        l = normalize(-g_light_vector_array);

                        // N dot L
                        n_dot_l = saturate(dot(n, l));

                        // Add in light
                        d += n_dot_l * g_light_color_array;
                        }

                        // Calculate final color and return;
                        c.rgb = saturate(saturate(c.rgb * (g_multiplier / 100.0f)) * d);

                        return c;
                        }

                        // ==============================================================

                        // ShaderMap Technique
                        technique shadermap_material
                        {
                        pass
                        {
                        VertexShader = compile vs_2_0 vs_main();
                        PixelShader = compile ps_2_a ps_main();
                        }
                        }

                        // ==============================================================
                        ]]>





                        And here is it running in ShaderMap 2:

                        e_26a.jpg


                        You can download the full material file here: Diffuse Lighting Material

                        To install the XML material file - place it in the following directory: C:\Program Files\ShaderMap 2\plugins\materials\

                        For more information and examples download the free ShaderMap SDK: http://shadermap.com/downloads
Sign in to follow this  


0 Comments


Recommended Comments

There are no comments to display.

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now