Enum DecklinkHDTVPulldownOnOutput

Namespace

VisioForge.Core.Types.Decklink

Assembly

VisioForge.Core.dll

Specifies the 3:2 pulldown output mode for DeckLink cards that support HD video.

public enum DecklinkHDTVPulldownOnOutput

Fields

Default = 0

Uses the default pulldown behavior configured in the device or driver settings.

The default behavior varies depending on: - The specific Decklink model - Current driver configuration - The output video format selected

This setting allows the device to automatically determine whether to apply 3:2 pulldown based on the content and output format. It's the recommended setting when you want the device to handle pulldown decisions automatically.

Enabled = 1

Explicitly enables 3:2 pulldown processing on HD output.

When enabled, the device will apply 3:2 pulldown to convert 24fps content to 29.97fps for NTSC output. This is necessary when: - Broadcasting film-originated content on NTSC television - Ensuring compatibility with NTSC broadcast standards - Converting 24p content for display on 60Hz monitors

The pulldown process introduces a specific field pattern that may be detected by inverse telecine systems. This allows the original 24fps cadence to be recovered during post-processing if needed.

Warning: Enabling pulldown on content that is already at 29.97fps or has undergone previous pulldown processing may result in motion artifacts.

Disabled = 2

Explicitly disables 3:2 pulldown processing on HD output.

When disabled, the device will output video at its native frame rate without applying pulldown conversion. This is appropriate when: - Outputting to progressive displays that support 24p - Working in an all-digital workflow without broadcast requirements - The content is already at the correct frame rate for the output format - Preserving the original temporal characteristics of the content

Disabling pulldown maintains the original frame cadence but may cause compatibility issues with equipment expecting standard NTSC or PAL frame rates.

Note: When outputting 24p content to 60Hz displays without pulldown, the display device must handle the frame rate conversion, which may result in judder or other motion artifacts depending on the display's capabilities.

Remarks

3:2 pulldown (also known as telecine) is a technique used to convert 24fps film content to 29.97fps (NTSC) or 25fps (PAL) video formats. This process is essential when outputting film-originated content through broadcast television systems.

The 3:2 pulldown process works by: - Taking 4 film frames (at 24fps) - Converting them to 5 video fields (at 60 fields per second) - Creating a 2-3-2-3 field pattern that maintains smooth motion

This enumeration controls whether the Decklink device should apply 3:2 pulldown when outputting HD content. The setting is particularly important when: - Converting 24p content for NTSC broadcast - Maintaining compatibility with older broadcast equipment - Preserving the cinematic look of film-originated content

Note: This setting only affects HD output modes. Standard definition outputs may have different pulldown handling.