Detailed Description

Definition at line 64 of file Node.hpp.

Inheritance diagram for dw::framework::Node:

[legend]

Public Member Functions
virtual dwStatus	addToErrorSignal (uint32_t error, dwTime_t timestamp=0L)=0
	A function the allows user to add an error to the error signal list. More...

virtual dwStatus	addToHealthSignal (uint32_t error, dwTime_t timestamp=0L)=0
	A function the allows user to add an error to the health signal list. More...

virtual dwStatus	clearErrorSignal ()=0
	Clear the error signal for this node. More...

virtual dwStatus	clearHealthSignal ()=0
	Clear the health signal for this node. More...

virtual dwStatus	collectErrorSignals (dwGraphErrorSignal *&errorSignal, bool updateFromModule=true)=0
	Collect error signals from node and module, combine and return the pointer to the error signal for this node. If combination of module and node signals exceeds max amount, will return up to max amount, node first, and DW_BUFFER_FULL. More...

virtual dwStatus	collectHealthSignals (dwGraphHealthSignal *&healthSignal, bool updateFromModule=false)=0
	Collect health signals from node and module, combine and return the pointer to the health signal for this node. If combination of module and node signals exceeds max amount, will return up to max amount, node first, and DW_BUFFER_FULL. More...

virtual dwStatus	getInputChannel (const size_t portID, ChannelObject *&channel) const =0
	Gets the input channel associated with the input port. More...

virtual dwStatus	getInputPort (const size_t portID, dw::framework::PortBase *&port) const =0
	Gets the input port associated with the port id. More...

virtual dwStatus	getModuleErrorSignal (dwErrorSignal &errorSignal)=0
	Get a copy of the error signals from the module that is a member of this node. More...

virtual dwStatus	getModuleHealthSignal (dwHealthSignal &healthSignal)=0
	Return a copy of health signals from module that is a member of node. More...

virtual dwStatus	getName (const char **name)=0
	Get the name of the node. More...

virtual dwStatus	getNodeErrorSignal (dwGraphErrorSignal &errorSignal)=0
	Get a copy of the error signals for the node. More...

virtual dwStatus	getNodeHealthSignal (dwGraphHealthSignal &healthSignal)=0
	Return a copy of graph health signals for the node. More...

virtual dwStatus	getOutputChannel (const size_t portID, ChannelObject *&channel) const =0
	Gets the output channel associated with the output port. More...

virtual dwStatus	getOutputPort (const size_t portID, dw::framework::PortBase *&port) const =0
	Gets the output port associated with the port id. More...

virtual dwStatus	getPass (Pass **pass, size_t index)=0
	Get a const pointer to the pass at a specific index. More...

virtual size_t	getPassCount () const noexcept=0
	Get number of passes in the node. More...

virtual dwStatus	getPasses (VectorFixed< Pass * > &passList)=0
	Get all the passes in the node. More...

virtual dwStatus	reset ()=0
	Resets the state of the node. More...

virtual void	resetPorts ()=0
	Resets all the ports in the node. More...

virtual dwStatus	run ()=0
	Runs all the passes in the node. More...

virtual dwStatus	runPass (size_t passIndex)=0
	Run one pass by index as defined by the pass descriptors. More...

virtual dwStatus	setInputChannel (ChannelObject *channel, size_t portID)=0
	Sets an input channel for this node with an accompanying port. More...

virtual dwStatus	setIterationCount (uint32_t iterationCount)=0
	Sets the node's iteration count. More...

virtual dwStatus	setName (const char *name)=0
	Set the name of the node. More...

virtual dwStatus	setNodePeriod (uint32_t period)=0
	Set the node's period. More...

virtual dwStatus	setOutputChannel (ChannelObject *channel, size_t portID)=0
	Sets an output channel for this node with an accompanying port. More...

virtual dwStatus	setState (const char *state)=0
	Set the current state in node. Node implementation of this API need to be thread-safe. More...

virtual dwStatus	updateCurrentErrorSignal (dwGraphErrorSignal &signal)=0
	A function that allows user override to update error signal It is automatically called by dwFramework when getErrorSignal is called and when pass returns non-success return code. More...

