Table of Contents

Class DecklinkVideoFormat

Namespace
VisioForge.Core.Types.Decklink
Assembly
VisioForge.Core.dll

Represents a complete video format configuration for Decklink hardware, encapsulating all parameters needed for professional broadcast video I/O operations.

public class DecklinkVideoFormat : ICloneable

Inheritance

Implements

Inherited Members

Remarks

This class defines the complete video format specification required for configuring Decklink cards in professional broadcast environments. It combines multiple parameters that must be coordinated to ensure proper signal generation and compatibility with broadcast equipment.

Key considerations when configuring video formats:

  • Resolution and frame rate: Must match broadcast standards (e.g., 1920x1080 @ 29.97fps for 1080i59.94)
  • Video mode: Determines the specific broadcast standard including interlacing and exact timing
  • Pixel format: Affects color space, bit depth, and bandwidth requirements

Common broadcast format combinations include: - HD-SDI 1080i59.94: 1920x1080, 29.97fps, ModeHD1080i5994, 10-bit YUV - HD-SDI 720p60: 1280x720, 60fps, ModeHD720p60, 10-bit YUV - 4K UHD: 3840x2160, various frame rates, 10/12-bit YUV or RGB - SD-SDI NTSC: 720x486, 29.97fps, ModeNTSC, 10-bit YUV - SD-SDI PAL: 720x576, 25fps, ModePAL, 10-bit YUV

Properties

Gets or sets the frame rate for progressive formats or field rate for interlaced formats.

public VideoFrameRate FrameRate { get; set; }

Property Value

VideoFrameRate

Remarks

For interlaced formats, this represents the field rate (e.g., 59.94 fields/second for 1080i59.94). Common broadcast frame rates include 23.98, 24, 25, 29.97, 30, 50, 59.94, and 60 fps.

Gets or sets the vertical resolution in pixels.

public int Height { get; set; }

Property Value

int

Remarks

Standard broadcast resolutions include:

  • SD NTSC: 486 pixels (480 active lines)
  • SD PAL: 576 pixels
  • HD 1080: 1080 pixels
  • HD 720: 720 pixels
  • UHD/4K: 2160 pixels

Gets or sets the specific video mode that defines the complete broadcast standard.

public DecklinkVideoMode Mode { get; set; }

Property Value

DecklinkVideoMode

Remarks

The video mode encompasses resolution, frame rate, scan type (progressive/interlaced), and timing parameters as defined by broadcast standards like SMPTE 274M (HD), SMPTE 296M (720p), ITU-R BT.601 (SD), etc.

Gets or sets the human-readable name of the video format.

public string Name { get; set; }

Property Value

string

Remarks

Typically includes the resolution and frame rate, e.g., "1080i59.94", "720p60", "4K UHD 60p".

Gets or sets the pixel format determining color space, bit depth, and memory layout.

public DecklinkPixelFormat PixelFormat { get; set; }

Property Value

DecklinkPixelFormat

Remarks

Professional broadcast typically uses:

  • 10-bit YUV 4:2:2 for SDI signals (SMPTE 259M/292M/424M/2082)
  • 8-bit or 10-bit RGB for graphics and effects processing
  • 12-bit formats for HDR and cinema applications

Gets or sets the horizontal resolution in pixels.

public int Width { get; set; }

Property Value

int

Remarks

Standard broadcast resolutions include:

  • SD NTSC: 720 pixels
  • SD PAL: 720 pixels
  • HD: 1920 pixels (1080i/p) or 1280 pixels (720p)
  • UHD/4K: 3840 pixels
  • DCI 4K: 4096 pixels

Methods

Creates a deep copy of the current video format configuration.

public object Clone()

Returns

object

A new VisioForge.Core.Types.Decklink.DecklinkVideoFormat instance with identical settings.

Remarks

Useful when you need to create format variations or maintain format presets without affecting the original configuration.