EIC code displayed by LXR master/​include/​opencascade/​Graphic3d_ShaderProgram.hxx	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2026-10-02 09:12:30

 // Created on: 2013-09-20
 // Created by: Denis BOGOLEPOV
 // Copyright (c) 2013-2014 OPEN CASCADE SAS
 //
 // This file is part of Open CASCADE Technology software library.
 //
 // This library is free software; you can redistribute it and/or modify it under
 // the terms of the GNU Lesser General Public License version 2.1 as published
 // by the Free Software Foundation, with special exception defined in the file
 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
 // distribution for complete text of the license and disclaimer of any warranty.
 //
 // Alternatively, this file may be used under the terms of Open CASCADE
 // commercial license or contractual agreement.
 
 #ifndef _Graphic3d_ShaderProgram_HeaderFile
 #define _Graphic3d_ShaderProgram_HeaderFile
 
 #include <Graphic3d_RenderTransparentMethod.hxx>
 #include <Graphic3d_ShaderAttribute.hxx>
 #include <Graphic3d_ShaderObject.hxx>
 #include <Graphic3d_ShaderVariable.hxx>
 #include <Graphic3d_TextureParams.hxx>
 #include <NCollection_Sequence.hxx>
 
 //! List of shader objects.
 
 //! List of custom uniform shader variables.
 
 //! List of custom vertex shader attributes
 
 //! This class is responsible for managing shader programs.
 class Graphic3d_ShaderProgram : public Standard_Transient
 {
   DEFINE_STANDARD_RTTIEXT(Graphic3d_ShaderProgram, Standard_Transient)
 public:
   //! Default value of THE_MAX_LIGHTS macros within GLSL program (see Declarations.glsl).
   static const int THE_MAX_LIGHTS_DEFAULT = 8;
 
   //! Default value of THE_MAX_CLIP_PLANES macros within GLSL program (see Declarations.glsl).
   static const int THE_MAX_CLIP_PLANES_DEFAULT = 8;
 
   //! Default value of THE_NB_FRAG_OUTPUTS macros within GLSL program (see Declarations.glsl).
   static const int THE_NB_FRAG_OUTPUTS = 1;
 
 public:
   //! Creates new empty program object.
   Standard_EXPORT Graphic3d_ShaderProgram();
 
   //! Releases resources of program object.
   Standard_EXPORT ~Graphic3d_ShaderProgram() override;
 
   //! Checks if the program object is valid or not.
   Standard_EXPORT virtual bool IsDone() const;
 
   //! Returns unique ID used to manage resource in graphic driver.
   const TCollection_AsciiString& GetId() const { return myID; }
 
   //! Sets unique ID used to manage resource in graphic driver.
   //! WARNING! Graphic3d_ShaderProgram constructor generates a unique id for proper resource
   //! management; however if application overrides it, it is responsibility of application to avoid
   //! name collisions.
   void SetId(const TCollection_AsciiString& theId) { myID = theId; }
 
   //! Returns GLSL header (version code and extensions).
   const TCollection_AsciiString& Header() const { return myHeader; }
 
   //! Setup GLSL header containing language version code and used extensions.
   //! Will be prepended to the very beginning of the source code.
   //! Example:
   //! @code
   //!   #version 300 es
   //!   #extension GL_ARB_bindless_texture : require
   //! @endcode
   void SetHeader(const TCollection_AsciiString& theHeader) { myHeader = theHeader; }
 
   //! Append line to GLSL header.
   void AppendToHeader(const TCollection_AsciiString& theHeaderLine)
   {
     if (!myHeader.IsEmpty())
     {
       myHeader += "\n";
     }
     myHeader += theHeaderLine;
   }
 
   //! Return the length of array of light sources (THE_MAX_LIGHTS),
   //! to be used for initialization occLightSources.
   //! Default value is THE_MAX_LIGHTS_DEFAULT.
   int NbLightsMax() const { return myNbLightsMax; }
 
   //! Specify the length of array of light sources (THE_MAX_LIGHTS).
   void SetNbLightsMax(int theNbLights) { myNbLightsMax = theNbLights; }
 
   //! Return the length of array of shadow maps (THE_NB_SHADOWMAPS); 0 by default.
   int NbShadowMaps() const { return myNbShadowMaps; }
 
   //! Specify the length of array of shadow maps (THE_NB_SHADOWMAPS).
   void SetNbShadowMaps(int theNbMaps) { myNbShadowMaps = theNbMaps; }
 
   //! Return the length of array of clipping planes (THE_MAX_CLIP_PLANES),
   //! to be used for initialization occClipPlaneEquations.
   //! Default value is THE_MAX_CLIP_PLANES_DEFAULT.
   int NbClipPlanesMax() const { return myNbClipPlanesMax; }
 
   //! Specify the length of array of clipping planes (THE_MAX_CLIP_PLANES).
   void SetNbClipPlanesMax(int theNbPlanes) { myNbClipPlanesMax = theNbPlanes; }
 
   //! Attaches shader object to the program object.
   Standard_EXPORT bool AttachShader(const occ::handle<Graphic3d_ShaderObject>& theShader);
 
   //! Detaches shader object from the program object.
   Standard_EXPORT bool DetachShader(const occ::handle<Graphic3d_ShaderObject>& theShader);
 
   //! Returns list of attached shader objects.
   const NCollection_Sequence<occ::handle<Graphic3d_ShaderObject>>& ShaderObjects() const
   {
     return myShaderObjects;
   }
 
   //! The list of currently pushed but not applied custom uniform variables.
   //! This list is automatically cleared after applying to GLSL program.
   const NCollection_Sequence<occ::handle<Graphic3d_ShaderVariable>>& Variables() const
   {
     return myVariables;
   }
 
   //! Return the list of custom vertex attributes.
   const NCollection_Sequence<occ::handle<Graphic3d_ShaderAttribute>>& VertexAttributes() const
   {
     return myAttributes;
   }
 
   //! Assign the list of custom vertex attributes.
   //! Should be done before GLSL program initialization.
   Standard_EXPORT void SetVertexAttributes(
     const NCollection_Sequence<occ::handle<Graphic3d_ShaderAttribute>>& theAttributes);
 
   //! Returns the number (1+) of Fragment Shader outputs to be written to
   //! (more than 1 can be in case of multiple draw buffers); 1 by default.
   int NbFragmentOutputs() const { return myNbFragOutputs; }
 
   //! Sets the number of Fragment Shader outputs to be written to.
   //! Should be done before GLSL program initialization.
   void SetNbFragmentOutputs(const int theNbOutputs) { myNbFragOutputs = theNbOutputs; }
 
   //! Return true if Fragment Shader should perform alpha test; FALSE by default.
   bool HasAlphaTest() const { return myHasAlphaTest; }
 
   //! Set if Fragment Shader should perform alpha test.
   //! Note that this flag is designed for usage with - custom shader program may discard fragment
   //! regardless this flag.
   void SetAlphaTest(bool theAlphaTest) { myHasAlphaTest = theAlphaTest; }
 
   //! Return TRUE if standard program header should define default texture sampler occSampler0; TRUE
   //! by default for compatibility.
   bool HasDefaultSampler() const { return myHasDefSampler; }
 
   //! Set if standard program header should define default texture sampler occSampler0.
   void SetDefaultSampler(bool theHasDefSampler) { myHasDefSampler = theHasDefSampler; }
 
   //! Return if Fragment Shader color should output to OIT buffers; OFF by default.
   Graphic3d_RenderTransparentMethod OitOutput() const { return myOitOutput; }
 
   //! Set if Fragment Shader color should output to OIT buffers.
   //! Note that weighted OIT also requires at least 2 Fragment Outputs (color + coverage),
   //! and Depth Peeling requires at least 3 Fragment Outputs (depth + front color + back color),
   void SetOitOutput(Graphic3d_RenderTransparentMethod theOutput) { myOitOutput = theOutput; }
 
   //! Return TRUE if standard program header should define functions and variables used in PBR
   //! pipeline. FALSE by default.
   bool IsPBR() const { return myIsPBR; }
 
   //! Sets whether standard program header should define functions and variables used in PBR
   //! pipeline.
   void SetPBR(bool theIsPBR) { myIsPBR = theIsPBR; }
 
   //! Return texture units declared within the program, @sa Graphic3d_TextureSetBits.
   int TextureSetBits() const { return myTextureSetBits; }
 
   //! Set texture units declared within the program.
   void SetTextureSetBits(int theBits) { myTextureSetBits = theBits; }
 
   //! Pushes custom uniform variable to the program.
   //! The list of pushed variables is automatically cleared after applying to GLSL program.
   //! Thus after program recreation even unchanged uniforms should be pushed anew.
   template <class T>
   bool PushVariable(const TCollection_AsciiString& theName, const T& theValue);
 
   //! Removes all custom uniform variables from the program.
   Standard_EXPORT void ClearVariables();
 
   //! Pushes float uniform.
   bool PushVariableFloat(const TCollection_AsciiString& theName, const float theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec2 uniform.
   bool PushVariableVec2(const TCollection_AsciiString& theName,
                         const NCollection_Vec2<float>& theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec3 uniform.
   bool PushVariableVec3(const TCollection_AsciiString& theName,
                         const NCollection_Vec3<float>& theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec4 uniform.
   bool PushVariableVec4(const TCollection_AsciiString& theName,
                         const NCollection_Vec4<float>& theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes int uniform.
   bool PushVariableInt(const TCollection_AsciiString& theName, const int theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec2i uniform.
   bool PushVariableVec2i(const TCollection_AsciiString& theName,
                          const NCollection_Vec2<int>&   theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec3i uniform.
   bool PushVariableVec3i(const TCollection_AsciiString& theName,
                          const NCollection_Vec3<int>&   theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes vec4i uniform.
   bool PushVariableVec4i(const TCollection_AsciiString& theName,
                          const NCollection_Vec4<int>&   theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes mat3 uniform.
   bool PushVariableMat3(const TCollection_AsciiString& theName,
                         const NCollection_Mat3<float>& theValue)
   {
     return PushVariable(theName, theValue);
   }
 
   //! Pushes mat4 uniform.
   bool PushVariableMat4(const TCollection_AsciiString& theName,
                         const NCollection_Mat4<float>& theValue)
   {
     return PushVariable(theName, theValue);
   }
 
 public:
   //! The path to GLSL programs determined from CSF_ShadersDirectory or CASROOT environment
   //! variables.
   //! @return the root folder with default GLSL programs.
   Standard_EXPORT static const TCollection_AsciiString& ShadersFolder();
 
 private:
   TCollection_AsciiString myID; //!< the unique identifier of program object
   NCollection_Sequence<occ::handle<Graphic3d_ShaderObject>>
     myShaderObjects; //!< the list of attached shader objects
   NCollection_Sequence<occ::handle<Graphic3d_ShaderVariable>>
     myVariables; //!< the list of custom uniform variables
   NCollection_Sequence<occ::handle<Graphic3d_ShaderAttribute>>
     myAttributes; //!< the list of custom vertex attributes
   // clang-format off
   TCollection_AsciiString       myHeader;        //!< GLSL header with version code and used extensions
   int              myNbLightsMax;   //!< length of array of light sources (THE_MAX_LIGHTS)
   int              myNbShadowMaps;  //!< length of array of shadow maps (THE_NB_SHADOWMAPS)
   int              myNbClipPlanesMax; //!< length of array of clipping planes (THE_MAX_CLIP_PLANES)
   int              myNbFragOutputs; //!< length of array of Fragment Shader outputs (THE_NB_FRAG_OUTPUTS)
   int              myTextureSetBits;//!< texture units declared within the program, @sa Graphic3d_TextureSetBits
   Graphic3d_RenderTransparentMethod myOitOutput; //!< flag indicating that Fragment Shader includes OIT outputs
   bool              myHasDefSampler; //!< flag indicating that program defines default texture sampler occSampler0
   bool              myHasAlphaTest;       //!< flag indicating that Fragment Shader performs alpha test
   bool              myIsPBR;         //!< flag indicating that program defines functions and variables used in PBR pipeline
   // clang-format on
 };
 
 // =======================================================================
 // function : PushVariable
 // purpose  : Pushes custom uniform variable to the program
 // =======================================================================
 template <class T>
 inline bool Graphic3d_ShaderProgram::PushVariable(const TCollection_AsciiString& theName,
                                                   const T&                       theValue)
 {
   occ::handle<Graphic3d_ShaderVariable> aVariable =
     Graphic3d_ShaderVariable::Create(theName, theValue);
   if (aVariable.IsNull() || !aVariable->IsDone())
   {
     return false;
   }
 
   myVariables.Append(aVariable);
   return true;
 }
 
 #endif

This page was automatically generated by the 2.3.7 LXR engine. The LXR team