Skip to main content

nanoStream SDK for macOS

note

This API is deprecated! Please use nanoStream Webcaster and H5Live!

Intro

The nanoStream MacOS dylib API is a video capture and encoding software for streaming live video and audio to internet based media servers and other network clients.

The nanoStream MacOS dylib API supports internet broadcast streaming and local recording at the same time. A lots of video devices are supported, also Blackmagic devices. The resolution, frame rate, samplerate and more can be manipulated. For a full feature list and platform specific features look at the method list below.

Note:

This is preliminary documentation, please contact us for further information or help.

Setup:

The best way to start is using the C++ sample code included in the SDK.

System Requirements:

Mac OSX 10.9 or newer, Windows 7 or newer

Hardware Requirements:

Intel Core2 Duo or later

Recommended for HD capture: Intel Core i7 or Xeon

Method NameDescriptionlibnanoStream.dylib SupportMac Plugin SupportMac Framework SupportANE Support
InitPluginInitialization of the PluginnanoStreaminitEncoderinit
SetXmldeprecated - no functionality
GetVersionGet version number of the SDK
SetLicenseSet license for nano SDK
GetLicenseGet the current license of the SDK
SetConfigSet property over Identifier.
UpdatePreviewDimensionsUpdate preview dimensions of the bmp
GetPreviewDimensionsGet the current preview dimensions
GetPreviewImageGet the preview image
GetPreviewFrameGet current preview Frame
StartPreviewStart the preview.
StopPreviewStop the preview.
StartBroadcastStart broadcasting.startStream
StopBroadcastStop broadcasting.stopStream
GetNumberOfVideoSourcesCount video sources with current settings
GetNumberOfAudioSourcesCount audio sources with current settings
GetVideoSourceGet name of the video source as string.
GetAudioSourceGet name of the audio source as string.
SetVideoSourceSet video source for preview or broadcastingVideoSource
SetVideoSourceFromURLURL to an mp4 file source or ramp source
SetAudioSourceSet audio source for preview or broadcastingAudioSource
SetVideoWidthSet width of video in pixelsVideoWidth
GetVideoWidthGet width of video in pixelsVideoWidth
SetVideoHeightSet height of video in pixelsVideoHeight
GetVideoHeightGet height of video in pixelsVideoHeight
SetVideoResizeWidthResize width of video in pixels
SetVideoResizeHeightResize height of video in pixels
SetVideoFramerateSet frame rate of video in frames per secondSetFramerateVideoFrameRatesetFrameRate
SetNumberOfChannelsset channel number
SetVideoBitrateSet bitrate of video in kbits per second
GetVideoBitrateGet the current video bitrate
SetAudioBitrateSet bitrate of audio in kbits per second
GetAudioBitrateGet the current audio bitrate
SetAudioSamplerateSet the samplerate of the audio in HertzsetSampleRate
GetAudioLevelGet the audio level of a channel
SetAudioVolumeSet audio volumeAudioVolume
SetAudioPreviewVolumeSet audio volume of previewAudioPreviewVolume
SetColorSpaceSet the color space of an input source
GetNumberOfColorspacesGet the count of color spaces
GetColorspaceGet color space name as string
GetNumberOfResolutionsGet count of available resolutions
GetResolutionGet count of resolutions
GetNumberOfFrameratesCount of available frame rates as integer valueGetNumberOfFrameRates
GetFramerateGet the frame rate of a video sourcegetFrameRate
SetDeinterlacingSet deinterlacing mode and method
GetNumberOfOutputsGet count of output sources
AddOutputAdd new output source with url
SetOutputUrlSet output source with url. Local or rtmpsetOutputUrl
GetOutputUrl
GetNumberOfOutputUrls
AcceptDataInSampleBuffer
AddSampleBuffer
SetFilesourceFilenameSet the filename of a local source
ClearOutputsReset all output sources
SetVideoEffectAdd a video effect.
SetOverlayAdd a overlay to the video
ShowPropertyPageShow property page
SetLogSet log file path and log level.
SetXmlProfile
dispose():voidReset buffer

Method Description:

Setup the Plugin

