time.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_EF_TIME_H
#define PXR_EXEC_EF_TIME_H


#include "pxr/pxr.h"

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

#include "pxr/usd/usd/timeCode.h"

#include <cstdint>
#include <iosfwd>

PXR_NAMESPACE_OPEN_SCOPE

class EfTime
{
public:
    using SplineEvaluationFlags = uint8_t;

    EfTime() :
        _timeCode(UsdTimeCode::Default()),
        _splineFlags(0)
    {}

    explicit EfTime(
        const UsdTimeCode timeCode,
        SplineEvaluationFlags splineFlags = 0) :
        _timeCode(timeCode),
        _splineFlags(splineFlags)
    {}



    const UsdTimeCode GetTimeCode() const {
        return _timeCode;
    }

    void SetTimeCode(const UsdTimeCode timeCode) {
        _timeCode = timeCode;
    }




    SplineEvaluationFlags GetSplineEvaluationFlags() const {
        return _splineFlags;
    }

    void SetSplineEvaluationFlags(SplineEvaluationFlags flags) {
        _splineFlags = flags;
    }



    bool operator==(const EfTime &rhs) const {
        if (!_timeCode.IsDefault() && !rhs._timeCode.IsDefault()) {
            return _timeCode == rhs._timeCode
                && _splineFlags == rhs._splineFlags;
        }
        return _timeCode.IsDefault() == rhs._timeCode.IsDefault();
    }

    bool operator!=(const EfTime &rhs) const {
        return !(*this == rhs);
    }

    bool operator<(const EfTime &rhs) const {
        if (_timeCode.IsDefault() || rhs._timeCode.IsDefault()) {
            return _timeCode < rhs._timeCode;
        }

        return _timeCode < rhs._timeCode ||
            (_timeCode == rhs._timeCode && _splineFlags < rhs._splineFlags);
    }

    bool operator<=(const EfTime &rhs) const {
        return !(rhs < *this);
    }

    bool operator>(const EfTime &rhs) const {
        return rhs < *this;
    }

    bool operator>=(const EfTime &rhs) const {
        return !(*this < rhs);
    }

    template <class HashState>
    friend void TfHashAppend(HashState &h, const EfTime &t) {
        h.Append(t._timeCode);
        if (!t._timeCode.IsDefault()) {
            h.Append(t._splineFlags);
        }
    }

    EF_API
    std::string GetAsString() const;

private:

    // The time code value.
    UsdTimeCode _timeCode;

    // The spline evaluation flags to use during computation.
    SplineEvaluationFlags _splineFlags;
};

EF_API
std::ostream &operator<<(std::ostream &os, const EfTime &time);

PXR_NAMESPACE_CLOSE_SCOPE

#endif