From 393b5cd1dc438872af89d334ef6e5fcc59f27d47 Mon Sep 17 00:00:00 2001 From: David Walter Seikel Date: Sun, 13 Jan 2013 17:24:39 +1000 Subject: Added Irrlicht 1.8, but without all the Windows binaries. --- ..._1_1video_1_1_i_g_p_u_programming_services.html | 1270 ++++++++++++++++++++ 1 file changed, 1270 insertions(+) create mode 100644 libraries/irrlicht-1.8/doc/html/classirr_1_1video_1_1_i_g_p_u_programming_services.html (limited to 'libraries/irrlicht-1.8/doc/html/classirr_1_1video_1_1_i_g_p_u_programming_services.html') diff --git a/libraries/irrlicht-1.8/doc/html/classirr_1_1video_1_1_i_g_p_u_programming_services.html b/libraries/irrlicht-1.8/doc/html/classirr_1_1video_1_1_i_g_p_u_programming_services.html new file mode 100644 index 0000000..3ad6d50 --- /dev/null +++ b/libraries/irrlicht-1.8/doc/html/classirr_1_1video_1_1_i_g_p_u_programming_services.html @@ -0,0 +1,1270 @@ + + + + +Irrlicht 3D Engine: irr::video::IGPUProgrammingServices Class Reference + + + + + + + + + + + + + + +
+ + +
+ + + + + + + + + + + + + + + + + +
+
Irrlicht 3D Engine + +
+ +
+ + + + + + +
+
+
+ + + + +
+
+ +
+
+
+ +
+
+ +
+
irr::video::IGPUProgrammingServices Class Reference
+
+
+ +

Interface making it possible to create and use programs running on the GPU. + More...

+ +

#include <IGPUProgrammingServices.h>

+ +

List of all members.

+

+Public Member Functions

+ +

Detailed Description

+

Interface making it possible to create and use programs running on the GPU.

+ +

Definition at line 38 of file IGPUProgrammingServices.h.

+

Constructor & Destructor Documentation

+ +
+
+ + + + + + + +
virtual irr::video::IGPUProgrammingServices::~IGPUProgrammingServices () [inline, virtual]
+
+
+ +

Destructor.

+ +

Definition at line 43 of file IGPUProgrammingServices.h.

+ +
+
+

