Input properties
The properties are specific for MLive and MFLive objects.
| Name | Default value | Description |
|---|---|---|
| ndi.initialize_on_create | false | Once enabled, an available NDI source is initialized the moment you call the DeviceSet method. |
| ndi_audio_16bit | false | Receive audio in 16-bit short integer (false by default) |
| ndi_audio_thread | false | When enabled, audio is processed in a separate thread |
| ndi_auto_connect | true | When enabled, connects to the first available NDI source if no specific source is set. |
| ndi_bandwidth | highest | Specifies bandwidth priority for NDI streams.
|
| ndi_close_async | false | close NDI object asynchronously |
| ndi_convert_alpha_premul | 0 | incoming NDI alpha type: 0 = premultiplied, 1 = straight. |
| ndi_enum_recreate_sec | 0.0 | sets a time interval to recreate the NDI object. Use 0 to disable. |
| ndi_enum_timeout_sec | 10.0 | Sets a timeout period to remove all non-available sources. I.e. if a source is not available more than X seconds it is removed from input streams. |
| ndi_enum_wait_sec | 0.2 | Sets a timeout period before enumerating input sources in seconds |
| ndi_extra_ips | A comma-separated list of additional IP addresses/hosts to query for NDI sources. | |
| ndi_fake_video | false | Produces an empty initial video frame to support audio-only streams. |
| ndi_group | NDI Group name, group names must be separated by commas, for example: group_1, group_2, group_3 | |
| ndi_locator.run_always | true | When enabled, the NDI locator thread runs continuously while working with the source. If disabled, it stops once frame reception starts. |
| ndi_name | Sets a default NDI name | |
| ndi_on_preview | true | Flag for tally on a preview output |
| ndi_on_program | false | Flag for tally on a program output |
| ndi_reconnect_to_first | false | On disconnect, reconnects to the first available source |
| ndi_reference_level | 0.0 | The audio reference level in dB. This specifies how many dB above the reference level (+4dBU) is the full range of audio. |
| ndi_show_local | true | Once enabled, local NDI sources are enumerated |
| ndi_timecode | auto | Possible values: auto - use ML timecode from metadata if present, else use local time; src - Force to use SRC timecode from NDI video_frame.timestamp; ml - Force to use Medialooks timecode from metadata; local - Force to use local time as timecode. |
| ndi_video_timeout | dword:00000000 | Sets timeout period for grabbing a frame from a source |
Output properties
The properties are specific for MRenderer and MFRenderer objects
| Name | Default value | Description |
|---|---|---|
| input.buffers | dword:00000001 | Sets the maximal size of an output buffer in frames. |
| ndi_group | Sets NDI Group name. | |
| ndi_send_async | true | Once enabled, output frames are sent asynchronously. |
| ndi_optimize_fps | false | Once enabled, the object does not send the same video frames (for better performance) |
| ndi_name | MFormats NDI | Sets NDI stream name. |
| ndi_correct_name | true | Corrects the NDI stream name if the specified name is already in use. |
| ndi_frame_metadata | true | Once enabled, NDI output processes metadata in frames (Closed captions, ancillary data). |
| ndi_backup | A name of a backup NDI stream |