InitPlugin

Declaration

InitPlugin(xmlPath:String):int

Parameters

NameTypeDescription
xmlPathStringPath to the xml file with configuration information, can be local or a url. 1
1 **— deprecated - no functionality**|

Return Value

-1 if the initialization failed

Description

Initialization of the plugin.

Availability

On Windows and Mac OSX


GetVersion

Declaration

GetVersion()

Return Value

Version number as int value

Description

Return the version number of the SDK as int value

Availability

On Mac OSX


SetLicense

Declaration

SetLicense(licenseStr:String):int

Parameters

NameTypeDescription
licenseStrStringLicense String getting from nano.

Return Value

-1 if call failed

Description

Set license for nano SDK

Availability

On Windows and Mac OSX


GetLicense

Declaration

GetLicense()

Return Value

String represantation of the license

Description

Get license for nano SDK

Availability

On Mac OSX


SetConfig

Declaration

SetConfig(property:String, value:String):int

Parameters

NameTypeDescription
propertyStringProperty identifier as string. See property list for configuration on page 32.
valueStringValue for property as string representation.

Return Value

1 if call was successful, 0 otherwise

Description

Set property over Identifier.

Availability

On Windows and Mac OSX

Preview

UpdatePreviewDimensions

Declaration

UpdatePreviewDimensions():void

Description

Updates the preview with the current width and height.

Availability

On Windows and Mac OSX


GetPreviewDimensions

Declaration

GetPreviewDimensions(long *width, long *height, long *size)

Parameters

NameTypeDescription
widthlongPointer to return the video width
heightlongPointer to return the video height
sizelongPointer to return the video size

Return Value

1 if call failed, 0 otherwise

Description

Get the current preview dimensions.


GetPreviewImage

Declaration

GetPreviewImage(char *pixelBuffer, int size)

Parameters

NameTypeDescription
pixelBuffercharpixel buffer
sizeintsize

Return Value

1 if call failed, 0 otherwise

Description

Get the preview image.


GetPreviewFrame

Declaration

GetPreviewFrame(options:int = GET\_FRAME\_BITMAP):Boolean

Parameters

NameTypeDescription
optionsintoption as integer. Default is GET_FRAME_BITMAP = 2. A\ Also possible: \ GET_FRAME_RAW_BYTES:int = 4,\ GET_POWER_OF_2_FRAME_BGRA_BYTES:int = 8

Return Value

True if new frame was received otherwise false

Description

Get current preview Frame.


StartPreview

Declaration

StartPreview():int

Return Value

-1 if call failed

Description

Start the preview.

Availability

On Windows and Mac OSX


StopPreview

Declaration

StopPreview():int

Return Value

-1 if call failed

Description

Stop the preview.

Availability

On Windows and Mac OSX

Broadcast

StartBroadcast

Declaration

StartBroadcast():int

Return Value

ERROR_SETUP_ENCODER_FAILED = -2

ERROR_RTMP_OUTPUT_SOURCE1_FAILED = 2

ERROR_RTMP_OUTPUT_SOURCE2_FAILED = 3

Description

Start broadcasting.

Availability

On Windows and Mac OSX


StopBroadcast

Declaration

StopBroadcast():int

Return Value

-1 if call failed

Description

Stop broadcasting.

Availability

On Windows and Mac OSX

Video Source & Audio Source handling

GetNumberOfVideoSources

Declaration

GetNumberOfVideoSources():int

Return Value

Count of all available video sources.

Description

Count of all available video sources with current settings

Availability

On Windows and Mac OSX


GetNumberOfAudioSources

Declaration

GetNumberOfAudioSources():int

Return Value

Count of all available audio sources.

Description

Count of all available audio sources with current settings

Availability

On Windows and Mac OSX


GetVideoSource

Declaration

GetVideoSource(index:int):String

Parameters

NameTypeDescription
indexintIndex of the video source. The index of the video source, from 0 - GetNumberOfVideoSources -1

Return Value

Video source name as string.

Description

Get name of the video source as string. Call GetNumberOfVideoSources first.

Availability

On Windows and Mac OSX


