This API is used to tune the effects and shaders used for rendering.
3DSTATE supports Vertex Shaders, Pixel Shaders, fx script file
Microsoft HLSL (High Level Shader Language)
To make an object rendered using a specific effect use the function
STATE_object_create_effect(); This is the only way to create an effect.
Once the effect was created the engine will render the given object
using the specified effect.
This API (functions starting with 3DSTATE_effect_...) is used to tune the effect used.
The behavior of the functions of this API is different for every effect used
Some effects don't support any tuning others support only some of the
available functions and only a few support all the functions of this API
To learn which of the functions of this API can be used to tune a specific Effect
You should read the specific effect description.
Example:
If you use EFFECT_SKYSPHERE to render a sky sphere
You can use STATE_effect_set_color() to set the color of the sky.
When using the EFFECT_FAST_ENVIRONMENT_MAPPING effect
Calling STATE_effect_set_color() will have no effect.
In short the functions of this API will give different
results depending on the Effect used.
1. STATE_effect_set_color
2. STATE_effect_set_object_to_synchronize_with 3. STATE_effect_set_light_direction 4. STATE_effect_set_speed 5. STATE_effect_is_effect 6. STATE_effect_set_debug_mode 7. STATE_effect_delete
|