#GstEncodingTarget category for device-specific targets. The name of the target will usually be the constructor and model of the device, and that target will contain #GstEncodingProfiles suitable for that device.
#GstEncodingTarget category for file extensions. The name of the target will be the name of the file extensions possible for a particular target. Those targets are defining like 'default' formats usually used for a particular file extension.
#GstEncodingTarget category for online-services. The name of the target will usually be the name of the online service and that target will contain #GstEncodingProfiles suitable for that online service.
#GstEncodingTarget category for storage, archiving and editing targets. Those targets can be lossless and/or provide very fast random access content. The name of the target will usually be the container type or editing target, and that target will contain #GstEncodingProfiles suitable for editing or storage.
The major version of GStreamer's gst-plugins-base libraries at compile time.
The micro version of GStreamer's gst-plugins-base libraries at compile time.
The minor version of GStreamer's gst-plugins-base libraries at compile time.
The nano version of GStreamer's gst-plugins-base libraries at compile time. Actual releases have 0, GIT versions have 1, prerelease versions have 2-...
Sets the level and profile on caps if it can be determined from
audio_config. See gst_codec_utils_aac_get_level() and
gst_codec_utils_aac_get_profile() for more details on the parameters.
caps must be audio/mpeg caps with an "mpegversion" field of either 2 or 4.
If mpegversion is 4, the "base-profile" field is also set in caps.
the #GstCaps to which level and profile fields are to be added
a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1. (See below for more details)
Returns the channels of the given AAC stream.
a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1.
Translates the sample rate to the index corresponding to it in AAC spec.
Sample rate
Determines the level of a stream as defined in ISO/IEC 14496-3. For AAC LC streams, the constraints from the AAC audio profile are applied. For AAC Main, LTP, SSR and others, the Main profile is used.
The audio_config parameter follows the following format, starting from the
most significant bit of the first byte:
a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1.
Returns the profile of the given AAC stream as a string. The profile is
normally determined using the AudioObjectType field which is in the first
5 bits of audio_config
a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1.
Translates the sample rate index found in AAC headers to the actual sample rate.
a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1.
Translates the sample rate index found in AAC headers to the actual sample rate.
Sample rate index as from the AudioSpecificConfig (MPEG-4 container) or ADTS frame header
Converts a RFC 6381 compatible codec string to #GstCaps. More than one codec
string can be present (separated by ,).
Registered codecs can be found at http://mp4ra.org/#/codecs
A mime codec string field
Converts caps to a RFC 6381 compatible codec string if possible.
Useful for providing the 'codecs' field inside the 'Content-Type' HTTP header for containerized formats, such as mp4 or matroska.
Registered codecs can be found at http://mp4ra.org/#/codecs
Sets the level and profile in caps if it can be determined from sps. See
gst_codec_utils_h264_get_level() and gst_codec_utils_h264_get_profile()
for more details on the parameters.
the #GstCaps to which the level and profile are to be added
Pointer to the sequence parameter set for the stream.
Converts the level indication (level_idc) in the stream's sequence parameter set into a string. The SPS is expected to have the same format as for gst_codec_utils_h264_get_profile().
Pointer to the sequence parameter set for the stream.
Transform a level string from the caps into the level_idc
A level string from caps
Converts the profile indication (profile_idc) in the stream's sequence parameter set into a string. The SPS is expected to have the following format, as defined in the H.264 specification. The SPS is viewed as a bitstream here, with bit 0 being the most significant bit of the first byte.
Pointer to the sequence parameter set for the stream.
Parses profile, flags, and level from a H264 AVCC extradata/sequence_header. These are most commonly retrieved from a video/x-h264 caps with a codec_data buffer.
The format of H264 AVCC extradata/sequence_header is documented in the ITU-T H.264 specification section 7.3.2.1.1 as well as in ISO/IEC 14496-15 section 5.3.3.1.2.
H264 AVCC extradata
Sets the level, tier and profile in caps if it can be determined from
profile_tier_level. See gst_codec_utils_h265_get_level(),
gst_codec_utils_h265_get_tier() and gst_codec_utils_h265_get_profile()
for more details on the parameters.
the #GstCaps to which the level, tier and profile are to be added
Pointer to the profile_tier_level struct
Converts the level indication (general_level_idc) in the stream's profile_tier_level structure into a string. The profiel_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile().
Pointer to the profile_tier_level for the stream
Transform a level string from the caps into the level_idc
A level string from caps
Converts the profile indication (general_profile_idc) in the stream's profile_level_tier structure into a string. The profile_tier_level is expected to have the following format, as defined in the H.265 specification. The profile_tier_level is viewed as a bitstream here, with bit 0 being the most significant bit of the first byte.
Pointer to the profile_tier_level structure for the stream.
Converts the tier indication (general_tier_flag) in the stream's profile_tier_level structure into a string. The profile_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile().
Pointer to the profile_tier_level for the stream.
Sets the level and profile in caps if it can be determined from
vis_obj_seq. See gst_codec_utils_mpeg4video_get_level() and
gst_codec_utils_mpeg4video_get_profile() for more details on the
parameters.
the #GstCaps to which the level and profile are to be added
Pointer to the visual object sequence for the stream.
Converts the level indication in the stream's visual object sequence into
a string. vis_obj_seq is expected to be the data following the visual
object sequence start code. Only the first byte
(profile_and_level_indication) is used.
Pointer to the visual object sequence for the stream.
Converts the profile indication in the stream's visual object sequence into
a string. vis_obj_seq is expected to be the data following the visual
object sequence start code. Only the first byte
(profile_and_level_indication) is used.
Pointer to the visual object sequence for the stream.
Creates Opus caps from the given parameters.
the sample rate
the number of channels
the channel mapping family
the number of independent streams
the number of stereo streams
the mapping between the streams
Creates OpusHead header from the given parameters.
the sample rate
the number of channels
the channel mapping family
the number of independent streams
the number of stereo streams
the mapping between the streams
Pre-skip in 48kHz samples or 0
Output gain or 0
List all available #GstEncodingTarget for the specified category, or all categories
if categoryname is %NULL.
The category, for ex: #GST_ENCODING_CATEGORY_DEVICE. Can be %NULL.
Lists all #GstEncodingTarget categories present on disk.
Requests plugin installation without blocking. Once the plugins have been
installed or installation has failed, func will be called with the result
of the installation and your provided user_data pointer.
This function requires a running GLib/Gtk main loop. If you are not running a GLib/Gtk main loop, make sure to regularly call g_main_context_iteration(NULL,FALSE).
The installer strings that make up detail are typically obtained by
calling gst_missing_plugin_message_get_installer_detail() on missing-plugin
messages that have been caught on a pipeline's bus or created by the
application via the provided API, such as gst_missing_element_message_new().
It is possible to request the installation of multiple missing plugins in one go (as might be required if there is a demuxer for a certain format installed but no suitable video decoder and no suitable audio decoder).
NULL-terminated array of installer string details (see below)
a #GstInstallPluginsContext, or NULL
the function to call when the installer program returns
Checks whether plugin installation (initiated by this application only) is currently in progress.
Convenience function to return the descriptive string associated with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging.
the return status code
Checks whether plugin installation is likely to be supported by the current environment. This currently only checks whether the helper script that is to be provided by the distribution or operating system vendor exists.
Requests plugin installation and block until the plugins have been installed or installation has failed.
This function should almost never be used, it only exists for cases where a non-GLib main loop is running and the user wants to run it in a separate thread and marshal the result back asynchronously into the main thread using the other non-GLib main loop. You should almost always use gst_install_plugins_async() instead of this function.
NULL-terminated array of installer string details
a #GstInstallPluginsContext, or NULL
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.
Creates a missing-plugin message for element to notify the application
that a decoder element for a particular set of (fixed) caps is missing.
This function is mainly for use in plugins.
the #GstElement posting the message
the (fixed) caps for which a decoder element is needed
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.
the name of the missing element (element factory), e.g. "videoscale" or "cdparanoiasrc"
Creates a missing-plugin message for element to notify the application
that a certain required element is missing. This function is mainly for
use in plugins.
the #GstElement posting the message
the name of the missing element (element factory), e.g. "videoscale" or "cdparanoiasrc"
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.
Creates a missing-plugin message for element to notify the application
that an encoder element for a particular set of (fixed) caps is missing.
This function is mainly for use in plugins.
the #GstElement posting the message
the (fixed) caps for which an encoder element is needed
Returns a localised string describing the missing feature, for use in
error dialogs and the like. Should never return NULL unless msg is not
a valid missing-plugin message.
This function is mainly for applications that need a human-readable string describing a missing plugin, given a previously collected missing-plugin message
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions.
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.
the URI protocol the missing source needs to implement, e.g. "http" or "mms"
Creates a missing-plugin message for element to notify the application
that a sink element for a particular URI protocol is missing. This
function is mainly for use in plugins.
the #GstElement posting the message
the URI protocol the missing sink needs to implement, e.g. "http" or "smb"
Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync().
This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.
the URI protocol the missing source needs to implement, e.g. "http" or "mms"
Creates a missing-plugin message for element to notify the application
that a source element for a particular URI protocol is missing. This
function is mainly for use in plugins.
the #GstElement posting the message
the URI protocol the missing source needs to implement, e.g. "http" or "mms"
Adds a codec tag describing the format specified by caps to taglist.
a #GstTagList
a GStreamer codec tag such as #GST_TAG_AUDIO_CODEC, #GST_TAG_VIDEO_CODEC or #GST_TAG_CODEC. If none is specified, the function will attempt to detect the appropriate category.
the (fixed) #GstCaps for which a codec tag should be added.
Returns flags that describe the format of the caps if known. No flags are set for unknown caps.
Returns a localised (as far as this is possible) string describing the
media format specified in caps, for use in error dialogs or other messages
to be seen by the user. Should never return NULL unless caps is invalid.
Also see the convenience function gst_pb_utils_add_codec_description_to_tag_list().
Returns a localised string describing an decoder for the format specified
in caps, for use in error dialogs or other messages to be seen by the user.
Should never return NULL unless factory_name or caps are invalid.
This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.
Returns a localised string describing the given element, for use in
error dialogs or other messages to be seen by the user. Should never
return NULL unless factory_name is invalid.
This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.
the name of the element, e.g. "giosrc"
Returns a localised string describing an encoder for the format specified
in caps, for use in error dialogs or other messages to be seen by the user.
Should never return NULL unless factory_name or caps are invalid.
This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.
Returns a localised string describing a sink element handling the protocol
specified in protocol, for use in error dialogs or other messages to be
seen by the user. Should never return NULL unless protocol is invalid.
This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.
the protocol the sink element needs to handle, e.g. "http"
Returns a localised string describing a source element handling the protocol
specified in protocol, for use in error dialogs or other messages to be
seen by the user. Should never return NULL unless protocol is invalid.
This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.
the protocol the source element needs to handle, e.g. "http"
Initialises the base utils support library. This function is not thread-safe. Applications should call it after calling gst_init(), plugins should call it from their plugin_init function.
This function may be called multiple times. It will do nothing if the library has already been initialised.
Gets the version number of the GStreamer Plugins Base libraries.
This function returns a string that is useful for describing this version of GStreamer's gst-plugins-base libraries to the outside world: user agent strings, logging, about dialogs ...
#GstEncodingTarget category for recording and capture. Targets within this category are optimized for low latency encoding.