GetAudioSource

Declaration

GetAudioSource(index:int):String

Parameters

NameTypeDescription
indexintIndex of the audio source. The index of the audio source, from 0 - GetNumberOfAudioSources -1

Return Value

Audio source name as string.

Description

Get name of the audio source as string. Call GetNumberOfAudioSources first.

Availability

On Windows and Mac OSX


SetVideoSource

Declaration

SetVideoSource(index:int, mixSource:int, mixMode:int):int

Parameters

NameTypeDescription
indexintIndex of the video source. The index of the video source goes from 0 - GetNumberOfVideoSources -1
mixSourceintset 0 to to set only the first video source. 1 to set a second video source. 1
mixModeintwhen mixSource 1 is set, the mix mode to combine two video sources can be chosen here. See available mix modes on page 33. 2
1 **— second video source only available on Microsoft Windows**2 **— only available on Microsoft Windows**

Return Value

-1 if call failed

Description

Set video source for preview or broadcasting over index. Call GetNumberOfVideoSources first. The mix source defines the video source you want set. The mixSource and mixMode is optional and only available on Microsoft Windows. There with you can combine two videos over the mixMode.

Availability

On Mac OSX only one video source can use. On Microsoft Windows up to two video sources can be used and be combined in different ways.


SetVideoSourceFromURL

Declaration

SetVideoSourceFromURL(url:String):int

Parameters

NameTypeDescription
urlStringURL to use an mp4 file as video source.

Return Value

-1 if call failed

Description

URL to an mp4 file source to stream this file.

Availability

Only Supported under Microsoft Windows


SetAudioSource

Declaration

SetAudioSource(index:int):int

Parameters

NameTypeDescription
indexintIndex of the audio source. The index of the audio source, from 0 - GetNumberOfAudioSources -1

Return Value

-1 if call failed

Description

Set audio source for preview or broadcasting over index. Call GetNumberOfAudioSources first.

Availability

Under Windows and Mac OSX

Video Properties

SetVideoWidth

Declaration

SetVideoWidth(width:int, mixSource:int):int

Parameters

NameTypeDescription
widthintWidth of the video in pixels as integer value
mixSourceintset 0 to to set only the first video source. 1 to set a second video source. 1
1 **— second video source only available on Microsoft Windows** #### Return Value

-1 if call failed

Description

Set width of video in pixels. With mixSource the height for two video sources can be set.

Availability

Set Width is supported under Mac OS X and Microsoft Windows. The second mix source is only available under Microsoft Windows.


SetVideoHeight

Declaration

SetVideoHeight(height:int, mixSource:int):int

Parameters

NameTypeDescription
heightintHeight of the video in pixels as integer value
mixSourceintset 0 to to set only the first video source. 1 to set a second video source 1
1 **— second video source only available on Microsoft Windows**

Return Value

-1 if call failed

Description

Set height of video in pixels. With mixSource the height for two video sources can be set.

Availability

Set Height is supported under Mac OS X and Microsoft Windows. The second mix source is only available under Microsoft Windows.


SetVideoResizeWidth

Declaration

SetVideoResizeWidth(width:int, index:int):int

Parameters

NameTypeDescription
widthintresize width of the video in pixels as integer value
indexintIndex of the output. The index of the output, from 0 - GetNumberOfOutputs -1

Return Value

-1 if call failed

Description

Resize width of video in pixels.

Availability

Only Supported under Microsoft Windows


SetVideoResizeHeight

Declaration

SetVideoResizeHeight(height:int, index:int):int

Parameters

NameTypeDescription
heightintresize height of the video in pixels as integer value
indexintIndex of the output. The index of the output, from 0 - GetNumberOfOutputs -1

Return Value

-1 if call failed

Description

Resize height of video in pixels.

Availability

Only supported under Microsoft Windows


SetVideoFramerate

Declaration

SetVideoFramerate(framerate:Number, mixSource:int):int

Parameters

NameTypeDescription
framerateNumberFrame rate in frames per Second(FPS) as number value.
mixSourceintset 0 to to set only the first video source. 1 to set a second video source. 1
1 **— second video source only available on Microsoft Windows**