virtual dwStatus	updateCurrentHealthSignal (dwGraphHealthSignal &signal)=0
	A function that allows user override to update health signal It is automatically called by dwFramework during teardown and when pass returns non-success return code. More...

virtual dwStatus	validate ()=0
	Checks that all mandatory ports are bound. The implementation should validate that all the ports are bound to the appropriate channels (any required ports, that is). For example, a camera node may have processed output and raw output ports, but only one is required to be bound. More...

virtual	~Node ()=default

Static Public Attributes
static constexpr const size_t	MAX_NAME_LEN {128U}

Constructor & Destructor Documentation

◆ ~Node()

virtual dw::framework::Node::~Node ( )

virtualdefault

Member Function Documentation

◆ addToErrorSignal()

virtual dwStatus dw::framework::Node::addToErrorSignal	(	uint32_t	error,
		dwTime_t	timestamp = `0L`
	)

pure virtual

A function the allows user to add an error to the error signal list.

Parameters

[in]	error	error value to add.
[in]	timestamp	timestamp when error is reported. return DW_SUCCESS, DW_BUFFER_FULL

Implemented in dw::framework::SimpleNode, and dw::framework::ExceptionSafeProcessNode.

◆ addToHealthSignal()

virtual dwStatus dw::framework::Node::addToHealthSignal	(	uint32_t	error,
		dwTime_t	timestamp = `0L`
	)

pure virtual

A function the allows user to add an error to the health signal list.

Parameters

[in]	error	error value to add.
[in]	timestamp	timestamp when error is reported. return DW_SUCCESS, DW_BUFFER_FULL

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ clearErrorSignal()

virtual dwStatus dw::framework::Node::clearErrorSignal ( )

pure virtual

Clear the error signal for this node.

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ clearHealthSignal()

virtual dwStatus dw::framework::Node::clearHealthSignal ( )

pure virtual

Clear the health signal for this node.

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ collectErrorSignals()

virtual dwStatus dw::framework::Node::collectErrorSignals	(	dwGraphErrorSignal *&	errorSignal,
		bool	updateFromModule = `true`
	)

pure virtual

Collect error signals from node and module, combine and return the pointer to the error signal for this node. If combination of module and node signals exceeds max amount, will return up to max amount, node first, and DW_BUFFER_FULL.

Parameters

[out]	errorSignal	The error signal.
[in]	updateFromModule	fetch from module and update node errors with module errors if true.

Returns: DW_SUCCESS, DW_NOT_AVAILABLE, DW_BUFFER_FULL

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ collectHealthSignals()

virtual dwStatus dw::framework::Node::collectHealthSignals	(	dwGraphHealthSignal *&	healthSignal,
		bool	updateFromModule = `false`
	)

pure virtual

Collect health signals from node and module, combine and return the pointer to the health signal for this node. If combination of module and node signals exceeds max amount, will return up to max amount, node first, and DW_BUFFER_FULL.

Parameters

[out]	healthSignal	The health signal.
[in]	updateFromModule	fetch from module if set to true

Returns: DW_SUCCESS, DW_NOT_AVAILABLE, DW_BUFFER_FULL

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getInputChannel()

virtual dwStatus dw::framework::Node::getInputChannel	(	const size_t	portID,
		ChannelObject *&	channel
	)		const

pure virtual

Gets the input channel associated with the input port.

Parameters

[in]	portID	The port to get the channel from.
[out]	channel	The channel associated to the portID.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getInputPort()

virtual dwStatus dw::framework::Node::getInputPort	(	const size_t	portID,
		dw::framework::PortBase *&	port
	)		const

pure virtual

Gets the input port associated with the port id.

Parameters

[in]	portID	The port id associated with the input port.
[out]	port	The port associated with the port id.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT if node doesnt have input port w/port id

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getModuleErrorSignal()

virtual dwStatus dw::framework::Node::getModuleErrorSignal ( dwErrorSignal & errorSignal )

pure virtual

Get a copy of the error signals from the module that is a member of this node.

