A Node represents a single computer in the cluster. More...

#include <node.h>

Inheritance diagram for eq::Node:

Collaboration diagram for eq::Node:

Classes
class	TransmitThread

Public Member Functions
	Node (Config *parent)
	Construct a new node. More...

virtual	~Node ()
	Destruct the node. More...

ClientPtr	getClient ()

ServerPtr	getServer ()

co::CommandQueue *	getMainThreadQueue ()

co::CommandQueue *	getCommandThreadQueue ()

uint32_t	getCurrentFrame () const

co::Barrier *	getBarrier (const co::ObjectVersion barrier)

FrameDataPtr	getFrameData (const co::ObjectVersion &frameDataVersion)

void	releaseFrameData (FrameDataPtr data)

void	waitInitialized () const

bool	isRunning () const

bool	isStopped () const

void	waitFrameStarted (const uint32_t frameNumber) const
	Wait for a frame to be started. More...

uint32_t	getFinishedFrame () const

virtual bool	processEvent (const Event &event)
	Process a received event. More...

virtual void	setDirty (const uint64_t bits)

void	dirtyClientExit ()

Public Member Functions inherited from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >
Config *	getConfig ()

const Config *	getConfig () const

const Pipes &	getPipes () const

bool	isApplicationNode () const

EQFABRIC_INL void	setApplicationNode (const bool isAppNode)

EQFABRIC_INL NodePath	getPath () const

Pipe *	findPipe (const UUID &id)

EQFABRIC_INL VisitorResult	accept (NodeVisitor &visitor)
	Perform a depth-first traversal of this node. More...

EQFABRIC_INL VisitorResult	accept (NodeVisitor &visitor) const
	Const-version of accept(). More...

virtual EQFABRIC_INL void	backup ()

virtual EQFABRIC_INL void	restore ()

void	create (Pipe **pipe)

void	release (Pipe *pipe)

virtual void	output (std::ostream &) const

virtual EQFABRIC_INL uint128_t	commit (const uint32_t incarnation=CO_COMMIT_NEXT)

EQFABRIC_INL void	setIAttribute (const IAttribute attr, const int32_t value)

EQFABRIC_INL int32_t	getIAttribute (const IAttribute attr) const

Public Member Functions inherited from eq::fabric::Object
virtual bool	isDirty () const

void	setName (const std::string &name)
	Set the name of the object. More...

const std::string &	getName () const

void	setUserData (co::Object *userData)
	Set user-specific data. More...

co::Object *	getUserData ()

const co::Object *	getUserData () const

void	setError (const int32_t error)
	Set an error code why the last operation failed. More...

eq::fabric::Error	getError () const

uint32_t	getTasks () const
	Return the set of tasks this channel might execute in the worst case. More...

uint32_t	getSerial () const

Public Attributes
eq::Node::TransmitThread	transmitter

Protected Member Functions
virtual void	attach (const UUID &id, const uint32_t instanceID)

Actions
void	startFrame (const uint32_t frameNumber)
	Start a frame by unlocking all child resources. More...

void	releaseFrame (const uint32_t frameNumber)
	Signal the completion of a frame to the parent. More...

void	releaseFrameLocal (const uint32_t frameNumber)
	Release the local synchronization of the parent for a frame. More...

Callbacks
The callbacks are called by Equalizer during rendering to execute various actions.
virtual bool	configInit (const uint128_t &initID)
	Initialize this node. More...

virtual bool	configExit ()
	Exit this node. More...

virtual void	frameStart (const uint128_t &frameID, const uint32_t frameNumber)
	Start rendering a frame. More...

virtual void	frameFinish (const uint128_t &frameID, const uint32_t frameNumber)
	Finish rendering a frame. More...

virtual void	frameDrawFinish (const uint128_t &frameID, const uint32_t frameNumber)
	Finish drawing. More...

virtual void	frameTasksFinish (const uint128_t &frameID, const uint32_t frameNumber)
	Finish all rendering tasks. More...