Return Value

-1 if call failed

Description

Set frame rate of video in frames per second (FPS). With mixSource the frame rate for two video sources can be set under Microsoft Windows.

Availability

Set video frame rate is supported under Mac OS X and Microsoft Windows. Mix Source is only available under Microsoft Windows.


SetNumberOfChannels

Declaration

SetNumberOfChannels(int numOfChannels)

Parameters

NameTypeDescription
numOfChannelsintNumber of channels as int value

Description

Set channel number

Availability

On Mac OSX


SetVideoBitrate

Declaration

SetVideoBitrate(bitrate:int, index:int):int

Parameters

NameTypeDescription
bitrateintVideo bitrate as integer value.
indexintindex of output to set the bitrate for multiple encoders. 1
1 **— set different outputs is only available on Microsoft Windows. On Mac OS X the same bitrate is set to all outputs.**

Return Value

-1 if call failed

Description

Set bitrate of video in kbits per second (kbits/s).

Availability

Under Mac OS X the same bitrate is set to all outputs. Under Microsoft Windows every output can be set to another bitrate.


GetVideoBitrate

Declaration

GetVideoBitrate(int source)

Parameters

NameTypeDescription
indexintindex of output to get the bitrate for multiple encoders. 1
1 **— set different outputs is only available on Microsoft Windows. On Mac OS X the same bitrate is set to all outputs.**

Return Value

Video bitrate as integer value.

Description

Get the current video bitrate.

Availability

Under Mac OS X there is only one output available. Under Microsoft Windows several outputs are available over the index parameter.

Audio Properties

SetAudioBitrate

Declaration

SetAudioBitrate(int bitrate, int index): int

Parameters

NameTypeDescription
bitrateintAudio bitrate as integer value.
indexintindex of output to set the bitrate for multiple encoders. 1
1 **— set different outputs is only available on Microsoft Windows. On Mac OS X the same bitrate is set to all outputs.** |

Return Value

-1 if call failed

Description

Set bitrate of audio in kbits per second (kbits/s).

Availability

Under Mac OS X the same bitrate is set to all outputs. Under Microsoft Windows every output can be set to another bitrate.


GetAudioBitrate

Declaration

GetAudioBitrate(int source): int

Parameters

NameTypeDescription
indexintindex of output to get the bitrate for multiple encoders. 1
1 **—Get different outputs is only available on Microsoft Windows. On Mac OS X there is only one source available.** |

Return Value

Audio bitrate as integer value.

Description

Get the current audio bitrate.


SetAudioSamplerate

Declaration

SetAudioSamplerate(int samplerate): int

Parameters

NameTypeDescription
samplerateintSamplerate of audio as integer value

Return Value

-1 if call failed

Description

Set the samplerate of the audio in Hertz (Hz).

Availability

Under Windows and Mac OSX.


GetAudioLevel

Declaration

GetAudioLevel(channel:int):int

Parameters

NameTypeDescription
channelintchannel id as integer.

Return Value

Audiolevel as integer value.

Description

Get the audio level of a channel.

Availability

Under Windows and Mac OSX.


SetAudioVolume

Declaration

SetAudioVolume(volume:int):int

Parameters

NameTypeDescription
volumeintvolume as integer value

Return Value

-1 if call failed

Description

Set audio volume.

Availability

Under Windows and Mac OSX.


SetAudioPreviewVolume

Declaration

SetAudioPreviewVolume(volume:int):int

Parameters

NameTypeDescription
volumeintvolume as integer value

Return Value

-1 if call failed

Description

Set audio volume of preview.

Availability

Under Windows and Mac OSX.

Color Management

SetColorSpace

Declaration

SetColorSpace(index:int, mixSource:int):int

Parameters

NameTypeDescription
indexintindex of the input source.
mixSourceintset 0 to to set only the first mixed source. 1 to set a second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

-1 if call failed

Description

Set the color space of an input source. Only the firtst source is supported under Mac OS X

Availability

Under Windows and Mac OSX.


GetNumberOfColorspaces

Declaration

