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