Protected Member Functions inherited from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >
	Node (Config *parent)

virtual EQFABRIC_INL void	serialize (co::DataOStream &os, const uint64_t dirtyBits)

virtual EQFABRIC_INL void	deserialize (co::DataIStream &is, const uint64_t dirtyBits)

virtual EQFABRIC_INL void	notifyDetach ()

virtual ChangeType	getChangeType () const

virtual uint64_t	getRedistributableBits () const

Protected Member Functions inherited from eq::fabric::Object
	Object ()
	Construct a new Object. More...

virtual	~Object ()
	Destruct the object. More...

virtual bool	hasMasterUserData ()

virtual uint32_t	getUserDataLatency () const

void	setTasks (const uint32_t tasks)

void	postRemove (Object *child)

virtual void	removeChild (const UUID &)

template<class C , class S >
void	commitChild (C child, S sender, uint32_t cmd, const uint32_t incarnation)

template<class C >
void	commitChild (C *child, const uint32_t incarnation)

template<class C , class S >
void	commitChildren (const std::vector< C * > &children, S *sender, uint32_t cmd, const uint32_t incarnation)

template<class C >
void	commitChildren (const std::vector< C * > &children, uint32_t cmd, const uint32_t incarnation)

template<class C >
void	commitChildren (const std::vector< C * > &children, const uint32_t incarnation)

template<class C >
void	syncChildren (const std::vector< C * > &children)

template<class P , class C >
void	releaseChildren (const std::vector< C * > &children)

bool	_cmdSync (co::ICommand &command)

Additional Inherited Members
Public Types inherited from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >
typedef std::vector< Pipe * >	Pipes
	A vector of pointers to pipes. More...

enum	IAttribute
	Integer attributes. More...

Public Types inherited from eq::fabric::Object
enum	DirtyBits { DIRTY_NAME = Serializable::DIRTY_CUSTOM << 0, DIRTY_USERDATA = Serializable::DIRTY_CUSTOM << 1, DIRTY_ERROR = Serializable::DIRTY_CUSTOM << 2, DIRTY_TASKS = Serializable::DIRTY_CUSTOM << 3, DIRTY_REMOVED = Serializable::DIRTY_CUSTOM << 4, DIRTY_SERIAL = Serializable::DIRTY_CUSTOM << 5, DIRTY_CUSTOM = Serializable::DIRTY_CUSTOM << 6, DIRTY_OBJECT_BITS = DIRTY_NAME \| DIRTY_USERDATA \| DIRTY_ERROR }
	The changed parts of the object since the last pack(). More...

Static Public Member Functions inherited from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >
static const std::string &	getIAttributeString (const IAttribute attr)

Protected Types inherited from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >
enum	DirtyBits

Detailed Description

A Node represents a single computer in the cluster.

Each node is executed in a separate process. Each process has only its local node instantiated, that is, it has at most instance of a Node and does not see other node instances. The application process may not have a node, which is the case when it does not contribute to the rendering.

The eq::Node is not to be confused with the co::Node which represents the process in the underlying peer-to-peer network layer. The eq::Client and eq::Server are co::Nodes representing the local client and Equalizer server, respectively.

See Also: fabric::Node

Definition at line 49 of file include/eq/client/node.h.

Constructor & Destructor Documentation

eq::Node::Node ( Config * parent )

Construct a new node.

Version: 1.0

virtual eq::Node::~Node ( )

virtual

Destruct the node.

Version: 1.0

Reimplemented from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >.

Reimplemented in eqPly::Node, and eVolve::Node.

Member Function Documentation

virtual bool eq::Node::configExit ( )

protectedvirtual

Exit this node.

Version: 1.0

virtual bool eq::Node::configInit ( const uint128_t & initID )

protectedvirtual

Initialize this node.

Parameters

initID the init identifier.

Version: 1.0

Reimplemented in eqPly::Node, and eVolve::Node.

