Internal base class for all distributed, inheritable Equalizer objects. More...

#include <object.h>

Inherited by eq::fabric::Canvas< Config, Canvas, Segment, Layout >, eq::fabric::Channel< Window, Channel >, eq::fabric::Config< Server, Config, Observer, Layout, Canvas, Node, ConfigVisitor >, eq::fabric::Canvas< CFG, C, S, L >, eq::fabric::Channel< W, C >, eq::fabric::Config< S, C, O, L, CV, N, V >, eq::fabric::Layout< C, L, V >, eq::fabric::Node< C, N, P, V >, eq::fabric::Observer< C, O >, eq::fabric::Pipe< N, P, W, V >, eq::fabric::Segment< C, S, CH >, eq::fabric::View< L, V, O >, eq::fabric::Window< P, W, C >, eq::fabric::Layout< Config, Layout, View >, eq::fabric::Node< Config, Node, Pipe, NodeVisitor >, eq::fabric::Observer< Config, Observer >, eq::fabric::Pipe< Node, Pipe, eq::Window, PipeVisitor >, eq::fabric::Segment< Canvas, Segment, Channel >, eq::fabric::View< Layout, View, Observer >, and eq::fabric::Window< Pipe, Window, Channel >.

Collaboration diagram for eq::fabric::Object:

List of all members.

Classes
struct	BackupData
Public Member Functions
virtual bool	isDirty () const
virtual uint32_t	commitNB (const uint32_t incarnation)
	Start committing a new version of this object.
virtual void	backup ()
virtual void	restore ()
Data Access.
void	setName (const std::string &name)
	Set the name of the object.
const std::string &	getName () const
void	setUserData (co::Object *userData)
	Set user-specific data.
co::Object *	getUserData ()
const co::Object *	getUserData () const
Error Information.
void	setError (const int32_t error)
	Set an error code why the last operation failed.
co::base::Error	getError () const
Data Access
uint32_t	getTasks () const
	Return the set of tasks this channel might execute in the worst case.
uint32_t	getSerial () const
Public Types
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...
Protected Member Functions
	Object ()
	Construct a new Object.
virtual	~Object ()
	Destruct the object.
virtual bool	hasMasterUserData ()
virtual uint32_t	getUserDataLatency () const
void	setTasks (const uint32_t tasks)
virtual void	notifyDetach ()
	Notify that this object will be deregistered or unmapped.
virtual void	serialize (co::DataOStream &os, const uint64_t dirtyBits)
	Worker for pack() and getInstanceData().
virtual void	deserialize (co::DataIStream &is, const uint64_t dirtyBits)
	Worker for unpack() and applyInstanceData().
virtual uint64_t	getRedistributableBits () const
void	postRemove (const Object *child)
virtual void	removeChild (const co::base::UUID &)
template<class C , class PKG , class S >
void	commitChild (C child, S sender, const uint32_t incarnation)
template<class C >
void	commitChild (C *child, const uint32_t incarnation)
template<class C , class PKG , class S >
void	commitChildren (const std::vector< C * > &children, S *sender, const uint32_t incarnation)
template<class C , class PKG >
void	commitChildren (const std::vector< C * > &children, 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::Command &command)

Detailed Description

Internal base class for all distributed, inheritable Equalizer objects.

This class provides common data storage used by all Equalizer resource entities. Do not subclass directly.

Definition at line 36 of file eq/fabric/object.h.

Member Enumeration Documentation

enum eq::fabric::Object::DirtyBits

The changed parts of the object since the last pack().

Subclasses should define their own bits, starting at DIRTY_CUSTOM.

Reimplemented from eq::fabric::Serializable.

Reimplemented in eq::fabric::Channel< W, C >, eq::fabric::Layout< C, L, V >, eq::fabric::Node< C, N, P, V >, eq::fabric::Observer< C, O >, eq::fabric::Pipe< N, P, W, V >, eq::fabric::Segment< C, S, CH >, eq::fabric::View< L, V, O >, eq::fabric::Window< P, W, C >, eq::fabric::Channel< Window, Channel >, eq::fabric::Layout< Config, Layout, View >, eq::fabric::Node< Config, Node, Pipe, NodeVisitor >, eq::fabric::Observer< Config, Observer >, eq::fabric::Pipe< Node, Pipe, eq::Window, PipeVisitor >, eq::fabric::Segment< Canvas, Segment, Channel >, eq::fabric::View< Layout, View, Observer >, and eq::fabric::Window< Pipe, Window, Channel >.

