Trace module

Classes
class	OMK::TracerIdTmp
	A class to activate temporarily an id. More...
class	LogOutput
	The output used to put the trace in the Ogre log. More...
Flags which enable/disable the specific warnings.
#define	OMK_DEBUG_WARNING   "WARNING"
	id for traces for warnings.
#define	OMK_DEBUG_FATAL_ERROR   "FATAL ERROR"
	id for traces for errors.
#define	OMK_DEBUG_ERROR   "ERROR"
	id for traces for errors.
#define	OMK_DEBUG_MESSAGE   "MESSAGE"
	id for traces for messages.
#define	OMK_DEBUG_OMK   "Kernel"
	id for traces of the kernel.
#define	OMK_DEBUG_OMK_EXEC   "Kernel:Stack"
	id for call stack traces of the kernel.
#define	OMK_DEBUG_OMK_OBJ   "Kernel:Object"
	id for object creation and configuration traces.
#define	OMK_DEBUG_OMK_POL   "Kernel:Polator"
	id for polator traces.
#define	OMK_DEBUG_OMK_NAME   "Kernel:Name"
	id of name server traces.
#define	OMK_DEBUG_OMK_EVENT   "Kernel:Event"
	id for event traces of the kernel.
#define	OMK_DEBUG_OMK_MULTI   "Kernel:Multi"
	id for multi-process traces.
#define	OMK_DEBUG_OMK_EXT   "Kernel:Extension"
	id for traces of the extension.
#define	OMK_DEBUG_OMK_ATTR   "Kernel:Attribute"
	id for traces of the attribute.
#define	OMK_DEBUG_OMK_TYPE   "Kernel:Type"
	id for traces of the type.
#define	OMK_DEBUG_INP_EXT   "Input:Extension"
	id for traces of the Input_Extension.
#define	OMK_DEBUG_VIS   "Vis"
	id for traces of the visualisation.
#define	OMK_DEBUG_VIS_EXEC   "Vis:Stack"
	id for call stack traces of the visualisation.
#define	OMK_DEBUG_III   "Iii"
	id for vis traces.
#define	OMK_DEBUG_INP   "Inp"
	id for traces of the inputs.
#define	OMK_DEBUG_PVM   "PVM"
	id for traces for PVM Can be used with OMTRACEID, see How to choose which messages to display.
Defines
#define	OMERROR(X)   TRACE( OMK_DEBUG_ERROR, X )
	Define the OMERROR macro.
#define	OMMESSAGE(X)   TRACE( OMK_DEBUG_MESSAGE, X )
	Define the OMMESSAGE macro.
#define	OMFATALERROR(X)
	Define the OMFATALERROR macro.
#define	OMTRACE(X)   TRACE( OMK_DEBUG_WARNING, X )
	Define the OMTRACE macro.
#define	OMTRACEID(ID, X)   TRACE( ID, X )
	Define the OMTRACEM macro.
#define	OMASSERT(X)
	Define the OMASSERT macro.
#define	OMASSERTM(TEST, X)
	Define the OMASSERTM macro.

---

Detailed Description

The available macros to display messages

This module defines the items to trace the code execution. You can use the following macros to output messages:

• OMTRACE, use it for warning messages
• OMTRACEID, use it for specific warning messages, see below How to choose which messages to display
• OMASSERT, use it for assertion without message
• OMASSERTM, use it for assertion with message
• OMERROR, use it for error messages, cannot be disabled
• OMMESSAGE, use it for information messages, cannot be disabled

Legends:

• These macros are disabled if the flag NDEBUG is defined.
  In this case, all the trace codes are ignored, this increases the speed of the simulation.
• These macros are always defined

How to choose which messages to display

The macro OMTRACEID, must be use in most of the case, because it uses an id, this id allows to show or hide the corresponding messages dynamically. It is very usefull to display only the messages you want to see.

The controller has 3 configuration fields:

• TraceIds which allows to define the traces that you want to see.
• TraceAll if you wants all the traces or only those which are defined in TracedIds.
• TraceFile if you wants to get the traces in a file.

#OpenMASK3
root 
{
  Class Controller
  UserParams
  {
    TraceFile "trace.txt"
    TraceAll false // true : All traces are displayed
                   // false : Only the registered ids will be displayed
    TraceIds ["Kernel" "Kernel:Extension"] // All the texts of the ids you want to see
  }
  ...
}

The ids are defined in the file "Tracer.h"

The following table shows some of the flags you can activate.

Id	Text
Kernel
OM_DEBUG_OMK	Kernel
OM_DEBUG_OMK_EXEC	Kernel:Stack
OM_DEBUG_OMK_OBJ	Kernel:Object
OM_DEBUG_OMK_EVENT	Kernel:Event
OM_DEBUG_OMK_MULTI	Kernel:Multi
OM_DEBUG_OMK_EXT	Kernel:Extension
OM_DEBUG_OMK_ATTR	Kernel:Attribute
OM_DEBUG_OMK_TYPE	Kernel:Type
Interaction
OM_DEBUG_III	Iii
Visualisation
OM_DEBUG_VIS	Vis
OM_DEBUG_VIS_EXEC	Vis:Stack
Inputs
OM_DEBUG_INP	Inp

How to define your own message family

You can define your own id, it is only a string. You should define your string in a global constant, like it is done for OM_DEBUG_OMK for example.

Declare the id:

// id for my traces.
#define OM_DEBUG_MINE "Mine" 

in your code, use:

OMTRACEID( OM_DEBUG_MINE, "Hello, I'm here !" ) ;

to display the message in the cerr, the id must be registered in the Tracer.
there is two ways:

• add this line in your code

  OM::Tracer::registerId( OM_DEBUG_MINE ) ;
  

• or let the controller do the job, add the id in the configuration file

  #OpenMASK3
  root 
  {
          Class Controller
    UserParams
    {
      TracedIds ["Mine"]
    }
    ...
  }
  

and the result in the log will be:

[OMK:Mine] in FileName@LineNumber
Hello, I'm here !

---

Define Documentation

#define OMASSERT

(

X

)

Value:

if( !(X) ) \
{ \
        std::ostringstream msgForDebugASSERT ; \
        msgForDebugASSERT << #X ; \
        OMTRACEID( OMK_DEBUG_FATAL_ERROR, msgForDebugASSERT.str() ) ; \
  throw OMK::Exception( msgForDebugASSERT.str().c_str() ) ; \
}

Define the OMASSERT macro.

This macro has the standard behaviour of an assertion macro, if the assertion fails it displays a error message and goes out of the program.

Because a constant string is always evaluated as true, the macro can be used like this to help the user to know more details about the assertion error:

 void func( MyClass* aPointer )
 {
   OMASSERT( ( !aPointer || aPointer->isValid() ) && "the object cannot be not null and invalid" ) ;
   //...
 } 

If the assertion fails, it will display the message:

 [OMK:FATAL ERROR] in FileName@LineNumber
 ( !aPointer || aPointer-isValid() ) && "the object cannot be null or invalid"

Define NDEBUG to suppress assertions.

Definition at line 320 of file OMKTracer.h.

Referenced by OMK::SimulatedObject::addControlParameter(), OMK::ObjectDescriptor::addSon(), OMK::OutputAlias< T >::alias(), OMK::Vis::AnimatorInputPlugT< T >::AnimatorInputPlugT(), OMK::Vis::AnimatorT< T >::AnimatorT(), OMK::MultipleConfigurationParameter::appendSubDescriptor(), OMK::MultipleConfigurationParameter::appendSubDescriptorNamed(), OMK::MultipleConfigurationParameter::appendSubDescriptorsOf(), OMK::PvmSvm::broadcastToGroup(), OMK::SimulatedObject::cancelRegistrationForSignalBy(), OMK::Controller::changeObjectsFather(), OMK::PvmOutgoingMessage::checkForChangedBuffer(), OMK::PvmIncomingMessage::checkForGetErrors(), OMK::PvmOutgoingMessage::checkForPackErrors(), OMK::PvmOutgoingMessage::checkForSendErrors(), OMK::Controller::computeScheduling(), OMK::Iii::SimpleConnectorT< Type >::connect(), OMK::Output< T >::connectedMyself(), OMK::Controller::Controller(), OMK::Controller::createControlledObjects(), OMK::Controller::createReferenceObject(), OMK::ObjectDescriptor::deleteCachedData(), OMK::Controller::deleteObject(), OMK::Controller::destroyObject(), OMK::Controller::finish(), OMK::Output< T >::get(), OMK::PvmNameServer::getIdentifierAsFrom(), OMK::IncomingSynchronisationMessage::getInputStream(), OMK::MultipleConfigurationParameter::getNameOfSubDescriptor(), OMK::PvmNameServer::getStringAssociatedToOnCentralServer(), OMK::MultipleConfigurationParameter::getSubDescriptorByName(), OMK::MultipleConfigurationParameter::getSubDescriptorByPosition(), OMK::PvmSvm::groupBarrier(), OMK::Controller::hasEventsToProcess(), OMK::Vis::SwitchAnimator::init(), OMK::PvmSvm::initBeforeMessagePacking(), OMK::Inp::InputExtension::initOIS(), OMK::Inp::InputListener::InputListener(), OMK::ObjectDescriptor::interpretConfigurationParameterAsObjectDescription(), OMK::PvmSvm::joinSvmGroup(), OMK::SimulatedObject::listBrothersOfType(), OMK::Name::Name(), OMK::Controller::noActivationNeededFor(), OMK::PvmSvm::nonblockingReceive(), OMK::ObjectDescriptor::ObjectDescriptor(), operator<<(), OMK::OutputAlias< T >::OutputAlias(), OMK::UniqueConfigurationParameter::pack(), OMK::SimulatedObject::pack(), OMK::SimulatedObject::packAllValues(), OMK::Type::Polator< T >::polate(), OMK::InputConnectionEventListener< T >::processEvent(), OMK::Controller::processEvent(), OMK::Controller::processNewObjectDeclaration(), OMK::PvmCentralNameServer::PvmCentralNameServer(), OMK::PvmNameServer::PvmNameServer(), OMK::Controller::reactToControlledObjectsSystemEvents(), OMK::Inp::DistributedCameraListener::readConfigurationParameters(), OMK::SimulatedObject::registerEventListenerForEvent(), OMK::Vis::VisBase::registerEventPlug(), OMK::SimulatedObject::registerForSignalBy(), OMK::MultipleConfigurationParameter::replaceSubDescriptor(), OMK::MultipleConfigurationParameter::replaceSubDescriptorNamed(), OMK::Controller::run(), OMK::Controller::runControllersStep(), OMK::SimulatedObject::sendEvent(), OMK::Vis::AnimatorEventPlugT< T >::setEvent(), OMK::ObjectDescriptor::setFathersDescription(), OMK::PvmSvmLink::testForAnyMessage(), OMK::UniqueConfigurationParameter::unpack(), OMK::SimulatedObject::unpack(), OMK::SimulatedObject::unpackAllValues(), OMK::SimulatedObject::unregisterEventListener(), OMK::PvmCentralNameServer::verifyCompatibilityWithLocalNameServer(), and OMK::PvmSvm::waitForAnyRequests().

#define OMASSERTM	(	TEST,
		X		)

Value:

if( !(TEST) ) \
{ \
        std::ostringstream msgForDebugASSERTM ; \
        msgForDebugASSERTM << #TEST << std::endl << X ; \
        OMTRACEID( OMK_DEBUG_FATAL_ERROR, msgForDebugASSERTM.str() ) ; \
  throw OMK::Exception( msgForDebugASSERTM.str().c_str() ) ; \
}

Define the OMASSERTM macro.

This macro defines an assertion macro with message, if the assertion fails it displays a error message and goes out of the program.

This macro use stream, so it can be use to concat string in the output stream like the following example:

 void func( int a )
 {
   OMASSERT( ( 0 < a && a < 100 ), "the value must be in [1, 99] and is " << a ) ;
   //...
 } 

If the assertion fails, it will display the message (here a is 20085):

 [OMK:FATAL ERROR] in FileName@LineNumber
 the value must be in [1, 99] and is 20085

Define NDEBUG to suppress assertions.

Definition at line 350 of file OMKTracer.h.

Referenced by OMK::AccessorAccT< Type, AttributType >::AccessorAccT(), OMK::DoubleList::activate(), OMK::Vis::VisBase::addNewVisualObject(), OMK::Name::changeId(), OMK::NameServer::changeNamesId(), OMK::Iii::SessionPrm::create(), OMK::Iii::IConvertorT< TypeOut, TypeIn >::create(), OMK::NameServer::created(), OMK::EventCreator::createEvent(), OMK::IAttributeT< PrmType, ModelType, AccessorType >::createInput(), OMK::Inp::InputExtension::createOISInputSystem(), OMK::Type::NumericPolatorT< Type >::cubicExtrapolate(), OMK::Vis::VisualObject::deleteAnimator(), OMK::NameServer::deleted(), OMK::Vis::VisBase::deleteVisualObject(), OMK::DistributedController::dispatchEvent(), OMK::EventListenerCallBack< CallerClass >::EventListenerCallBack(), OMK::Extension::Extension(), OMK::MirrorObjectHandle::extract(), OMK::Input< T >::extract(), OMK::DoubleList::find(), OMK::DoubleList::findInSuperList(), OMK::Vis::OgreAnimatorCommon::findOgreNode(), OMK::Vis::IMaterialAction::getFirstPassOfFirstTechnique(), OMK::NameServer::getNamesOfId(), OMK::Fifo< T >::getNumberOfPresentValues(), OMK::Fifo< T >::getPreceedingDate(), OMK::Fifo< T >::getPreceedingValue(), OMK::NameServer::getStringAssociatedTo(), OMK::NameServer::getSystemIdentifier(), OMK::Vis::AnimatorInputPlugT< T >::getTypedValue(), OMK::Type::Transform::getUniformScale(), OMK::PluginsLoaderClass::init(), OMK::IAttributeAnimatorT< PrmType, ModelType, AccessorType >::initAnimator(), OMK::DoubleList::insert(), OMK::Input< T >::insertInStream(), OMK::Iii::InteractorOutputT< PrmType, ModelType >::InteractorOutputT(), OMK::Type::NumericPolatorT< Type >::linearExtrapolate(), OMK::Iii::SessionPrm::Link::Link(), OMK::ObjectDescriptor::listDescendantsOfType(), OMK::Vis::VisObjectExtension::loadAnimatorParameters(), OMK::Iii::JointExtension::loadExtensionParameters(), OMK::ExtensionManager::loadOrder(), OMK::IAttributeAnimatorT< PrmType, ModelType, AccessorType >::loadParameters(), OMK::DoubleList::next(), OMK::Type::Polator< T >::polate(), OMK::Iii::JointExtension::postComputeParameters(), OMK::TriggerBaseExtension::preComputeParameters(), OMK::PreOffsetExtension::preComputeParameters(), OMK::Iii::InteractorExtension::processAccessibleParameters(), OMK::Vis::VisBase::processAddAnimatorEvent(), OMK::Vis::VisBase::processAddVisualObjectEvent(), OMK::IAttribute::processConnectTo(), OMK::Iii::InteractorExtension::processCurrentValuesSent(), OMK::Vis::VisBase::processDeleteAnimatorEvent(), OMK::Vis::VisBase::processDeleteVisualObjectEvent(), OMK::DistributedController::processEvent(), OMK::DistributedController::processNewObjectDeclaration(), OMK::Vis::Animator::processVis(), OMK::Type::NumericPolatorT< Type >::quadraticExtrapolate(), OMK::DoubleList::remove(), OMK::Vis::TransparencyValueAnimator::selfProcessVis(), OMK::Vis::TransparencyAnimAnimator::selfProcessVis(), OMK::Iii::SessionPrm::SessionPrm(), OMK::AccessorAccT< Type, AttributType >::setAccessor(), OMK::Iii::AccessRule::setCurrentLevel(), OMK::Fifo< T >::setInPlace(), OMK::ReferenceObjectHandle::setMorphosisPhaseTrue(), OMK::IAttribute::setOwner(), OMK::Type::Transform::setScale(), OMK::Type::Transform::setUniformScale(), OMK::IAttributeAnimatorT< PrmType, ModelType, AccessorType >::setValueToOutput(), OMK::DoubleList::superListNext(), OMK::Type::Transform::Transform(), OMK::Vis::AwarenessColorAnimator::update(), OMK::Vis::AwarenessAnimator< Type >::update(), and OMK::ValuedEventListenerCallBack< CallerClass, PrmType >::ValuedEventListenerCallBack().

#define OMERROR

(

X

)

TRACE( OMK_DEBUG_ERROR, X )

Define the OMERROR macro.

This macro has the standard behaviour of an trace macro, it displays a information message. This macro use stream, so it can be use to concat string in the output stream like the following example:

 int aNumber = 150 ;
 OMERROR( "The value is " << aNumber ) ;

it will display:

 [OMK:WARNING] in FileName@LineNumber
 The value is 150

Definition at line 195 of file OMKTracer.h.

Referenced by OMK::SimulatedObject::addInputAlias(), OMK::SimulatedObject::addOutputAlias(), OMK::SimulatedObject::addSensitiveInputAlias(), OMK::SimulatedObject::addSensitiveNotifyingInputAlias(), OMK::MKMHumano::computeParameters(), OMK::Input< T >::connect(), OMK::AbstractInput< Type >::connect(), OMK::Input< T >::connectToControlParameter(), OMK::AbstractInput< Type >::connectToControlParameter(), OMK::Controller::Controller(), OMK::Controller::createReferenceObject(), OMK::NameServer::deleted(), OMK::Controller::destroyObject(), OMK::ParametersAccessor::displayError(), OMK::Input< T >::get(), OMK::Input< T >::getDateOfLastExactValue(), OMK::Input< T >::getLastExactValue(), OMK::Type::AddVisualObjectPrm::innerParametersLoader(), OMK::Inp::AddInputListenerPrm::innerParametersLoader(), OMK::Inp::AddInputKeyPrm::innerParametersLoader(), OMK::Type::AddAnimatorPrm::innerParametersLoader(), OMK::InputAlias< OMK::Type::SimpleTypeT< Type > >::InputAlias(), OMK::Inp::PlusMinusExtension< T >::loadExtensionParameters(), OMK::Iii::InteractiveExtension::loadExtensionParameters(), OMK::Vis::OgreVis::loadParameters(), OMK::MultiValuedEventSignalEmitterUtilT< T, ModelType >::loadParametersUtil(), OMK::ValuedEventSignalEmitterUtilT< T, ModelType >::loadParametersUtil(), OMK::Vis::VisualObjectCreator::operator()(), OMK::Iii::InteractorOutputCreator::operator()(), OMK::Inp::InputListenerCreator::operator()(), OMK::Iii::ConnectorCreator::operator()(), OMK::Output< T >::Output(), OMK::ValuedEventListenerCallBack< CallerClass, PrmType >::processEvent(), OMK::Input< T >::realConnect(), OMK::Vis::VisBase::removeEventPlug(), OMK::Iii::SessionPrm::selfControlFreeze(), OMK::Iii::SessionPrm::selfControlUnfreeze(), OMK::Vis::SwitchAnimator::selfProcessVis(), OMK::ParametersAccessor::set(), OMK::Output< T >::set(), OMK::AbstractInput< Type >::setConnectable(), OMK::IAttributeAnimatorT< PrmType, ModelType, AccessorType >::setValueToOutput(), and OMK::ObjectDescriptor::~ObjectDescriptor().

#define OMFATALERROR

(

X

)

Value:

std::ostringstream msgForDebugTrace ; \
msgForDebugTrace << X ; \
TRACE( OMK_DEBUG_FATAL_ERROR, msgForDebugTrace.str() ) ; \
  throw OMK::Exception( msgForDebugTrace.str().c_str() ) ;

Define the OMFATALERROR macro.

This macro displays an information message and throw a Exception. This macro use stream ( << ).

Definition at line 225 of file OMKTracer.h.

Referenced by OMK::Vis::OgreVis::createSceneManager(), OMK::ExtensibleSimulatedObject::init(), OMK::Iii::InteractiveExtension::loadExtensionParameters(), and OMK::Output< T >::Output().

#define OMK_DEBUG_ERROR   "ERROR"

id for traces for errors.

This id is registered by default by the tracer. It is used by OMERROR.

Definition at line 45 of file OMKTracer.h.

Referenced by OMK::Controller::Controller().

#define OMK_DEBUG_FATAL_ERROR   "FATAL ERROR"

id for traces for errors.

This id is registered by default by the tracer. It is used by OMASSERT and OMASSERTM.

Definition at line 41 of file OMKTracer.h.

Referenced by OMK::Controller::Controller().

#define OMK_DEBUG_III   "Iii"

id for vis traces.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 106 of file OMKTracer.h.

Referenced by OMK::Iii::SessionPrm::addControlledConnector(), OMK::Iii::InteractorExtension::closeSessionWith(), OMK::Iii::SharedConnectorT< Type >::connect(), OMK::Iii::SimpleConnectorT< Type >::connect(), OMK::Iii::InteractorOutput::create(), OMK::Iii::SharedConnectorT< Type >::disconnect(), OMK::Iii::SimpleConnectorT< Type >::disconnect(), OMK::Iii::SessionPrm::init(), OMK::Iii::InteractorExtension::InteractorExtension(), OMK::Iii::JointInteractorExtension::loadExtensionParameters(), OMK::Iii::InteractorExtension::loadExtensionParameters(), OMK::Iii::InteractorExtension::processAccessibleParameters(), OMK::Iii::InteractiveExtension::processControlRelease(), OMK::Iii::InteractiveExtension::processControlUnfreeze(), OMK::Iii::SessionPrm::removeControlledConnector(), OMK::Iii::SessionPrm::selfControlRelease(), OMK::Iii::SessionPrm::selfControlTakeOverAndGetCurrentValues(), and OMK::Iii::InteractorExtension::startSessionWith().

#define OMK_DEBUG_INP   "Inp"

id for traces of the inputs.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 110 of file OMKTracer.h.

#define OMK_DEBUG_INP_EXT   "Input:Extension"

id for traces of the Input_Extension.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 94 of file OMKTracer.h.

Referenced by OMK::Inp::InputExtension::addListener(), OMK::Inp::InputExtension::initOIS(), OMK::Inp::InputCreatorListener::processEvent(), and OMK::Inp::InputExtension::removeListener().

#define OMK_DEBUG_MESSAGE   "MESSAGE"

id for traces for messages.

This id is registered by default by the tracer. It is used by OMMESSAGE.

Definition at line 50 of file OMKTracer.h.

Referenced by OMK::Controller::Controller().

#define OMK_DEBUG_OMK   "Kernel"

id for traces of the kernel.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 54 of file OMKTracer.h.

#define OMK_DEBUG_OMK_ATTR   "Kernel:Attribute"

id for traces of the attribute.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 86 of file OMKTracer.h.

Referenced by OMK::IAttribute::activateConnectByEvent(), OMK::IAttribute::activateGetByEvent(), OMK::IAttributeT< PrmType, ModelType, AccessorType >::activateSetByEvent(), OMK::IAttributeT< PrmType, ModelType, AccessorType >::activateSetByEventOf(), OMK::ExtensibleSimulatedObject::addAttribute(), OMK::IAttribute::connectTo(), OMK::ExtensibleSimulatedObject::init(), OMK::IAttributeBaseT< PrmType >::loadParameters(), and OMK::ExtensibleSimulatedObject::removeAttribute().

#define OMK_DEBUG_OMK_EVENT   "Kernel:Event"

id for event traces of the kernel.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 74 of file OMKTracer.h.

Referenced by OMK::Controller::broadcastEventsForSignal(), OMK::Controller::hasEventsToProcess(), OMK::Controller::processEventsOfSuspendedObjects(), OMK::Controller::processStartEventOf(), OMK::Controller::reactToControlledObjectsSystemEvents(), OMK::ReferenceObjectHandle::receiveEvent(), OMK::Controller::receiveRegistrationForSignal(), OMK::SimulatedObject::sendEvent(), OMK::MultiValuedEventSignalEmitterUtilT< T, ModelType >::sendUtil(), and OMK::ValuedEventSignalEmitterUtilT< T, ModelType >::sendUtil().

#define OMK_DEBUG_OMK_EXEC   "Kernel:Stack"

id for call stack traces of the kernel.

Can be used with OMTRACEID, see How to choose which messages to display, see How to choose which messages to display.

Definition at line 58 of file OMKTracer.h.

Referenced by OMK::SimulatedObject::addControlParameter(), OMK::SimulatedObject::addInput(), OMK::SimulatedObject::addInputAlias(), OMK::SimulatedObject::addOutput(), OMK::SimulatedObject::addOutputAlias(), OMK::SimulatedObject::addSensitiveInput(), OMK::SimulatedObject::addSensitiveInputAlias(), OMK::SimulatedObject::addSensitiveNotifyingInput(), OMK::SimulatedObject::addSensitiveNotifyingInputAlias(), OMK::Controller::addToPendingEvents(), OMK::FrameScheduler::addToScheduable(), OMK::Controller::changeObjectsFather(), OMK::ReferenceObjectHandle::compute(), OMK::Controller::computeNextSimulationStep(), OMK::Controller::computeScheduling(), OMK::OutputNT::connect(), OMK::ExtensionManager::createAndAddExtension(), OMK::Controller::deleteObject(), OMK::Controller::deleteObjectHandle(), OMK::Controller::finish(), OMK::FrameScheduler::FrameScheduler(), OMK::SimulatedObject::getPointerToOutputNamed(), OMK::ReferenceObjectHandle::init(), OMK::Controller::processDeleteEventOf(), OMK::Controller::processEvent(), OMK::ReferenceObjectHandle::processEvents(), OMK::Controller::purgeMemoryFromOldEvents(), OMK::Controller::reactToControlledObjectsSystemEvents(), OMK::ExtensionManager::removeExtension(), OMK::FrameScheduler::removeFromScheduable(), OMK::Controller::runControllersStep(), OMK::FrameScheduler::runStep(), OMK::FrameScheduler::schedule(), OMK::Controller::sendInitialEventsTo(), OMK::FrameScheduler::unschedule(), and OMK::SimulatedObject::~SimulatedObject().

#define OMK_DEBUG_OMK_EXT   "Kernel:Extension"

id for traces of the extension.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 82 of file OMKTracer.h.

Referenced by OMK::ExtensionManager::addExtension(), OMK::ExtensionManager::createAndAddExtension(), OMK::ExtensionT< SimulatedObjectType >::ExtensionT(), OMK::ExtensionManager::getExtension(), OMK::ExtensionManager::getExtensionT(), and OMK::ExtensionManager::removeExtension().

#define OMK_DEBUG_OMK_MULTI   "Kernel:Multi"

id for multi-process traces.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 78 of file OMKTracer.h.

Referenced by OMK::SimulatedObject::extract(), OMK::SimulatedObject::insertInStream(), OMK::SimulatedObject::pack(), OMK::SimulatedObject::packAllValues(), OMK::SimulatedObject::unpack(), and OMK::SimulatedObject::unpackAllValues().

#define OMK_DEBUG_OMK_NAME   "Kernel:Name"

id of name server traces.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 70 of file OMKTracer.h.

Referenced by OMK::Name::getString(), OMK::NameServer::includes(), and OMK::Name::Name().

#define OMK_DEBUG_OMK_OBJ   "Kernel:Object"

id for object creation and configuration traces.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 62 of file OMKTracer.h.

Referenced by OMK::ObjectDescriptor::addSon(), OMK::MultipleConfigurationParameter::appendSubDescriptorsOf(), OMK::Controller::createControlledObjects(), OMK::ObjectDescriptor::createDescribedObject(), OMK::Controller::createReferenceObject(), OMK::Controller::createReferenceObjectHandle(), OMK::ParametersAccessor::displayError(), OMK::ObjectDescriptor::setFathersDescription(), and OMK::ObjectDescriptor::~ObjectDescriptor().

#define OMK_DEBUG_OMK_POL   "Kernel:Polator"

id for polator traces.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 66 of file OMKTracer.h.

Referenced by OMK::Type::Polator< T >::antepolate(), OMK::Type::Polator< T >::extrapolate(), OMK::Type::Polator< T >::getDate(), OMK::Type::Polator< T >::getNumberOfPresentValues(), OMK::Type::Polator< T >::interpolate(), OMK::Output< T >::Output(), OMK::Type::Polator< T >::polate(), OMK::Type::Polator< T >::Polator(), and OMK::Type::Polator< T >::setFifo().

#define OMK_DEBUG_OMK_TYPE   "Kernel:Type"

id for traces of the type.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 90 of file OMKTracer.h.

Referenced by OMK::Type::NumericPolatorT< Type >::antepolate(), OMK::Type::ColorPolator::antepolate(), OMK::Input< T >::connect(), OMK::Input< T >::connectToControlParameter(), OMK::Type::NumericPolatorT< Type >::extrapolate(), OMK::Type::ColorPolator::extrapolate(), OMK::Input< T >::get(), OMK::Type::NumericPolatorT< Type >::interpolate(), OMK::Type::ColorPolator::interpolate(), and OMK::Type::Transform::updateFlags().

#define OMK_DEBUG_PVM   "PVM"

id for traces for PVM Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 114 of file OMKTracer.h.

Referenced by OMK::ObjectDescriptor::interpretSchedulingParameters().

#define OMK_DEBUG_VIS   "Vis"

id for traces of the visualisation.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 98 of file OMKTracer.h.

Referenced by OMK::Vis::VisBase::createInput(), OMK::Vis::SwitchAnimator::init(), OMK::Vis::OgreObjectScene::loadConfigurationParameters(), OMK::Vis::OgreVis::loadParameters(), OMK::Vis::OgreVis::loadSceneFile(), OMK::Vis::OgreAnimatorCommon::OgreAnimatorCommon(), and OMK::Vis::VisualObject::readConfigurationParameters().

#define OMK_DEBUG_VIS_EXEC   "Vis:Stack"

id for call stack traces of the visualisation.

Can be used with OMTRACEID, see How to choose which messages to display.

Definition at line 102 of file OMKTracer.h.

Referenced by OMK::Vis::Animator::Animator(), OMK::Vis::VisualObject::deleteAnimator(), OMK::Vis::VisBase::deleteVisualObject(), OMK::Vis::VisBase::finish(), OMK::Vis::VisObjectExtension::loadAnimatorParameters(), OMK::Vis::OgreObjectScene::loadConfigurationParameters(), OMK::Vis::OgreObjectScene::loadGeometry(), OMK::Vis::VisObjectExtension::loadObjectParameters(), OMK::Vis::VisBase::processAddAnimatorEvent(), OMK::Vis::VisBase::processAddVisualObjectEvent(), OMK::Vis::VisBase::processEvent(), OMK::Vis::VisualObject::VisualObject(), OMK::Vis::Animator::~Animator(), and OMK::Vis::VisualObject::~VisualObject().

#define OMK_DEBUG_WARNING   "WARNING"

id for traces for warnings.

This id is registered by default by the tracer. It is used by OMTRACE.

Definition at line 36 of file OMKTracer.h.

Referenced by OMK::Controller::Controller().

#define OMMESSAGE

(

X

)

TRACE( OMK_DEBUG_MESSAGE, X )

Define the OMMESSAGE macro.

This macro has the standard behaviour of an trace macro, it displays a information message. This macro use stream, so it can be use to concat string in the output stream like the following example:

 int aNumber = 150 ;
 OMMESSAGE( "The value is " << aNumber ) ;

it will display:

 [OMK:MESSAGE] in FileName@LineNumber
 The value is 150

Definition at line 216 of file OMKTracer.h.

Referenced by OMK::Controller::advanceSimulatedDate(), OMK::Controller::computeScheduling(), OMK::PluginsLoaderClass::init(), OMK::Controller::init(), OMK::HumanoRecorder::loadParameters(), OMK::Iii::JointExtension::postComputeParameters(), OMK::InputAlias< T >::printDebuggingInformation(), OMK::Vis::VisBase::processAddVisualObjectEvent(), OMK::Name::setNameServer(), OMK::Iii::JointInteractorExtension::startRetroPropagation(), and OMK::Iii::JointInteractorExtension::stopRetroPropagation().

#define OMTRACE

(

X

)

TRACE( OMK_DEBUG_WARNING, X )

Define the OMTRACE macro.

This macro has the standard behaviour of an trace macro, it displays a information message. This macro use stream, so it can be use to concat string in the output stream like the following example:

 int aNumber = 150 ;
 OMTRACE( "The value is " << aNumber ) ;

it will display:

 [OMK:WARNING] in FileName@LineNumber
 The value is 150

Define NDEBUG to suppress messages.

Definition at line 252 of file OMKTracer.h.

Referenced by OMK::Inp::AddInputListenerPrm::AddInputListenerPrm(), OMK::SimulatedObject::fireSignal(), OMK::MovingHumano::getVisualObjectPrm(), OMK::Inp::AddInputListenerPrm::innerParametersLoader(), OMK::Vis::VisObjectExtension::loadObjectParameters(), OMK::Inp::AddInputListenerPrm::loadParameters(), OMK::Vis::VisBase::processAddVisualObjectEvent(), OMK::Inp::AddInputListenerPrm::resetDefaultValues(), OMK::Svm::serveNameRequestsUntilEnd(), and OMK::Inp::AddInputListenerPrm::~AddInputListenerPrm().

#define OMTRACEID	(	ID,
		X		)	TRACE( ID, X )

Define the OMTRACEM macro.

This macro has the standard behaviour of an trace macro, it displays a information message. This macro use stream, so it can be use to concat string in the output stream like the following example:

 int aNumber = 150 ;
 OMTRACEM( "MY_DEBUG_ID", "The value is " << aNumber ) ;

it will display:

 [OMK:MY_DEBUG_ID] in FileName@LineNumber
 The value is 150

Don't forget to register your id if you want display the messages

 OMK::Tracer::registerId( "MY_DEBUG_ID" ) ;

Define NDEBUG to suppress messages.

Definition at line 279 of file OMKTracer.h.

