Writes data to a module.
apiwrite module, pin, value |
Parameters
module
Name of module or (internal) function.
pin
Name of pin. Pin names are case insensitive.
value
Value to be written. The type of value (e.g. text, integer, boolean) depends on the pin.
Remarks
The apiwrite function writes a value to a module's pin. If this is a text and you wish to have leading spaces then use double quotes around the text. Note the value parameter supports escaping (\xhh, where hh is the hexadecimal value of the character), you will need this to embed special characters in a text string (like comma and double quotes). Note some apiwrite commands address internal functions, here the module parameter is used to indicate the internal function (e.g. macro).
Example
The following example selects Camera 1 as Source 1 of Effect module 1.
apiwrite effect 1, source1, Camera 1 |
The following example writes a text with leading spaces and two special characters to an overlay module.
apiwrite overlay 1, text, " A text with leading spaces and an embedded double quote:\x22 and comma:\x2c." |