Skip to main content

TdxCustomCameraControl.Active Property

Toggles capturing and rendering of the camera output on the control’s surface.

Declaration

property Active: Boolean read; write;

Property Value

Type
Boolean

Remarks

Set this property to True to activate the camera control and allow it to access a specific camera registered in the Device Manager. Activating the camera control allows it to do the following:

  • Access the camera specified by the DeviceIndex property.

  • Acquire a lock of the camera to capture and render its output. Once locked, the camera is inaccessible for other applications, including other instances of the same application;

  • Initiate capturing and rendering of the camera output.

  • Continuously render output frames on the surface until the camera control is paused, stopped, or made inactive. Note that the camera control renders the output only at runtime to avoid unnecessary camera lock-ups.

Use the State property to determine the camera control’s current state. To respond to any changes, handle the OnStateChanged event.

Default Value

The Active property’s default value is False.

See Also