Equalizer  1.12.0
Parallel Rendering Framework
eq::Client Class Reference

The client represents a network node of the application in the cluster. More...

#include <client.h>

+ Inheritance diagram for eq::Client:
+ Collaboration diagram for eq::Client:

Public Member Functions

EQ_API Client ()
 Construct a new client. More...
 
EQ_API bool connectServer (ServerPtr server)
 Open and connect an Equalizer server to the local client. More...
 
EQ_API bool disconnectServer (ServerPtr server)
 Disconnect and close the connection to an Equalizer server. More...
 
EQ_API bool initLocal (const int argc, char **argv) override
 Initialize a local, listening node. More...
 
EQ_API bool exitLocal () override
 De-initialize a local, listening node. More...
 
EQ_API bool hasCommands ()
 
EQ_API bool isRunning () const
 
EQ_API co::CommandQueue * getMainThreadQueue () override
 
void interruptMainThread ()
 Experimental: interrupt main thread queue.
 
Data Access
EQ_API void setName (const std::string &name)
 Set the name of the configuration. More...
 
EQ_API const std::string & getName () const
 
EQ_API void addActiveLayout (const std::string &activeLayout)
 Add an active layout programmatically, like –eq-layout does. More...
 
const Strings & getActiveLayouts () const
 
const std::string & getGPUFilter () const
 
float getModelUnit () const
 
- Public Member Functions inherited from eq::fabric::Client
EQFABRIC_API bool connectServer (co::NodePtr server)
 Open and connect an Equalizer server to the local client. More...
 
EQFABRIC_API bool disconnectServer (co::NodePtr server)
 Disconnect and close the connection to an Equalizer server. More...
 
EQFABRIC_API void processCommand (const uint32_t timeout=LB_TIMEOUT_INDEFINITE)
 Get and process one pending command from the node command queue. More...
 
virtual EQFABRIC_API bool dispatchCommand (co::ICommand &command)
 

Protected Member Functions

virtual EQ_API ~Client ()
 Destruct the client. More...
 
virtual EQ_API void clientLoop ()
 Implements the processing loop for render clients. More...
 
virtual EQ_API void exitClient ()
 Exit the process cleanly on render clients. More...
 
- Protected Member Functions inherited from eq::fabric::Client
EQFABRIC_API Client ()
 Construct a new client.
 

Detailed Description

The client represents a network node of the application in the cluster.

The methods initLocal() and exitLocal() should be used to set up and exit the listening node instance for each application process.

See also
fabric::Client for public methods

Definition at line 39 of file client.h.

Constructor & Destructor Documentation

EQ_API eq::Client::Client ( )

Construct a new client.

Version
1.0
virtual EQ_API eq::Client::~Client ( )
protectedvirtual

Destruct the client.

Version
1.0

Reimplemented from eq::fabric::Client.

Member Function Documentation

EQ_API void eq::Client::addActiveLayout ( const std::string &  activeLayout)

Add an active layout programmatically, like –eq-layout does.

Version
1.9
virtual EQ_API void eq::Client::clientLoop ( )
protectedvirtual

Implements the processing loop for render clients.

As long as the node is running, that is, between initLocal() and an exit send from the server, this method executes received commands using processCommand() and triggers the message pump between commands. This default implementation performs 'while( isRunning( )) processCommand();'.

See also
Pipe::createMessagePump(), isRunning(), processCommand()
Version
1.0
EQ_API bool eq::Client::connectServer ( ServerPtr  server)

Open and connect an Equalizer server to the local client.

The client has to be in the listening state, see initLocal(). Not thread safe.

Parameters
serverthe server.
Returns
true if the server was connected, false if not.
Version
1.0
EQ_API bool eq::Client::disconnectServer ( ServerPtr  server)

Disconnect and close the connection to an Equalizer server.

Not thread safe.

Parameters
serverthe server.
Returns
true if the server was disconnected, false if not.
Version
1.0
virtual EQ_API void eq::Client::exitClient ( )
protectedvirtual

Exit the process cleanly on render clients.

Version
1.0
EQ_API bool eq::Client::exitLocal ( )
override

De-initialize a local, listening node.

Version
1.1.6
EQ_API co::CommandQueue* eq::Client::getMainThreadQueue ( )
overridevirtual
Returns
the command queue to the main node thread.

Implements eq::fabric::Client.

EQ_API const std::string& eq::Client::getName ( ) const
Returns
the name of the configuration.
Version
1.10
EQ_API bool eq::Client::hasCommands ( )
Returns
true if the client has commands pending, false otherwise.
Version
1.0
EQ_API bool eq::Client::initLocal ( const int  argc,
char **  argv 
)
override

Initialize a local, listening node.

The following command line options are recognized by this method:

–eq-client is used for remote nodes which have been auto-launched by another node, e.g., remote render clients. This method does not return when this command line option is present.

–eq-layout can apply multiple times. Each instance has to be followed by the name of a layout. The given layouts will be activated on all canvases using them during Config::init().

–eq-modelunit is used for scaling the rendered models in all views. The model unit defines the size of the model wrt the virtual room unit which is always in meter. The default unit is 1 (1 meter or EQ_M).

Parameters
argcthe command line argument count.
argvthe command line argument values.
Returns
true if the client was successfully initialized, false otherwise.
Version
1.0
EQ_API bool eq::Client::isRunning ( ) const
Returns
true if the clientLoop() should keep running.
Version
1.11
EQ_API void eq::Client::setName ( const std::string &  name)

Set the name of the configuration.

Version
1.10

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