Shader Viewer

The Shader Viewer can be used to look through the scene and model shaders that come with the 3D Gamestudio. To start it just run the shadertest.c which you will find in the "projects\shadertest\"-folder.

The Shader Viewer automatically loads every shader addressed in mtlFX.c and mtlView.c with the following prefix:

////////////////////////////////////////////////////////////////////
//Shader Name: XXX
//Material Name: mtl_xxx
//Standard Model: xxx.mdl 
//Variable1: var1
//Variable2: var2
//Variable3: Not used
//Variable4: Not used

The Shader Name may consist of a maximum of 24 characters and will be displayed in the Shader Panel. The Material Name must match the existing material identifier. The Standard Model will be loaded when a new shader is selected and must exist in the shadertest-directory. Already included are two models: marine.mdl & stones.mdl. To change shader-parameters at runtime, the Shader Panel also offers 4 sliders for the scene shader as well as for the model shader. To give a hint what the parameters are for they can be named by Variable1 to Variable4. Within the model shader, the variables are addressed by the vecSkill41 vector and within the scene shaders through the vecSkill1 vector.

The Panels

General Stuff Frames/Second - shows the actual fps which can be affected by the selected shaders SkyColor - Set the background color (only if the skycube is not activated) SkyCube - Toggle the standard skycube on/off or load your own

Shader Scene Shader - Scroll through the scene shader library or load your own scene shader Scene Shader Variables - Change the shader parameters, if existing Model Shader - Scroll through the model shader library or load your own model shader Model Shader Variables - Change the shader parameters, if existing

Model Open - Load your own model entity Skin - Toggle the model skin on/off -> turn skin off to see what the shader is doing Skins - Number of model skins -> a maximum of 4 can be used in shaders Vertices - Number of model vertices Selected Skin (within the white frame) - Thumbnail of the selected model skin Shown Skin - Slide through the model skins Animation - Toggle the model animation - if existing (see "Frames") Frames - Number of animation frames Model Scale - Scale the model to perfectly fit onto the screen zOffset - Move the model along the z-axis Texture Overlay - Toggle the texture overlay on/off

Light + / - - Adds/removes a dynamic light Movement - Choose a movement behavior for the selected (red dot) light entity Color - Change the light-color of the selected light entity Light Distance - Adjust the distance of the selected light entity to the model

All Panels

To reposition a panel just press the left mouse button over the button in the upper left corner.

Additional help

In the upper middle part of the window you will always find some additional information about what you are pointing at.

Navigation

To rotate the model entity, press the right mouse-button.
To zoom in or out use the mouse-wheel.