colorizeSelectionTask.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_COLORIZE_SELECTION_TASK_H
#define PXR_IMAGING_HDX_COLORIZE_SELECTION_TASK_H
 
#include "pxr/pxr.h"
#include "pxr/base/gf/vec2f.h"
#include "pxr/imaging/hdx/api.h"
#include "pxr/imaging/hdx/task.h"
 
#include "pxr/imaging/hgi/texture.h"
 
PXR_NAMESPACE_OPEN_SCOPE
 
struct HdxColorizeSelectionTaskParams
{
    HdxColorizeSelectionTaskParams()
        : enableSelectionHighlight(false)
        , enableLocateHighlight(false)
        , selectionColor(0)
        , locateColor(0)
        , enableOutline(false)
        , outlineRadius(5)
        , primIdBufferPath()
        , instanceIdBufferPath()
        , elementIdBufferPath()
        {}
 
    bool enableSelectionHighlight;
    bool enableLocateHighlight;
    GfVec4f selectionColor;
    GfVec4f locateColor;
    bool enableOutline;
    unsigned int outlineRadius;
 
    SdfPath primIdBufferPath;
    SdfPath instanceIdBufferPath;
    SdfPath elementIdBufferPath;
};
 
class HdxColorizeSelectionTask : public HdxTask
{
public:
    using TaskParams = HdxColorizeSelectionTaskParams;
 
    HDX_API
    HdxColorizeSelectionTask(HdSceneDelegate* delegate, SdfPath const& id);
 
    HDX_API
    ~HdxColorizeSelectionTask() override;
 
    bool IsConverged() const 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:
    // The core colorizing logic of this task: given the ID buffers and the
    // selection buffer, produce a color output at each pixel.
    void _ColorizeSelection();
 
    GfVec4f _GetColorForMode(int mode) const;
 
    // Utility function to update the shader uniform parameters.
    // Returns true if the values were updated. False if unchanged.
    bool _UpdateParameterBuffer();
 
    // Create a new GPU texture for the provided format and pixel data.
    // If an old texture exists it will be destroyed first.
    void _CreateTexture(
        int width, 
        int height,
        HdFormat format,
        void *data);
 
    // This struct must match ParameterBuffer in outline.glslfx.
    // Be careful to remember the std430 rules.
    struct _ParameterBuffer
    {
        // Size of a colorIn texel - to iterate adjacent texels.
        GfVec2f texelSize;
        // Draws outline when enabled, or color overlay when disabled.
        int enableOutline = 0;
        // The outline radius (thickness). 
        int radius = 5;
 
        bool operator==(const _ParameterBuffer& other) const {
            return texelSize == other.texelSize &&
                   enableOutline == other.enableOutline &&
                   radius == other.radius;
        }
    };
 
    // Incoming data
    HdxColorizeSelectionTaskParams _params;
 
    int _lastVersion;
    bool _hasSelection;
    VtIntArray _selectionOffsets;
 
    HdRenderBuffer *_primId;
    HdRenderBuffer *_instanceId;
    HdRenderBuffer *_elementId;
 
    uint8_t *_outputBuffer;
    size_t _outputBufferSize;
    bool _converged;
 
    std::unique_ptr<class HdxFullscreenShader> _compositor;
 
    _ParameterBuffer _parameterData;
    HgiTextureHandle _texture;
    bool _pipelineCreated;
};
 
// VtValue requirements
HDX_API
std::ostream& operator<<(std::ostream& out,
    const HdxColorizeSelectionTaskParams& pv);
HDX_API
bool operator==(const HdxColorizeSelectionTaskParams& lhs,
                const HdxColorizeSelectionTaskParams& rhs);
HDX_API
bool operator!=(const HdxColorizeSelectionTaskParams& lhs,
                const HdxColorizeSelectionTaskParams& rhs);
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif // PXR_IMAGING_HDX_COLORIZE_SELECTION_TASK_H