Irrlicht 3D Engine
irr::video::IMaterialRendererServices Class Referenceabstract

Interface providing some methods for changing advanced, internal states of a IVideoDriver. More...

#include <IMaterialRendererServices.h>

Public Member Functions

virtual ~IMaterialRendererServices ()
 Destructor. More...
 
virtual IVideoDrivergetVideoDriver ()=0
 Get pointer to the IVideoDriver interface. More...
 
virtual void setBasicRenderStates (const SMaterial &material, const SMaterial &lastMaterial, bool resetAllRenderstates)=0
 Can be called by an IMaterialRenderer to make its work easier. More...
 
virtual bool setPixelShaderConstant (const c8 *name, const f32 *floats, int count)=0
 Sets a constant for the pixel shader based on a name. More...
 
virtual bool setPixelShaderConstant (const c8 *name, const bool *bools, int count)=0
 Bool interface for the above. More...
 
virtual bool setPixelShaderConstant (const c8 *name, const s32 *ints, int count)=0
 Int interface for the above. More...
 
virtual void setPixelShaderConstant (const f32 *data, s32 startRegister, s32 constantAmount=1)=0
 Sets a pixel shader constant. More...
 
virtual bool setVertexShaderConstant (const c8 *name, const f32 *floats, int count)=0
 Sets a constant for the vertex shader based on a name. More...
 
virtual bool setVertexShaderConstant (const c8 *name, const bool *bools, int count)=0
 Bool interface for the above. More...
 
virtual bool setVertexShaderConstant (const c8 *name, const s32 *ints, int count)=0
 Int interface for the above. More...
 
virtual void setVertexShaderConstant (const f32 *data, s32 startRegister, s32 constantAmount=1)=0
 Sets a vertex shader constant. More...
 

Detailed Description

Interface providing some methods for changing advanced, internal states of a IVideoDriver.

Definition at line 20 of file IMaterialRendererServices.h.

Constructor & Destructor Documentation

§ ~IMaterialRendererServices()

virtual irr::video::IMaterialRendererServices::~IMaterialRendererServices ( )
inlinevirtual

Member Function Documentation

§ getVideoDriver()

virtual IVideoDriver* irr::video::IMaterialRendererServices::getVideoDriver ( )
pure virtual

Get pointer to the IVideoDriver interface.

Returns
Pointer to the IVideoDriver interface

Referenced by ~IMaterialRendererServices().

§ setBasicRenderStates()

virtual void irr::video::IMaterialRendererServices::setBasicRenderStates ( const SMaterial material,
const SMaterial lastMaterial,
bool  resetAllRenderstates 
)
pure virtual

Can be called by an IMaterialRenderer to make its work easier.

Sets all basic renderstates if needed. Basic render states are diffuse, ambient, specular, and emissive color, specular power, bilinear and trilinear filtering, wireframe mode, grouraudshading, lighting, zbuffer, zwriteenable, backfaceculling and fog enabling.

Parameters
materialThe new material to be used.
lastMaterialThe material used until now.
resetAllRenderstatesSet to true if all renderstates should be set, regardless of their current state.

Referenced by ~IMaterialRendererServices().

§ setPixelShaderConstant() [1/4]

virtual bool irr::video::IMaterialRendererServices::setPixelShaderConstant ( const c8 name,
const f32 floats,
int  count 
)
pure virtual

Sets a constant for the pixel shader based on a name.

This can be used if you used a high level shader language like GLSL or HLSL to create a shader. See setVertexShaderConstant() for an example on how to use this.

Parameters
nameName of the variable
floatsPointer to array of floats
countAmount of floats in array.
Returns
True if successful.

Referenced by ~IMaterialRendererServices().

§ setPixelShaderConstant() [2/4]

virtual bool irr::video::IMaterialRendererServices::setPixelShaderConstant ( const c8 name,
const bool *  bools,
int  count 
)
pure virtual

Bool interface for the above.

§ setPixelShaderConstant() [3/4]

virtual bool irr::video::IMaterialRendererServices::setPixelShaderConstant ( const c8 name,
const s32 ints,
int  count 
)
pure virtual

Int interface for the above.

§ setPixelShaderConstant() [4/4]

virtual void irr::video::IMaterialRendererServices::setPixelShaderConstant ( const f32 data,
s32  startRegister,
s32  constantAmount = 1 
)
pure virtual

Sets a pixel shader constant.

Can be used if you created a shader using pixel/vertex shader assembler or ARB_fragment_program or ARB_vertex_program.

Parameters
dataData to be set in the constants
startRegisterFirst register to be set.
constantAmountAmount of registers to be set. One register consists of 4 floats.

§ setVertexShaderConstant() [1/4]

virtual bool irr::video::IMaterialRendererServices::setVertexShaderConstant ( const c8 name,
const f32 floats,
int  count 
)
pure virtual

Sets a constant for the vertex shader based on a name.

This can be used if you used a high level shader language like GLSL or HLSL to create a shader. Example: If you created a shader which has variables named 'mWorldViewProj' (containing the WorldViewProjection matrix) and another one named 'fTime' containing one float, you can set them in your IShaderConstantSetCallBack derived class like this:

virtual void OnSetConstants(video::IMaterialRendererServices* services, s32 userData)
{
video::IVideoDriver* driver = services->getVideoDriver();
f32 time = (f32)os::Timer::getTime()/100000.0f;
services->setVertexShaderConstant("fTime", &time, 1);
core::matrix4 worldViewProj(driver->getTransform(video::ETS_PROJECTION));
worldViewProj *= driver->getTransform(video::ETS_VIEW);
worldViewProj *= driver->getTransform(video::ETS_WORLD);
services->setVertexShaderConstant("mWorldViewProj", worldViewProj.M, 16);
}
Parameters
nameName of the variable
floatsPointer to array of floats
countAmount of floats in array.
Returns
True if successful.

Referenced by ~IMaterialRendererServices().

§ setVertexShaderConstant() [2/4]

virtual bool irr::video::IMaterialRendererServices::setVertexShaderConstant ( const c8 name,
const bool *  bools,
int  count 
)
pure virtual

Bool interface for the above.

§ setVertexShaderConstant() [3/4]

virtual bool irr::video::IMaterialRendererServices::setVertexShaderConstant ( const c8 name,
const s32 ints,
int  count 
)
pure virtual

Int interface for the above.

§ setVertexShaderConstant() [4/4]

virtual void irr::video::IMaterialRendererServices::setVertexShaderConstant ( const f32 data,
s32  startRegister,
s32  constantAmount = 1 
)
pure virtual

Sets a vertex shader constant.

Can be used if you created a shader using pixel/vertex shader assembler or ARB_fragment_program or ARB_vertex_program.

Parameters
dataData to be set in the constants
startRegisterFirst register to be set
constantAmountAmount of registers to be set. One register consists of 4 floats.

The documentation for this class was generated from the following file: