A View is a 2D area of a Layout. More...

#include <view.h>

Inheritance diagram for eq::View:

Collaboration diagram for eq::View:

Public Member Functions
EQ_API	View (Layout *parent)
	Construct a new view. More...

virtual EQ_API	~View ()
	Destruct this view. More...

Data Access.
Pipe *	getPipe ()

EQ_API const Pipe *	getPipe () const

EQ_API Config *	getConfig ()

EQ_API const Config *	getConfig () const

EQ_API ServerPtr	getServer ()

Operations
virtual EQ_API bool	handleEvent (const Event &event)
	Handle a received (view) event. More...

Public Member Functions inherited from eq::fabric::View< Layout, View, Observer >
void	setCapabilities (const uint64_t bitmask)

virtual void	updateCapabilities ()

EQFABRIC_INL const std::string &	getSAttribute (const SAttribute attr) const

EQFABRIC_INL const Viewport &	getViewport () const

Layout *	getLayout ()

const Layout *	getLayout () const

EQFABRIC_INL void	setObserver (Observer *observer)
	Set the entity tracking this view. More...

Observer *	getObserver ()

const Observer *	getObserver () const
	const version of getObserver(). More...

EQFABRIC_INL void	setOverdraw (const Vector2i &pixels)

const Vector2i &	getOverdraw () const

EQFABRIC_INL void	useEqualizer (uint32_t equalizerMask)

uint32_t	getEqualizers () const

EQFABRIC_INL const Equalizer &	getEqualizer () const

EQFABRIC_INL Equalizer &	getEqualizer ()

EQFABRIC_INL void	setViewport (const Viewport &viewport)

Mode	getMode () const

virtual EQFABRIC_INL void	changeMode (const Mode mode)
	Set the mode of this view. More...

virtual void	activateMode (const Mode mode)

EQFABRIC_INL bool	isActive () const

EQFABRIC_INL bool	setModelUnit (const float modelUnit)
	Set the model unit of this view. More...

EQFABRIC_INL float	getModelUnit () const
	Get the model unit of this view. More...

EQFABRIC_INL VisitorResult	accept (LeafVisitor< View > &visitor)
	Traverse this view using a view visitor. More...

EQFABRIC_INL VisitorResult	accept (LeafVisitor< View > &visitor) const
	Const-version of accept(). More...

virtual EQFABRIC_INL void	backup ()

virtual EQFABRIC_INL void	restore ()

EQFABRIC_INL void	setMinimumCapabilities (const uint64_t bitmask)
	Set the minimum required capabilities for this view. More...

EQFABRIC_INL uint64_t	getMinimumCapabilities () const

EQFABRIC_INL void	setMaximumCapabilities (const uint64_t bitmask)
	Set the maximum desired capabilities for this view. More...

EQFABRIC_INL uint64_t	getMaximumCapabilities () const

EQFABRIC_INL uint64_t	getCapabilities () const

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

virtual EQFABRIC_API uint128_t	commit (const uint32_t incarnation=CO_COMMIT_NEXT)

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

EQFABRIC_API const std::string &	getName () const

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

EQFABRIC_API co::Object *	getUserData ()

EQFABRIC_API const co::Object *	getUserData () const

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

EQFABRIC_API uint32_t	getSerial () const

Public Member Functions inherited from eq::fabric::Frustum
EQFABRIC_API	Frustum ()
	Construct a new frustum. More...

virtual EQFABRIC_API	~Frustum ()
	Destruct the frustum. More...

EQFABRIC_API void	setWall (const Wall &wall)
	Set the frustum using a wall description. More...

EQFABRIC_API void	setProjection (const Projection &projection)
	Set the frustum using a projection description. More...

const Wall &	getWall () const

const Projection &	getProjection () const

Type	getCurrentType () const

EQFABRIC_API void	unsetFrustum ()
	Set the last specified frustum to TYPE_NONE. More...

EQFABRIC_API void	serialize (co::DataOStream &os)

EQFABRIC_API void	deserialize (co::DataIStream &is)

Protected Member Functions
virtual EQ_API void	deserialize (co::DataIStream &is, const uint64_t dirtyBits)

EQ_API const Frustum &	getBaseFrustum () const

virtual EQ_API void	detach ()

