Welcome to Firefly
Switch language
Firefly Docsss
Last Updated: 2026-08-27 07:36:09

Caps and Format Negotiation

Basic Concepts

2.4 Caps and Format Negotiation

Caps describe the media types and parameters supported by a pad, such as pixel format, resolution, and frame rate:

gst-launch-1.0 videotestsrc \
  ! 'video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1' \
  ! autovideosink

Common Caps types:

CapsMeaning
video/x-rawUncompressed video frames
video/x-h264H.264 encoded stream
video/x-h265H.265 encoded stream
image/jpegJPEG/MJPEG data
audio/x-rawUncompressed audio data

If the upstream and downstream Caps are incompatible, the pipeline reports negotiation errors such as not-negotiated. Check the actual formats and insert a parser, decoder, videoconvert, or videoscale as required.

On this page