loftedOutputSet.h

//
// Copyright 2025 Pixar
//
// Licensed under the terms set forth in the LICENSE.txt file available at
// https://openusd.org/license.
//
#ifndef PXR_EXEC_EF_LOFTED_OUTPUT_SET_H
#define PXR_EXEC_EF_LOFTED_OUTPUT_SET_H

#include "pxr/pxr.h"

#include "pxr/exec/ef/api.h"

#include "pxr/exec/vdf/types.h"

#include <tbb/concurrent_hash_map.h>

#include <atomic>
#include <cstddef>
#include <cstdint>
#include <memory>
#include <vector>

PXR_NAMESPACE_OPEN_SCOPE

class VdfMaskedOutput;
class VdfNetwork;
class VdfMask;
using VdfMaskedOutputVector = std::vector<VdfMaskedOutput>;
class VdfOutput;

class Ef_LoftedOutputSet
{
public:
    EF_API
    Ef_LoftedOutputSet();

    EF_API
    ~Ef_LoftedOutputSet();

    size_t GetSize() const {
        return _loftedOutputs.size();
    }

    EF_API
    void Resize(const VdfNetwork &network);

    EF_API
    bool Add(
        const VdfOutput &output,
        const VdfMask &mask);

    EF_API
    void Remove(
        const VdfId outputId,
        const VdfId nodeId,
        const VdfMask &mask);

    EF_API
    void RemoveAllOutputsForNode(const VdfNode &node);

    EF_API
    void Clear();

    EF_API
    void CollectLoftedDependencies(
        const VdfOutputToMaskMap &deps,
        VdfMaskedOutputVector *processedRequest) const;

private:
    // A set of outputs, which had their values sourced from the page cache
    // during evaluation (or getting of output values.) We need to keep track
    // of these outputs in order to allows us to later properly invalidate them.
    using _LoftedOutputsMap = tbb::concurrent_hash_map<VdfId, VdfMask>;
    _LoftedOutputsMap _loftedOutputs;

    // An array of node references used to accelerate lookups into the
    // _loftedOutputs map.
    std::unique_ptr<std::atomic<uint32_t>[]> _loftedNodeRefs;

    // The size of _loftedNodeRefs, which grows to accommodate the network's 
    // maximum capacity. 
    size_t _numLoftedNodeRefs = 0;
};

PXR_NAMESPACE_CLOSE_SCOPE

#endif