Enum DecklinkGenlockStatus

Namespace

VisioForge.Core.Types.Decklink

Assembly

VisioForge.Core.dll

Represents the synchronization status of a Decklink device's genlock feature.

public enum DecklinkGenlockStatus

Fields

NotSupported = 0

The Decklink device does not support genlock functionality.

This status indicates that the current Decklink model or configuration does not have genlock capabilities. Consumer-grade or entry-level Decklink cards may not include genlock support. Check the device specifications to confirm genlock availability.

NotConnected = 1

Genlock is supported but no reference signal is currently connected.

This status indicates that the device has genlock capability but is not receiving a reference signal. This could mean: - No cable is connected to the genlock input - The connected device is not providing a valid reference signal - The reference source is powered off or disconnected

To resolve this, ensure a valid reference signal is connected to the genlock input (typically a BNC connector labeled "REF IN" or "GENLOCK").

Locked = 2

The device is successfully locked to the genlock reference signal.

This is the desired state for synchronized video production. The device has: - Detected a valid reference signal - Successfully synchronized its internal timing to the reference - Achieved stable phase lock with the reference signal

In this state, the device's video output will be frame-accurate and synchronized with other genlocked devices in the production chain. This ensures seamless switching between video sources and prevents synchronization artifacts.

NotLocked = 3

A reference signal is detected but the device has not achieved lock.

This status indicates that the device is receiving a reference signal but cannot maintain stable synchronization. Possible causes include: - Incompatible reference signal format or frequency - Weak or noisy reference signal - Mismatched video format between the device and reference - Internal timing issues with the device

To resolve this: - Verify the reference signal format matches the device's current video mode - Check cable quality and connections - Ensure the reference signal meets broadcast specifications - Consider using a different reference source

Max = 4

Reserved value representing the maximum enumeration value.

This value is used internally for validation and should not be used in application code. It represents the upper bound of valid genlock status values.

Remarks

Genlock (generator locking) is a technique used in professional video production to synchronize multiple video sources to a common reference signal. This ensures that all video equipment in a production facility operates in perfect synchronization, preventing issues like frame tearing, rolling, or other timing-related artifacts.

The genlock reference signal typically comes from: - A dedicated sync generator - A master video device - A GPS-based timing source - Another synchronized video signal

This enumeration helps determine the current state of genlock synchronization on a Decklink device, which is crucial for professional broadcast and production environments where multiple cameras and video sources must be perfectly synchronized.