GetNumberOfColorspaces(width:int, height:int, mixSource:int):int

Parameters

NameTypeDescription
widthintwidth of the video source
heightintheight of the video source
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

Count of color spaces as integer value.

Description

Get the count of color spaces. Get the color space for the specified with and height.

Availability

Under Windows and Mac OSX. Under Mac OSX mix source is not supported.


GetColorspace

Declaration

GetColorspace(index:int, mixSource:int):String

Parameters

NameTypeDescription
indexintIndex of the color spaces. The index of the color spaces, from 0 - GetNumberOfColorspaces -1
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

color space name as String

Description

Get color space name as string. First call GetNumberOfColorspaces.

Availability

Under Windows and Mac OSX. Under Mac OSX only the first mix source is supported.

Resolution & Frame rate

GetNumberOfResolutions

Declaration

GetNumberOfResolutions(mixSource:int):int

Parameters

NameTypeDescription
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

Count of resolutions as integer value.

Description

Get count of resolutions.

Availability

Under Windows and Mac OSX. Under Mac OSX only the first mix source is supported.


GetResolution

Declaration

GetResolution(index:int, mixSource:int):Object

Parameters

NameTypeDescription
indexintIndex of the resolutions. The index of the resolutions, from 0 - GetNumberOfResolutions -1
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

Get resolution of video source. First call GetNumberOfResolutions.

Description

Get count of resolutions.

Availability

Under Windows and Mac OSX. Under Mac OSX only the first mix source is supported.


GetNumberOfFramerates

Declaration

GetNumberOfFramerates(width:int, height:int, colorspace:String, mixSource:int):int

Parameters

NameTypeDescription
widthintwidth of the video source
heightintheight of the video source.
colorspaceStringname of the color space get from GetColorspace
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

Count of available frame rates as integer value.

Description

Get count of available frame rates.

Availability

Under Windows and Mac OSX. Under Mac OSX only the first mix source is supported.


GetFramerate

Declaration

GetFramerate(index:int, mixSource:int):Number

Parameters

NameTypeDescription
indexintIndex of the frame rate. The index of the frame rate, from 0 - GetNumberOfFramerates -1
mixSourceintset 0 to to get the first mixed source. 1 to get the second mixed source. 1
1 **—second mixed source is only available on Microsoft Windows**

Return Value

Frame rate (FPS) as number value.

Description

Get the frame rate of a video source. Call GetNumberOfFramerates first.

Availability

Under Windows and Mac OSX. Under Mac OSX only the first mix source is supported.


SetDeinterlacing

Declaration

SetDeinterlacing(mode:int, method:int):int

Parameters

NameTypeDescription
modeintpossible values: 0=off, 1=auto, 2=on \ no auto mode for mac
methodintpossible values: 0=duplicate field/bob, 1=blend, 2=vertical filter, 3=edge, 4=median, 5=median2

Return Value

-1 if call failed

Description

Set deinterlacing mode and method.

Availability

Under Windows and Mac OSX.

Outputs

GetNumberOfOutputs

Declaration

GetNumberOfOutputs():int

Return Value

Count of outputs as integer value.

Description

Get count of outputs.

Availability

Only Supported under Microsoft Windows.


AddOutput

Declaration

AddOutput(url:String):int

Parameters

NameTypeDescription
urlStringUrl of outputs can be a local mp4 recording or a rtmp source.

Return Value

-1 if call failed

Description

Add new output source with url.

Availability

Only Supported under Microsoft Windows.


SetOutputUrl

Declaration

SetOutputUrl(url:String, index:int):int

Parameters

NameTypeDescription
urlStringUrl of outputs can be a local mp4 recording or a rtmp server.
indexintIndex of the output.

Return Value

-1 if call failed

Description

Set output with url. A local mp4 recording or a rtmp server.

Availability

Under Windows and Mac OSX.


GetOutputUrl


GetNumberOfOutputUrls


AcceptDataInSampleBuffer


SetFilesourceFilename

Declaration

SetFilesourceFilename(url:String):int

Parameters

NameTypeDescription
urlStringUrl to the local file

Return Value

-1 if call failed

Description

