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