Referenced by eVolve::Node::configInit(), and eqPly::Node::configInit().

Here is the caller graph for this function:

virtual void eq::Node::frameDrawFinish	(	const uint128_t &	frameID,
		const uint32_t	frameNumber
	)

protectedvirtual

Finish drawing.

Called once per frame after the last draw operation. Waits for the pipes to release the local synchonization and releases the node's local synchronization if the thread model is draw_sync (the default).

Parameters

frameID	the per-frame identifier.
frameNumber	the frame finished with draw.

See Also: Pipe::waitFrameLocal(), releaseFrameLocal()

Version: 1.0

virtual void eq::Node::frameFinish	(	const uint128_t &	frameID,
		const uint32_t	frameNumber
	)

protectedvirtual

Finish rendering a frame.

Called once at the end of each frame, to end the frame and to do per-frame updates of node-specific data. This method has to call releaseFrame().

Parameters

frameID	the per-frame identifier.
frameNumber	the frame to finish.

See Also: endFrame(), Config::finishFrame()

Version: 1.0

virtual void eq::Node::frameStart	(	const uint128_t &	frameID,
		const uint32_t	frameNumber
	)

protectedvirtual

Start rendering a frame.

Called once at the beginning of each frame, to start the node's frame and to do per-frame updates of node-specific data. This method has to call startFrame(). Immediately releases local synchronization if the thread model is async.

Parameters

frameID	the per-frame identifier.
frameNumber	the frame to start.

See Also: startFrame(), Config::beginFrame()

Version: 1.0

virtual void eq::Node::frameTasksFinish	(	const uint128_t &	frameID,
		const uint32_t	frameNumber
	)

protectedvirtual

Finish all rendering tasks.

Called once per frame after all frame tasks. Waits for the pipes to release the local synchonization and releases the node's local synchronization if the thread model is local_sync.

Note that frameFinish is called after the latency is exhausted and synchronizes pipe thread execution.

Parameters

frameID	the per-frame identifier.
frameNumber	the frame finished with draw.

See Also: Pipe::waitFrameLocal(), releaseFrameLocal()

Version: 1.0

ClientPtr eq::Node::getClient ( )

Returns: the parent client node.

Version: 1.0

ServerPtr eq::Node::getServer ( )

Returns: the parent server node.

Version: 1.0

bool eq::Node::isRunning ( ) const

Returns: true if this node is running, false otherwise.

Version: 1.0

bool eq::Node::isStopped ( ) const

Returns: true if this node is stopped, false otherwise.

Version: 1.0

virtual bool eq::Node::processEvent ( const Event & event )

virtual

Process a received event.

The task of this method is to update the node as necessary, and transform the event into a config event to be send to the application using Config::sendEvent().

Parameters

event the received event.

Returns: true when the event was handled, false if not.

Version: 1.5.2

void eq::Node::releaseFrame ( const uint32_t frameNumber )

protected

Signal the completion of a frame to the parent.

Parameters

frameNumber the frame to end.

Version: 1.0

void eq::Node::releaseFrameLocal ( const uint32_t frameNumber )

protected

Release the local synchronization of the parent for a frame.

Parameters

frameNumber the frame to release.

Version: 1.0

virtual void eq::Node::setDirty ( const uint64_t bits )

virtual

See Also: Serializable::setDirty()

Reimplemented from eq::fabric::Node< Config, Node, Pipe, NodeVisitor >.

void eq::Node::startFrame ( const uint32_t frameNumber )

protected

Start a frame by unlocking all child resources.

Parameters

frameNumber the frame to start.

Version: 1.0

void eq::Node::waitFrameStarted ( const uint32_t frameNumber ) const

Wait for a frame to be started.

Used by the pipe task methods to implement the current thread synchronization model.

Parameters

frameNumber the frame number.

See Also: releaseFrame()

Version: 1.0

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

include/eq/client/node.h

Classes

Public Member Functions

Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation