Video IO API - Calls
SaveImage
Requests node(s) frames to be sent over the DH2 network. Generates up to X responses, each image in it's own response.
Params| Nodes | STRING LIST OPTIONAL | List of node names. These are generally the UUID for the I/O nodes. Or the node type appended onto the UUID, eg. "UUID_Chr". Call "Nodes" to get a list of all active node names. If this is not supplied or empty, it will reply with all nodes images. |
| Format | STRING OPTIONAL | Optional format, PNG or JPEG, defaults to JPEG. |
| Scale | FLOAT OPTIONAL | Optional scale value, default is 1.0, which is 100%. |
| GammaCorrection | BOOL OPTIONAL | Should the request apply gamma correction or not. Default is true. |
| ITM | BOOL OPTIONAL | Should the request apply inverse tonemap or not. Default depends on State.Pipeline.DynamicRange eing "HDR". |
| HighlightCentralArea | BOOL OPTIONAL | Should we highlight the center area. Default is false. |
| Image | STRING | A base64-encoded image. |
| Name | STRING | The name of the node replied with. |
CaptureVideoIOData
Requests information from node(s) -- See SaveImage for the shared params, but has the additional options, and sends everything in a single packet.
Params| Image | BOOL | default false, if we want images included or not. |
| Metadata | BOOL | default true, if we want frame metadata included |
| Props | BOOL | default false, if we want node props or not |
EnableFlow/IP/Port
Requests set of nmos output node parameter.
Params| Node | STRING | The node UUID of the output node. |
| FlowType | INT | 0|1 - (video|ancillary) flow to be set. |
| Redundancy | BOOL | notifies if certain param to be set is in regards of main or secondary flow. |
| Value | BOOL|STRING|INT | Value to be set by call (EnableFlow - bool; Port - int; IP - string). |
Nodes
No arguments - Send an array of nodes back over the network.
No params.CallResult
| Nodes | STRING LIST | A list of unique node names. |
| FriendlyNodes | OBJECT LIST | A list of objects with `Friendly` and `Raw` components. |
Health
No arguments - Send an array of each node->healthStatus() result back.
No params.CallResult
| OBJECT LIST | Health/status information for each node. |
RebuildNodes
This does cause the video I/O to briefly suspend.
No arguments - Triggers the Pipeline to rebuild all of the nodes, essentially a soft restart.
No params.Shutdown
The video I/O will of course cease operation.
No arguments - Triggers the pipeline to shut itself down.
No params.NodeTimes
These may/will not be accurate.
No arguments - Returns a list of node times.
No params.SetBMDProfile
The video I/O will rebuild.
String Profile - Rebuilds the Pipeline, and sets the BMD profile to Profile.
No params.StartColorAnalysis
This will disable Engine transfers, and take a very long period of time.
This will rebuild the VideoIO after it's completed.
No arguments - Begins the XR calibration if XR is active.
Params| Name | STRING | The filename of the .cube file created. |
| Type | STRING OPTIONAL SOLO, READER, WRITER | One of, the mode of the call. Solo or multiple machines. Defaults to Solo. |
| ID | STRING OPTIONAL | The UUID of the XR node you would like to interact with, if blank or omitted it will use the first node. |
GetDiagram
Send the Chromacity diagram to Director - The .png file is sent in the binary payload object.
Params| Name | STRING | The filename of the .png chromacity diagram generated from the corresponding LUT name |
| Image | STRING | A base64-encoded image. |
EnableEventTimers
Enables the debug event timers and begins announcing them over the network. This rebuilds the VideoIO
Params| Enabled | BOOL | true for enabled, false to disable. |