cacheView.h

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

#include "pxr/pxr.h"

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

#include "pxr/base/tf/span.h"
#include "pxr/exec/vdf/dataManagerFacade.h"

#include <memory>
#include <optional>

PXR_NAMESPACE_OPEN_SCOPE

class Exec_ValueExtractor;
class VdfExecutorInterface;
class VdfMaskedOutput;
class VtValue;

class Exec_CacheView
{
public:
    Exec_CacheView() = default;

    Exec_CacheView(const Exec_CacheView &) = delete;

    EXEC_API
    Exec_CacheView(Exec_CacheView &&other);

    EXEC_API
    ~Exec_CacheView();

    EXEC_API
    VtValue Get(int index) const;

private:
    friend class Exec_RequestImpl;

    // Constructs a cache view that extracts computed values from
    // \p dataManager. The data manager must outlive the cache view.
    Exec_CacheView(
        const VdfDataManagerFacade dataManager,
        TfSpan<const VdfMaskedOutput> outputs,
        TfSpan<const Exec_ValueExtractor> extractors);

    // Constructs a cache view that assumes ownership of an \p executor, so that
    // it remains valid while computed values are extracted from it.
    Exec_CacheView(
        std::unique_ptr<VdfExecutorInterface> &&executor,
        TfSpan<const VdfMaskedOutput> outputs,
        TfSpan<const Exec_ValueExtractor> extractors);

private:
    std::optional<const VdfDataManagerFacade> _dataManager;
    const TfSpan<const VdfMaskedOutput> _outputs;
    const TfSpan<const Exec_ValueExtractor> _extractors;
    std::unique_ptr<VdfExecutorInterface> _executor;
};

PXR_NAMESPACE_CLOSE_SCOPE

#endif