Member Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
virtual s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial (const c8vertexShaderProgram,
const c8vertexShaderEntryPointName,
E_VERTEX_SHADER_TYPE vsCompileTarget,
const c8pixelShaderProgram,
const c8pixelShaderEntryPointName,
E_PIXEL_SHADER_TYPE psCompileTarget,
const c8geometryShaderProgram,
const c8geometryShaderEntryPointName = "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,
IShaderConstantSetCallBackcallback = 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.

+
Parameters:
+ + + + + + + + + + + + + + + + + +
vertexShaderProgramString containing the source of the vertex shader program. This can be 0 if no vertex program shall be used.
vertexShaderEntryPointNameName of the entry function of the vertexShaderProgram (p.e. "main")
vsCompileTargetVertex shader version the high level shader shall be compiled to.
pixelShaderProgramString containing the source of the pixel shader program. This can be 0 if no pixel shader shall be used.
pixelShaderEntryPointNameEntry name of the function of the pixelShaderProgram (p.e. "main")
psCompileTargetPixel shader version the high level shader shall be compiled to.
geometryShaderProgramString containing the source of the geometry shader program. This can be 0 if no geometry shader shall be used.
geometryShaderEntryPointNameEntry name of the function of the geometryShaderProgram (p.e. "main")
gsCompileTargetGeometry shader version the high level shader shall be compiled to.
inTypeType of vertices passed to geometry shader
outTypeType of vertices created by geometry shader
verticesOutMaximal number of vertices created by geometry shader. If 0, maximal number supported is assumed.
callbackPointer 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.
baseMaterialBase material which renderstates will be used to shade the material.
userDataa 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.
shaderLanga type of shading language used in current shader.
+
+
+
Returns:
Number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured, e.g. if a shader program could not be compiled or a compile target is not reachable. The error strings are then printed to the error log and can be catched with a custom event receiver.
+ +

Referenced by addHighLevelShaderMaterial().

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterial (const c8vertexShaderProgram,
const c8vertexShaderEntryPointName = "main",
E_VERTEX_SHADER_TYPE vsCompileTarget = EVST_VS_1_1,
const c8pixelShaderProgram = 0,
const c8pixelShaderEntryPointName = "main",
E_PIXEL_SHADER_TYPE psCompileTarget = EPST_PS_1_1,
IShaderConstantSetCallBackcallback = 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 c8vertexShaderProgram,
const c8pixelShaderProgram = 0,
IShaderConstantSetCallBackcallback = 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 c8vertexShaderProgram,
const c8pixelShaderProgram = 0,
const c8geometryShaderProgram = 0,
scene::E_PRIMITIVE_TYPE inType = scene::EPT_TRIANGLES,
scene::E_PRIMITIVE_TYPE outType = scene::EPT_TRIANGLE_STRIP,
u32 verticesOut = 0,
IShaderConstantSetCallBackcallback = 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::pathvertexShaderProgramFileName,
const c8vertexShaderEntryPointName,
E_VERTEX_SHADER_TYPE vsCompileTarget,
const io::pathpixelShaderProgramFileName,
const c8pixelShaderEntryPointName,
E_PIXEL_SHADER_TYPE psCompileTarget,
const io::pathgeometryShaderProgramFileName,
const c8geometryShaderEntryPointName = "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,
IShaderConstantSetCallBackcallback = 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.

+
Parameters:
+ + + + + + + + + + + + + + + + + +
vertexShaderProgramFileNameText file containing the source of the vertex shader program. Set to empty string if no vertex shader shall be created.
vertexShaderEntryPointNameName of the entry function of the vertexShaderProgram (p.e. "main")
vsCompileTargetVertex shader version the high level shader shall be compiled to.
pixelShaderProgramFileNameText file containing the source of the pixel shader program. Set to empty string if no pixel shader shall be created.
pixelShaderEntryPointNameEntry name of the function of the pixelShaderProgram (p.e. "main")
psCompileTargetPixel shader version the high level shader shall be compiled to.
geometryShaderProgramFileNameName of the source of the geometry shader program. Set to empty string if no geometry shader shall be created.
geometryShaderEntryPointNameEntry name of the function of the geometryShaderProgram (p.e. "main")
gsCompileTargetGeometry shader version the high level shader shall be compiled to.
inTypeType of vertices passed to geometry shader
outTypeType of vertices created by geometry shader
verticesOutMaximal number of vertices created by geometry shader. If 0, maximal number supported is assumed.
callbackPointer 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.
baseMaterialBase material which renderstates will be used to shade the material.
userDataa 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.
shaderLanga type of shading language used in current shader.
+
+
+
Returns:
Number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured, e.g. if a shader program could not be compiled or a compile target is not reachable. The error strings are then printed to the error log and can be catched with a custom event receiver.
+ +

Referenced by addHighLevelShaderMaterialFromFiles().

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles (const io::pathvertexShaderProgramFileName,
const c8vertexShaderEntryPointName = "main",
E_VERTEX_SHADER_TYPE vsCompileTarget = EVST_VS_1_1,
const io::pathpixelShaderProgramFileName = "",
const c8pixelShaderEntryPointName = "main",
E_PIXEL_SHADER_TYPE psCompileTarget = EPST_PS_1_1,
IShaderConstantSetCallBackcallback = 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::pathvertexShaderProgramFileName,
const io::pathpixelShaderProgramFileName = "",
IShaderConstantSetCallBackcallback = 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::pathvertexShaderProgramFileName,
const io::pathpixelShaderProgramFileName = "",
const io::pathgeometryShaderProgramFileName = "",
scene::E_PRIMITIVE_TYPE inType = scene::EPT_TRIANGLES,
scene::E_PRIMITIVE_TYPE outType = scene::EPT_TRIANGLE_STRIP,
u32 verticesOut = 0,
IShaderConstantSetCallBackcallback = 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::IReadFilevertexShaderProgram,
const c8vertexShaderEntryPointName,
E_VERTEX_SHADER_TYPE vsCompileTarget,
io::IReadFilepixelShaderProgram,
const c8pixelShaderEntryPointName,
E_PIXEL_SHADER_TYPE psCompileTarget,
io::IReadFilegeometryShaderProgram,
const c8geometryShaderEntryPointName = "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,
IShaderConstantSetCallBackcallback = 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.

+
Parameters:
+ + + + + + + + + + + + + + + + + +
vertexShaderProgramText file handle containing the source of the vertex shader program. Set to 0 if no vertex shader shall be created.
vertexShaderEntryPointNameName of the entry function of the vertexShaderProgram
vsCompileTargetVertex shader version the high level shader shall be compiled to.
pixelShaderProgramText file handle containing the source of the pixel shader program. Set to 0 if no pixel shader shall be created.
pixelShaderEntryPointNameEntry name of the function of the pixelShaderProgram (p.e. "main")
psCompileTargetPixel shader version the high level shader shall be compiled to.
geometryShaderProgramText file handle containing the source of the geometry shader program. Set to 0 if no geometry shader shall be created.
geometryShaderEntryPointNameEntry name of the function of the geometryShaderProgram (p.e. "main")
gsCompileTargetGeometry shader version the high level shader shall be compiled to.
inTypeType of vertices passed to geometry shader
outTypeType of vertices created by geometry shader
verticesOutMaximal number of vertices created by geometry shader. If 0, maximal number supported is assumed.
callbackPointer 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.
baseMaterialBase material which renderstates will be used to shade the material.
userDataa 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.
shaderLanga type of shading language used in current shader.
+
+
+
Returns:
Number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured, e.g. if a shader program could not be compiled or a compile target is not reachable. The error strings are then printed to the error log and can be catched with a custom event receiver.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
s32 irr::video::IGPUProgrammingServices::addHighLevelShaderMaterialFromFiles (io::IReadFilevertexShaderProgram,
const c8vertexShaderEntryPointName = "main",
E_VERTEX_SHADER_TYPE vsCompileTarget = EVST_VS_1_1,
io::IReadFilepixelShaderProgram = 0,
const c8pixelShaderEntryPointName = "main",
E_PIXEL_SHADER_TYPE psCompileTarget = EPST_PS_1_1,
IShaderConstantSetCallBackcallback = 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 c8vertexShaderProgram = 0,
const c8pixelShaderProgram = 0,
IShaderConstantSetCallBackcallback = 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.

+
Parameters:
+ + +
vertexShaderProgramString 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.

+
Parameters:
+ + + + + +
pixelShaderProgramString containing the source of the pixel shader program. This can be 0 if you don't want to use a pixel shader.
callbackPointer 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.
baseMaterialBase material which renderstates will be used to shade the material.
userDataa 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.
+
+
+
Returns:
Returns the number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured. -1 is returned for example if a vertex or pixel shader program could not be compiled, the error strings are then printed out into the error log, and can be catched with a custom event receiver.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
virtual s32 irr::video::IGPUProgrammingServices::addShaderMaterialFromFiles (io::IReadFilevertexShaderProgram,
io::IReadFilepixelShaderProgram,
IShaderConstantSetCallBackcallback = 0,
E_MATERIAL_TYPE baseMaterial = video::EMT_SOLID,
s32 userData = 0 
) [pure virtual]
+
+
+ +

Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.

+
Parameters:
+ + + + + + +
vertexShaderProgramText file containing the source of the vertex shader program. Set to 0 if no shader shall be created.
pixelShaderProgramText file containing the source of the pixel shader program. Set to 0 if no shader shall be created.
callbackPointer to an IShaderConstantSetCallback object to which the OnSetConstants function is called.
baseMaterialbaseMaterial
userDataa 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.
+
+
+
Returns:
Returns the number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured. -1 is returned for example if a vertex or pixel shader program could not be compiled, the error strings are then printed out into the error log, and can be catched with a custom event receiver.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
virtual s32 irr::video::IGPUProgrammingServices::addShaderMaterialFromFiles (const io::pathvertexShaderProgramFileName,
const io::pathpixelShaderProgramFileName,
IShaderConstantSetCallBackcallback = 0,
E_MATERIAL_TYPE baseMaterial = video::EMT_SOLID,
s32 userData = 0 
) [pure virtual]
+
+
+ +

Like IGPUProgrammingServices::addShaderMaterial(), but loads from files.

+
Parameters:
+ + + + + + +
vertexShaderProgramFileNameText file name containing the source of the vertex shader program. Set to 0 if no shader shall be created.
pixelShaderProgramFileNameText file name containing the source of the pixel shader program. Set to 0 if no shader shall be created.
callbackPointer to an IShaderConstantSetCallback object on which the OnSetConstants function is called.
baseMaterialbaseMaterial
userDataa 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.
+
+
+
Returns:
Returns the number of the material type which can be set in SMaterial::MaterialType to use the renderer. -1 is returned if an error occured. -1 is returned for example if a vertex or pixel shader program could not be compiled, the error strings are then printed out into the error log, and can be catched with a custom event receiver.
+ +
+
+
The documentation for this class was generated from the following file: +
+
+ + + + + -- cgit v1.1