Parameters

[out] errorSignal The error signal.

Returns: DW_SUCCESS, DW_NOT_AVAILABLE

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getModuleHealthSignal()

virtual dwStatus dw::framework::Node::getModuleHealthSignal ( dwHealthSignal & healthSignal )

pure virtual

Return a copy of health signals from module that is a member of node.

Parameters

[out] healthSignal The health signal.

Returns: DW_SUCCESS, DW_NOT_AVAILABLE

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getName()

virtual dwStatus dw::framework::Node::getName ( const char ** name )

pure virtual

Get the name of the node.

Parameters

name	The output name.

Returns: DW_SUCCESS, DW_INVALID_ARUGMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getNodeErrorSignal()

virtual dwStatus dw::framework::Node::getNodeErrorSignal ( dwGraphErrorSignal & errorSignal )

pure virtual

Get a copy of the error signals for the node.

Parameters

[out] errorSignal The error signal.

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getNodeHealthSignal()

virtual dwStatus dw::framework::Node::getNodeHealthSignal ( dwGraphHealthSignal & healthSignal )

pure virtual

Return a copy of graph health signals for the node.

Parameters

[out] healthSignal The health signal.

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getOutputChannel()

virtual dwStatus dw::framework::Node::getOutputChannel	(	const size_t	portID,
		ChannelObject *&	channel
	)		const

pure virtual

Gets the output channel associated with the output port.

Parameters

[in]	portID	The port to get the channel from.
[out]	channel	The channel associated to the portID.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getOutputPort()

virtual dwStatus dw::framework::Node::getOutputPort	(	const size_t	portID,
		dw::framework::PortBase *&	port
	)		const

pure virtual

Gets the output port associated with the port id.

Parameters

[in]	portID	The port id associated with the output port.
[out]	port	The port associated with the port id.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT if node doesnt have output port w/port id

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getPass()

virtual dwStatus dw::framework::Node::getPass	(	Pass **	pass,
		size_t	index
	)

pure virtual

Get a const pointer to the pass at a specific index.

Parameters

[out]	pass	A const pointer to the pass
[in]	index	The index of the pass to get

Returns: DW_SUCCESS on success DW_NOT_INITIALIZED if setup and teardown pass does not exist DW_INVALID_ARGUMENT on invalid index

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getPassCount()

virtual size_t dw::framework::Node::getPassCount ( ) const

pure virtualnoexcept

Get number of passes in the node.

Returns: The number of passes

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ getPasses()

virtual dwStatus dw::framework::Node::getPasses ( VectorFixed< Pass * > & passList )

pure virtual

Get all the passes in the node.

Parameters

passList The output list to populate.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ reset()

virtual dwStatus dw::framework::Node::reset ( )

pure virtual

Resets the state of the node.

Returns: DW_SUCCESS, DW_FAILURE

Implemented in dw::framework::ExceptionSafeProcessNode, dw::framework::SimpleNode, and dw::framework::SimpleNodeT< T >.

◆ resetPorts()

virtual void dw::framework::Node::resetPorts ( )

pure virtual

Resets all the ports in the node.

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ run()

virtual dwStatus dw::framework::Node::run ( )

pure virtual

Runs all the passes in the node.

Returns: DW_SUCCESS, DW_FAILURE

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ runPass()

virtual dwStatus dw::framework::Node::runPass ( size_t passIndex )

pure virtual

Run one pass by index as defined by the pass descriptors.

Parameters

passIndex The index of the pass to run.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT, DW_FAILURE

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ setInputChannel()

virtual dwStatus dw::framework::Node::setInputChannel	(	ChannelObject *	channel,
		size_t	portID
	)

pure virtual

Sets an input channel for this node with an accompanying port.

Parameters

channel	The channel to bind to the portID.
portID	The port to bind the channel with.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ setIterationCount()

virtual dwStatus dw::framework::Node::setIterationCount ( uint32_t iterationCount )

pure virtual

Sets the node's iteration count.

Parameters

iterationCount The current iteration count

Returns: DW_SUCCESS

