Pin


channel

Returns channel that is currently displayed and selected for audio. Default is 0.


channel, <channel>

Set the <channel> that is displayed and selected for audio. Default is 0.


channels, <count>

Set the <count> number of output channels (currently limited to 2), value parameter is text string with number of channels. The default setting is 1. Change this pin before writing to other pins.

Returns the number of output channels.


clip <channel>

Returns the name of the clip currently loaded, or empty string if none.


clips[, first, last]

Returns a comma-separated list of available clips for this module (aka camera angle). Optionally the clip range can be limited from <first> to <last>.


deleteclip, <name>

Deletes video clip. Value parameter holds text string with clip <name>.


exportclip <channel>

Saves recording/clip in <channel> from in to out point as compressed video file. All videos will be stored in the export folder. The file will be automatically named VidBlasterXSlomoClip_yymmddhhmmss_n, e.g. VidBlasterXSlomoClip_200818143000_1 for Slomo module 1 on August 18th 2020 at 2.30 PM.


guardband, <time>

A guardband is the additional <time> of media saved, both before and after the intended clip. Value parameter holds text string with guardband in seconds.


in <channel>

Marks current timecode for <channel> as IN point if the value parameter is true, or erases the IN point if value is false.

Reads IN timecode for <channel>.


live <channel>

Enables/disables live mode for <channel>. Value parameter is "true" or "false".

Returns live mode status ("true" or "false") for <channel>.


loadclip <channel>, <index>

Loads video clip <index> into <channel> play buffer.


mode, <text>

Read/write mode. Value parameter is <text> string. For internal use only.


off

Disables the module and stops internal recorder. Value parameter is ignored.


on

Enables the module and starts internal recorder. Value parameter is ignored.


osd, <text>

Output OSD <text>. Value parameter is text string.


out <channel>

Marks current timecode for <channel> as out point if the value parameter is true, or erases the out point if value is false.

Read out timecode for <channel>.


recording

Returns true if recording.


recordpath

Returns the full path to the record file.


reset

       Resets all settings except the number of channels.


saveclip <channel>, <index>

Saves recording in <channel> from in to out point as video clip with <index> (0..9999).


speed <channel>, <speed>

Sets <speed> of <channel> at which frames are output. Fixed frame output is set with speed 0, (delayed) real time playback with speed 100. Value parameter is text string with percentage value.


tally <channel>, <status>

Sets tally <status> of <channel>. Value parameter is text string "program", "Preview" or empty.


timecode <channel>, <timecode>

Write to this pin to change the <timecode> of <channel>. Timecode is considered absolute unless it is preceded by a plus or minus sign in which case it is relative to the channel's current timecode.
Read from this pin to get the current timecode of <channel>. Returns 0 if no timecode available.


timecodeframe <channel>

Read from this pin to get the timecode of <frame> number. The frame number is considered an absolute value unless it is preceded by a plus or minus sign in which case it is considered an offset to the channel's current frame number. In this mode, which is typically used for jogging, the offset it automatically limited to avoid wrapping (which would result in the timecode jumping from newest to oldest or vice versa). Returns 0 if no timecode available.


timecodelive

Returns current live timecode in seconds.


timecodelivehms

Returns current live timecode formatted as hh:mm:ss.


Note by default 2 channels are available: 1 (PGM) and 2 (PVW). Where applicable to address both channels at the same time use 0.

Note timecode is a text representation of a double, where the integral part is unix time and the optional fractional part represents the fraction of the second. Decimal separator is a period.


Event


onchannel, <module>, <channel>

Triggered when the active channel changes.


onclip, <module>, <channel>, <clip name>

Triggered when a clip is loaded. Use onlive event to detect clip unload.


onclipadded, <module>, <clip name>

Triggered when a clip is created, includes the name of the clip.


onclipremoved, <module>, <clip name>

Triggered when a clip is deleted, includes the name of the clip.


onlive, <module>, <channel>, <live>

Triggered when a channel's live status changes.


onplay, <module>, <channel>, <speed>

Triggered when a channel's play status changes.


Example


The following example sets program playback to half speed.



apiwrite slomo 1, speed 1, 50



The following example sets the timecode for channel 1 of all Slomo modules to January 1st, 2020 0:00 UTC.



apiwrite slomo 0, timecode 1, 1577836800