diff --git a/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json b/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json index 38f43bd9a7..15a52bec68 100644 --- a/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json +++ b/subprojects/gst-plugins-bad/docs/plugins/gst_plugins_cache.json @@ -969,9 +969,750 @@ }, "filename": "gstaja", "license": "LGPL", - "other-types": {}, - "package": "GStreamer", - "source": "gstreamer", + "other-types": { + "GstAjaAudioSource": { + "kind": "enum", + "values": [ + { + "desc": "embedded", + "name": "Embedded", + "value": "0" + }, + { + "desc": "aes", + "name": "AES", + "value": "1" + }, + { + "desc": "analog", + "name": "Analog", + "value": "2" + }, + { + "desc": "hdmi", + "name": "HDMI", + "value": "3" + }, + { + "desc": "mic", + "name": "Microphone", + "value": "4" + } + ] + }, + "GstAjaAudioSystem": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "Auto (based on selected channel)", + "value": "0" + }, + { + "desc": "1", + "name": "Audio system 1", + "value": "1" + }, + { + "desc": "2", + "name": "Audio system 2", + "value": "2" + }, + { + "desc": "3", + "name": "Audio system 3", + "value": "3" + }, + { + "desc": "4", + "name": "Audio system 4", + "value": "4" + }, + { + "desc": "5", + "name": "Audio system 5", + "value": "5" + }, + { + "desc": "6", + "name": "Audio system 6", + "value": "6" + }, + { + "desc": "7", + "name": "Audio system 7", + "value": "7" + }, + { + "desc": "8", + "name": "Audio system 8", + "value": "8" + } + ] + }, + "GstAjaClosedCaptionCaptureMode": { + "kind": "enum", + "values": [ + { + "desc": "cea708-and-cea608", + "name": "CEA708 S334-2 and CEA608 S334-1 Annex A Closed Captions", + "value": "0" + }, + { + "desc": "cea708-or-cea608", + "name": "CEA708 S334-2 or if not existing CEA608 S334-1 Annex A Closed Captions", + "value": "1" + }, + { + "desc": "cea608-or-cea708", + "name": "CEA608 S334-1 Annex A or if not existing CEA708 S334-2 Closed Captions", + "value": "2" + }, + { + "desc": "cea708-only", + "name": "CEA708 S334-2 Closed Captions only", + "value": "3" + }, + { + "desc": "cea608-only", + "name": "CEA608 S334-1 Annex A Closed Captions only", + "value": "4" + }, + { + "desc": "none", + "name": "Don't capture Closed Captions", + "value": "5" + } + ] + }, + "GstAjaEmbeddedAudioInput": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "auto", + "value": "0" + }, + { + "desc": "video-1", + "name": "Video 1", + "value": "1" + }, + { + "desc": "video-2", + "name": "Video 2", + "value": "2" + }, + { + "desc": "video-3", + "name": "Video 3", + "value": "3" + }, + { + "desc": "video-4", + "name": "Video 4", + "value": "4" + }, + { + "desc": "video-5", + "name": "Video 5", + "value": "5" + }, + { + "desc": "video-6", + "name": "Video 6", + "value": "6" + }, + { + "desc": "video-7", + "name": "Video 7", + "value": "7" + }, + { + "desc": "video-8", + "name": "Video 8", + "value": "8" + } + ] + }, + "GstAjaInputSource": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "Auto (based on selected channel)", + "value": "0" + }, + { + "desc": "analog-1", + "name": "Analog Input 1", + "value": "1" + }, + { + "desc": "sdi-1", + "name": "SDI Input 1", + "value": "6" + }, + { + "desc": "sdi-2", + "name": "SDI Input 2", + "value": "7" + }, + { + "desc": "sdi-3", + "name": "SDI Input 3", + "value": "8" + }, + { + "desc": "sdi-4", + "name": "SDI Input 4", + "value": "9" + }, + { + "desc": "sdi-5", + "name": "SDI Input 5", + "value": "10" + }, + { + "desc": "sdi-6", + "name": "SDI Input 6", + "value": "11" + }, + { + "desc": "sdi-7", + "name": "SDI Input 7", + "value": "12" + }, + { + "desc": "sdi-8", + "name": "SDI Input 8", + "value": "13" + }, + { + "desc": "hdmi-1", + "name": "HDMI Input 1", + "value": "2" + }, + { + "desc": "hdmi-2", + "name": "HDMI Input 2", + "value": "3" + }, + { + "desc": "hdmi-3", + "name": "HDMI Input 3", + "value": "4" + }, + { + "desc": "hdmi-4", + "name": "HDMI Input 4", + "value": "5" + } + ] + }, + "GstAjaOutputDestination": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "Auto (based on selected channel)", + "value": "0" + }, + { + "desc": "analog", + "name": "Analog Output", + "value": "1" + }, + { + "desc": "sdi-1", + "name": "SDI Output 1", + "value": "2" + }, + { + "desc": "sdi-2", + "name": "SDI Output 2", + "value": "3" + }, + { + "desc": "sdi-3", + "name": "SDI Output 3", + "value": "4" + }, + { + "desc": "sdi-4", + "name": "SDI Output 4", + "value": "5" + }, + { + "desc": "sdi-5", + "name": "SDI Output 5", + "value": "6" + }, + { + "desc": "sdi-6", + "name": "SDI Output 6", + "value": "7" + }, + { + "desc": "sdi-7", + "name": "SDI Output 7", + "value": "8" + }, + { + "desc": "sdi-8", + "name": "SDI Output 8", + "value": "9" + }, + { + "desc": "hdmi", + "name": "HDMI Output", + "value": "10" + } + ] + }, + "GstAjaReferenceSource": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "Auto", + "value": "0" + }, + { + "desc": "freerun", + "name": "Freerun", + "value": "1" + }, + { + "desc": "external", + "name": "External", + "value": "2" + }, + { + "desc": "input-1", + "name": "SDI Input 1", + "value": "3" + }, + { + "desc": "input-2", + "name": "SDI Input 2", + "value": "4" + }, + { + "desc": "input-3", + "name": "SDI Input 3", + "value": "5" + }, + { + "desc": "input-4", + "name": "SDI Input 4", + "value": "6" + }, + { + "desc": "input-5", + "name": "SDI Input 5", + "value": "7" + }, + { + "desc": "input-6", + "name": "SDI Input 6", + "value": "8" + }, + { + "desc": "input-7", + "name": "SDI Input 7", + "value": "9" + }, + { + "desc": "input-8", + "name": "SDI Input 8", + "value": "10" + } + ] + }, + "GstAjaSdiMode": { + "kind": "enum", + "values": [ + { + "desc": "single-link", + "name": "Single Link", + "value": "0" + }, + { + "desc": "quad-link-sqd", + "name": "Quad Link SQD", + "value": "1" + }, + { + "desc": "quad-link-tsi", + "name": "Quad Link TSI", + "value": "2" + } + ] + }, + "GstAjaTimecodeIndex": { + "kind": "enum", + "values": [ + { + "desc": "vitc", + "name": "Embedded SDI VITC", + "value": "0" + }, + { + "desc": "atc-ltc", + "name": "Embedded SDI ATC LTC", + "value": "1" + }, + { + "desc": "ltc-1", + "name": "Analog LTC 1", + "value": "2" + }, + { + "desc": "ltc-2", + "name": "Analog LTC 2", + "value": "3" + } + ] + }, + "GstAjaVideoFormat": { + "kind": "enum", + "values": [ + { + "desc": "auto", + "name": "Auto detect format", + "value": "0" + }, + { + "desc": "1080i-5000", + "name": "1080i 5000", + "value": "1" + }, + { + "desc": "1080i-5994", + "name": "1080i 5994", + "value": "2" + }, + { + "desc": "1080i-6000", + "name": "1080i 6000", + "value": "3" + }, + { + "desc": "720p-5994", + "name": "720p 5994", + "value": "4" + }, + { + "desc": "720p-6000", + "name": "720p 6000", + "value": "5" + }, + { + "desc": "1080psf-2398", + "name": "1080psf 2398", + "value": "6" + }, + { + "desc": "1080psf-2400", + "name": "1080psf 2400", + "value": "7" + }, + { + "desc": "1080p-2997", + "name": "1080p 2997", + "value": "8" + }, + { + "desc": "1080p-3000", + "name": "1080p 3000", + "value": "9" + }, + { + "desc": "1080p-2500", + "name": "1080p 2500", + "value": "10" + }, + { + "desc": "1080p-2398", + "name": "1080p 2398", + "value": "11" + }, + { + "desc": "1080p-2400", + "name": "1080p 2400", + "value": "12" + }, + { + "desc": "720p-5000", + "name": "720p 5000", + "value": "13" + }, + { + "desc": "1080p-5000-a", + "name": "1080p 5000 A", + "value": "14" + }, + { + "desc": "1080p-5994-a", + "name": "1080p 5994 A", + "value": "15" + }, + { + "desc": "1080p-6000-a", + "name": "1080p 6000 A", + "value": "16" + }, + { + "desc": "720p-2398", + "name": "720p 2398", + "value": "17" + }, + { + "desc": "720p-2500", + "name": "720p 2500", + "value": "18" + }, + { + "desc": "1080psf-2500-2", + "name": "1080psf 2500 2", + "value": "19" + }, + { + "desc": "1080psf-2997-2", + "name": "1080psf 2997 2", + "value": "20" + }, + { + "desc": "1080psf-3000-2", + "name": "1080psf 3000 2", + "value": "21" + }, + { + "desc": "625-5000", + "name": "625 5000", + "value": "22" + }, + { + "desc": "525-5994", + "name": "525 5994", + "value": "23" + }, + { + "desc": "525-2398", + "name": "525 2398", + "value": "24" + }, + { + "desc": "525-2400", + "name": "525 2400", + "value": "25" + }, + { + "desc": "1080p-dci-2398", + "name": "1080p DCI 2398", + "value": "26" + }, + { + "desc": "1080p-dci-2400", + "name": "1080p DCI 2400", + "value": "27" + }, + { + "desc": "1080p-dci-2500", + "name": "1080p DCI 2500", + "value": "28" + }, + { + "desc": "1080p-dci-2997", + "name": "1080p DCI 2997", + "value": "29" + }, + { + "desc": "1080p-dci-3000", + "name": "1080p DCI 3000", + "value": "30" + }, + { + "desc": "1080p-dci-5000-a", + "name": "1080p DCI 5000 A", + "value": "31" + }, + { + "desc": "1080p-dci-5994-a", + "name": "1080p DCI 5994 A", + "value": "32" + }, + { + "desc": "1080p-dci-6000-a", + "name": "1080p DCI 6000 A", + "value": "33" + }, + { + "desc": "2160p-2398", + "name": "2160p 2398", + "value": "34" + }, + { + "desc": "2160p-2400", + "name": "2160p 2400", + "value": "35" + }, + { + "desc": "2160p-2500", + "name": "2160p 2500", + "value": "36" + }, + { + "desc": "2160p-2997", + "name": "2160p 2997", + "value": "37" + }, + { + "desc": "2160p-3000", + "name": "2160p 3000", + "value": "38" + }, + { + "desc": "2160p-5000", + "name": "2160p 5000", + "value": "39" + }, + { + "desc": "2160p-5994", + "name": "2160p 5994", + "value": "40" + }, + { + "desc": "2160p-6000", + "name": "2160p 6000", + "value": "41" + }, + { + "desc": "2160p-dci-2398", + "name": "2160p DCI 2398", + "value": "42" + }, + { + "desc": "2160p-dci-2400", + "name": "2160p DCI 2400", + "value": "43" + }, + { + "desc": "2160p-dci-2500", + "name": "2160p DCI 2500", + "value": "44" + }, + { + "desc": "2160p-dci-2997", + "name": "2160p DCI 2997", + "value": "45" + }, + { + "desc": "2160p-dci-3000", + "name": "2160p DCI 3000", + "value": "46" + }, + { + "desc": "2160p-dci-5000", + "name": "2160p DCI 5000", + "value": "47" + }, + { + "desc": "2160p-dci-5994", + "name": "2160p DCI 5994", + "value": "48" + }, + { + "desc": "2160p-dci-6000", + "name": "2160p DCI 6000", + "value": "49" + }, + { + "desc": "4320p-2398", + "name": "4320p 2398", + "value": "50" + }, + { + "desc": "4320p-2400", + "name": "4320p 2400", + "value": "51" + }, + { + "desc": "4320p-2500", + "name": "4320p 2500", + "value": "52" + }, + { + "desc": "4320p-2997", + "name": "4320p 2997", + "value": "53" + }, + { + "desc": "4320p-3000", + "name": "4320p 3000", + "value": "54" + }, + { + "desc": "4320p-5000", + "name": "4320p 5000", + "value": "55" + }, + { + "desc": "4320p-5994", + "name": "4320p 5994", + "value": "56" + }, + { + "desc": "4320p-6000", + "name": "4320p 6000", + "value": "57" + }, + { + "desc": "4320p-dci-2398", + "name": "4320p DCI 2398", + "value": "58" + }, + { + "desc": "4320p-dci-2400", + "name": "4320p DCI 2400", + "value": "59" + }, + { + "desc": "4320p-dci-2500", + "name": "4320p DCI 2500", + "value": "60" + }, + { + "desc": "4320p-dci-2997", + "name": "4320p DCI 2997", + "value": "61" + }, + { + "desc": "4320p-dci-3000", + "name": "4320p DCI 3000", + "value": "62" + }, + { + "desc": "4320p-dci-5000", + "name": "4320p DCI 5000", + "value": "63" + }, + { + "desc": "4320p-dci-5994", + "name": "4320p DCI 5994", + "value": "64" + }, + { + "desc": "4320p-dci-6000", + "name": "4320p DCI 6000", + "value": "65" + } + ] + } + }, + "package": "GStreamer Bad Plug-ins", + "source": "gst-plugins-bad", "tracers": {}, "url": "Unknown package origin" }, diff --git a/subprojects/gst-plugins-bad/sys/aja/README.md b/subprojects/gst-plugins-bad/sys/aja/README.md index 0934a55d06..669b0ffbe6 100644 --- a/subprojects/gst-plugins-bad/sys/aja/README.md +++ b/subprojects/gst-plugins-bad/sys/aja/README.md @@ -36,167 +36,3 @@ gst-launch-1.0 ajasrc video-format=1080p-3000 channel=1 input-source=sdi-1 audio 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 -``` diff --git a/subprojects/gst-plugins-bad/sys/aja/gstajacommon.cpp b/subprojects/gst-plugins-bad/sys/aja/gstajacommon.cpp index 1fef9c8f13..bd0e5fd41b 100644 --- a/subprojects/gst-plugins-bad/sys/aja/gstajacommon.cpp +++ b/subprojects/gst-plugins-bad/sys/aja/gstajacommon.cpp @@ -1178,4 +1178,20 @@ GType gst_aja_closed_caption_capture_mode_get_type(void) { void gst_aja_common_init(void) { GST_DEBUG_CATEGORY_INIT(gst_aja_debug, "aja", 0, "Debug category for AJA plugin"); + + gst_type_mark_as_plugin_api(GST_TYPE_AJA_AUDIO_SYSTEM, (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_OUTPUT_DESTINATION, + (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_REFERENCE_SOURCE, + (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_INPUT_SOURCE, (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_SDI_MODE, (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_VIDEO_FORMAT, (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_AUDIO_SOURCE, (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_EMBEDDED_AUDIO_INPUT, + (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_TIMECODE_INDEX, + (GstPluginAPIFlags)0); + gst_type_mark_as_plugin_api(GST_TYPE_AJA_CLOSED_CAPTION_CAPTURE_MODE, + (GstPluginAPIFlags)0); } diff --git a/subprojects/gst-plugins-bad/sys/aja/gstajasink.cpp b/subprojects/gst-plugins-bad/sys/aja/gstajasink.cpp index c729938123..d4cd63dfed 100644 --- a/subprojects/gst-plugins-bad/sys/aja/gstajasink.cpp +++ b/subprojects/gst-plugins-bad/sys/aja/gstajasink.cpp @@ -17,6 +17,34 @@ * Boston, MA 02110-1335, USA. */ +/** + * SECTION:element-ajasrc + * + * Source element for [AJA](https://www.aja.com) output cards. + * + * ## Example usage + * + * Output a 1080p2997 test audio/video stream + * + * ```sh + * 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 + * + * ```sh + * 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 + * ``` + * + * Since: 1.24 + * + */ + #ifdef HAVE_CONFIG_H #include "config.h" #endif diff --git a/subprojects/gst-plugins-bad/sys/aja/gstajasrc.cpp b/subprojects/gst-plugins-bad/sys/aja/gstajasrc.cpp index 2b3434560c..4ac1240434 100644 --- a/subprojects/gst-plugins-bad/sys/aja/gstajasrc.cpp +++ b/subprojects/gst-plugins-bad/sys/aja/gstajasrc.cpp @@ -17,6 +17,34 @@ * Boston, MA 02110-1335, USA. */ +/** + * SECTION:element-ajasrc + * + * Source element for [AJA](https://www.aja.com) capture cards. + * + * ## Example usage + * + * Capture 1080p30 audio/video and display it locally + * + * ```sh + * 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 + * ``` + * + * Capture 1080p30 audio/video and directly output it again on the same card + * + * ```sh + * 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 + * ``` + * + * Since: 1.24 + * + */ + #ifdef HAVE_CONFIG_H #include "config.h" #endif diff --git a/subprojects/gst-plugins-bad/sys/aja/plugin.cpp b/subprojects/gst-plugins-bad/sys/aja/plugin.cpp index bfd6f7f96e..fa0502b20e 100644 --- a/subprojects/gst-plugins-bad/sys/aja/plugin.cpp +++ b/subprojects/gst-plugins-bad/sys/aja/plugin.cpp @@ -16,6 +16,20 @@ * Free Software Foundation, Inc., 51 Franklin Street, Suite 500, * Boston, MA 02110-1335, USA. */ + +/** + * SECTION:plugin-aja + * + * Plugin for [AJA](https://www.aja.com) capture and output cards. + * + * This plugin requires the AJA NTV2 SDK version 16 or newer and works with + * both the [Open Source](https://github.com/aja-video/ntv2.git) and + * [proprietary](https://www.aja.com/family/developer) version. + * + * Since: 1.24 + * + */ + #ifdef HAVE_CONFIG_H #include "config.h" #endif