Implemented in dw::framework::SimpleNode, and dw::framework::ExceptionSafeProcessNode.

◆ setName()

virtual dwStatus dw::framework::Node::setName ( const char * name )

pure virtual

Set the name of the node.

Parameters

name	The name of the node.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::SimpleNode, and dw::framework::ExceptionSafeProcessNode.

◆ setNodePeriod()

virtual dwStatus dw::framework::Node::setNodePeriod ( uint32_t period )

pure virtual

Set the node's period.

Parameters

period Node's execution period in microseconds

Returns: DW_SUCCESS

Implemented in dw::framework::SimpleNode, and dw::framework::ExceptionSafeProcessNode.

◆ setOutputChannel()

virtual dwStatus dw::framework::Node::setOutputChannel	(	ChannelObject *	channel,
		size_t	portID
	)

pure virtual

Sets an output channel for this node with an accompanying port.

Parameters

channel	The channel to bind to the portID.
portID	The port to bind the channel with.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ setState()

virtual dwStatus dw::framework::Node::setState ( const char * state )

pure virtual

Set the current state in node. Node implementation of this API need to be thread-safe.

Parameters

state The name of the new state which is about to start. The pointer is valid only for the runtime of the function and data should be stored with a deep copy.

Returns: DW_SUCCESS, DW_INVALID_ARGUMENT

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ updateCurrentErrorSignal()

virtual dwStatus dw::framework::Node::updateCurrentErrorSignal ( dwGraphErrorSignal & signal )

pure virtual

A function that allows user override to update error signal It is automatically called by dwFramework when getErrorSignal is called and when pass returns non-success return code.

Parameters

[in,out] signal that the node owner modifies to store current health. It is pre-filled with the latest module health signal

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ updateCurrentHealthSignal()

virtual dwStatus dw::framework::Node::updateCurrentHealthSignal ( dwGraphHealthSignal & signal )

pure virtual

A function that allows user override to update health signal It is automatically called by dwFramework during teardown and when pass returns non-success return code.

Parameters

[in,out] signal that the node owner modifies to store current health. It is pre-filled with the latest module health signal

Returns: DW_SUCCESS

Implemented in dw::framework::ExceptionSafeProcessNode, and dw::framework::SimpleNode.

◆ validate()

virtual dwStatus dw::framework::Node::validate ( )

pure virtual

Checks that all mandatory ports are bound. The implementation should validate that all the ports are bound to the appropriate channels (any required ports, that is). For example, a camera node may have processed output and raw output ports, but only one is required to be bound.

Returns: DW_SUCCESS, DW_FAILURE

Implemented in dw::framework::ExceptionSafeProcessNode, dw::framework::SimpleNode, and dw::framework::SimpleNodeT< T >.

Member Data Documentation

◆ MAX_NAME_LEN

constexpr const size_t dw::framework::Node::MAX_NAME_LEN {128U}

staticconstexpr

Definition at line 70 of file Node.hpp.

The documentation for this class was generated from the following file:

src/dwcgf/core/dwcgf/node/Node.hpp

Detailed Description

Public Member Functions

Static Public Attributes

Constructor & Destructor Documentation

◆ ~Node()

Member Function Documentation

◆ addToErrorSignal()

◆ addToHealthSignal()

◆ clearErrorSignal()

◆ clearHealthSignal()

◆ collectErrorSignals()

◆ collectHealthSignals()

◆ getInputChannel()

◆ getInputPort()

◆ getModuleErrorSignal()

◆ getModuleHealthSignal()

◆ getName()

◆ getNodeErrorSignal()

◆ getNodeHealthSignal()

◆ getOutputChannel()

◆ getOutputPort()

◆ getPass()

◆ getPassCount()

◆ getPasses()

◆ reset()

◆ resetPorts()

◆ run()

◆ runPass()

◆ setInputChannel()

◆ setIterationCount()

◆ setName()

◆ setNodePeriod()

◆ setOutputChannel()

◆ setState()

◆ updateCurrentErrorSignal()

◆ updateCurrentHealthSignal()

◆ validate()

Member Data Documentation

◆ MAX_NAME_LEN