omni::graph::exec::unstable::NodeDefT
Defined in omni/graph/exec/unstable/NodeDef.h
-
template<typename ...Bases>
class NodeDefT : public omni::graph::exec::unstable::Implements<Bases...> Opaque node definition.
Nodes are opaque because the Execution Framework has no knowledge or what the execution method will do and does not orchestrate generation and dispatch of the tasks.
Node definitions can be shared across multiple nodes and graphs. The implementation should leverage execution task to operate within proper task state.
See Execution Concepts for an in-depth guide on how this object is used during execution.
See also omni::graph::exec::unstable::ExecutionTask, omni::graph::exec::unstable::ExecutionPath.
Subclassed by omni::graph::exec::unstable::NodeDefLambda
Public Functions
-
inline void acquire() noexcept
Increments the object’s reference count.
Objects may have multiple reference counts (e.g. one per interface implemented). As such, it is important that you call omni::core::IObject::release() on the same pointer from which you called omni::core::IObject::acquire().
Do not directly use this method, rather use omni::core::ObjectPtr, which will manage calling omni::core::IObject::acquire() and omni::core::IObject::release() for you.
- Thread Safety
This method is thread safe.
-
inline void release() noexcept
Decrements the objects reference count.
Most implementations will destroy the object if the reference count reaches 0 (though this is not a requirement).
Objects may have multiple reference counts (e.g. one per interface implemented). As such, it is important that you call omni::core::IObject::release() on the same pointer from which you called omni::core::IObject::acquire().
Do not directly use this method, rather use omni::core::ObjectPtr, which will manage calling omni::core::IObject::acquire() and omni::core::IObject::release() for you.
- Thread Safety
This method is thread safe.
-
inline uint32_t getUseCount() noexcept
Returns the number of different instances (this included) referencing the current object.
- Thread Safety
This method is thread safe.
-
inline void *castWithoutAcquire(omni::core::TypeId id) noexcept
See omni::graph::exec::unstable::IBase_abi::castWithoutAcquire_abi.
Public Static Functions
-
static inline omni::core::ObjectPtr<NodeDefT> create(const carb::cpp::string_view &definitionName) noexcept
Construct node definition.
This function always returns a valid pointer.
- Parameters
definitionName – Definition name is considered as a token that transformation passes can register against. This name must not be
nullptr
.
Protected Functions
-
inline Status execute_abi(ExecutionTask *info) noexcept override
Execute the node definition.
The given task must not be
nullptr
.Prefer calling omni::graph::exec::unstable::ExecutionTask::execute() rather than this method as omni::graph::exec::unstable::ExecutionTask::execute() populates information such as omni::graph::exec::unstable::getCurrentTask().
See Error Handling to understand the error handling/reporting responsibilities of implementors of this method.
Unless overriden by a subclass, returns Status::eSuccess.
- Thread Safety
See thread safety information in interface description.
-
inline SchedulingInfo getSchedulingInfo_abi(const ExecutionTask *info) noexcept override
Provides runtime information about scheduling constraints for a given task/node.
The provided omni::graph::exec::unstable::ExecutionTask can be used to determine the path of the current definition.
The given task must not be
nullptr
.Unless overriden by a subclass, returns SchedulingInfo::eSerial.
- Thread Safety
See thread safety information in interface description.
-
inline const ConstName *getName_abi() noexcept override
Return unique definition identifier.
The returned pointer is never
nullptr
. The lifetime of the data returned is tied to the lifetime of this object.- Thread Safety
See thread safety information in interface description.
-
inline NodeDefT(const carb::cpp::string_view &definitionName) noexcept
Constructor.
-
inline void acquire_abi() noexcept override
Increments the object’s reference count.
Objects may have multiple reference counts (e.g. one per interface implemented). As such, it is important that you call omni::core::IObject::release() on the same pointer from which you called omni::core::IObject::acquire().
Do not directly use this method, rather use omni::core::ObjectPtr, which will manage calling omni::core::IObject::acquire() and omni::core::IObject::release() for you.
- Thread Safety
This method is thread safe.
-
inline void release_abi() noexcept override
Decrements the objects reference count.
Most implementations will destroy the object if the reference count reaches 0 (though this is not a requirement).
Objects may have multiple reference counts (e.g. one per interface implemented). As such, it is important that you call omni::core::IObject::release() on the same pointer from which you called omni::core::IObject::acquire().
Do not directly use this method, rather use omni::core::ObjectPtr, which will manage calling omni::core::IObject::acquire() and omni::core::IObject::release() for you.
- Thread Safety
This method is thread safe.
-
inline uint32_t getUseCount_abi() noexcept override
Returns the number of different instances (this included) referencing the current object.
-
inline void *cast_abi(omni::core::TypeId id) noexcept override
Returns a pointer to the interface defined by the given type id if this object implements the type id’s interface.
Objects can support multiple interfaces, even interfaces that are in different inheritance chains.
The returned object will have omni::core::IObject::acquire() called on it before it is returned, meaning it is up to the caller to call omni::core::IObject::release() on the returned pointer.
The returned pointer can be safely
reinterpret_cast<>
to the type id’s C++ class. For example, “omni.windowing.IWindow” can be cast toomni::windowing::IWindow
.Do not directly use this method, rather use a wrapper function like omni::core::cast() or omni::core::ObjectPtr::as().
- Thread Safety
This method is thread safe.
-
inline void *castWithoutAcquire_abi(omni::core::TypeId id) noexcept override
Casts this object to the type described the the given id.
Returns
nullptr
if the cast was not successful.Unlike omni::core::IObject::cast(), this casting method does not call omni::core::IObject::acquire().
- Thread Safety
This method is thread safe.
-
inline void acquire() noexcept