#pragma once #include "BsCorePrerequisites.h" #include "BsGpuParam.h" #include "BsCoreObject.h" #include "BsIResourceListener.h" #include "BsVectorNI.h" #include "BsMatrixNxM.h" namespace BansheeEngine { /** @addtogroup Implementation * @{ */ /** @cond INTERNAL */ /** Stores information needed for binding a texture to the pipeline. */ struct BoundTextureInfo { BoundTextureInfo() :isLoadStore(false) { } bool isLoadStore; TextureSurface surface; }; /** Helper structure whose specializations convert an engine data type into a GPU program data parameter type. */ template struct TGpuDataParamInfo { }; template<> struct TGpuDataParamInfo < float > { enum { TypeId = GPDT_FLOAT1 }; }; template<> struct TGpuDataParamInfo < Vector2 > { enum { TypeId = GPDT_FLOAT2 }; }; template<> struct TGpuDataParamInfo < Vector3 > { enum { TypeId = GPDT_FLOAT3 }; }; template<> struct TGpuDataParamInfo < Vector4 > { enum { TypeId = GPDT_FLOAT4 }; }; template<> struct TGpuDataParamInfo < int > { enum { TypeId = GPDT_INT1 }; }; template<> struct TGpuDataParamInfo < Vector2I > { enum { TypeId = GPDT_INT2 }; }; template<> struct TGpuDataParamInfo < Vector3I > { enum { TypeId = GPDT_INT3 }; }; template<> struct TGpuDataParamInfo < Vector4I > { enum { TypeId = GPDT_INT4 }; }; template<> struct TGpuDataParamInfo < Matrix2 > { enum { TypeId = GPDT_MATRIX_2X2 }; }; template<> struct TGpuDataParamInfo < Matrix2x3 > { enum { TypeId = GPDT_MATRIX_2X3 }; }; template<> struct TGpuDataParamInfo < Matrix2x4 > { enum { TypeId = GPDT_MATRIX_2X3 }; }; template<> struct TGpuDataParamInfo < Matrix3 > { enum { TypeId = GPDT_MATRIX_3X3 }; }; template<> struct TGpuDataParamInfo < Matrix3x2 > { enum { TypeId = GPDT_MATRIX_3X2 }; }; template<> struct TGpuDataParamInfo < Matrix3x4 > { enum { TypeId = GPDT_MATRIX_3X4 }; }; template<> struct TGpuDataParamInfo < Matrix4 > { enum { TypeId = GPDT_MATRIX_4X4 }; }; template<> struct TGpuDataParamInfo < Matrix4x2 > { enum { TypeId = GPDT_MATRIX_4X2 }; }; template<> struct TGpuDataParamInfo < Matrix4x3 > { enum { TypeId = GPDT_MATRIX_4X3 }; }; template<> struct TGpuDataParamInfo < Color > { enum { TypeId = GPDT_COLOR }; }; /** @endcond */ /** Contains functionality common for both sim and core thread version of GpuParams. */ class BS_CORE_EXPORT GpuParamsBase { public: /** * Creates new GpuParams object using the specified parameter descriptions. * * @param[in] paramDesc Reference to parameter descriptions that will be used for finding needed * parameters. * @param[in] transposeMatrices If true the stored matrices will be transposed before submitted to the GPU * (some APIs require different matrix layout). * * @note You normally do not want to call this manually. Instead use GpuProgram::createParameters. */ GpuParamsBase(const GpuParamDescPtr& paramDesc, bool transposeMatrices); virtual ~GpuParamsBase(); // Note: Disallow copy/assign because it would require some care when copying (copy internal data shared_ptr and // all the internal buffers too). Trivial to implement but not needed at this time. Un-delete and implement if necessary. GpuParamsBase(const GpuParamsBase& other) = delete; GpuParamsBase& operator=(const GpuParamsBase& rhs) = delete; /** Returns a description of all stored parameters. */ const GpuParamDesc& getParamDesc() const { return *mParamDesc; } /** * Returns the size of a data parameter with the specified name, in bytes. Returns 0 if such parameter doesn't exist. */ UINT32 getDataParamSize(const String& name) const; /** Checks if parameter with the specified name exists. */ bool hasParam(const String& name) const; /** Checks if texture parameter with the specified name exists. */ bool hasTexture(const String& name) const; /** Checks if sampler state parameter with the specified name exists. */ bool hasSamplerState(const String& name) const; /** Checks if a parameter block with the specified name exists. */ bool hasParamBlock(const String& name) const; /** * Checks is the texture at the specified slot to be bound as random load/store texture instead of a normal sampled * texture. */ bool isLoadStoreTexture(UINT32 slot) const; /** Changes the type of the texture at the specified slot. */ void setIsLoadStoreTexture(UINT32 slot, bool isLoadStore); /** Returns information that determines which texture surfaces to bind as load/store parameters. */ const TextureSurface& getLoadStoreSurface(UINT32 slot) const; /** Sets information that determines which texture surfaces to bind as load/store parameters. */ void setLoadStoreSurface(UINT32 slot, const TextureSurface& surface) const; /** Checks whether matrices should be transformed before being written to the parameter buffer. */ bool getTransposeMatrices() const { return mTransposeMatrices; } /** * @copydoc CoreObject::markCoreDirty * * @note Internal method. */ virtual void _markCoreDirty() { } /** * @copydoc IResourceListener::markResourcesDirty * * @note Internal method. */ virtual void _markResourcesDirty() { } protected: /** Gets a descriptor for a data parameter with the specified name. */ GpuParamDataDesc* getParamDesc(const String& name) const; GpuParamDescPtr mParamDesc; UINT32 mNumParamBlocks; UINT32 mNumTextures; UINT32 mNumSamplerStates; BoundTextureInfo* mTextureInfo; bool mTransposeMatrices; }; /** Templated version of GpuParams that contains functionality for both sim and core thread versions of stored data. */ template class BS_CORE_EXPORT TGpuParams : public GpuParamsBase { public: template struct TTypes { }; template<> struct TTypes < false > { typedef GpuParams GpuParamsType; typedef HTexture TextureType; typedef SamplerStatePtr SamplerType; typedef SPtr ParamsBufferType; }; template<> struct TTypes < true > { typedef GpuParamsCore GpuParamsType; typedef SPtr TextureType; typedef SPtr SamplerType; typedef SPtr ParamsBufferType; }; typedef typename TTypes::GpuParamsType GpuParamsType; typedef typename TTypes::TextureType TextureType; typedef typename TTypes::SamplerType SamplerType; typedef typename TTypes::ParamsBufferType ParamsBufferType; /** @copydoc GpuParamsBase::GpuParamsBase(const GpuParamDescPtr&, bool) */ TGpuParams(const GpuParamDescPtr& paramDesc, bool transposeMatrices); virtual ~TGpuParams(); /** * Binds a new parameter buffer to the specified slot. Any following parameter reads or writes that are referencing * that buffer slot will use the new buffer. * * @note * This is useful if you want to share a parameter buffer among multiple GPU programs. You would only set the * values once and then share the buffer among all other GpuParams. * @note * It is up to the caller to guarantee the provided buffer matches parameter block descriptor for this slot. */ void setParamBlockBuffer(UINT32 slot, const ParamsBufferType& paramBlockBuffer); /** * Replaces the parameter buffer with the specified name. Any following parameter reads or writes that are * referencing that buffer will use the new buffer. * * @note * This is useful if you want to share a parameter buffer among multiple GPU programs. You would only set the * values once and then share the buffer among all other GpuParams. * @note * It is up to the caller to guarantee the provided buffer matches parameter block descriptor for this slot. */ void setParamBlockBuffer(const String& name, const ParamsBufferType& paramBlockBuffer); /** * Returns a handle for the parameter with the specified name. Handle may then be stored and used for quickly * setting or retrieving values to/from that parameter. * * Throws exception if parameter with that name and type doesn't exist. * * Parameter handles will be invalidated when their parent GpuParams object changes. */ template void getParam(const String& name, TGpuDataParam& output) const; /** @copydoc getParam(const String&, TGpuDataParam&) */ void getStructParam(const String& name, TGpuParamStruct& output) const; /** * @copydoc getParam(const String&, TGpuDataParam&) */ void getTextureParam(const String& name, TGpuParamTexture& output) const; /** @copydoc getParam(const String&, TGpuDataParam&) */ void getLoadStoreTextureParam(const String& name, TGpuParamLoadStoreTexture& output) const; /** @copydoc getParam(const String&, TGpuDataParam&) */ void getSamplerStateParam(const String& name, TGpuParamSampState& output) const; /** Gets a parameter block buffer from the specified slot. */ ParamsBufferType getParamBlockBuffer(UINT32 slot) const; /** Gets a texture bound to the specified slot. */ TextureType getTexture(UINT32 slot); /** Gets a sampler state bound to the specified slot. */ SamplerType getSamplerState(UINT32 slot); /** Sets a texture at the specified slot. */ void setTexture(UINT32 slot, const TextureType& texture); /** Sets a sampler state at the specified slot. */ void setSamplerState(UINT32 slot, const SamplerType& sampler); protected: /** @copydoc CoreObject::getThisPtr */ virtual SPtr _getThisPtr() const = 0; ParamsBufferType* mParamBlockBuffers; TextureType* mTextures; SamplerType* mSamplerStates; }; /** @} */ /** @addtogroup RenderAPI * @{ */ /** @cond INTERNAL */ /** * @brief Core thread version of GpuParams. * * @note Core thread only. */ class BS_CORE_EXPORT GpuParamsCore : public CoreObjectCore, public TGpuParams { public: ~GpuParamsCore() { } /** Uploads all CPU stored parameter buffer data to the GPU buffers. */ void updateHardwareBuffers(); /** @copydoc GpuParamsBase::GpuParamsBase */ static SPtr create(const GpuParamDescPtr& paramDesc, bool transposeMatrices); protected: friend class GpuParams; /** @copydoc GpuParamsBase::GpuParamsBase */ GpuParamsCore(const GpuParamDescPtr& paramDesc, bool transposeMatrices); /** @copydoc CoreObject::getThisPtr */ SPtr _getThisPtr() const override; /** @copydoc CoreObjectCore::syncToCore */ void syncToCore(const CoreSyncData& data) override; }; /** @endcond */ /** * Contains descriptions for all parameters in a GPU program and also allows you to write and read those parameters. * All parameter values are stored internally on the CPU, and are only submitted to the GPU once the parameters are * bound to the pipeline. * * @note Sim thread only. */ class BS_CORE_EXPORT GpuParams : public CoreObject, public TGpuParams, public IResourceListener { public: ~GpuParams() { } /** * @copydoc CoreObject::markCoreDirty * * @note Internal method. */ void _markCoreDirty() override; /** * @copydoc IResourceListener::markResourcesDirty * * @note Internal method. */ void _markResourcesDirty() override; /** Retrieves a core implementation of a mesh usable only from the core thread. */ SPtr getCore() const; /** @copydoc GpuParamsBase::GpuParamsBase */ static SPtr create(const GpuParamDescPtr& paramDesc, bool transposeMatrices); /** Contains a lookup table for sizes of all data parameters. Sizes are in bytes. */ const static GpuDataParamInfos PARAM_SIZES; protected: /** @copydoc GpuParamsBase::GpuParamsBase */ GpuParams(const GpuParamDescPtr& paramDesc, bool transposeMatrices); /** @copydoc CoreObject::getThisPtr */ SPtr _getThisPtr() const override; /** @copydoc CoreObject::createCore */ SPtr createCore() const override; /** @copydoc CoreObject::syncToCore */ CoreSyncData syncToCore(FrameAlloc* allocator) override; /** @copydoc IResourceListener::getListenerResources */ void getListenerResources(Vector& resources) override; /** @copydoc IResourceListener::notifyResourceLoaded */ void notifyResourceLoaded(const HResource& resource) override { markCoreDirty(); } /** @copydoc IResourceListener::notifyResourceChanged */ void notifyResourceChanged(const HResource& resource) override { markCoreDirty(); } }; /** @} */ }