Skip to content

AJA Source Operator

Authors: Holoscan Team (NVIDIA)
Supported platforms: x86_64, aarch64
Last modified: March 18, 2025
Latest version: 1.0
Minimum Holoscan SDK version: 1.0.3
Tested Holoscan SDK versions: 2.0.0
Contribution metric: Level 1 - Highly Reliable

The AJA Source operator provides functionality to capture high-quality video streams from AJA capture cards and devices. It offers comprehensive support for both SDI (Serial Digital Interface) and HDMI (High-Definition Multimedia Interface) input sources, allowing for professional video capture in various formats and resolutions. The operator is designed to work seamlessly with AJA's hardware capabilities, including features like frame synchronization and format detection. Additionally, it provides an optional overlay channel capability that enables real-time mixing and compositing of multiple video streams, making it suitable for applications requiring picture-in-picture, graphics overlay, or other video mixing scenarios.

Requirements

  • AJA capture card (e.g., KONA HDMI)
  • CUDA-capable GPU
  • Holoscan SDK 1.0.3 or later

Parameters

The following parameters can be configured for this operator:

Parameter Type Description Default
device string Device specifier (e.g., "0" for device 0) "0"
channel NTV2Channel Camera channel to use for input NTV2_CHANNEL1
width uint32_t Width of the video stream 1920
height uint32_t Height of the video stream 1080
framerate uint32_t Frame rate of the video stream 60
interlaced bool Whether the video is interlaced false
rdma bool Enable RDMA for video input false
enable_overlay bool Enable overlay channel false
overlay_channel NTV2Channel Camera channel to use for overlay NTV2_CHANNEL2
overlay_rdma bool Enable RDMA for overlay false

Supported Video Formats

The operator supports various video formats based on resolution, frame rate, and scan type:

  • 720p (1280x720) at 50/59.94/60 fps
  • 1080i (1920x1080) at 50/59.94/60 fps
  • 1080p (1920x1080) at 23.98/24/25/29.97/30/50/59.94/60 fps
  • UHD (3840x2160) at 23.98/24/25/29.97/30/50/59.94/60 fps
  • 4K (4096x2160) at 23.98/24/25/29.97/30/50/59.94/60 fps

Input Ports

  • overlay_buffer_input (optional): Video buffer for overlay mixing when enable_overlay is true

Output Ports

  • video_buffer_output: Video buffer containing the captured frame
  • overlay_buffer_output (optional): Empty video buffer for overlay when enable_overlay is true