SolarCapture C Bindings User Guide  SF-115721-CD
Issue 1
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
sc_rt_pacer Node Reference

Emits packets at a variable rate determined by a control input.

Detailed Description

This node is used to control packet rate in real-time under the control of an interactive input. That is, this node emits packets at a rate determined by the control input, and the rate can be changed immediately in response to new control inputs.

This node expects two inputs: A control input named "controller" and a data-path input named "" or NULL. The data-path input is forwarded to the output under the control of commands read from the control input.

Each buffer on the control input should contain a single command formatted as a nul terminated string. The node is initially stopped. The commands are:

Command Description
speedup MUL Start forwarding with speedup (MUL > 1.0) or slow down (MUL < 1.0) relative to real-time.
pps PPS Start forwarding. PPS gives the target packet rate in packets-per-second.
bw BPS Start forwarding with constant bandwidth BPS (in bits per second).
stop Stop forwarding now.
n N Stop forwarding after N packets.
pause TIME Pause processing of commands for give time. TIME must have suffix "s", "ms", "us", or "ns".
sleep TIME Synonym for "pause TIME".