Video Inputs

Multiple different video inputs are supported. Some will work straight out of the box while others will need additional drivers. Some video inputs are only available on certain platforms but that is stated in the list below. If you have a question about support for certain video input, please contact your Voysys representative.

All video inputs have a few settings in common.

Figure 1. Common settings for video inputs.

ID: Set an ID on the input to differentiate between multiple inputs. Name and color can be selected for each input.
Texture: Preview of the texture.
Save texture: Save the current texture to a .png file.

Argus (Jetson only)

Clone Stream

The Clone Stream input clones the video stream from another entity. This is useful when only one video input can be connected to a certain interface at the time. In some instances clone stream is necessary, for instance to get the video from a Remote Streamer or Virtual Camera.

Source: Which video source that this input should clone from.
Focus Region: Enable focus region.
Copy To Texture: By default, Clone Stream uses the original video source texture when displaying it along with any filters. Copy To Texture changes this behavior to instead make a copy of the cloned texture. This also enables the hard crop functionality. When copy to texture is enabled you can modify any filter applied without changing the source video filter.
Hard Crop: Crops the size of the texture in GPU memory instead of cropping it during display.

Decklink (Blackmagic)

Direct Show (Windows only)

Direct Show is a Windows API for capturing and displaying video sources. It supports many different camera devices.

If a dedicated input type exists for a device, use that instead for improved performance and lower latency. For example NDI or Decklink.

Device Name: The available devices that can be capture.
Rescan Devices: Rescan for new devices.
Rescan And Show All Devices: Rescan for new devices and showing all found devices, including devices that we do not recommend using with Direct Show.
Resolution: The video resolution.
Capture Rate: Different resolutions can have a specific range of available frame rates. This sets the range and the frame rate setting sets the specific frame rate for the input.
Frame Rate: The frame rate of the video.
Pixel Format: The video pixel format. Different pixel format can have different performance.
Retry: If enabled, the software will continue to try to connect to the camera if it is disconnected, e.g. if a cable is pulled out and then inserted.

Display Capture

Will capture the selected screen.

Cursor: If enabled, the cursor will be visible in the display capture.
Monitor: Selects which monitor should be captured.

FFmpeg

File

Flir (Spinnaker)

This is the video input for capturing FLIR cameras (USB3 Vision). This input requires a driver to work, contact your Voysys representative to get information about which version is compatible.

Try to Reconnect

If enabled, will try to reconnect to the select camera if disconnected.

Start/Stop

Start and stop the camera.

Only appears after a device is selected.

Rescan Devices

Rescans the devices on the interfaces that already has been detected.

Rescan Devices and Interfaces

Rescan devices as well as scanning for new interfaces.

Device

The available devices.

Custom Resolution

Make custom resolutions available for the user.

Resolution

The video capture resolution.

Pixel Format

The pixel format the camera will send, all formats might not be available on all cameras.

Auto Frame Rate

If enabled it will automatically set the camera to the highest possible frame rate.

Frame Rate

The frame rate of the camera, the camera interface does not show available frame rates so we refer to the camera specifications. The console will output an error if the frame rate is not supported. This settings is only visible if "Auto Frame Rate" is disabled.

Advanced

Center Image

When using a resolution lower than the maximum, the camera will send a subset of the image. If "Center Image" is enabled it will put the subset in the center. If disabled, the user can set wherein the sensor the subset should be taken from by changing the "Offset X" and "Offset Y" variables.

Binning

Binning combines pixels on the camera which makes the image from the camera smaller but uses a larger part of the sensor. This is useful when wanting to reduce the data transmitted from the camera but still get the image from the whole sensor. When changing the binning, the resolution must be changed also. It means that if the max resolution is 3000x4000 pixels and binning is set to 2x2 the selected resolution must be the max resolution divided by the binning, i.e 1500x2000 pixels.

Auto Exposure

Enables the auto exposure, depending on its state different settings can be set.

Enabled: If auto exposure is enabled a tab with settings will be visible. It gives the user the ability to set a minimum and maximum value which the auto exposure can work in between. This setting might be needed to make the camera reach its highest frame rate since the minimum exposure time could be too long by default.

Figure 2. Auto exposure settings.
Disabled: When auto exposure is disabled, the user can set the exposure time as well as the gain manually.

Auto WB

If enable, auto-corrects the white balance. When disabled settings for manually settings the white balance is available.

Buffer Count

The buffer count is the amount of frames the camera can buffer if the software does not read the frame quick enough, for example during a frame stutter. It is recommended to use the default value.

Reset on Startup

Resets the camera on startup, this can help with weird behaviors such as when the camera is stuck in a specific USB speed mode. This can make the startup of the camera slower.

Reset Camera

Resets the camera, can be used if the camera is misbehaving. This operation takes a while!

Flir/Point Grey (FlyCapture2)

GigE

GStreamer

This input will take a regular Gstreamer pipeline and input the video data to Oden. The video data will be put to the odenvideosink plugin, the sink can be added into the pipeline as ! odenvideosink processing-deadline=0 or be left out. If it is left out Oden will add it internally.

Start

Starts the pipeline.

HW Decode

Enable or disables the hardware decoder for the input.

Codec

Set the codec for the hardware decoder, available selection is H.264, H.265 and MJPEG.

Advanced

Exclusive Start: Enable exclusive start, sets a time between when different pipeline should start so only one starts at a time.
Exclusive Start Duration: Time between pipeline starts.
Exclusive Start Priority: Sets priority, lower number starts earlier.
Sync On Sink: Sets the property sync=true on the gstreamer pipeline if enabled.

Figure 3. Gstreamer input

HLS

IDS

NDI

Pleora

RTMP

RTP

RTSP

Real-Time Streaming Protocol(RTSP) is a network protocol for video and audio which is often used by IP cameras.

Start: Start receiving the RTSP stream with the current settings.
Url: The url to the RTSP server should have similar structure as the following URL rtsp://127.0.0.1:8554/live. The structure of the URL consist of an Ip address, a port number and which stream from the server that should be listen to, which is the 'live' part of the example URL.
Video: Enable or disable the video from the stream.
Codec: Which incoming codec that the stream use, currently supported are H.264, H.265, and MJPEG.
Audio: Enable or disable the audio from the stream.
Username: Some RTSP server requires a username.
Password: Some RTSP server requires a password.

Advanced

Convert To Raw GStreamer Pipeline: Converts all settings to a pure GStreamer pipeline.
Sync On Sink: GStreamer gives a timestamp when the frame should be displayed, if 'Sync On Sink' is enabled then the frame is presented when the timestamp occurs.

For live feeds, it is recommended to have 'Sync On Sink' set to disabled. However, for prerecorded video, it is recommended to have it set to enabled.

HW Decode: Enables the hardware decoding for the codec.

Spout (Windows Only)

Spout is a frame sharing system for Windows. It can receive the texture from other programs that have implemented the Spout protocol. Spout shares the textures over the GPU which means that both systems must use the same GPU. Performance can differ if the sending program uses DirectX since all GPU does not have support for DirectX to OpenGL texture transformation, if the GPU has support for it is shown under the tab 'info'.

Source: The available Spout source that is currently sending on the system.
Use Alpha Channel: Some programs might use alpha values that does not follow the standard format, therefor this button enable/disable the use of the alpha channel.
Log Spout Messages: Logs the Spout messages to file, the file will be located in the same location as the project file. Hover over the button to see the exact location.
Info: Some info about the system and the Spout capabilities.

Test Source

Test source is a video input that contains multiple different videos that can be used as a placeholder for a camera.

Resolution

The resolution of the test source.

Pattern

The available pattern to choose from.

Some of the patterns are static which will make the drop detector kick in, turn off the drop detector when using those!

V4L2 (Linux only)

Video for Linux version 2 (V4L2) is an API for realtime video capture on Linux systems. It supports many USB webcams and other camera devices.

Device

The camera you want to receive video from.

Pixel Format

The video pixel format.

Resolution

The video resolution.

Frame Rate

The video frame rate.

Controls

Displayed when the video input is active. Controls various aspects of supported cameras, such as exposure time, brightness, contrast, etc.

Advanced

Blocking Mode: Block and wait for the camera to send us an image. Necessary for certain cameras. Try enabling if you have issues receiving video.
Retry Until Success: Repeatedly try to establish a connection with the camera until successful. Can be useful if you cannot guarantee that the cameras are running when starting the application.
Use Custom Path: Use a custom device path. Should not be needed in most cases.
Custom Path: A custom device path in case your camera does not show up in the list, e.g. /dev/v4l/DEVICE_ID.

Image

Renders an image as a video input.

Open Image File: Open the dialog window to select an image. The supported file formats are .png, .jpeg, and .jpg.