Skip to content

Dual display

Overview

Two identical video windows can be displayed, e.g. for a teacher to see the video preview on a 1st monitor, and for students to see the same video on a 2nd monitor in full screen mode.

The default video window is handled through the "Display_" properties and methods, and the 2nd video window through the identical "DualDisplay_" properties and methods.

Default video window

By default, only the 1st video window is active (Display_Active = true) and the 2nd video window is disabled (DualDisplay_Active = false).

By default, the 1st video window is embedded in the TVideoGrabber control (Display_Embedded = true).

Activation/deactivation of the dual display

To activate the 2nd video window, enable DualDisplay_Active before calling StartPreview, StartRecording or OpenPlayer.

The 2nd video window can then be shown or hidden while the preview/recording/playback is running, by enabling or disabling DualDisplay_Visible.

Multi-monitor display

Each video window can be sent to the desired monitor: assign the index of the desired monitor to the Display_Monitor or DualDisplay_Monitor property.

2 functions give information on the available monitors:

  1. MonitorsCount returns the number of monitors available on the current platform. Therefore Display_Monitor and DualDisplay_Monitor accept a value in the 0..MonitorsCount - 1 range.
  2. MonitorBounds returns the bounds of the monitor specified by its MonitorNumber parameter, in the 0..MonitorsCount - 1 range. The bounds returned are intended to help position the video window within the screen bounds.

Window location

When it is not embedded (Display_Embedded = false), the video window:

However, rather than assigning these properties one by one, all of them can be set at the same time with Display_SetLocation.