Interface making it possible to create and use programs running on the GPU. More...
#include <IGPUProgrammingServices.h>
Interface making it possible to create and use programs running on the GPU.
Definition at line 38 of file IGPUProgrammingServices.h.
virtual irr::video::IGPUProgrammingServices::~IGPUProgrammingServices | ( | ) | [inline, virtual] |
Destructor.
Definition at line 43 of file IGPUProgrammingServices.h.
virtual s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial | ( | const c8 * | vertexShaderProgram, |
const c8 * | vertexShaderEntryPointName, | ||
E_VERTEX_SHADER_TYPE | vsCompileTarget, | ||
const c8 * | pixelShaderProgram, | ||
const c8 * | pixelShaderEntryPointName, | ||
E_PIXEL_SHADER_TYPE | psCompileTarget, | ||
const c8 * | geometryShaderProgram, | ||
const c8 * | geometryShaderEntryPointName = "main" , |
||
E_GEOMETRY_SHADER_TYPE | gsCompileTarget = EGST_GS_4_0 , |
||
scene::E_PRIMITIVE_TYPE | inType = scene::EPT_TRIANGLES , |
||
scene::E_PRIMITIVE_TYPE | outType = scene::EPT_TRIANGLE_STRIP , |
||
u32 | verticesOut = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [pure virtual] |
Adds a new high-level shading material renderer to the VideoDriver.
Currently only HLSL/D3D9 and GLSL/OpenGL are supported.
vertexShaderProgram | String containing the source of the vertex shader program. This can be 0 if no vertex program shall be used. |
vertexShaderEntryPointName | Name of the entry function of the vertexShaderProgram (p.e. "main") |
vsCompileTarget | Vertex shader version the high level shader shall be compiled to. |
pixelShaderProgram | String containing the source of the pixel shader program. This can be 0 if no pixel shader shall be used. |
pixelShaderEntryPointName | Entry name of the function of the pixelShaderProgram (p.e. "main") |
psCompileTarget | Pixel shader version the high level shader shall be compiled to. |
geometryShaderProgram | String containing the source of the geometry shader program. This can be 0 if no geometry shader shall be used. |
geometryShaderEntryPointName | Entry name of the function of the geometryShaderProgram (p.e. "main") |
gsCompileTarget | Geometry shader version the high level shader shall be compiled to. |
inType | Type of vertices passed to geometry shader |
outType | Type of vertices created by geometry shader |
verticesOut | Maximal number of vertices created by geometry shader. If 0, maximal number supported is assumed. |
callback | Pointer to an implementation of IShaderConstantSetCallBack in which you can set the needed vertex, pixel, and geometry shader program constants. Set this to 0 if you don't need this. |
baseMaterial | Base material which renderstates will be used to shade the material. |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |
shaderLang | a type of shading language used in current shader. |
Referenced by addHighLevelShaderMaterial().
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial | ( | const c8 * | vertexShaderProgram, |
const c8 * | vertexShaderEntryPointName = "main" , |
||
E_VERTEX_SHADER_TYPE | vsCompileTarget = EVST_VS_1_1 , |
||
const c8 * | pixelShaderProgram = 0 , |
||
const c8 * | pixelShaderEntryPointName = "main" , |
||
E_PIXEL_SHADER_TYPE | psCompileTarget = EPST_PS_1_1 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [inline] |
convenience function for use without geometry shaders
Definition at line 106 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterial(), irr::video::EGST_GS_4_0, irr::scene::EPT_TRIANGLE_STRIP, and irr::scene::EPT_TRIANGLES.
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial | ( | const c8 * | vertexShaderProgram, |
const c8 * | pixelShaderProgram = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [inline] |
convenience function for use with many defaults, without geometry shader
All shader names are set to "main" and compile targets are shader type 1.1.
Definition at line 131 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterial(), irr::video::EGST_GS_4_0, irr::video::EPST_PS_1_1, irr::scene::EPT_TRIANGLE_STRIP, irr::scene::EPT_TRIANGLES, and irr::video::EVST_VS_1_1.
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial | ( | const c8 * | vertexShaderProgram, |
const c8 * | pixelShaderProgram = 0 , |
||
const c8 * | geometryShaderProgram = 0 , |
||
scene::E_PRIMITIVE_TYPE | inType = scene::EPT_TRIANGLES , |
||
scene::E_PRIMITIVE_TYPE | outType = scene::EPT_TRIANGLE_STRIP , |
||
u32 | verticesOut = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [inline] |
convenience function for use with many defaults, with geometry shader
All shader names are set to "main" and compile targets are shader type 1.1 and geometry shader 4.0.
Definition at line 151 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterial(), irr::video::EGST_GS_4_0, irr::video::EPST_PS_1_1, and irr::video::EVST_VS_1_1.
virtual s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | const io::path & | vertexShaderProgramFileName, |
const c8 * | vertexShaderEntryPointName, | ||
E_VERTEX_SHADER_TYPE | vsCompileTarget, | ||
const io::path & | pixelShaderProgramFileName, | ||
const c8 * | pixelShaderEntryPointName, | ||
E_PIXEL_SHADER_TYPE | psCompileTarget, | ||
const io::path & | geometryShaderProgramFileName, | ||
const c8 * | geometryShaderEntryPointName = "main" , |
||
E_GEOMETRY_SHADER_TYPE | gsCompileTarget = EGST_GS_4_0 , |
||
scene::E_PRIMITIVE_TYPE | inType = scene::EPT_TRIANGLES , |
||
scene::E_PRIMITIVE_TYPE | outType = scene::EPT_TRIANGLE_STRIP , |
||
u32 | verticesOut = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [pure virtual] |
Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.
vertexShaderProgramFileName | Text file containing the source of the vertex shader program. Set to empty string if no vertex shader shall be created. |
vertexShaderEntryPointName | Name of the entry function of the vertexShaderProgram (p.e. "main") |
vsCompileTarget | Vertex shader version the high level shader shall be compiled to. |
pixelShaderProgramFileName | Text file containing the source of the pixel shader program. Set to empty string if no pixel shader shall be created. |
pixelShaderEntryPointName | Entry name of the function of the pixelShaderProgram (p.e. "main") |
psCompileTarget | Pixel shader version the high level shader shall be compiled to. |
geometryShaderProgramFileName | Name of the source of the geometry shader program. Set to empty string if no geometry shader shall be created. |
geometryShaderEntryPointName | Entry name of the function of the geometryShaderProgram (p.e. "main") |
gsCompileTarget | Geometry shader version the high level shader shall be compiled to. |
inType | Type of vertices passed to geometry shader |
outType | Type of vertices created by geometry shader |
verticesOut | Maximal number of vertices created by geometry shader. If 0, maximal number supported is assumed. |
callback | Pointer to an implementation of IShaderConstantSetCallBack in which you can set the needed vertex, pixel, and geometry shader program constants. Set this to 0 if you don't need this. |
baseMaterial | Base material which renderstates will be used to shade the material. |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |
shaderLang | a type of shading language used in current shader. |
Referenced by addHighLevelShaderMaterialFromFiles().
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | const io::path & | vertexShaderProgramFileName, |
const c8 * | vertexShaderEntryPointName = "main" , |
||
E_VERTEX_SHADER_TYPE | vsCompileTarget = EVST_VS_1_1 , |
||
const io::path & | pixelShaderProgramFileName = "" , |
||
const c8 * | pixelShaderEntryPointName = "main" , |
||
E_PIXEL_SHADER_TYPE | psCompileTarget = EPST_PS_1_1 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [inline] |
convenience function for use without geometry shaders
Definition at line 233 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterialFromFiles(), irr::video::EGST_GS_4_0, irr::scene::EPT_TRIANGLE_STRIP, and irr::scene::EPT_TRIANGLES.
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | const io::path & | vertexShaderProgramFileName, |
const io::path & | pixelShaderProgramFileName = "" , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [inline] |
convenience function for use with many defaults, without geometry shader
All shader names are set to "main" and compile targets are shader type 1.1.
Definition at line 258 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterialFromFiles(), irr::video::EGST_GS_4_0, irr::video::EPST_PS_1_1, irr::scene::EPT_TRIANGLE_STRIP, irr::scene::EPT_TRIANGLES, and irr::video::EVST_VS_1_1.
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | const io::path & | vertexShaderProgramFileName, |
const io::path & | pixelShaderProgramFileName = "" , |
||
const io::path & | geometryShaderProgramFileName = "" , |
||
scene::E_PRIMITIVE_TYPE | inType = scene::EPT_TRIANGLES , |
||
scene::E_PRIMITIVE_TYPE | outType = scene::EPT_TRIANGLE_STRIP , |
||
u32 | verticesOut = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [inline] |
convenience function for use with many defaults, with geometry shader
All shader names are set to "main" and compile targets are shader type 1.1 and geometry shader 4.0.
Definition at line 278 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterialFromFiles(), irr::video::EGST_GS_4_0, irr::video::EPST_PS_1_1, and irr::video::EVST_VS_1_1.
virtual s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | io::IReadFile * | vertexShaderProgram, |
const c8 * | vertexShaderEntryPointName, | ||
E_VERTEX_SHADER_TYPE | vsCompileTarget, | ||
io::IReadFile * | pixelShaderProgram, | ||
const c8 * | pixelShaderEntryPointName, | ||
E_PIXEL_SHADER_TYPE | psCompileTarget, | ||
io::IReadFile * | geometryShaderProgram, | ||
const c8 * | geometryShaderEntryPointName = "main" , |
||
E_GEOMETRY_SHADER_TYPE | gsCompileTarget = EGST_GS_4_0 , |
||
scene::E_PRIMITIVE_TYPE | inType = scene::EPT_TRIANGLES , |
||
scene::E_PRIMITIVE_TYPE | outType = scene::EPT_TRIANGLE_STRIP , |
||
u32 | verticesOut = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [pure virtual] |
Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.
vertexShaderProgram | Text file handle containing the source of the vertex shader program. Set to 0 if no vertex shader shall be created. |
vertexShaderEntryPointName | Name of the entry function of the vertexShaderProgram |
vsCompileTarget | Vertex shader version the high level shader shall be compiled to. |
pixelShaderProgram | Text file handle containing the source of the pixel shader program. Set to 0 if no pixel shader shall be created. |
pixelShaderEntryPointName | Entry name of the function of the pixelShaderProgram (p.e. "main") |
psCompileTarget | Pixel shader version the high level shader shall be compiled to. |
geometryShaderProgram | Text file handle containing the source of the geometry shader program. Set to 0 if no geometry shader shall be created. |
geometryShaderEntryPointName | Entry name of the function of the geometryShaderProgram (p.e. "main") |
gsCompileTarget | Geometry shader version the high level shader shall be compiled to. |
inType | Type of vertices passed to geometry shader |
outType | Type of vertices created by geometry shader |
verticesOut | Maximal number of vertices created by geometry shader. If 0, maximal number supported is assumed. |
callback | Pointer to an implementation of IShaderConstantSetCallBack in which you can set the needed vertex and pixel shader program constants. Set this to 0 if you don't need this. |
baseMaterial | Base material which renderstates will be used to shade the material. |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |
shaderLang | a type of shading language used in current shader. |
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles | ( | io::IReadFile * | vertexShaderProgram, |
const c8 * | vertexShaderEntryPointName = "main" , |
||
E_VERTEX_SHADER_TYPE | vsCompileTarget = EVST_VS_1_1 , |
||
io::IReadFile * | pixelShaderProgram = 0 , |
||
const c8 * | pixelShaderEntryPointName = "main" , |
||
E_PIXEL_SHADER_TYPE | psCompileTarget = EPST_PS_1_1 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 , |
||
E_GPU_SHADING_LANGUAGE | shadingLang = EGSL_DEFAULT |
||
) | [inline] |
convenience function for use without geometry shaders
Definition at line 358 of file IGPUProgrammingServices.h.
References addHighLevelShaderMaterialFromFiles(), irr::video::EGST_GS_4_0, irr::scene::EPT_TRIANGLE_STRIP, and irr::scene::EPT_TRIANGLES.
virtual s32 irr::video::IGPUProgrammingServices::addShaderMaterial | ( | const c8 * | vertexShaderProgram = 0 , |
const c8 * | pixelShaderProgram = 0 , |
||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [pure virtual] |
Adds a new ASM shader material renderer to the VideoDriver.
Note that it is a good idea to call IVideoDriver::queryFeature() in advance to check if the IVideoDriver supports the vertex and/or pixel shader version your are using.
The material is added to the VideoDriver like with IVideoDriver::addMaterialRenderer() and can be used like it had been added with that method.
vertexShaderProgram | String containing the source of the vertex shader program. This can be 0 if no vertex program shall be used. |
For DX8 programs, the will always input registers look like this: v0: position, v1: normal, v2: color, v3: texture cooridnates, v4: texture coordinates 2 if available.
For DX9 programs, you can manually set the registers using the dcl_ statements.
pixelShaderProgram | String containing the source of the pixel shader program. This can be 0 if you don't want to use a pixel shader. |
callback | Pointer to an implementation of IShaderConstantSetCallBack in which you can set the needed vertex and pixel shader program constants. Set this to 0 if you don't need this. |
baseMaterial | Base material which renderstates will be used to shade the material. |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |
virtual s32 irr::video::IGPUProgrammingServices::addShaderMaterialFromFiles | ( | io::IReadFile * | vertexShaderProgram, |
io::IReadFile * | pixelShaderProgram, | ||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [pure virtual] |
Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.
vertexShaderProgram | Text file containing the source of the vertex shader program. Set to 0 if no shader shall be created. |
pixelShaderProgram | Text file containing the source of the pixel shader program. Set to 0 if no shader shall be created. |
callback | Pointer to an IShaderConstantSetCallback object to which the OnSetConstants function is called. |
baseMaterial | baseMaterial |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |
virtual s32 irr::video::IGPUProgrammingServices::addShaderMaterialFromFiles | ( | const io::path & | vertexShaderProgramFileName, |
const io::path & | pixelShaderProgramFileName, | ||
IShaderConstantSetCallBack * | callback = 0 , |
||
E_MATERIAL_TYPE | baseMaterial = video::EMT_SOLID , |
||
s32 | userData = 0 |
||
) | [pure virtual] |
Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.
vertexShaderProgramFileName | Text file name containing the source of the vertex shader program. Set to 0 if no shader shall be created. |
pixelShaderProgramFileName | Text file name containing the source of the pixel shader program. Set to 0 if no shader shall be created. |
callback | Pointer to an IShaderConstantSetCallback object on which the OnSetConstants function is called. |
baseMaterial | baseMaterial |
userData | a user data int. This int can be set to any value and will be set as parameter in the callback method when calling OnSetConstants(). In this way it is easily possible to use the same callback method for multiple materials and distinguish between them during the call. |