/* GStreamer * Copyright (C) 2010 Collabora Multimedia * 2010 Nokia Corporation * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifdef HAVE_CONFIG_H #include "config.h" #endif #include "pbutils.h" #include "pbutils-private.h" static GstDiscovererStreamInfo * gst_discoverer_info_copy_int (GstDiscovererStreamInfo * info, GHashTable * stream_map); static GstDiscovererContainerInfo * gst_stream_container_info_copy_int (GstDiscovererContainerInfo * ptr, GHashTable * stream_map); static GstDiscovererAudioInfo * gst_discoverer_audio_info_copy_int (GstDiscovererAudioInfo * ptr); static GstDiscovererVideoInfo * gst_discoverer_video_info_copy_int (GstDiscovererVideoInfo * ptr); static GstDiscovererSubtitleInfo * gst_discoverer_subtitle_info_copy_int (GstDiscovererSubtitleInfo * ptr); /* Per-stream information */ G_DEFINE_TYPE (GstDiscovererStreamInfo, gst_discoverer_stream_info, G_TYPE_OBJECT); static void gst_discoverer_stream_info_init (GstDiscovererStreamInfo * info) { /* Nothing needs initialization */ } static void gst_discoverer_stream_info_finalize (GObject * object) { GstDiscovererStreamInfo *info = (GstDiscovererStreamInfo *) object; if (info->next) g_object_unref ((GObject *) info->next); if (info->caps) gst_caps_unref (info->caps); if (info->tags) gst_tag_list_unref (info->tags); if (info->toc) gst_toc_unref (info->toc); g_free (info->stream_id); if (info->misc) gst_structure_free (info->misc); } static void gst_discoverer_stream_info_class_init (GObjectClass * klass) { klass->finalize = gst_discoverer_stream_info_finalize; } static GstDiscovererStreamInfo * gst_discoverer_stream_info_new (void) { return (GstDiscovererStreamInfo *) g_object_new (GST_TYPE_DISCOVERER_STREAM_INFO, NULL); } static GstDiscovererStreamInfo * gst_discoverer_info_copy_int (GstDiscovererStreamInfo * info, GHashTable * stream_map) { GstDiscovererStreamInfo *ret; GType ltyp; g_return_val_if_fail (info != NULL, NULL); ltyp = G_TYPE_FROM_INSTANCE (info); if (ltyp == GST_TYPE_DISCOVERER_CONTAINER_INFO) { ret = (GstDiscovererStreamInfo *) gst_stream_container_info_copy_int ( (GstDiscovererContainerInfo *) info, stream_map); } else if (ltyp == GST_TYPE_DISCOVERER_AUDIO_INFO) { ret = (GstDiscovererStreamInfo *) gst_discoverer_audio_info_copy_int ((GstDiscovererAudioInfo *) info); } else if (ltyp == GST_TYPE_DISCOVERER_VIDEO_INFO) { ret = (GstDiscovererStreamInfo *) gst_discoverer_video_info_copy_int ((GstDiscovererVideoInfo *) info); } else if (ltyp == GST_TYPE_DISCOVERER_SUBTITLE_INFO) { ret = (GstDiscovererStreamInfo *) gst_discoverer_subtitle_info_copy_int ((GstDiscovererSubtitleInfo *) info); } else ret = gst_discoverer_stream_info_new (); if (info->next) { ret->next = gst_discoverer_info_copy_int (info->next, stream_map); ret->next->previous = ret; } if (info->caps) ret->caps = gst_caps_copy (info->caps); if (info->tags) ret->tags = gst_tag_list_copy (info->tags); if (info->toc) ret->toc = gst_toc_ref (info->toc); if (info->stream_id) ret->stream_id = g_strdup (info->stream_id); if (info->misc) ret->misc = gst_structure_copy (info->misc); if (stream_map) g_hash_table_insert (stream_map, info, ret); return ret; } /* Container information */ G_DEFINE_TYPE (GstDiscovererContainerInfo, gst_discoverer_container_info, GST_TYPE_DISCOVERER_STREAM_INFO); static void gst_discoverer_container_info_init (GstDiscovererContainerInfo * info) { /* Nothing to initialize */ } static GstDiscovererContainerInfo * gst_discoverer_container_info_new (void) { return (GstDiscovererContainerInfo *) g_object_new (GST_TYPE_DISCOVERER_CONTAINER_INFO, NULL); } static void gst_discoverer_container_info_finalize (GObject * object) { GstDiscovererContainerInfo *info = (GstDiscovererContainerInfo *) object; GList *tmp; for (tmp = ((GstDiscovererContainerInfo *) info)->streams; tmp; tmp = tmp->next) g_object_unref ((GObject *) tmp->data); gst_discoverer_stream_info_list_free (info->streams); gst_discoverer_stream_info_finalize ((GObject *) info); } static void gst_discoverer_container_info_class_init (GObjectClass * klass) { klass->finalize = gst_discoverer_container_info_finalize; } static GstDiscovererContainerInfo * gst_stream_container_info_copy_int (GstDiscovererContainerInfo * ptr, GHashTable * stream_map) { GstDiscovererContainerInfo *ret; GList *tmp; g_return_val_if_fail (ptr != NULL, NULL); ret = gst_discoverer_container_info_new (); for (tmp = ((GstDiscovererContainerInfo *) ptr)->streams; tmp; tmp = tmp->next) { GstDiscovererStreamInfo *subtop = gst_discoverer_info_copy_int (tmp->data, stream_map); ret->streams = g_list_append (ret->streams, subtop); if (stream_map) g_hash_table_insert (stream_map, tmp->data, subtop); } return ret; } /* Audio information */ G_DEFINE_TYPE (GstDiscovererAudioInfo, gst_discoverer_audio_info, GST_TYPE_DISCOVERER_STREAM_INFO); static void gst_discoverer_audio_info_finalize (GObject * object) { GstDiscovererAudioInfo *info = (GstDiscovererAudioInfo *) object; g_free (info->language); G_OBJECT_CLASS (gst_discoverer_audio_info_parent_class)->finalize (object); } static void gst_discoverer_audio_info_class_init (GObjectClass * klass) { klass->finalize = gst_discoverer_audio_info_finalize; } static void gst_discoverer_audio_info_init (GstDiscovererAudioInfo * info) { info->language = NULL; } static GstDiscovererAudioInfo * gst_discoverer_audio_info_new (void) { return (GstDiscovererAudioInfo *) g_object_new (GST_TYPE_DISCOVERER_AUDIO_INFO, NULL); } static GstDiscovererAudioInfo * gst_discoverer_audio_info_copy_int (GstDiscovererAudioInfo * ptr) { GstDiscovererAudioInfo *ret; ret = gst_discoverer_audio_info_new (); ret->channels = ptr->channels; ret->channel_mask = ptr->channel_mask; ret->sample_rate = ptr->sample_rate; ret->depth = ptr->depth; ret->bitrate = ptr->bitrate; ret->max_bitrate = ptr->max_bitrate; ret->language = g_strdup (ptr->language); return ret; } /* Subtitle information */ G_DEFINE_TYPE (GstDiscovererSubtitleInfo, gst_discoverer_subtitle_info, GST_TYPE_DISCOVERER_STREAM_INFO); static void gst_discoverer_subtitle_info_init (GstDiscovererSubtitleInfo * info) { info->language = NULL; } static void gst_discoverer_subtitle_info_finalize (GObject * object) { GstDiscovererSubtitleInfo *info = (GstDiscovererSubtitleInfo *) object; g_free (info->language); G_OBJECT_CLASS (gst_discoverer_subtitle_info_parent_class)->finalize (object); } static void gst_discoverer_subtitle_info_class_init (GObjectClass * klass) { klass->finalize = gst_discoverer_subtitle_info_finalize; } static GstDiscovererSubtitleInfo * gst_discoverer_subtitle_info_new (void) { return (GstDiscovererSubtitleInfo *) g_object_new (GST_TYPE_DISCOVERER_SUBTITLE_INFO, NULL); } static GstDiscovererSubtitleInfo * gst_discoverer_subtitle_info_copy_int (GstDiscovererSubtitleInfo * ptr) { GstDiscovererSubtitleInfo *ret; ret = gst_discoverer_subtitle_info_new (); ret->language = g_strdup (ptr->language); return ret; } /* Video information */ G_DEFINE_TYPE (GstDiscovererVideoInfo, gst_discoverer_video_info, GST_TYPE_DISCOVERER_STREAM_INFO); static void gst_discoverer_video_info_class_init (GObjectClass * klass) { /* Nothing to initialize */ } static void gst_discoverer_video_info_init (GstDiscovererVideoInfo * info) { /* Nothing to initialize */ } static GstDiscovererVideoInfo * gst_discoverer_video_info_new (void) { return (GstDiscovererVideoInfo *) g_object_new (GST_TYPE_DISCOVERER_VIDEO_INFO, NULL); } static GstDiscovererVideoInfo * gst_discoverer_video_info_copy_int (GstDiscovererVideoInfo * ptr) { GstDiscovererVideoInfo *ret; ret = gst_discoverer_video_info_new (); ret->width = ptr->width; ret->height = ptr->height; ret->depth = ptr->depth; ret->framerate_num = ptr->framerate_num; ret->framerate_denom = ptr->framerate_denom; ret->par_num = ptr->par_num; ret->par_denom = ptr->par_denom; ret->interlaced = ptr->interlaced; ret->bitrate = ptr->bitrate; ret->max_bitrate = ptr->max_bitrate; ret->is_image = ptr->is_image; return ret; } /* Global stream information */ G_DEFINE_TYPE (GstDiscovererInfo, gst_discoverer_info, G_TYPE_OBJECT); static void gst_discoverer_info_init (GstDiscovererInfo * info) { info->missing_elements_details = g_ptr_array_new_with_free_func (g_free); } static void gst_discoverer_info_finalize (GObject * object) { GstDiscovererInfo *info = (GstDiscovererInfo *) object; g_free (info->uri); if (info->stream_info) g_object_unref ((GObject *) info->stream_info); if (info->misc) gst_structure_free (info->misc); g_list_free (info->stream_list); if (info->tags) gst_tag_list_unref (info->tags); if (info->toc) gst_toc_unref (info->toc); g_ptr_array_unref (info->missing_elements_details); } static GstDiscovererInfo * gst_discoverer_info_new (void) { return (GstDiscovererInfo *) g_object_new (GST_TYPE_DISCOVERER_INFO, NULL); } /** * gst_discoverer_info_copy: * @ptr: (transfer none): a #GstDiscovererInfo * * Returns: (transfer full): A copy of the #GstDiscovererInfo */ GstDiscovererInfo * gst_discoverer_info_copy (GstDiscovererInfo * ptr) { GstDiscovererInfo *ret; GHashTable *stream_map; GList *tmp; g_return_val_if_fail (ptr != NULL, NULL); stream_map = g_hash_table_new (g_direct_hash, NULL); ret = gst_discoverer_info_new (); ret->uri = g_strdup (ptr->uri); if (ptr->stream_info) { ret->stream_info = gst_discoverer_info_copy_int (ptr->stream_info, stream_map); } ret->duration = ptr->duration; ret->result = ptr->result; ret->seekable = ptr->seekable; ret->live = ptr->live; if (ptr->misc) ret->misc = gst_structure_copy (ptr->misc); /* We need to set up the new list of streams to correspond to old one. The * list just contains a set of pointers to streams in the stream_info tree, * so we keep a map of old stream info objects to the corresponding new * ones and use that to figure out correspondence in stream_list. */ for (tmp = ptr->stream_list; tmp; tmp = tmp->next) { GstDiscovererStreamInfo *old_stream = (GstDiscovererStreamInfo *) tmp->data; GstDiscovererStreamInfo *new_stream = g_hash_table_lookup (stream_map, old_stream); g_assert (new_stream != NULL); ret->stream_list = g_list_append (ret->stream_list, new_stream); } if (ptr->tags) ret->tags = gst_tag_list_copy (ptr->tags); if (ptr->toc) ret->toc = gst_toc_ref (ptr->toc); g_hash_table_destroy (stream_map); return ret; } static void gst_discoverer_info_class_init (GObjectClass * klass) { klass->finalize = gst_discoverer_info_finalize; } /** * gst_discoverer_stream_info_list_free: * @infos: (element-type GstPbutils.DiscovererStreamInfo): a #GList of #GstDiscovererStreamInfo * * Decrements the reference count of all contained #GstDiscovererStreamInfo * and fress the #GList. */ void gst_discoverer_stream_info_list_free (GList * infos) { GList *tmp; for (tmp = infos; tmp; tmp = tmp->next) gst_discoverer_stream_info_unref ((GstDiscovererStreamInfo *) tmp->data); g_list_free (infos); } /** * gst_discoverer_info_get_streams: * @info: a #GstDiscovererInfo * @streamtype: a #GType derived from #GstDiscovererStreamInfo * * Finds the #GstDiscovererStreamInfo contained in @info that match the * given @streamtype. * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): A #GList of * matching #GstDiscovererStreamInfo. The caller should free it with * gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_streams (GstDiscovererInfo * info, GType streamtype) { GList *tmp, *res = NULL; for (tmp = info->stream_list; tmp; tmp = tmp->next) { GstDiscovererStreamInfo *stmp = (GstDiscovererStreamInfo *) tmp->data; if (G_TYPE_CHECK_INSTANCE_TYPE (stmp, streamtype)) res = g_list_append (res, gst_discoverer_stream_info_ref (stmp)); } return res; } /** * gst_discoverer_info_get_audio_streams: * @info: a #GstDiscovererInfo * * Finds all the #GstDiscovererAudioInfo contained in @info * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): A #GList of * matching #GstDiscovererStreamInfo. The caller should free it with * gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_audio_streams (GstDiscovererInfo * info) { return gst_discoverer_info_get_streams (info, GST_TYPE_DISCOVERER_AUDIO_INFO); } /** * gst_discoverer_info_get_video_streams: * @info: a #GstDiscovererInfo * * Finds all the #GstDiscovererVideoInfo contained in @info * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): A #GList of * matching #GstDiscovererStreamInfo. The caller should free it with * gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_video_streams (GstDiscovererInfo * info) { return gst_discoverer_info_get_streams (info, GST_TYPE_DISCOVERER_VIDEO_INFO); } /** * gst_discoverer_info_get_subtitle_streams: * @info: a #GstDiscovererInfo * * Finds all the #GstDiscovererSubtitleInfo contained in @info * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): A #GList of * matching #GstDiscovererStreamInfo. The caller should free it with * gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_subtitle_streams (GstDiscovererInfo * info) { return gst_discoverer_info_get_streams (info, GST_TYPE_DISCOVERER_SUBTITLE_INFO); } /** * gst_discoverer_info_get_container_streams: * @info: a #GstDiscovererInfo * * Finds all the #GstDiscovererContainerInfo contained in @info * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): A #GList of * matching #GstDiscovererStreamInfo. The caller should free it with * gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_container_streams (GstDiscovererInfo * info) { return gst_discoverer_info_get_streams (info, GST_TYPE_DISCOVERER_CONTAINER_INFO); } /** * gst_discoverer_stream_info_get_stream_type_nick: * @info: a #GstDiscovererStreamInfo * * Returns: a human readable name for the stream type of the given @info (ex : "audio", * "container",...). */ const gchar * gst_discoverer_stream_info_get_stream_type_nick (GstDiscovererStreamInfo * info) { if (GST_IS_DISCOVERER_CONTAINER_INFO (info)) return "container"; if (GST_IS_DISCOVERER_AUDIO_INFO (info)) return "audio"; if (GST_IS_DISCOVERER_VIDEO_INFO (info)) { if (gst_discoverer_video_info_is_image ((GstDiscovererVideoInfo *) info)) return "video(image)"; else return "video"; } if (GST_IS_DISCOVERER_SUBTITLE_INFO (info)) return "subtitles"; return "unknown"; } /* ACCESSORS */ #define GENERIC_ACCESSOR_CODE(parent, parenttype, parentgtype, fieldname, type, failval) \ type parent##_get_##fieldname(const parenttype info) { \ g_return_val_if_fail(G_TYPE_CHECK_INSTANCE_TYPE((info), parentgtype), failval); \ return (info)->fieldname; \ } /** * gst_discoverer_stream_info_get_previous: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer full): the previous #GstDiscovererStreamInfo in a chain. * %NULL for starting points. Unref with #gst_discoverer_stream_info_unref * after usage. */ GstDiscovererStreamInfo * gst_discoverer_stream_info_get_previous (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); if (info->previous) return gst_discoverer_stream_info_ref (info->previous); return NULL; } /** * gst_discoverer_stream_info_get_next: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer full): the next #GstDiscovererStreamInfo in a chain. %NULL * for final streams. * Unref with #gst_discoverer_stream_info_unref after usage. */ GstDiscovererStreamInfo * gst_discoverer_stream_info_get_next (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); if (info->next) return gst_discoverer_stream_info_ref (info->next); return NULL; } /** * gst_discoverer_stream_info_get_caps: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer full): the #GstCaps of the stream. Unref with * #gst_caps_unref after usage. */ GstCaps * gst_discoverer_stream_info_get_caps (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); if (info->caps) return gst_caps_ref (info->caps); return NULL; } /** * gst_discoverer_stream_info_get_tags: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer none): the tags contained in this stream. If you wish to * use the tags after the life-time of @info you will need to copy them. */ const GstTagList * gst_discoverer_stream_info_get_tags (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); return info->tags; } /** * gst_discoverer_stream_info_get_toc: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer none): the TOC contained in this stream. If you wish to * use the TOC after the life-time of @info you will need to copy it. */ const GstToc * gst_discoverer_stream_info_get_toc (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); return info->toc; } /** * gst_discoverer_stream_info_get_stream_id: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer none): the stream ID of this stream. If you wish to * use the stream ID after the life-time of @info you will need to copy it. */ const gchar * gst_discoverer_stream_info_get_stream_id (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); return info->stream_id; } /** * gst_discoverer_stream_info_get_misc: * @info: a #GstDiscovererStreamInfo * * Deprecated: This functions is deprecated since version 1.4, use * #gst_discoverer_info_get_missing_elements_installer_details * * Returns: (transfer none): additional information regarding the stream (for * example codec version, profile, etc..). If you wish to use the #GstStructure * after the life-time of @info you will need to copy it. */ const GstStructure * gst_discoverer_stream_info_get_misc (GstDiscovererStreamInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_STREAM_INFO (info), NULL); return info->misc; } /* GstDiscovererContainerInfo */ /** * gst_discoverer_container_info_get_streams: * @info: a #GstDiscovererStreamInfo * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): the list of * #GstDiscovererStreamInfo this container stream offers. * Free with gst_discoverer_stream_info_list_free() after usage. */ GList * gst_discoverer_container_info_get_streams (GstDiscovererContainerInfo * info) { GList *res = NULL, *tmp; g_return_val_if_fail (GST_IS_DISCOVERER_CONTAINER_INFO (info), NULL); for (tmp = info->streams; tmp; tmp = tmp->next) res = g_list_append (res, gst_discoverer_stream_info_ref ((GstDiscovererStreamInfo *) tmp->data)); return res; } /* GstDiscovererAudioInfo */ #define AUDIO_INFO_ACCESSOR_CODE(fieldname, type, failval) \ GENERIC_ACCESSOR_CODE(gst_discoverer_audio_info, GstDiscovererAudioInfo*, \ GST_TYPE_DISCOVERER_AUDIO_INFO, \ fieldname, type, failval) /** * gst_discoverer_audio_info_get_channels: * @info: a #GstDiscovererAudioInfo * * Returns: the number of channels in the stream. */ AUDIO_INFO_ACCESSOR_CODE (channels, guint, 0); /** * gst_discoverer_audio_info_get_channel_mask: * @info: a #GstDiscovererAudioInfo * * Returns: the channel-mask of the stream, refer to * gst_audio_channel_positions_from_mask() for more * information. * * Since: 1.14 */ AUDIO_INFO_ACCESSOR_CODE (channel_mask, guint64, G_MAXUINT64); /** * gst_discoverer_audio_info_get_sample_rate: * @info: a #GstDiscovererAudioInfo * * Returns: the sample rate of the stream in Hertz. */ AUDIO_INFO_ACCESSOR_CODE (sample_rate, guint, 0); /** * gst_discoverer_audio_info_get_depth: * @info: a #GstDiscovererAudioInfo * * Returns: the number of bits used per sample in each channel. */ AUDIO_INFO_ACCESSOR_CODE (depth, guint, 0); /** * gst_discoverer_audio_info_get_bitrate: * @info: a #GstDiscovererAudioInfo * * Returns: the average or nominal bitrate of the stream in bits/second. */ AUDIO_INFO_ACCESSOR_CODE (bitrate, guint, 0); /** * gst_discoverer_audio_info_get_max_bitrate: * @info: a #GstDiscovererAudioInfo * * Returns: the maximum bitrate of the stream in bits/second. */ AUDIO_INFO_ACCESSOR_CODE (max_bitrate, guint, 0); /** * gst_discoverer_audio_info_get_language: * @info: a #GstDiscovererAudioInfo * * Returns: the language of the stream, or NULL if unknown. */ AUDIO_INFO_ACCESSOR_CODE (language, const gchar *, NULL); /* GstDiscovererVideoInfo */ #define VIDEO_INFO_ACCESSOR_CODE(fieldname, type, failval) \ GENERIC_ACCESSOR_CODE(gst_discoverer_video_info, GstDiscovererVideoInfo*, \ GST_TYPE_DISCOVERER_VIDEO_INFO, \ fieldname, type, failval) /** * gst_discoverer_video_info_get_width: * @info: a #GstDiscovererVideoInfo * * Returns: the width of the video stream in pixels. */ VIDEO_INFO_ACCESSOR_CODE (width, guint, 0); /** * gst_discoverer_video_info_get_height: * @info: a #GstDiscovererVideoInfo * * Returns: the height of the video stream in pixels. */ VIDEO_INFO_ACCESSOR_CODE (height, guint, 0); /** * gst_discoverer_video_info_get_depth: * @info: a #GstDiscovererVideoInfo * * Returns: the depth in bits of the video stream. */ VIDEO_INFO_ACCESSOR_CODE (depth, guint, 0); /** * gst_discoverer_video_info_get_framerate_num: * @info: a #GstDiscovererVideoInfo * * Returns: the framerate of the video stream (numerator). */ VIDEO_INFO_ACCESSOR_CODE (framerate_num, guint, 0); /** * gst_discoverer_video_info_get_framerate_denom: * @info: a #GstDiscovererVideoInfo * * Returns: the framerate of the video stream (denominator). */ VIDEO_INFO_ACCESSOR_CODE (framerate_denom, guint, 0); /** * gst_discoverer_video_info_get_par_num: * @info: a #GstDiscovererVideoInfo * * Returns: the Pixel Aspect Ratio (PAR) of the video stream (numerator). */ VIDEO_INFO_ACCESSOR_CODE (par_num, guint, 0); /** * gst_discoverer_video_info_get_par_denom: * @info: a #GstDiscovererVideoInfo * * Returns: the Pixel Aspect Ratio (PAR) of the video stream (denominator). */ VIDEO_INFO_ACCESSOR_CODE (par_denom, guint, 0); /** * gst_discoverer_video_info_is_interlaced: * @info: a #GstDiscovererVideoInfo * * Returns: %TRUE if the stream is interlaced, else %FALSE. */ gboolean gst_discoverer_video_info_is_interlaced (const GstDiscovererVideoInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_VIDEO_INFO (info), FALSE); return info->interlaced; } /** * gst_discoverer_video_info_get_bitrate: * @info: a #GstDiscovererVideoInfo * * Returns: the average or nominal bitrate of the video stream in bits/second. */ VIDEO_INFO_ACCESSOR_CODE (bitrate, guint, 0); /** * gst_discoverer_video_info_get_max_bitrate: * @info: a #GstDiscovererVideoInfo * * Returns: the maximum bitrate of the video stream in bits/second. */ VIDEO_INFO_ACCESSOR_CODE (max_bitrate, guint, 0); /** * gst_discoverer_video_info_is_image: * @info: a #GstDiscovererVideoInfo * * Returns: %TRUE if the video stream corresponds to an image (i.e. only contains * one frame). */ gboolean gst_discoverer_video_info_is_image (const GstDiscovererVideoInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_VIDEO_INFO (info), FALSE); return info->is_image; } /* GstDiscovererSubtitleInfo */ #define SUBTITLE_INFO_ACCESSOR_CODE(fieldname, type, failval) \ GENERIC_ACCESSOR_CODE(gst_discoverer_subtitle_info, GstDiscovererSubtitleInfo*, \ GST_TYPE_DISCOVERER_SUBTITLE_INFO, \ fieldname, type, failval) /** * gst_discoverer_subtitle_info_get_language: * @info: a #GstDiscovererSubtitleInfo * * Returns: the language of the stream, or NULL if unknown. */ SUBTITLE_INFO_ACCESSOR_CODE (language, const gchar *, NULL); /* GstDiscovererInfo */ #define DISCOVERER_INFO_ACCESSOR_CODE(fieldname, type, failval) \ GENERIC_ACCESSOR_CODE(gst_discoverer_info, GstDiscovererInfo*, \ GST_TYPE_DISCOVERER_INFO, \ fieldname, type, failval) /** * gst_discoverer_info_get_uri: * @info: a #GstDiscovererInfo * * Returns: (transfer none): the URI to which this information corresponds to. * Copy it if you wish to use it after the life-time of @info. */ DISCOVERER_INFO_ACCESSOR_CODE (uri, const gchar *, NULL); /** * gst_discoverer_info_get_result: * @info: a #GstDiscovererInfo * * Returns: the result of the discovery as a #GstDiscovererResult. */ DISCOVERER_INFO_ACCESSOR_CODE (result, GstDiscovererResult, GST_DISCOVERER_OK); /** * gst_discoverer_info_get_stream_info: * @info: a #GstDiscovererInfo * * Returns: (transfer full): the structure (or topology) of the URI as a * #GstDiscovererStreamInfo. * This structure can be traversed to see the original hierarchy. Unref with * gst_discoverer_stream_info_unref() after usage. */ GstDiscovererStreamInfo * gst_discoverer_info_get_stream_info (GstDiscovererInfo * info) { g_return_val_if_fail (GST_IS_DISCOVERER_INFO (info), NULL); if (info->stream_info) return gst_discoverer_stream_info_ref (info->stream_info); return NULL; } /** * gst_discoverer_info_get_stream_list: * @info: a #GstDiscovererInfo * * Returns: (transfer full) (element-type GstPbutils.DiscovererStreamInfo): the list of * all streams contained in the #info. Free after usage * with gst_discoverer_stream_info_list_free(). */ GList * gst_discoverer_info_get_stream_list (GstDiscovererInfo * info) { GList *res = NULL, *tmp; g_return_val_if_fail (GST_IS_DISCOVERER_INFO (info), NULL); for (tmp = info->stream_list; tmp; tmp = tmp->next) res = g_list_append (res, gst_discoverer_stream_info_ref ((GstDiscovererStreamInfo *) tmp->data)); return res; } /** * gst_discoverer_info_get_duration: * @info: a #GstDiscovererInfo * * Returns: the duration of the URI in #GstClockTime (nanoseconds). */ DISCOVERER_INFO_ACCESSOR_CODE (duration, GstClockTime, GST_CLOCK_TIME_NONE); /** * gst_discoverer_info_get_seekable: * @info: a #GstDiscovererInfo * * Returns: the whether the URI is seekable. */ DISCOVERER_INFO_ACCESSOR_CODE (seekable, gboolean, FALSE); /** * gst_discoverer_info_get_live: * @info: a #GstDiscovererInfo * * Returns: whether the URI is live. * * Since: 1.14 */ DISCOVERER_INFO_ACCESSOR_CODE (live, gboolean, FALSE); /** * gst_discoverer_info_get_misc: * @info: a #GstDiscovererInfo * * Deprecated: This functions is deprecated since version 1.4, use * #gst_discoverer_info_get_missing_elements_installer_details * * Returns: (transfer none): Miscellaneous information stored as a #GstStructure * (for example: information about missing plugins). If you wish to use the * #GstStructure after the life-time of @info, you will need to copy it. */ DISCOVERER_INFO_ACCESSOR_CODE (misc, const GstStructure *, NULL); /** * gst_discoverer_info_get_tags: * @info: a #GstDiscovererInfo * * Returns: (transfer none): all tags contained in the URI. If you wish to use * the tags after the life-time of @info, you will need to copy them. */ DISCOVERER_INFO_ACCESSOR_CODE (tags, const GstTagList *, NULL); /** * gst_discoverer_info_get_toc: * @info: a #GstDiscovererInfo * * Returns: (transfer none): TOC contained in the URI. If you wish to use * the TOC after the life-time of @info, you will need to copy it. */ DISCOVERER_INFO_ACCESSOR_CODE (toc, const GstToc *, NULL); /** * gst_discoverer_info_ref: * @info: a #GstDiscovererInfo * * Increments the reference count of @info. * * Returns: the same #GstDiscovererInfo object */ /** * gst_discoverer_info_unref: * @info: a #GstDiscovererInfo * * Decrements the reference count of @info. */ /** * gst_discoverer_stream_info_ref: * @info: a #GstDiscovererStreamInfo * * Increments the reference count of @info. * * Returns: the same #GstDiscovererStreamInfo object */ /** * gst_discoverer_stream_info_unref: * @info: a #GstDiscovererStreamInfo * * Decrements the reference count of @info. */ /** * gst_discoverer_info_get_missing_elements_installer_details: * @info: a #GstDiscovererStreamInfo to retrieve installer detail * for the missing element * * Get the installer details for missing elements * * Returns: (transfer none) (array zero-terminated=1): An array of strings * containing informations about how to install the various missing elements * for @info to be usable. If you wish to use the strings after the life-time * of @info, you will need to copy them. * * Since: 1.4 */ const gchar ** gst_discoverer_info_get_missing_elements_installer_details (const GstDiscovererInfo * info) { if (info->result != GST_DISCOVERER_MISSING_PLUGINS) { GST_WARNING_OBJECT (info, "Trying to get missing element installed details " "but result is not 'MISSING_PLUGINS'"); return NULL; } if (info->missing_elements_details->pdata[info->missing_elements_details-> len]) { GST_DEBUG ("Adding NULL pointer to the end of missing_elements_details"); g_ptr_array_add (info->missing_elements_details, NULL); } return (const gchar **) info->missing_elements_details->pdata; }