diff options
| author | cutealien <cutealien@dfc29bdd-3216-0410-991c-e03cc46cb475> | 2020-01-03 19:05:16 +0000 |
|---|---|---|
| committer | cutealien <cutealien@dfc29bdd-3216-0410-991c-e03cc46cb475> | 2020-01-03 19:05:16 +0000 |
| commit | 2ae2a551a6290f46734307bbfdafea4b1a2cf2ba (patch) | |
| tree | ba2f0b468640e44899fed3df2d4cc58795f4a003 /include/IShaderConstantSetCallBack.h | |
| download | irrlicht-2ae2a551a6290f46734307bbfdafea4b1a2cf2ba.tar.xz | |
Merging r5975 through r6036 from trunk to ogl-es branch.
GLES drivers adapted, but only did make compile-tests.
git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/branches/ogl-es@6038 dfc29bdd-3216-0410-991c-e03cc46cb475
Diffstat (limited to 'include/IShaderConstantSetCallBack.h')
| -rw-r--r-- | include/IShaderConstantSetCallBack.h | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/include/IShaderConstantSetCallBack.h b/include/IShaderConstantSetCallBack.h new file mode 100644 index 0000000..fdf9e9a --- /dev/null +++ b/include/IShaderConstantSetCallBack.h @@ -0,0 +1,85 @@ +// Copyright (C) 2002-2012 Nikolaus Gebhardt
+// This file is part of the "Irrlicht Engine".
+// For conditions of distribution and use, see copyright notice in irrlicht.h
+
+#ifndef __I_SHADER_CONSTANT_SET_CALLBACT_H_INCLUDED__
+#define __I_SHADER_CONSTANT_SET_CALLBACT_H_INCLUDED__
+
+#include "IReferenceCounted.h"
+
+namespace irr
+{
+namespace video
+{
+ class IMaterialRendererServices;
+ class SMaterial;
+
+//! Interface making it possible to set constants for gpu programs every frame.
+/** Implement this interface in an own class and pass a pointer to it to one of
+the methods in IGPUProgrammingServices when creating a shader. The
+OnSetConstants method will be called every frame now. */
+class IShaderConstantSetCallBack : public virtual IReferenceCounted
+{
+public:
+
+ //! Called to let the callBack know the used material (optional method)
+ /**
+ \code
+ class MyCallBack : public IShaderConstantSetCallBack
+ {
+ const video::SMaterial *UsedMaterial;
+
+ OnSetMaterial(const video::SMaterial& material)
+ {
+ UsedMaterial=&material;
+ }
+
+ OnSetConstants(IMaterialRendererServices* services, s32 userData)
+ {
+ services->setVertexShaderConstant("myColor", reinterpret_cast<f32*>(&UsedMaterial->color), 4);
+ }
+ }
+ \endcode
+ */
+ virtual void OnSetMaterial(const SMaterial& material) { }
+
+ //! Called by the engine when the vertex and/or pixel shader constants for an material renderer should be set.
+ /**
+ Implement the IShaderConstantSetCallBack in an own class and implement your own
+ OnSetConstants method using the given IMaterialRendererServices interface.
+ Pass a pointer to this class to one of the methods in IGPUProgrammingServices
+ when creating a shader. The OnSetConstants method will now be called every time
+ before geometry is being drawn using your shader material. A sample implementation
+ would look like this:
+ \code
+ virtual void OnSetConstants(video::IMaterialRendererServices* services, s32 userData)
+ {
+ video::IVideoDriver* driver = services->getVideoDriver();
+
+ // set clip matrix at register 4
+ core::matrix4 worldViewProj(driver->getTransform(video::ETS_PROJECTION));
+ worldViewProj *= driver->getTransform(video::ETS_VIEW);
+ worldViewProj *= driver->getTransform(video::ETS_WORLD);
+ services->setVertexShaderConstant(&worldViewProj.M[0], 4, 4);
+ // for high level shading languages, this would be another solution:
+ //services->setVertexShaderConstant("mWorldViewProj", worldViewProj.M, 16);
+
+ // set some light color at register 9
+ video::SColorf col(0.0f,1.0f,1.0f,0.0f);
+ services->setVertexShaderConstant(reinterpret_cast<const f32*>(&col), 9, 1);
+ // for high level shading languages, this would be another solution:
+ //services->setVertexShaderConstant("myColor", reinterpret_cast<f32*>(&col), 4);
+ }
+ \endcode
+ \param services: Pointer to an interface providing methods to set the constants for the shader.
+ \param userData: Userdata int which can be specified when creating the shader.
+ */
+ virtual void OnSetConstants(IMaterialRendererServices* services, s32 userData) = 0;
+};
+
+
+} // end namespace video
+} // end namespace irr
+
+#endif
+
|