Allolib  1.0
C++ Components For Interactive Multimedia
al::StateReceiveDomain< TSharedState > Class Template Reference
Inheritance diagram for al::StateReceiveDomain< TSharedState >:
al::SynchronousDomain al::ComputationDomain

Public Member Functions

bool init (ComputationDomain *parent=nullptr) override
 initialize More...
 
bool tick () override
 Execute a pass of the domain. More...
 
bool cleanup (ComputationDomain *parent=nullptr) override
 cleanup More...
 
void configure (uint16_t port=10100, std::string id="state", std::string address="0.0.0.0", uint16_t packetSize=1400)
 
std::shared_ptr< TSharedState > state ()
 
void setStatePointer (std::shared_ptr< TSharedState > ptr)
 
void lockState ()
 
void unlockState ()
 
int newStates ()
 
std::string id () const
 
void setId (const std::string &id)
 
template<class DomainType >
std::shared_ptr< DomainType > newSubDomain (bool prepend=false)
 Add a synchronous domain to this domain. More...
 
void removeSubDomain (std::shared_ptr< SynchronousDomain > subDomain)
 Remove a subdomain. More...
 
double timeDelta ()
 Return time delta with respect to previous processing pass for this domain. More...
 
void setTimeDelta (double delta)
 
void registerInitializeCallback (std::function< void(ComputationDomain *)> callback)
 register callbacks to be called in the init() function More...
 
void registerCleanupCallback (std::function< void(ComputationDomain *)> callback)
 register callbacks to be called in the cleanup() function More...
 
std::vector< ParameterMeta * > parameters ()
 Return a list of parameters that control this domain. More...
 

Protected Member Functions

bool initializeSubdomains (bool pre=false)
 initializeSubdomains should be called within the domain's initialization function More...
 
bool tickSubdomains (bool pre=false)
 execute subdomains More...
 
bool cleanupSubdomains (bool pre=false)
 cleanup subdomains More...
 
void callInitializeCallbacks ()
 callInitializeCallbacks should be called by children of this class after the domain has been initialized
 
void callCleanupCallbacks ()
 callInitializeCallbacks should be called by children of this class before the domain has been cleaned up
 

Protected Attributes

std::shared_ptr< TSharedState > mState
 
int mQueuedStates {1}
 
std::string mAddress {"localhost"}
 
uint16_t mPort = 10100
 
uint16_t mPacketSize = 1400
 
std::mutex mSubdomainLock
 
double mTimeDrift {0.0}
 
std::vector< std::pair< std::shared_ptr< SynchronousDomain >, bool > > mSubDomainList
 
std::vector< ParameterMeta * > mParameters
 

Detailed Description

template<class TSharedState = DefaultState>
class al::StateReceiveDomain< TSharedState >

Definition at line 64 of file al_StateDistributionDomain.hpp.

Member Function Documentation

◆ cleanup()

template<class TSharedState = DefaultState>
bool al::StateReceiveDomain< TSharedState >::cleanup ( ComputationDomain parent = nullptr)
inlineoverridevirtual

cleanup

Parameters
parent
Returns
true if cleanup succesfull

Reimplemented from al::ComputationDomain.

Definition at line 83 of file al_StateDistributionDomain.hpp.

◆ cleanupSubdomains()

bool al::ComputationDomain::cleanupSubdomains ( bool  pre = false)
protectedinherited

cleanup subdomains

Parameters
precleanup prepended domains if true, otherwise appended domains.
Returns
true if all cleanup sucessful.

You must call this function twice: once for prepended and then for appended domains.

◆ init()

template<class TSharedState >
bool al::StateReceiveDomain< TSharedState >::init ( ComputationDomain parent = nullptr)
overridevirtual

initialize

Parameters
parent
Returns
true if init succeeded

Multiple calls to init() should be allowed.

Reimplemented from al::ComputationDomain.

Definition at line 155 of file al_StateDistributionDomain.hpp.

◆ initializeSubdomains()

bool al::ComputationDomain::initializeSubdomains ( bool  pre = false)
protectedinherited

initializeSubdomains should be called within the domain's initialization function

Parameters
preinitialize prepended domains if true, otherwise appended domains.
Returns
true if all initializations sucessful.

You must call this function twice: once for prepended and then for appended domains.

◆ newSubDomain()

template<class DomainType >
std::shared_ptr< DomainType > al::ComputationDomain::newSubDomain ( bool  prepend = false)
inherited

Add a synchronous domain to this domain.

Parameters
prependDetermines whether the sub-domain should run before or after this domain
Returns
the created domain.

The domain specified by DomainType must inherit from SynchronousDomian. It will trigger an assertion if not (will have undefined behavior for Release builds) This operation is thread safe if the domain can pause itself, but it is blocking, so there are no guarantees that it will not interefere with the timely running of the domain.

Definition at line 218 of file al_ComputationDomain.hpp.

◆ parameters()

std::vector<ParameterMeta *> al::ComputationDomain::parameters ( )
inlineinherited

Return a list of parameters that control this domain.

Returns
list of parameters

The parameters provided here provide runtime "continuous" parameters, for example like audio gain or eye separation. There should be a clear distinction between values that need to be set on domain intialization that must remain immutable during domain operation and parameters provided here that provide continuous adjustment to the domain's operation.

Definition at line 104 of file al_ComputationDomain.hpp.

◆ registerCleanupCallback()

void al::ComputationDomain::registerCleanupCallback ( std::function< void(ComputationDomain *)>  callback)
inherited

register callbacks to be called in the cleanup() function

Parameters
callback

◆ registerInitializeCallback()

void al::ComputationDomain::registerInitializeCallback ( std::function< void(ComputationDomain *)>  callback)
inherited

register callbacks to be called in the init() function

Parameters
callback

◆ removeSubDomain()

void al::ComputationDomain::removeSubDomain ( std::shared_ptr< SynchronousDomain subDomain)
inherited

Remove a subdomain.

Parameters
subDomainThis operation is thread safe, but it might block causing drops or missed deadlines for the parent domain. If this is a problem, the domain should be stopped prior to adding/removeing sub-domains.

◆ tick()

template<class TSharedState = DefaultState>
bool al::StateReceiveDomain< TSharedState >::tick ( )
inlineoverridevirtual

Execute a pass of the domain.

Returns
true if execution of the domain succeeded

Reimplemented from al::SynchronousDomain.

Definition at line 68 of file al_StateDistributionDomain.hpp.

◆ tickSubdomains()

bool al::ComputationDomain::tickSubdomains ( bool  pre = false)
protectedinherited

execute subdomains

Parameters
preexecute prepended domains if true, otherwise appended domains.
Returns
true if all execution sucessful.

You must call this function twice: once for prepended and then for appended domains.

◆ timeDelta()

double al::ComputationDomain::timeDelta ( )
inlineinherited

Return time delta with respect to previous processing pass for this domain.

Returns
time delta

The time delta may be set internally by the domain so that it is available whenever the domain ticks. It might be 0 for domains that don't support this functionality or that are tied to strict hardware clocks where this information is not necessary

Definition at line 75 of file al_ComputationDomain.hpp.


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