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 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,
        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::ChangedTargetPaths(
    EsfEditReason::_BitIndex::ChangedTargetPaths);
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif