// In header file
CDPParameterTimer myCDPParameterTimer;

// In Create()
myCDPParameterTimer.Create("MyCDPParameterTimer", this);

// In end of Configure() or Activate()
myCDPParameterTimer.Restart();      // Will start timing from now

// In ProcessSomething()
if (myCDPParameterTimer.TimedOut())
{
  myCDPParameterTimer.Restart();    // Start new timing cycle
  CDPMessage("Will be written every time the period specified in the parameter times out.\n")
}

Member Function Documentation

CDPParameterTimer::CDPParameterTimer()

Default constructs an instance of CDPParameterTimer.

[override virtual] void CDPParameterTimer::Configure(const char *xml)

Reimplemented from CDPObject::Configure().

Configures CDPParameter from an xml-string and sets up the timer.

[override virtual] void CDPParameterTimer::Configure(XMLElementEx *pParameterElement)

Reimplemented from CDPObject::Configure().

Configures CDPParameter from an xml element and sets up the timer.

[override virtual] void CDPParameterTimer::Create(const char *shortName, CDPComponent *pParent)

Reimplemented from CDPObject::Create().

Calls CDPParameter::Create(), m_cTimer.Create() and sets up callback when m_timeoutDelay changes.

CDPParameter::Create() will be called with shortName, while m_cTimer.Create() will be called with shortName+"Timer" (to avoid same name for these objects).

double CDPParameterTimer::Delay()

Returns the delay set by Reset(delay)

double CDPParameterTimer::DeltaTime()

Returns time [s] between last two TimedOut() calls.

[override virtual] void CDPParameterTimer::Destroy()

Reimplemented from CDPBaseObject::Destroy().

Destroys the CDPParameter and timer instance.

[override virtual] void CDPParameterTimer::FillNodeChildren(CDP::StudioAPI::NodeStream &stream) const

Reimplemented from CDPNode::FillNodeChildren().

Writes its CDPSettings to stream.

double CDPParameterTimer::Frequency()

Returns frequency in Hz of time interval between last two TimedOut() calls (equals 1.0/DeltaTime()).

bool CDPParameterTimer::IsRunning()

Returns true if timer is running.

double CDPParameterTimer::LastTime()

Returns time [s] between last TimedOut() called and the first CDPTimer initialized.

void CDPParameterTimer::Reset(double delay)

Resets and sets specified delay timeout in seconds.

Stores the parameter-value and resets the timer.

void CDPParameterTimer::Reset()

Resets and sets delay timeout in seconds with value from CDPParameter.

Will call m_cTimer.Reset(Value()).

void CDPParameterTimer::Restart()

Resets and starts the timer with value from CDPParameter

void CDPParameterTimer::Set()

Sets the timeout flag state to true.

[override virtual] void CDPParameterTimer::SetValue(double newValue)

Reimplemented from CDPParameter::SetValue().

Sets the parameter-value and resets the timer.

[virtual] void CDPParameterTimer::Start()

Deprecated, use Restart() instead.

bool CDPParameterTimer::State()

Returns the state of the timeout flag as calculated by the previous TimedOut() call.

double CDPParameterTimer::TimeElapsed()

Returns time [s] elapsed since Start() or Restart() was called.

bool CDPParameterTimer::TimedOut()

Updates delta time, checks if timeout and returns true if timeout.