Into

Modules

Documentation

classPiiFlowLevelChanger

#include <PiiFlowLevelChanger.h>

An operation that changes the flow level of data passed through it.

Inherits PiiDefaultOperation

Description

It is useful in situations where one needs to adjust different flow levels before connecting them to further processing. A typical use is to fake image pieces to be "original" images as shown in the image below. The images emitted through output will be at the flow level of PiiImageFileReader's image.

Inputs

syncSynchronization input. The output will always maintain the flow level of this input.
inputThe objects whose flow level must match sync.

Outputs

outputObjects read from input at the flow level of sync.

Constructors and destructor

Protected member functions

virtual void

Executes one round of processing.

Function details

  • PiiFlowLevelChanger

    ()
  • virtual void process

    ()
    [protected, virtual]

    Executes one round of processing.

    This function is invoked by the processor if the necessary preconditions for a new processing round are met. This function does all the necessary calculations to create output objects and sends them to output sockets.

    Calls to process(), syncEvent(), and setProperty() are synchronized and cannot occur simultaneously. PiiDefaultOperation ensures this by locking processLock() for reading before calling process().

    Note: With time-consuming operations, one should occasionally check that the operation hasn't been interrupted, i.e. that state() returns Running.

    Exceptions
    PiiExecutionException

    whenever an unrecoverable error occurs during a processing round, the operation is interrupted, or finishes execution due to end of input data.

    Reimplemented from PiiDefaultOperation.

Notes (0)

Add a note

Not a single note added yet. Be the first, add yours.