Referenced by OMK::IAttribute::activateConnectByEvent(), OMK::IAttribute::activateGetByEvent(), OMK::Vis::SubEntityMaterial::activateMaterial(), OMK::IAttributeT< PrmType, ModelType, AccessorType >::activateSetByEvent(), OMK::IAttributeT< PrmType, ModelType, AccessorType >::activateSetByEventOf(), OMK::ExtensibleSimulatedObject::addAttribute(), OMK::Iii::SessionPrm::addControlledConnector(), OMK::SimulatedObject::addControlParameter(), OMK::ExtensionManager::addExtension(), OMK::SimulatedObject::addInput(), OMK::SimulatedObject::addInputAlias(), OMK::Inp::InputExtension::addListener(), OMK::SimulatedObject::addOutput(), OMK::SimulatedObject::addOutputAlias(), OMK::SimulatedObject::addSensitiveInput(), OMK::SimulatedObject::addSensitiveInputAlias(), OMK::SimulatedObject::addSensitiveNotifyingInput(), OMK::SimulatedObject::addSensitiveNotifyingInputAlias(), OMK::ObjectDescriptor::addSon(), OMK::Controller::addToPendingEvents(), OMK::FrameScheduler::addToScheduable(), OMK::Vis::Animator::Animator(), OMK::Type::Polator< T >::antepolate(), OMK::Type::NumericPolatorT< Type >::antepolate(), OMK::Type::ColorPolator::antepolate(), OMK::MultipleConfigurationParameter::appendSubDescriptorsOf(), OMK::Controller::broadcastEventsForSignal(), OMK::PvmMirrorObjectHandle::cancelRegistrationForSignal(), OMK::Controller::changeObjectsFather(), OMK::Iii::InteractorExtension::closeSessionWith(), OMK::ReferenceObjectHandle::compute(), OMK::Controller::computeNextSimulationStep(), OMK::Controller::computeScheduling(), OMK::OutputNT::connect(), OMK::Input< T >::connect(), OMK::Iii::SharedConnectorT< Type >::connect(), OMK::Iii::SimpleConnectorT< Type >::connect(), OMK::IAttribute::connectTo(), OMK::Input< T >::connectToControlParameter(), OMK::Iii::InteractorOutput::create(), OMK::ExtensionManager::createAndAddExtension(), OMK::Controller::createControlledObjects(), OMK::Vis::NodeMaterialOrig::createCopyAndUpdateWith(), OMK::ObjectDescriptor::createDescribedObject(), OMK::Vis::VisBase::createInput(), OMK::Controller::createReferenceObject(), OMK::Controller::createReferenceObjectHandle(), OMK::Vis::VisualObject::deleteAnimator(), OMK::Controller::deleteObject(), OMK::Controller::deleteObjectHandle(), OMK::Vis::VisBase::deleteVisualObject(), OMK::Iii::SharedConnectorT< Type >::disconnect(), OMK::Iii::SimpleConnectorT< Type >::disconnect(), OMK::ParametersAccessor::displayError(), OMK::Vis::MaterialAnimator< Type >::doIt(), OMK::Vis::MaterialRemovePickUDO::entityAction(), OMK::Vis::MaterialAddPickUDO::entityAction(), OMK::Vis::EntityMaterialOrig::EntityMaterialOrig(), OMK::ExtensionT< SimulatedObjectType >::ExtensionT(), OMK::SimulatedObject::extract(), OMK::Type::Polator< T >::extrapolate(), OMK::Type::NumericPolatorT< Type >::extrapolate(), OMK::Type::ColorPolator::extrapolate(), OMK::Vis::VisBase::finish(), OMK::Controller::finish(), OMK::FrameScheduler::FrameScheduler(), OMK::Input< T >::get(), OMK::Type::Polator< T >::getDate(), OMK::ExtensionManager::getExtension(), OMK::ExtensionManager::getExtensionT(), OMK::Type::Polator< T >::getNumberOfPresentValues(), OMK::SimulatedObject::getPointerToOutputNamed(), OMK::Name::getString(), OMK::Controller::hasEventsToProcess(), OMK::NameServer::includes(), OMK::Vis::SwitchAnimator::init(), OMK::Iii::SessionPrm::init(), OMK::ReferenceObjectHandle::init(), OMK::ExtensibleSimulatedObject::init(), OMK::Inp::InputExtension::initOIS(), OMK::SimulatedObject::insertInStream(), OMK::Iii::InteractorExtension::InteractorExtension(), OMK::Type::Polator< T >::interpolate(), OMK::Type::NumericPolatorT< Type >::interpolate(), OMK::Type::ColorPolator::interpolate(), OMK::ObjectDescriptor::interpretSchedulingParameters(), OMK::Vis::VisObjectExtension::loadAnimatorParameters(), OMK::Vis::OgreObjectScene::loadConfigurationParameters(), OMK::Iii::JointInteractorExtension::loadExtensionParameters(), OMK::Iii::InteractorExtension::loadExtensionParameters(), OMK::Vis::OgreObjectScene::loadGeometry(), OMK::Vis::VisObjectExtension::loadObjectParameters(), OMK::Vis::OgreVis::loadParameters(), OMK::IAttributeBaseT< PrmType >::loadParameters(), OMK::Vis::OgreVis::loadSceneFile(), OMK::Name::Name(), OMK::Vis::NodeMaterialOrig::NodeMaterialOrig(), OMK::Vis::OgreAnimatorCommon::OgreAnimatorCommon(), OMK::Output< T >::Output(), OMK::SimulatedObject::pack(), OMK::SimulatedObject::packAllValues(), OMK::Vis::PickUDO::PickUDO(), OMK::Type::Polator< T >::polate(), OMK::Type::Polator< T >::Polator(), OMK::Inp::DistributedCameraOgreListener::postComputeParameters(), OMK::Iii::InteractorExtension::processAccessibleParameters(), OMK::Vis::VisBase::processAddAnimatorEvent(), OMK::Vis::VisBase::processAddVisualObjectEvent(), OMK::Iii::InteractiveExtension::processControlRelease(), OMK::Iii::InteractiveExtension::processControlUnfreeze(), OMK::Controller::processDeleteEventOf(), OMK::Vis::VisBase::processEvent(), OMK::Inp::InputCreatorListener::processEvent(), OMK::Controller::processEvent(), OMK::ReferenceObjectHandle::processEvents(), OMK::Controller::processEventsOfSuspendedObjects(), OMK::Controller::processStartEventOf(), OMK::Controller::purgeMemoryFromOldEvents(), OMK::Controller::reactToControlledObjectsSystemEvents(), OMK::Vis::VisualObject::readConfigurationParameters(), OMK::ReferenceObjectHandle::receiveEvent(), OMK::PvmMirrorObjectHandle::receiveRegistrationForSignal(), OMK::Controller::receiveRegistrationForSignal(), OMK::ExtensibleSimulatedObject::removeAttribute(), OMK::Iii::SessionPrm::removeControlledConnector(), OMK::ExtensionManager::removeExtension(), OMK::FrameScheduler::removeFromScheduable(), OMK::Inp::InputExtension::removeListener(), OMK::Controller::runControllersStep(), OMK::FrameScheduler::runStep(), OMK::FrameScheduler::schedule(), OMK::Iii::SessionPrm::selfControlRelease(), OMK::Iii::SessionPrm::selfControlTakeOverAndGetCurrentValues(), OMK::Vis::MaterialAnimator< Type >::selfProcessVis(), OMK::Vis::AwarenessColorAnimator::selfProcessVis(), OMK::Vis::AwarenessAnimator< Type >::selfProcessVis(), OMK::SimulatedObject::sendEvent(), OMK::Controller::sendInitialEventsTo(), OMK::MultiValuedEventSignalEmitterUtilT< T, ModelType >::sendUtil(), OMK::ValuedEventSignalEmitterUtilT< T, ModelType >::sendUtil(), OMK::Svm::serveNameRequestsUntilEnd(), OMK::ObjectDescriptor::setFathersDescription(), OMK::Type::Polator< T >::setFifo(), OMK::IAttributeAnimatorT< PrmType, ModelType, AccessorType >::setValueToOutput(), OMK::Iii::InteractorExtension::startSessionWith(), OMK::Vis::MaterialSetShader::subEntityAction(), OMK::Vis::SubEntityMaterialOrig::SubEntityMaterialOrig(), OMK::SimulatedObject::unpack(), OMK::PvmReferenceObjectHandle::unpack(), OMK::SimulatedObject::unpackAllValues(), OMK::FrameScheduler::unschedule(), OMK::Vis::NodeMaterialOrig::updateCopyWith(), OMK::Type::Transform::updateFlags(), OMK::Vis::VisualObject::VisualObject(), OMK::Vis::Animator::~Animator(), OMK::MultipleConfigurationParameter::~MultipleConfigurationParameter(), OMK::ObjectDescriptor::~ObjectDescriptor(), OMK::SimulatedObject::~SimulatedObject(), and OMK::Vis::VisualObject::~VisualObject().

---