Set the filename of a local source.

Availability

Only Supported under Microsoft Windows.


ClearOutputs

Declaration

ClearOutputs():int

Return Value

-1 if call failed

Description

Reset all outputs except the first one.

Availability

Only Supported under Microsoft Windows.

Video Special

SetVideoEffect

Declaration

SetVideoEffect(mode:int):int

Parameters

NameTypeDescription
modeintMode of video effect. See possible overlay effects on page 33

Return Value

-1 if call failed

Description

Add a video effect. For overlay.

Availability

Only Supported under Microsoft Windows.


SetOverlay

Declaration

SetOverlay(url:String):int

Parameters

NameTypeDescription
urlStringUrl of the overlay source. Can be a locale path or server url to a png or txt file. Also can be a txt string.

Return Value

-1 if call failed

Description

Add a overlay to the video.

Availability

Only Supported under Microsoft Windows.


ShowPropertyPage

Declaration

ShowPropertyPage(value:int):int

Parameters

NameTypeDescription
valueint1 or 0 are possible values

Return Value

-1 if call failed

Description

Show property page. Only used for Blackmagic devices.

Availability

Only supported under Microsoft Windows.

Logging

SetLog

Declaration

SetLog(logFile:String, logLevel:int):int

Parameters

NameTypeDescription
logFileStringlocal path for logfile as string.
logLevelintlog level as integer. For possible loglevels 0-9.

Return Value

-1 if call failed

Description

Set log file path and log level.

Availability

Under Windows and Mac OSX.

Availability

Under Windows and Mac OSX.


SetXmlProfile

dispose

Declaration

dispose():void

Description

Destructor.

Availability

Under Windows and Mac OSX.

SetConfig Properties

Property nameDescriptionValuesMac Platform Support
licenseLicense string
XMLPathPath to the XML file with configuration information
RemoteControlPortPort number
LiveSource
RemoteIP
AVOffsetMs
ReconnectPeriod/ReconnectInterval
ReconnectAttemptsAuto Reconnect No. of Attempts5
UseInternalReconnectUse RTMP Internal Reconnect of the RTMP Filter (do not stop encoder on network errors)0 / 1
UseUnlimitedReconnectDon't stop reconnecting after a specific number of failed attempts (encoder is not stopped)0 / 1
AuthAuthentication for RTMP and RTSP Push streaming“user:password”
RtmpUrlDelimiterSet delimiter for RTMP-url and streamname.Example: ”+“ will split so that “myStream” is the stream name.
DeinterlacingModeDeinterlacing Mode0=off, 1=auto (default), 2=on Note: for some capture devices you need to set this to „on“ (2). (Resolutions 480i, 576i, 1080i)
DeinterlacingMethodDeinterlacing Method0=duplicate field/bob, 1=blend, 2=vertical filter, 3=edge, 4=median, 5=median2
RemoteSendAudioLevelInterval
CaptureRegionCapture Region of the input source, example for a input resolution of 640×480: SetConfig(“CaptureRegion”, “10,630,10,470”) - discards 10 pixels on each sideleft,right,top,bottom
RTMPPublishModeRTMP Publish/Live/Record on Server (VOD)1=record, 2=append, 0=live (default)
VideoAudioInput
PreviewNoInvert
ScreenCapModeScreen Capture Desktop Mode0=Screen, 1=FollowMouse, 2=Region relative, 3=Region absolute, 4=Window, 5=Window overlapping
ScreenCapWindowIndex
ApplyDynamicSettings
Mp4RecordOnTheFlyChangeName
Mp4RecordOnTheFlyControlIf Mp4RecordOnTheFly is enabled, controls start/stop recording0=stop, 1=start
AudioPreviewEnables audio preview during preview or broadcast0=no preview, 1=visual preview (default, requires filter AudioVolume), 2=visual and audible preview, 3=audible preview
Mp4RecordOnTheFlyEnables start/stop recording to local file while the broadcast is running0=off (default), 1=on
H264QualityH.264 Encoder Quality/Speed Ratio0=worst/fastest 1=default 6=highest/slowest
H264IFrameDistanceH.264 I Frame / GOP Length in Frames (100 Frames = 4 seconds for 25 fps)100=default, 1 = I-Frame-Only
H264PFrameDistanceH.264 P/B Frame Distance3 1 = IP-Only (no B-Frames)
H264ProfileH.264 Encoding ProfileBaseline, Main, Extended, High Most compatible but lowest quality is Baseline, (no B-Frames, no CABAC VLC)
H264LevelH.264 Level10=1.0, 11=1.1, 12=1.2, 13=1.3, 20=2.0, 21=2.1, 22=2.2, 30=3.0, 31=3.1, 32=3.2, 40=4.0, 41=4.1, 42=4.2, 50=5.0, 51=5.1
H264VlcModeH.264 VLC Mode (CAVLC/CABAC)=CAVLC, 2=CABAC (not allowed in H.264 Baseline Profile)
OutputFrameRateVideo Output (Encoded) Frame Rate5,10,15,20,25,30, OR 23980 OR 29970
RTMPWriteTimecodeSend timecodes in RTMP streams, If enabled RTMP timecodes are sent in addition to the always sent RTMP packet timestamps0=off (default), 1=on
UseSystemTimeAsTimecodeSend RTMP/MP4 timecodes as UTC system date time or stream time0=stream time (default), 1=UTC system date time
TimecodeIntervalRTMP/MP4 timecode interval in millisecondsShould be higher or equal to 1000 (1s)
TcpConnectTimeout
RTSPSinkModeDetermines if the RTSPSink is running as a server (passive/pull) or as a streamer to a RTSP push capable server (active/push)1=server/pull (default), 2=streamer/push
RTSPSDPFileFolder
RTSPStreamDescription
AudioVolumePerSoftwareControl volume with the Audio Volume Filter0=off (default), 1=on
AVFShowBlackmagicDevicesuse AVFoundation for BlackMagic devices0=off (default), 1=on
OverlayRectSets the dimensions for a given overlay-image.“index,left,top,right,bottom”. index: the overlay-index, beginning with 0. left, top, right and bottom define a rectangle in screen-coordinates.
OverlayAlphaSets the alpha-value for overlays.Range: 0-1. 0.0 (not visable), 1 (fully visable).
OverlayTextColorText Overlay ColorMust be a hexadecimal color-value in BGR-format, e.g.: “0000FF” (255 (0x0000FF) - red)
OverlayBackgroundColorMust be a hexadecimal color-value in BGR-format, e.g.: “000000” (0 (0x000000) - black).
OverlaySkipColorSetting skipcolor to a specific value will result in this color to be rendered transparent in the overlays.Example: If OverlayBackgroundColor was set to blue (“FF0000”) setting OverlaySkipColor to blue as well will result in a transparent background. Parameter must be a hexadecimal color-value in BGR-format, e.g.: “FF0000” (blue). Disable: Setting OverlaySkipColor to “FF000000” (ABGR) will disable the usage of skipcolor.
AudioDelayStreaming Audio Delay / Offset (ms)
ShowPropertyPageForDeviceCalls the propertypage for a given device.0 for device with index: 0
UseQuicktimeH264Encoder
RotateDegreesset the degrees by which video should be rotated, only works if UseRotation is set to on, set before StartPreview or StartBroadcast0/90/180/270

Mixmode

NO_MIXING = 0 (if video mixing is not used)

LEFT_RIGHT_FULL = 1

LEFT_RIGHT_HALF = 2

TOP_BOTTOM = 3

INTERLACED_LINES = 4

INTERLACED_COLUMN = 5

ANAGLYPH = 6

PIC_IN_PIC_LEFT_TOP = 7

PIC_IN_PIC_RIGHT_TOP = 8

PIC_IN_PIC_LEFT_BOTTOM = 9

PIC_IN_PIC_RIGHT_BOTTOM = 10

VIDEO1_ONLY = 11

VIDEO2_ONLY = 12

REGION = 13

MAX = 14

Overlay Effects

Overlay off = 0

Left Top = 1

Right Top = 2

Left Bottom = 3

Right bottom = 4

Free Postion = 5