Definition at line 115 of file eq/fabric/object.h.

Constructor & Destructor Documentation

eq::fabric::Object::Object ( ) [protected]

Construct a new Object.

Reimplemented from co::Object.

virtual eq::fabric::Object::~Object ( ) [protected, virtual]

Destruct the object.

Reimplemented from co::Object.

Member Function Documentation

virtual uint32_t eq::fabric::Object::commitNB ( const uint32_t incarnation ) [virtual]

Start committing a new version of this object.

The commit transaction has to be completed using commitSync, passing the returned identifier.

Parameters:

incarnation the commit incarnation for auto obsoletion.

Returns:: the commit identifier to be passed to commitSync

See also:: commit(), commitSync()

Reimplemented from co::Object.

virtual void eq::fabric::Object::deserialize	(	co::DataIStream &	,
		const uint64_t
	)		`[protected, virtual]`

Worker for unpack() and applyInstanceData().

This function is called with the dirty bits send by the master instance. The dirty bits are received beforehand, and do not need to be deserialized by the overriding method.

See also:: serialize()

Version:: 1.0

Reimplemented from eq::fabric::Serializable.

Reimplemented in eq::fabric::Canvas< CFG, C, S, L >, eq::fabric::Channel< W, C >, eq::fabric::Config< S, C, O, L, CV, N, V >, eq::fabric::Layout< C, L, V >, eq::fabric::Node< C, N, P, V >, eq::fabric::Observer< C, O >, eq::fabric::Pipe< N, P, W, V >, eq::fabric::Segment< C, S, CH >, eq::fabric::View< L, V, O >, eq::fabric::Window< P, W, C >, eq::View, eq::fabric::Canvas< Config, Canvas, Segment, Layout >, eq::fabric::Channel< Window, Channel >, eq::fabric::Config< Server, Config, Observer, Layout, Canvas, Node, ConfigVisitor >, eq::fabric::Layout< Config, Layout, View >, eq::fabric::Node< Config, Node, Pipe, NodeVisitor >, eq::fabric::Observer< Config, Observer >, eq::fabric::Pipe< Node, Pipe, eq::Window, PipeVisitor >, eq::fabric::Segment< Canvas, Segment, Channel >, eq::fabric::View< Layout, View, Observer >, and eq::fabric::Window< Pipe, Window, Channel >.

co::base::Error eq::fabric::Object::getError ( ) const [inline]

Returns:: the error from the last failed operation.

Version:: 1.0

Definition at line 79 of file eq/fabric/object.h.

Referenced by eVolve::Pipe::configInit(), osgScaleViewer::OSGScaleViewer::run(), eVolve::EVolve::run(), and eqPly::EqPly::run().

Here is the caller graph for this function:

const std::string& eq::fabric::Object::getName ( ) const

Returns:: the name of the object.

Version:: 1.0

uint32_t eq::fabric::Object::getTasks ( ) const [inline]

Return the set of tasks this channel might execute in the worst case.

It is not guaranteed that all the tasks will be actually executed during rendering.

Returns:: the tasks.

Warning:: Experimental - may not be supported in the future

Definition at line 93 of file eq/fabric/object.h.

co::Object* eq::fabric::Object::getUserData ( ) [inline]

Returns:: the user-specific data.

Version:: 1.0

Definition at line 59 of file eq/fabric/object.h.

const co::Object* eq::fabric::Object::getUserData ( ) const [inline]

Returns:: the user-specific data.

Version:: 1.0

Definition at line 62 of file eq/fabric/object.h.

virtual uint32_t eq::fabric::Object::getUserDataLatency ( ) const [inline, protected, virtual]

Returns:: the latency to be used for keeping user data versions.

Reimplemented in eq::fabric::View< L, V, O >, and eq::fabric::View< Layout, View, Observer >.

Definition at line 142 of file eq/fabric/object.h.

