domeLightComputations.h

//
// Copyright 2019 Pixar
//
// Licensed under the terms set forth in the LICENSE.txt file available at
// https://openusd.org/license.
//
#ifndef PXR_IMAGING_HD_ST_DOME_LIGHT_COMPUTATIONS_H
#define PXR_IMAGING_HD_ST_DOME_LIGHT_COMPUTATIONS_H
 
#include "pxr/pxr.h"
#include "pxr/imaging/hdSt/api.h"
#include "pxr/imaging/hdSt/computation.h"
 
#include "pxr/base/gf/vec3i.h"
#include "pxr/base/tf/token.h"
 
PXR_NAMESPACE_OPEN_SCOPE
 
 
using HdStSimpleLightingShaderPtr =
    std::weak_ptr<class HdStSimpleLightingShader>;
struct HgiTextureDesc;
 
class HdSt_DomeLightComputationGPU : public HdStComputation
{
public:
    HDST_API
    HdSt_DomeLightComputationGPU(
        // Name of computation shader to use, also used as texture name.
        const TfToken & shaderToken,
        // Whether to use the dome light cubemap texture or the dome light
        // latlong texture as the input for the computation.
        bool useCubemapAsSourceTexture,
        // Lighting shader for accessing any referenced textures.
        HdStSimpleLightingShaderPtr const &lightingShader,
        // Dimension of the dome light cubemap texture. NOTE: this is only used  
        // when the latlong texture is input for the compuation.  
        unsigned int computedCubeMapDim,
        // Number of mip levels.
        unsigned int numLevels = 1,
        // Level to be filled (0 means also to allocate texture).
        unsigned int level = 0,
        // Roughness associated with the texture level.
        float roughness = -1.0);
 
    HDST_API
    void GetBufferSpecs(HdBufferSpecVector *specs) const override {}
   
    HDST_API
    void Execute(HdBufferArrayRangeSharedPtr const &range,
                 HdResourceRegistry *resourceRegistry) override;
 
    int GetNumOutputElements() const override { return 0; }
 
private:
    const TfToken _shaderToken;
    const bool _useCubemapAsSourceTexture;
    const HdStSimpleLightingShaderPtr _lightingShader;
    const unsigned int _computedCubeMapDim;
    const unsigned int _numLevels;
    const unsigned int _level;
    const float _roughness;
};
 
class HdSt_DomeLightMipmapComputationGPU : public HdStComputation
{
public:
    HDST_API
    HdSt_DomeLightMipmapComputationGPU(
        // Lighting shader for accessing textures.
        HdStSimpleLightingShaderPtr const &lightingShader);
 
    HDST_API
    void GetBufferSpecs(HdBufferSpecVector *specs) const override {}
   
    HDST_API
    void Execute(HdBufferArrayRangeSharedPtr const &range,
                 HdResourceRegistry *resourceRegistry) override;
 
    int GetNumOutputElements() const override { return 0; }
 
private:
    const HdStSimpleLightingShaderPtr _lightingShader;
};
 
// For the given 2D dome light texture, compute the resulting dimensions of 
// the cubemap.
HDST_API
int HdSt_ComputeDomeLightCubemapWidth(
    const std::string& domeLightFilePath,
    const HgiTextureDesc& domelightTextureDesc,
    const unsigned int cubemapTargetMemoryMB);
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif // PXR_IMAGING_HD_ST_DOME_LIGHT_COMPUTATIONS_H