Protected Member Functions inherited from eq::fabric::View< Layout, View, Observer >
EQFABRIC_INL	View (Layout *layout)

virtual bool	hasMasterUserData ()
	The application view instance holds the user data master by default. More...

virtual EQFABRIC_INL uint32_t	getUserDataLatency () const
	The view user data instance uses the config latency by default. More...

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

virtual EQFABRIC_INL void	setDirty (const uint64_t bits)

void	setSAttribute (const SAttribute attr, const std::string &value)

virtual uint64_t	getRedistributableBits () const

virtual void	notifyFrustumChanged ()

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

EQFABRIC_API	Object (const Object &)
	Construct an unmapped, unregistered copy of an object. More...

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

EQFABRIC_API Object &	operator= (const Object &from)
	NOP assignment operator. More...

EQFABRIC_API void	setTasks (const uint32_t tasks)

virtual EQFABRIC_API void	notifyDetach ()

EQFABRIC_API void	postRemove (Object *child)

virtual void	removeChild (const uint128_t &)

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)

EQFABRIC_API bool	_cmdSync (co::ICommand &command)

Protected Member Functions inherited from eq::fabric::Frustum
virtual void	updateFrustum ()

Friends
class	Pipe

Callbacks
Callbacks are called by Equalizer during rendering to execute various actions from the application main thread before sending the corresponding command to the server.
class	detail::InitVisitor

class	detail::ExitVisitor

virtual bool	configInit ()
	Initialize this view. More...

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

Additional Inherited Members
Public Types inherited from eq::fabric::View< Layout, View, Observer >
enum	Mode
	The current rendering mode. More...

enum	DirtyBits

enum	SAttribute
	String attributes. More...

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

Public Types inherited from eq::fabric::Frustum
enum	Type { TYPE_NONE, TYPE_WALL, TYPE_PROJECTION }
	The type of the last specified frustum. More...

Static Public Member Functions inherited from eq::fabric::View< Layout, View, Observer >
static EQFABRIC_INL const std::string &	getSAttributeString (const SAttribute attr)

Detailed Description

A View is a 2D area of a Layout.

It is a view of the application's data on a model, in the sense used by the MVC pattern. It can be a scene, viewing mode, viewing position, or any other representation of the application's data.

Warning: Never commit a View. Equalizer does take care of this to correctly associate view version with rendering frames.

See also: fabric::View

Definition at line 42 of file view.h.

Constructor & Destructor Documentation

EQ_API eq::View::View ( Layout * parent )

explicit

Construct a new view.

Version: 1.0

virtual EQ_API eq::View::~View ( )

virtual

Destruct this view.

Version: 1.0

Reimplemented from eq::fabric::View< Layout, View, Observer >.

Member Function Documentation

virtual bool eq::View::configExit ( )

inlineprotectedvirtual

Exit this view.

Version: 1.11

Definition at line 105 of file view.h.

virtual bool eq::View::configInit ( )

inlineprotectedvirtual

Initialize this view.

Version: 1.11

Definition at line 101 of file view.h.

EQ_API const Frustum& eq::View::getBaseFrustum ( ) const

protected

Returns: the initial frustum value of this view.

EQ_API Config* eq::View::getConfig ( )

Returns: the config of this view.

Version: 1.0

EQ_API const Config* eq::View::getConfig ( ) const

Returns: the config of this view.

Version: 1.0

Pipe* eq::View::getPipe ( )

inline

Returns: the parent pipe of this view, 0 for non-render client views.

Version: 1.1.2

Definition at line 57 of file view.h.

EQ_API const Pipe* eq::View::getPipe ( ) const

inline

Returns: the parent pipe of this view, 0 for non-render client views.

Version: 1.1.2

Definition at line 63 of file view.h.

EQ_API ServerPtr eq::View::getServer ( )

Returns: the Server of this view.

Version: 1.0

virtual EQ_API bool eq::View::handleEvent ( const Event & event )

virtual

Handle a received (view) event.

The task of this method is to update the view as necessary. It is called by Config::handleEvent on the application main thread for all view events. Thread safe.

Parameters

event the received view event.

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

Version: 1.0

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

view.h

Public Member Functions

Protected Member Functions

Friends

Callbacks

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation