presentTask.h

//
// Copyright 2019 Pixar
//
// Licensed under the terms set forth in the LICENSE.txt file available at
// https://openusd.org/license.
//
#ifndef PXR_IMAGING_HDX_PRESENT_TASK_H
#define PXR_IMAGING_HDX_PRESENT_TASK_H
 
#include "pxr/pxr.h"
#include "pxr/imaging/hdx/api.h"
#include "pxr/imaging/hdx/task.h"
#include "pxr/base/gf/vec4f.h"
#include "pxr/imaging/hgi/tokens.h"
#include "pxr/imaging/hgi/types.h"
#include "pxr/imaging/hgiInterop/hgiInterop.h"
 
PXR_NAMESPACE_OPEN_SCOPE
 
struct HdxPresentTaskParams
{
    HdxPresentTaskParams()
        : dstApi(HgiTokens->OpenGL)
        , dstRegion(0)
        , normalizedSrcRegion(0.0F, 0.0F, 1.0F, 1.0F)
        , enabled(true)
    {}
 
    // The graphics lib that is used by the application / viewer.
    // (The 'interopSrc' is determined by checking Hgi->GetAPIName)
    TfToken dstApi;
 
    VtValue dstFramebuffer;
 
    // Subrectangular region of the framebuffer over which to composite aov
    // contents. Coordinates are (left, BOTTOM, width, height), which is the
    // same convention as OpenGL viewport coordinates. Note that this
    // is specified in *pixel* coordinates.
    GfVec4i dstRegion;
 
    // Normalized [0,1] sub-rectangle of the source AOV textures to sample.
    // Coordinates are (left, bottom, width, height). Identity is (0,0,1,1)
    // which samples the entire texture. Note this is specified in *normalized*
    // coordinates.
    GfVec4f normalizedSrcRegion;
 
    // When not enabled, present task does not execute, but still calls
    // Hgi::EndFrame.
    bool enabled;
};
 
class HdxPresentTask : public HdxTask
{
public:
    using TaskParams = HdxPresentTaskParams;
    
    // Returns true if the format is supported for presentation. This is useful
    // for upstream tasks to prepare the AOV data accordingly, and keeps the 
    // interop step simple.
    HDX_API
    static bool IsFormatSupported(HgiFormat aovFormat);
 
    HDX_API
    HdxPresentTask(HdSceneDelegate* delegate, SdfPath const& id);
 
    HDX_API
    ~HdxPresentTask() override;
 
    HDX_API
    void Prepare(HdTaskContext* ctx,
                 HdRenderIndex* renderIndex) override;
 
    HDX_API
    void Execute(HdTaskContext* ctx) override;
 
protected:
    HDX_API
    void _Sync(HdSceneDelegate* delegate,
               HdTaskContext* ctx,
               HdDirtyBits* dirtyBits) override;
 
private:
    HdxPresentTaskParams _params;
    HgiInterop _interop;
 
    HdxPresentTask() = delete;
    HdxPresentTask(const HdxPresentTask &) = delete;
    HdxPresentTask &operator =(const HdxPresentTask &) = delete;
};
 
 
 
// VtValue requirements
HDX_API
std::ostream& operator<<(std::ostream& out, const HdxPresentTaskParams& pv);
HDX_API
bool operator==(const HdxPresentTaskParams& lhs,
                const HdxPresentTaskParams& rhs);
HDX_API
bool operator!=(const HdxPresentTaskParams& lhs,
                const HdxPresentTaskParams& rhs);
 
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif