mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2025-05-14 12:18:57 +00:00
GStreamer multimedia framework
bfdf93ecd1
The number of frame stores / frame buffers can't be used like this as the actual number of frames that can be used also depends on the resolution. If too many frames are used and the card's memory runs full, strange problems (green frames, channels leaking into each other, etc.) will appear. As such, configure 8 frames for the source by default and half the queue length for the sink. If anything else is needed, manual configuration via the properties has to happen based on the expected workload on all channels and the characteristics of the card in use. |
||
|---|---|---|
| .clang-format | ||
| .gitignore | ||
| COPYING | ||
| gstajacommon.cpp | ||
| gstajacommon.h | ||
| gstajadeviceprovider.cpp | ||
| gstajadeviceprovider.h | ||
| gstajasink.cpp | ||
| gstajasink.h | ||
| gstajasinkcombiner.cpp | ||
| gstajasinkcombiner.h | ||
| gstajasrc.cpp | ||
| gstajasrc.h | ||
| gstajasrcdemux.cpp | ||
| gstajasrcdemux.h | ||
| meson.build | ||
| meson_options.txt | ||
| plugin.cpp | ||
| README.md | ||
GStreamer AJA source/sink plugin
GStreamer plugin for AJA capture and output cards.
This plugin requires the NTV2 SDK version 16 or newer.
Example usage
Capture 1080p30 audio/video and display it locally
gst-launch-1.0 ajasrc video-format=1080p-3000 ! ajasrcdemux name=d \
d.video ! queue max-size-bytes=0 max-size-buffers=0 max-size-time=1000000000 ! videoconvert ! autovideosink \
d.audio ! queue max-size-bytes=0 max-size-buffers=0 max-size-time=1000000000 ! audioconvert ! audioresample ! autoaudiosink
Output a 1080p2997 test audio/video stream
gst-launch-1.0 videotestsrc pattern=ball ! video/x-raw,format=v210,width=1920,height=1080,framerate=30000/1001,interlace-mode=progressive ! timeoverlay ! timecodestamper ! combiner.video \
audiotestsrc freq=440 ! audio/x-raw,format=S32LE,rate=48000,channels=16 ! audiobuffersplit output-buffer-duration=1/30 ! combiner.audio \
ajasinkcombiner name=combiner ! ajasink channel=0
Capture 1080p30 audio/video and directly output it again on the same card
gst-launch-1.0 ajasrc video-format=1080p-3000 channel=1 input-source=sdi-1 audio-system=2 ! ajasrcdemux name=d \
d.video ! queue max-size-bytes=0 max-size-buffers=0 max-size-time=1000000000 ! c.video \
d.audio ! queue max-size-bytes=0 max-size-buffers=0 max-size-time=1000000000 ! c.audio \
ajasinkcombiner name=c ! ajasink channel=0 reference-source=input-1
Configuration
Source
audio-source : Audio source to use
flags: readable, writable
Enum "GstAjaAudioSource" Default: 0, "Embedded"
(0): Embedded - embedded
(1): AES - aes
(2): Analog - analog
(3): HDMI - hdmi
(4): Microphone - mic
audio-system : Audio system to use
flags: readable, writable
Enum "GstAjaAudioSystem" Default: 0, "Auto (based on selected channel)"
(0): Auto (based on selected channel) - auto
(1): Audio system 1 - 1
(2): Audio system 2 - 2
(3): Audio system 3 - 3
(4): Audio system 4 - 4
(5): Audio system 5 - 5
(6): Audio system 6 - 6
(7): Audio system 7 - 7
(8): Audio system 8 - 8
capture-cpu-core : Sets the affinity of the capture thread to this CPU core (-1=disabled)
flags: readable, writable
Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295
channel : Channel to use
flags: readable, writable
Unsigned Integer. Range: 0 - 7 Default: 0
device-identifier : Input device instance to use
flags: readable, writable
String. Default: "0"
input-source : Input source to use
flags: readable, writable
Enum "GstAjaInputSource" Default: 0, "Auto (based on selected channel)"
(0): Auto (based on selected channel) - auto
(1): Analog Input 1 - analog-1
(6): SDI Input 1 - sdi-1
(7): SDI Input 2 - sdi-2
(8): SDI Input 3 - sdi-3
(9): SDI Input 4 - sdi-4
(10): SDI Input 5 - sdi-5
(11): SDI Input 6 - sdi-6
(12): SDI Input 7 - sdi-7
(13): SDI Input 8 - sdi-8
(2): HDMI Input 1 - hdmi-1
(3): HDMI Input 2 - hdmi-2
(4): HDMI Input 3 - hdmi-3
(5): HDMI Input 4 - hdmi-4
queue-size : Size of internal queue in number of video frames. Half of this is allocated as device buffers and equal to the latency.
flags: readable, writable
Unsigned Integer. Range: 1 - 2147483647 Default: 16
reference-source : Reference source to use
flags: readable, writable
Enum "GstAjaReferenceSource" Default: 1, "Freerun"
(0): Auto - auto
(1): Freerun - freerun
(2): External - external
(3): SDI Input 1 - input-1
(4): SDI Input 2 - input-2
(5): SDI Input 3 - input-3
(6): SDI Input 4 - input-4
(7): SDI Input 5 - input-5
(8): SDI Input 6 - input-6
(9): SDI Input 7 - input-7
(10): SDI Input 8 - input-8
timecode-index : Timecode index to use
flags: readable, writable
Enum "GstAjaTimecodeIndex" Default: 0, "Embedded SDI ATC LTC"
(0): Embedded SDI VITC - vitc
(0): Embedded SDI ATC LTC - atc-ltc
(2): Analog LTC 1 - ltc-1
(3): Analog LTC 2 - ltc-2
video-format : Video format to use
flags: readable, writable
Enum "GstAjaVideoFormat" Default: 0, "1080i 5000"
(0): 1080i 5000 - 1080i-5000
(1): 1080i 5994 - 1080i-5994
(2): 1080i 6000 - 1080i-6000
(3): 720p 5994 - 720p-5994
(4): 720p 6000 - 720p-6000
(5): 1080p 2997 - 1080p-2997
(6): 1080p 3000 - 1080p-3000
(7): 1080p 2500 - 1080p-2500
(8): 1080p 2398 - 1080p-2398
(9): 1080p 2400 - 1080p-2400
(10): 720p 5000 - 720p-5000
(11): 720p 2398 - 720p-2398
(12): 720p 2500 - 720p-2500
(13): 1080p 5000 A - 1080p-5000-a
(14): 1080p 5994 A - 1080p-5994-a
(15): 1080p 6000 A - 1080p-6000-a
(16): 625 5000 - 625-5000
(17): 525 5994 - 525-5994
(18): 525 2398 - 525-2398
(19): 525 2400 - 525-2400
Sink
audio-system : Audio system to use
flags: readable, writable
Enum "GstAjaAudioSystem" Default: 0, "Auto (based on selected channel)"
(0): Auto (based on selected channel) - auto
(1): Audio system 1 - 1
(2): Audio system 2 - 2
(3): Audio system 3 - 3
(4): Audio system 4 - 4
(5): Audio system 5 - 5
(6): Audio system 6 - 6
(7): Audio system 7 - 7
(8): Audio system 8 - 8
channel : Channel to use
flags: readable, writable
Unsigned Integer. Range: 0 - 7 Default: 0
device-identifier : Input device instance to use
flags: readable, writable
String. Default: "0"
output-cpu-core : Sets the affinity of the output thread to this CPU core (-1=disabled)
flags: readable, writable
Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295
output-destination : Output destination to use
flags: readable, writable
Enum "GstAjaOutputDestination" Default: 0, "Auto (based on selected channel)"
(0): Auto (based on selected channel) - auto
(1): Analog Output - analog
(2): SDI Output 1 - sdi-1
(3): SDI Output 2 - sdi-2
(4): SDI Output 3 - sdi-3
(5): SDI Output 4 - sdi-4
(6): SDI Output 5 - sdi-5
(7): SDI Output 6 - sdi-6
(8): SDI Output 7 - sdi-7
(9): SDI Output 8 - sdi-8
(10): HDMI Output - hdmi
queue-size : Size of internal queue in number of video frames. Half of this is allocated as device buffers and equal to the latency.
flags: readable, writable
Unsigned Integer. Range: 1 - 2147483647 Default: 16
reference-source : Reference source to use
flags: readable, writable
Enum "GstAjaReferenceSource" Default: 0, "Auto"
(0): Auto - auto
(1): Freerun - freerun
(2): External - external
(3): SDI Input 1 - input-1
(4): SDI Input 2 - input-2
(5): SDI Input 3 - input-3
(6): SDI Input 4 - input-4
(7): SDI Input 5 - input-5
(8): SDI Input 6 - input-6
(9): SDI Input 7 - input-7
(10): SDI Input 8 - input-8
timecode-index : Timecode index to use
flags: readable, writable
Enum "GstAjaTimecodeIndex" Default: 0, "Embedded SDI ATC LTC"
(0): Embedded SDI VITC - vitc
(0): Embedded SDI ATC LTC - atc-ltc
(2): Analog LTC 1 - ltc-1
(3): Analog LTC 2 - ltc-2