editReason.h

Go to the documentation of this file.

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


#include "pxr/pxr.h"

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

#include <cstdint>
#include <string>

PXR_NAMESPACE_OPEN_SCOPE

class EsfEditReason
{
public:


    static const EsfEditReason None;

    static const EsfEditReason ResyncedObject;

    static const EsfEditReason ChangedPropertyList;

    static const EsfEditReason ChangedConnectionPaths;

    static const EsfEditReason ChangedIncomingConnections;

    static const EsfEditReason ChangedTargetPaths;



    constexpr explicit operator bool() const {
        return _bits;
    }

    constexpr bool operator==(EsfEditReason other) const {
        return _bits == other._bits;
    }

    constexpr bool operator!=(EsfEditReason other) const {
        return _bits != other._bits;
    }

    constexpr EsfEditReason& operator&=(EsfEditReason other) {
        _bits &= other._bits;
        return *this;
    }

    constexpr EsfEditReason& operator|=(EsfEditReason other) {
        _bits |= other._bits;
        return *this;
    }

    constexpr EsfEditReason operator&(EsfEditReason other) const {
        return {_bits & other._bits};
    }

    constexpr EsfEditReason operator|(EsfEditReason other) const {
        return {_bits | other._bits};
    }

    constexpr bool Contains(EsfEditReason other) const {
        return (_bits & other._bits) == other._bits;
    }


    bool operator<(const EsfEditReason &other) const {
        return _bits < other._bits;
    }

    constexpr EsfEditReason() = default;

    ESF_API std::string GetDescription() const;

private:
    using _BitsType = uint32_t;

    // Private methods use this constructor to initialize from a raw bitmask.
    constexpr EsfEditReason(_BitsType bits) : _bits(bits) {}

    // By using an enum class value for each bit position, we make it less
    // error-prone to define new edit reasons.
    enum class _BitIndex : uint8_t {
        ResyncedObject,
        ChangedPropertyList,
        ChangedConnectionPaths,
        ChangedIncomingConnections,
        ChangedTargetPaths,
        Max
    };

    // Predefined edit reasons use this constructor.
    constexpr EsfEditReason(_BitIndex bit)
        : _bits(1 << static_cast<int>(bit))
    {}

    // Returns a string describing this _BitIndex enum value.
    static const char *_GetBitDescription(_BitIndex bit);

    _BitsType _bits = 0;
};

inline constexpr EsfEditReason EsfEditReason::None(0);

inline constexpr EsfEditReason EsfEditReason::ResyncedObject(
    EsfEditReason::_BitIndex::ResyncedObject);

inline constexpr EsfEditReason EsfEditReason::ChangedPropertyList(
    EsfEditReason::_BitIndex::ChangedPropertyList);

inline constexpr EsfEditReason EsfEditReason::ChangedConnectionPaths(
    EsfEditReason::_BitIndex::ChangedConnectionPaths);

inline constexpr EsfEditReason EsfEditReason::ChangedIncomingConnections(
    EsfEditReason::_BitIndex::ChangedIncomingConnections);

inline constexpr EsfEditReason EsfEditReason::ChangedTargetPaths(
    EsfEditReason::_BitIndex::ChangedTargetPaths);

PXR_NAMESPACE_CLOSE_SCOPE

#endif