virtual bool eq::fabric::Object::hasMasterUserData ( ) [inline, protected, virtual]

Returns:: true if this instance shall hold the master instance of the user data object, false otherwise.

Reimplemented in eq::fabric::View< L, V, O >, and eq::fabric::View< Layout, View, Observer >.

Definition at line 139 of file eq/fabric/object.h.

virtual bool eq::fabric::Object::isDirty ( ) const [virtual]

Returns:: true if the object has data to commit.

Version:: 1.0

Reimplemented from eq::fabric::Serializable.

virtual void eq::fabric::Object::notifyDetach ( ) [protected, virtual]

Notify that this object will be deregistered or unmapped.

The method is called from the thread initiating the deregistration or unmapping, before the operation is executed.

See also:: isMaster()

Reimplemented from co::Object.

Reimplemented in eq::Config, eq::fabric::Canvas< CFG, C, S, L >, eq::fabric::Config< S, C, O, L, CV, N, V >, eq::fabric::Layout< C, L, V >, eq::fabric::Node< C, N, P, V >, eq::fabric::Pipe< N, P, W, V >, eq::fabric::Window< P, W, C >, eq::fabric::Canvas< Config, Canvas, Segment, Layout >, eq::fabric::Config< Server, Config, Observer, Layout, Canvas, Node, ConfigVisitor >, eq::fabric::Layout< Config, Layout, View >, eq::fabric::Node< Config, Node, Pipe, NodeVisitor >, eq::fabric::Pipe< Node, Pipe, eq::Window, PipeVisitor >, and eq::fabric::Window< Pipe, Window, Channel >.

virtual void eq::fabric::Object::serialize	(	co::DataOStream &	,
		const uint64_t
	)		`[protected, virtual]`

Worker for pack() and getInstanceData().

Override this and deserialize() if you want to distribute subclassed data.

This method is called with DIRTY_ALL from getInstanceData() and with the actual dirty bits from pack(), which also resets the dirty state afterwards. The dirty bits are transmitted beforehand, and do not need to be transmitted by the overriding method.

Version:: 1.0

Reimplemented from eq::fabric::Serializable.

Reimplemented in eq::fabric::Canvas< CFG, C, S, L >, eq::fabric::Channel< W, C >, eq::fabric::Config< S, C, O, L, CV, N, V >, eq::fabric::Layout< C, L, V >, eq::fabric::Node< C, N, P, V >, eq::fabric::Observer< C, O >, eq::fabric::Pipe< N, P, W, V >, eq::fabric::Segment< C, S, CH >, eq::fabric::View< L, V, O >, eq::fabric::Window< P, W, C >, eq::fabric::Canvas< Config, Canvas, Segment, Layout >, eq::fabric::Channel< Window, Channel >, eq::fabric::Config< Server, Config, Observer, Layout, Canvas, Node, ConfigVisitor >, eq::fabric::Layout< Config, Layout, View >, eq::fabric::Node< Config, Node, Pipe, NodeVisitor >, eq::fabric::Observer< Config, Observer >, eq::fabric::Pipe< Node, Pipe, eq::Window, PipeVisitor >, eq::fabric::Segment< Canvas, Segment, Channel >, eq::fabric::View< Layout, View, Observer >, and eq::fabric::Window< Pipe, Window, Channel >.

void eq::fabric::Object::setError ( const int32_t error )

Set an error code why the last operation failed.

The error will be transmitted to the originator of the request, for example to Config::init when set from within configInit().

Parameters:

error the error message.

Version:: 1.0

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

Here is the caller graph for this function:

void eq::fabric::Object::setName ( const std::string & name )

Set the name of the object.

Version:: 1.0

void eq::fabric::Object::setUserData ( co::Object * userData )

Set user-specific data.

Registration, mapping, commit and sync of the user data object are automatically executed when committing and syncing this object. Not all instances of the object have to set a user data object. All instances have to set the same type of object.

Version:: 1.0

Referenced by eqPly::View::View(), and eqPly::View::~View().

Here is the caller graph for this function:

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

eq/fabric/object.h

eq::fabric::Object Class Reference

Classes

Public Member Functions

Public Types

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation