diff -r 6f340f756486 -r 1373546e05c6 gstreamer_core/tools/gst-inspect.c --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/gstreamer_core/tools/gst-inspect.c Thu May 27 13:09:21 2010 +0300 @@ -0,0 +1,1401 @@ +/* GStreamer + * Copyright (C) 1999,2000 Erik Walthinsen + * 2000 Wim Taymans + * 2004 Thomas Vander Stichele + * + * gst-inspect.c: tool to inspect the GStreamer registry + * + * 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., 59 Temple Place - Suite 330, + * Boston, MA 02111-1307, USA. + */ + +#ifdef HAVE_CONFIG_H +# include "config.h" +#endif + + +#include +#include "tools.h" + +#include +#include +#include +#include +#include + +static char *_name = NULL; + +static int print_element_info (GstElementFactory * factory, + gboolean print_names); + +static void +n_print (const char *format, ...) +{ + va_list args; + gint retval; + + if (_name) + g_print (_name); + + va_start (args, format); + retval = g_vprintf (format, args); + va_end (args); +} + +static gboolean +print_field (GQuark field, const GValue * value, gpointer pfx) +{ + gchar *str = gst_value_serialize (value); + + n_print ("%s %15s: %s\n", (gchar *) pfx, g_quark_to_string (field), str); + g_free (str); + return TRUE; +} + +static void +print_caps (const GstCaps * caps, const gchar * pfx) +{ + guint i; + + g_return_if_fail (caps != NULL); + + if (gst_caps_is_any (caps)) { + n_print ("%sANY\n", pfx); + return; + } + if (gst_caps_is_empty (caps)) { + n_print ("%sEMPTY\n", pfx); + return; + } + + for (i = 0; i < gst_caps_get_size (caps); i++) { + GstStructure *structure = gst_caps_get_structure (caps, i); + + n_print ("%s%s\n", pfx, gst_structure_get_name (structure)); + gst_structure_foreach (structure, print_field, (gpointer) pfx); + } +} + +#if 0 +static void +print_formats (const GstFormat * formats) +{ + while (formats && *formats) { + const GstFormatDefinition *definition; + + definition = gst_format_get_details (*formats); + if (definition) + n_print ("\t\t(%d):\t%s (%s)\n", *formats, + definition->nick, definition->description); + else + n_print ("\t\t(%d):\tUnknown format\n", *formats); + + formats++; + } +} +#endif + +static void +print_query_types (const GstQueryType * types) +{ + while (types && *types) { + const GstQueryTypeDefinition *definition; + + definition = gst_query_type_get_details (*types); + if (definition) + n_print ("\t\t(%d):\t%s (%s)\n", *types, + definition->nick, definition->description); + else + n_print ("\t\t(%d):\tUnknown query format\n", *types); + + types++; + } +} + +#ifndef GST_DISABLE_ENUMTYPES +#if 0 +static void +print_event_masks (const GstEventMask * masks) +{ + GType event_type; + GEnumClass *klass; + GType event_flags; + GFlagsClass *flags_class = NULL; + + event_type = gst_event_type_get_type (); + klass = (GEnumClass *) g_type_class_ref (event_type); + + while (masks && masks->type) { + GEnumValue *value; + gint flags = 0, index = 0; + + switch (masks->type) { + case GST_EVENT_SEEK: + flags = masks->flags; + event_flags = gst_seek_type_get_type (); + flags_class = (GFlagsClass *) g_type_class_ref (event_flags); + break; + default: + break; + } + + value = g_enum_get_value (klass, masks->type); + g_print ("\t\t%s ", value->value_nick); + + while (flags) { + GFlagsValue *value; + + if (flags & 1) { + value = g_flags_get_first_value (flags_class, 1 << index); + + if (value) + g_print ("| %s ", value->value_nick); + else + g_print ("| ? "); + } + flags >>= 1; + index++; + } + g_print ("\n"); + + masks++; + } +} +#endif +#else +static void +print_event_masks (const GstEventMask * masks) +{ +} +#endif + +static char * +get_rank_name (gint rank) +{ + switch (rank) { + case GST_RANK_NONE: + return "none"; + case GST_RANK_MARGINAL: + return "marginal"; + case GST_RANK_SECONDARY: + return "secondary"; + case GST_RANK_PRIMARY: + return "primary"; + default: + return "unknown"; + } +} + +static void +print_factory_details_info (GstElementFactory * factory) +{ + n_print ("Factory Details:\n"); + n_print (" Long name:\t%s\n", factory->details.longname); + n_print (" Class:\t%s\n", factory->details.klass); + n_print (" Description:\t%s\n", factory->details.description); + n_print (" Author(s):\t%s\n", factory->details.author); + n_print (" Rank:\t\t%s (%d)\n", + get_rank_name (GST_PLUGIN_FEATURE (factory)->rank), + GST_PLUGIN_FEATURE (factory)->rank); + n_print ("\n"); +} + +static void +print_hierarchy (GType type, gint level, gint * maxlevel) +{ + GType parent; + gint i; + + parent = g_type_parent (type); + + *maxlevel = *maxlevel + 1; + level++; + + if (parent) + print_hierarchy (parent, level, maxlevel); + + if (_name) + g_print (_name); + + for (i = 1; i < *maxlevel - level; i++) + g_print (" "); + if (*maxlevel - level) + g_print (" +----"); + + g_print ("%s\n", g_type_name (type)); + + if (level == 1) + n_print ("\n"); +} + +static void +print_interfaces (GType type) +{ + guint n_ifaces; + GType *iface, *ifaces = g_type_interfaces (type, &n_ifaces); + + if (ifaces) { + if (n_ifaces) { + if (_name) + g_print (_name); + g_print (_("Implemented Interfaces:\n")); + iface = ifaces; + while (*iface) { + if (_name) + g_print (_name); + g_print (" %s\n", g_type_name (*iface)); + iface++; + } + if (_name) + g_print (_name); + g_print ("\n"); + } + g_free (ifaces); + } +} + +static void +print_element_properties_info (GstElement * element) +{ + GParamSpec **property_specs; + guint num_properties, i; + gboolean readable; + gboolean first_flag; + + property_specs = g_object_class_list_properties + (G_OBJECT_GET_CLASS (element), &num_properties); + n_print ("\n"); + n_print ("Element Properties:\n"); + + for (i = 0; i < num_properties; i++) { + GValue value = { 0, }; + GParamSpec *param = property_specs[i]; + + readable = FALSE; + + g_value_init (&value, param->value_type); + + n_print (" %-20s: %s\n", g_param_spec_get_name (param), + g_param_spec_get_blurb (param)); + + first_flag = TRUE; + n_print ("%-23.23s flags: ", ""); + if (param->flags & G_PARAM_READABLE) { + g_object_get_property (G_OBJECT (element), param->name, &value); + readable = TRUE; + if (!first_flag) + g_print (", "); + else + first_flag = FALSE; + g_print (_("readable")); + } + if (param->flags & G_PARAM_WRITABLE) { + if (!first_flag) + g_print (", "); + else + first_flag = FALSE; + g_print (_("writable")); + } + if (param->flags & GST_PARAM_CONTROLLABLE) { + if (!first_flag) + g_print (", "); + else + first_flag = FALSE; + g_print (_("controllable")); + } + n_print ("\n"); + + switch (G_VALUE_TYPE (&value)) { + case G_TYPE_STRING: + { + GParamSpecString *pstring = G_PARAM_SPEC_STRING (param); + + n_print ("%-23.23s String. ", ""); + + if (pstring->default_value == NULL) + g_print ("Default: null "); + else + g_print ("Default: \"%s\" ", pstring->default_value); + + if (readable) { + const char *string_val = g_value_get_string (&value); + + if (string_val == NULL) + g_print ("Current: null"); + else + g_print ("Current: \"%s\"", string_val); + } + break; + } + case G_TYPE_BOOLEAN: + { + GParamSpecBoolean *pboolean = G_PARAM_SPEC_BOOLEAN (param); + + n_print ("%-23.23s Boolean. ", ""); + g_print ("Default: %s ", (pboolean->default_value ? "true" : "false")); + if (readable) + g_print ("Current: %s", + (g_value_get_boolean (&value) ? "true" : "false")); + break; + } + case G_TYPE_ULONG: + { + GParamSpecULong *pulong = G_PARAM_SPEC_ULONG (param); + + n_print ("%-23.23s Unsigned Long. ", ""); + g_print ("Range: %lu - %lu Default: %lu ", + pulong->minimum, pulong->maximum, pulong->default_value); + if (readable) + g_print ("Current: %lu", g_value_get_ulong (&value)); + break; + } + case G_TYPE_LONG: + { + GParamSpecLong *plong = G_PARAM_SPEC_LONG (param); + + n_print ("%-23.23s Long. ", ""); + g_print ("Range: %ld - %ld Default: %ld ", + plong->minimum, plong->maximum, plong->default_value); + if (readable) + g_print ("Current: %ld", g_value_get_long (&value)); + break; + } + case G_TYPE_UINT: + { + GParamSpecUInt *puint = G_PARAM_SPEC_UINT (param); + + n_print ("%-23.23s Unsigned Integer. ", ""); + g_print ("Range: %u - %u Default: %u ", + puint->minimum, puint->maximum, puint->default_value); + if (readable) + g_print ("Current: %u", g_value_get_uint (&value)); + break; + } + case G_TYPE_INT: + { + GParamSpecInt *pint = G_PARAM_SPEC_INT (param); + + n_print ("%-23.23s Integer. ", ""); + g_print ("Range: %d - %d Default: %d ", + pint->minimum, pint->maximum, pint->default_value); + if (readable) + g_print ("Current: %d", g_value_get_int (&value)); + break; + } + case G_TYPE_UINT64: + { + GParamSpecUInt64 *puint64 = G_PARAM_SPEC_UINT64 (param); + + n_print ("%-23.23s Unsigned Integer64. ", ""); + g_print ("Range: %" G_GUINT64_FORMAT " - %" G_GUINT64_FORMAT + " Default: %" G_GUINT64_FORMAT " ", + puint64->minimum, puint64->maximum, puint64->default_value); + if (readable) + g_print ("Current: %" G_GUINT64_FORMAT, g_value_get_uint64 (&value)); + break; + } + case G_TYPE_INT64: + { + GParamSpecInt64 *pint64 = G_PARAM_SPEC_INT64 (param); + + n_print ("%-23.23s Integer64. ", ""); + g_print ("Range: %" G_GINT64_FORMAT " - %" G_GINT64_FORMAT + " Default: %" G_GINT64_FORMAT " ", + pint64->minimum, pint64->maximum, pint64->default_value); + if (readable) + g_print ("Current: %" G_GINT64_FORMAT, g_value_get_int64 (&value)); + break; + } + case G_TYPE_FLOAT: + { + GParamSpecFloat *pfloat = G_PARAM_SPEC_FLOAT (param); + + n_print ("%-23.23s Float. ", ""); + g_print ("Range: %15.7g - %15.7g Default: %15.7g ", + pfloat->minimum, pfloat->maximum, pfloat->default_value); + if (readable) + g_print ("Current: %15.7g", g_value_get_float (&value)); + break; + } + case G_TYPE_DOUBLE: + { + GParamSpecDouble *pdouble = G_PARAM_SPEC_DOUBLE (param); + + n_print ("%-23.23s Double. ", ""); + g_print ("Range: %15.7g - %15.7g Default: %15.7g ", + pdouble->minimum, pdouble->maximum, pdouble->default_value); + if (readable) + g_print ("Current: %15.7g", g_value_get_double (&value)); + break; + } + default: + if (param->value_type == GST_TYPE_CAPS) { + const GstCaps *caps = gst_value_get_caps (&value); + + if (!caps) + n_print ("%-23.23s Caps (NULL)", ""); + else { + print_caps (caps, " "); + } + } else if (G_IS_PARAM_SPEC_ENUM (param)) { + GParamSpecEnum *penum = G_PARAM_SPEC_ENUM (param); + GEnumValue *values; + guint j = 0; + gint enum_value; + const gchar *def_val_nick = "", *cur_val_nick = ""; + + values = G_ENUM_CLASS (g_type_class_ref (param->value_type))->values; + enum_value = g_value_get_enum (&value); + + while (values[j].value_name) { + if (values[j].value == enum_value) + cur_val_nick = values[j].value_nick; + if (values[j].value == penum->default_value) + def_val_nick = values[j].value_nick; + j++; + } + + n_print + ("%-23.23s Enum \"%s\" Default: %d, \"%s\" Current: %d, \"%s\"", + "", g_type_name (G_VALUE_TYPE (&value)), penum->default_value, + def_val_nick, enum_value, cur_val_nick); + + j = 0; + while (values[j].value_name) { + g_print ("\n"); + if (_name) + g_print (_name); + g_print ("%-23.23s (%d): %-16s - %s", "", + values[j].value, values[j].value_nick, values[j].value_name); + j++; + } + /* g_type_class_unref (ec); */ + } else if (G_IS_PARAM_SPEC_FLAGS (param)) { + GParamSpecFlags *pflags = G_PARAM_SPEC_FLAGS (param); + GFlagsValue *values; + guint j = 0; + gint flags_value; + GString *cur_flags = NULL, *def_flags = NULL; + + values = G_FLAGS_CLASS (g_type_class_ref (param->value_type))->values; + flags_value = g_value_get_flags (&value); + + while (values[j].value_name) { + if (values[j].value & flags_value) { + if (cur_flags) { + g_string_append_printf (cur_flags, " | %s", + values[j].value_nick); + } else { + cur_flags = g_string_new (values[j].value_nick); + } + } + if (values[j].value & pflags->default_value) { + if (def_flags) { + g_string_append_printf (def_flags, " | %s", + values[j].value_nick); + } else { + def_flags = g_string_new (values[j].value_nick); + } + } + j++; + } + + n_print + ("%-23.23s Flags \"%s\" Default: 0x%08x, \"%s\" Current: 0x%08x, \"%s\"", + "", g_type_name (G_VALUE_TYPE (&value)), pflags->default_value, + (def_flags ? def_flags->str : "(none)"), flags_value, + (cur_flags ? cur_flags->str : "(none)")); + + j = 0; + while (values[j].value_name) { + g_print ("\n"); + if (_name) + g_print (_name); + g_print ("%-23.23s (0x%08x): %-16s - %s", "", + values[j].value, values[j].value_nick, values[j].value_name); + j++; + } + + if (cur_flags) + g_string_free (cur_flags, TRUE); + if (def_flags) + g_string_free (def_flags, TRUE); + } else if (G_IS_PARAM_SPEC_OBJECT (param)) { + n_print ("%-23.23s Object of type \"%s\"", "", + g_type_name (param->value_type)); + } else if (G_IS_PARAM_SPEC_BOXED (param)) { + n_print ("%-23.23s Boxed pointer of type \"%s\"", "", + g_type_name (param->value_type)); + } else if (G_IS_PARAM_SPEC_POINTER (param)) { + if (param->value_type != G_TYPE_POINTER) { + n_print ("%-23.23s Pointer of type \"%s\".", "", + g_type_name (param->value_type)); + } else { + n_print ("%-23.23s Pointer.", ""); + } + } else if (param->value_type == G_TYPE_VALUE_ARRAY) { + n_print ("%-23.23s Array of GValues", ""); + } else if (GST_IS_PARAM_SPEC_FRACTION (param)) { + GstParamSpecFraction *pfraction = GST_PARAM_SPEC_FRACTION (param); + + n_print ("%-23.23s Fraction. ", ""); + + g_print ("Range: %d/%d - %d/%d Default: %d/%d ", + pfraction->min_num, pfraction->min_den, + pfraction->max_num, pfraction->max_den, + pfraction->def_num, pfraction->def_den); + if (readable) + g_print ("Current: %d/%d", + gst_value_get_fraction_numerator (&value), + gst_value_get_fraction_denominator (&value)); + + } else { + n_print ("%-23.23s Unknown type %ld \"%s\"", "", param->value_type, + g_type_name (param->value_type)); + } + break; + } + if (!readable) + g_print (" Write only\n"); + else + g_print ("\n"); + + g_value_reset (&value); + } + if (num_properties == 0) + n_print (" none\n"); + + g_free (property_specs); +} + +static void +print_pad_templates_info (GstElement * element, GstElementFactory * factory) +{ + GstElementClass *gstelement_class; + const GList *pads; + GstStaticPadTemplate *padtemplate; + + n_print ("Pad Templates:\n"); + if (!factory->numpadtemplates) { + n_print (" none\n"); + return; + } + + gstelement_class = GST_ELEMENT_CLASS (G_OBJECT_GET_CLASS (element)); + + pads = factory->staticpadtemplates; + while (pads) { + padtemplate = (GstStaticPadTemplate *) (pads->data); + pads = g_list_next (pads); + + if (padtemplate->direction == GST_PAD_SRC) + n_print (" SRC template: '%s'\n", padtemplate->name_template); + else if (padtemplate->direction == GST_PAD_SINK) + n_print (" SINK template: '%s'\n", padtemplate->name_template); + else + n_print (" UNKNOWN!!! template: '%s'\n", padtemplate->name_template); + + if (padtemplate->presence == GST_PAD_ALWAYS) + n_print (" Availability: Always\n"); + else if (padtemplate->presence == GST_PAD_SOMETIMES) + n_print (" Availability: Sometimes\n"); + else if (padtemplate->presence == GST_PAD_REQUEST) { + n_print (" Availability: On request\n"); + n_print (" Has request_new_pad() function: %s\n", + GST_DEBUG_FUNCPTR_NAME (gstelement_class->request_new_pad)); + } else + n_print (" Availability: UNKNOWN!!!\n"); + + if (padtemplate->static_caps.string) { + n_print (" Capabilities:\n"); + print_caps (gst_static_caps_get (&padtemplate->static_caps), " "); + } + + n_print ("\n"); + } +} + +static void +print_element_flag_info (GstElement * element) +{ + gboolean have_flags = FALSE; + + n_print ("\n"); + n_print ("Element Flags:\n"); + + if (!have_flags) + n_print (" no flags set\n"); + + if (GST_IS_BIN (element)) { + n_print ("\n"); + n_print ("Bin Flags:\n"); + if (!have_flags) + n_print (" no flags set\n"); + } +} + +static void +print_implementation_info (GstElement * element) +{ + GstObjectClass *gstobject_class; + GstElementClass *gstelement_class; + + gstobject_class = GST_OBJECT_CLASS (G_OBJECT_GET_CLASS (element)); + gstelement_class = GST_ELEMENT_CLASS (G_OBJECT_GET_CLASS (element)); + + n_print ("\n"); + n_print ("Element Implementation:\n"); + + n_print (" Has change_state() function: %s\n", + GST_DEBUG_FUNCPTR_NAME (gstelement_class->change_state)); +#ifndef GST_DISABLE_LOADSAVE + n_print (" Has custom save_thyself() function: %s\n", + GST_DEBUG_FUNCPTR_NAME (gstobject_class->save_thyself)); + n_print (" Has custom restore_thyself() function: %s\n", + GST_DEBUG_FUNCPTR_NAME (gstobject_class->restore_thyself)); +#endif +} + +static void +print_clocking_info (GstElement * element) +{ + if (!gst_element_requires_clock (element) && + !(gst_element_provides_clock (element) && + gst_element_get_clock (element))) { + n_print ("\n"); + n_print ("Element has no clocking capabilities."); + return; + } + + n_print ("\n"); + n_print ("Clocking Interaction:\n"); + if (gst_element_requires_clock (element)) { + n_print (" element requires a clock\n"); + } + + if (gst_element_provides_clock (element)) { + GstClock *clock; + + clock = gst_element_get_clock (element); + if (clock) + n_print (" element provides a clock: %s\n", GST_OBJECT_NAME (clock)); + else + n_print (" element is supposed to provide a clock but returned NULL\n"); + } +} + +#ifndef GST_DISABLE_INDEX +static void +print_index_info (GstElement * element) +{ + if (gst_element_is_indexable (element)) { + n_print ("\n"); + n_print ("Indexing capabilities:\n"); + n_print (" element can do indexing\n"); + } else { + n_print ("\n"); + n_print ("Element has no indexing capabilities.\n"); + } +} +#else +static void +print_index_info (GstElement * element) +{ +} +#endif + +static void +print_pad_info (GstElement * element) +{ + const GList *pads; + GstPad *pad; + + n_print ("\n"); + n_print ("Pads:\n"); + + if (!element->numpads) { + n_print (" none\n"); + return; + } + + pads = element->pads; + while (pads) { + gchar *name; + + pad = GST_PAD (pads->data); + pads = g_list_next (pads); + + n_print (""); + + name = gst_pad_get_name (pad); + if (gst_pad_get_direction (pad) == GST_PAD_SRC) + g_print (" SRC: '%s'", name); + else if (gst_pad_get_direction (pad) == GST_PAD_SINK) + g_print (" SINK: '%s'", name); + else + g_print (" UNKNOWN!!!: '%s'", name); + + g_free (name); + + g_print ("\n"); + + n_print (" Implementation:\n"); + if (pad->chainfunc) + n_print (" Has chainfunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->chainfunc)); + if (pad->getrangefunc) + n_print (" Has getrangefunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->getrangefunc)); + if (pad->eventfunc != gst_pad_event_default) + n_print (" Has custom eventfunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->eventfunc)); + if (pad->queryfunc != gst_pad_query_default) + n_print (" Has custom queryfunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->queryfunc)); + if (pad->querytypefunc != gst_pad_get_query_types_default) { + n_print (" Provides query types:\n"); + print_query_types (gst_pad_get_query_types (pad)); + } + + if (pad->intlinkfunc != gst_pad_get_internal_links_default) + n_print (" Has custom intconnfunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->intlinkfunc)); + + if (pad->bufferallocfunc) + n_print (" Has bufferallocfunc(): %s\n", + GST_DEBUG_FUNCPTR_NAME (pad->bufferallocfunc)); + + if (pad->padtemplate) + n_print (" Pad Template: '%s'\n", pad->padtemplate->name_template); + + if (pad->caps) { + n_print (" Capabilities:\n"); + print_caps (pad->caps, " "); + } + } +} + +#if 0 +static gint +compare_signal_names (GSignalQuery * a, GSignalQuery * b) +{ + return strcmp (a->signal_name, b->signal_name); +} +#endif + +static void +print_signal_info (GstElement * element) +{ + /* Signals/Actions Block */ + guint *signals; + guint nsignals; + gint i = 0, j, k; + GSignalQuery *query = NULL; + GType type; + GSList *found_signals, *l; + + for (k = 0; k < 2; k++) { + found_signals = NULL; + for (type = G_OBJECT_TYPE (element); type; type = g_type_parent (type)) { + if (type == GST_TYPE_ELEMENT || type == GST_TYPE_OBJECT) + break; + + if (type == GST_TYPE_BIN && G_OBJECT_TYPE (element) != GST_TYPE_BIN) + continue; + + signals = g_signal_list_ids (type, &nsignals); + for (i = 0; i < nsignals; i++) { + query = g_new0 (GSignalQuery, 1); + g_signal_query (signals[i], query); + + if ((k == 0 && !(query->signal_flags & G_SIGNAL_ACTION)) || + (k == 1 && (query->signal_flags & G_SIGNAL_ACTION))) + found_signals = g_slist_append (found_signals, query); + else + g_free (query); + } + g_free (signals); + signals = NULL; + } + + if (found_signals) { + n_print ("\n"); + if (k == 0) + n_print ("Element Signals:\n"); + else + n_print ("Element Actions:\n"); + } else { + continue; + } + + for (l = found_signals; l; l = l->next) { + gchar *indent; + int indent_len; + + query = (GSignalQuery *) l->data; + indent_len = strlen (query->signal_name) + + strlen (g_type_name (query->return_type)) + 24; + + indent = g_new0 (gchar, indent_len + 1); + memset (indent, ' ', indent_len); + + n_print (" \"%s\" : %s user_function (%s* object", + query->signal_name, + g_type_name (query->return_type), g_type_name (type)); + + for (j = 0; j < query->n_params; j++) { + if (_name) + g_print (_name); + if (G_TYPE_IS_FUNDAMENTAL (query->param_types[j])) { + g_print (",\n%s%s arg%d", indent, + g_type_name (query->param_types[j]), j); + } else if (G_TYPE_IS_ENUM (query->param_types[j])) { + g_print (",\n%s%s arg%d", indent, + g_type_name (query->param_types[j]), j); + } else { + g_print (",\n%s%s* arg%d", indent, + g_type_name (query->param_types[j]), j); + } + } + + if (k == 0) { + if (_name) + g_print (_name); + g_print (",\n%sgpointer user_data);\n", indent); + } else + g_print (");\n"); + + g_free (indent); + } + + if (found_signals) { + g_slist_foreach (found_signals, (GFunc) g_free, NULL); + g_slist_free (found_signals); + } + } +} + +static void +print_children_info (GstElement * element) +{ + GList *children; + + if (!GST_IS_BIN (element)) + return; + + children = (GList *) GST_BIN (element)->children; + if (children) { + n_print ("\n"); + g_print ("Children:\n"); + } + + while (children) { + n_print (" %s\n", GST_ELEMENT_NAME (GST_ELEMENT (children->data))); + children = g_list_next (children); + } +} + +static void +print_element_list (gboolean print_all) +{ + int plugincount = 0, featurecount = 0; + GList *plugins, *orig_plugins; + + orig_plugins = plugins = gst_default_registry_get_plugin_list (); + while (plugins) { + GList *features, *orig_features; + GstPlugin *plugin; + + plugin = (GstPlugin *) (plugins->data); + plugins = g_list_next (plugins); + plugincount++; + + orig_features = features = + gst_registry_get_feature_list_by_plugin (gst_registry_get_default (), + plugin->desc.name); + while (features) { + GstPluginFeature *feature; + + feature = GST_PLUGIN_FEATURE (features->data); + featurecount++; + + if (GST_IS_ELEMENT_FACTORY (feature)) { + GstElementFactory *factory; + + factory = GST_ELEMENT_FACTORY (feature); + if (print_all) + print_element_info (factory, TRUE); + else + g_print ("%s: %s: %s\n", plugin->desc.name, + GST_PLUGIN_FEATURE_NAME (factory), + gst_element_factory_get_longname (factory)); + } +#ifndef GST_DISABLE_INDEX + else if (GST_IS_INDEX_FACTORY (feature)) { + GstIndexFactory *factory; + + factory = GST_INDEX_FACTORY (feature); + if (!print_all) + g_print ("%s: %s: %s\n", plugin->desc.name, + GST_PLUGIN_FEATURE_NAME (factory), factory->longdesc); + } +#endif + else if (GST_IS_TYPE_FIND_FACTORY (feature)) { + GstTypeFindFactory *factory; + + factory = GST_TYPE_FIND_FACTORY (feature); + if (!print_all) + g_print ("%s: %s: ", plugin->desc.name, + gst_plugin_feature_get_name (feature)); + if (factory->extensions) { + guint i = 0; + + while (factory->extensions[i]) { + if (!print_all) + g_print ("%s%s", i > 0 ? ", " : "", factory->extensions[i]); + i++; + } + if (!print_all) + g_print ("\n"); + } else { + if (!print_all) + g_print ("no extensions\n"); + } + } else { + if (!print_all) + n_print ("%s: %s (%s)\n", plugin->desc.name, + GST_PLUGIN_FEATURE_NAME (feature), + g_type_name (G_OBJECT_TYPE (feature))); + } + + features = g_list_next (features); + } + + gst_plugin_feature_list_free (orig_features); + } + + gst_plugin_list_free (orig_plugins); + + g_print ("\n"); + g_print (_("Total count: ")); + g_print (ngettext ("%d plugin", "%d plugins", plugincount), plugincount); + g_print (", "); + g_print (ngettext ("%d feature", "%d features", featurecount), featurecount); + g_print ("\n"); +} + +static void +print_plugin_info (GstPlugin * plugin) +{ + n_print ("Plugin Details:\n"); + n_print (" Name:\t\t\t%s\n", plugin->desc.name); + n_print (" Description:\t\t%s\n", plugin->desc.description); + n_print (" Filename:\t\t%s\n", + plugin->filename ? plugin->filename : "(null)"); + n_print (" Version:\t\t%s\n", plugin->desc.version); + n_print (" License:\t\t%s\n", plugin->desc.license); + n_print (" Source module:\t%s\n", plugin->desc.source); + n_print (" Binary package:\t%s\n", plugin->desc.package); + n_print (" Origin URL:\t\t%s\n", plugin->desc.origin); + n_print ("\n"); +} + +static void +print_plugin_features (GstPlugin * plugin) +{ + GList *features; + gint num_features = 0; + gint num_elements = 0; + gint num_types = 0; + gint num_indexes = 0; + gint num_other = 0; + + features = + gst_registry_get_feature_list_by_plugin (gst_registry_get_default (), + plugin->desc.name); + + while (features) { + GstPluginFeature *feature; + + feature = GST_PLUGIN_FEATURE (features->data); + + if (GST_IS_ELEMENT_FACTORY (feature)) { + GstElementFactory *factory; + + factory = GST_ELEMENT_FACTORY (feature); + n_print (" %s: %s\n", GST_PLUGIN_FEATURE_NAME (factory), + gst_element_factory_get_longname (factory)); + num_elements++; + } +#ifndef GST_DISABLE_INDEX + else if (GST_IS_INDEX_FACTORY (feature)) { + GstIndexFactory *factory; + + factory = GST_INDEX_FACTORY (feature); + n_print (" %s: %s\n", GST_OBJECT_NAME (factory), factory->longdesc); + num_indexes++; + } +#endif + else if (GST_IS_TYPE_FIND_FACTORY (feature)) { + GstTypeFindFactory *factory; + + factory = GST_TYPE_FIND_FACTORY (feature); + if (factory->extensions) { + guint i = 0; + + g_print ("%s: %s: ", plugin->desc.name, + gst_plugin_feature_get_name (feature)); + while (factory->extensions[i]) { + g_print ("%s%s", i > 0 ? ", " : "", factory->extensions[i]); + i++; + } + g_print ("\n"); + } else + g_print ("%s: %s: no extensions\n", plugin->desc.name, + gst_plugin_feature_get_name (feature)); + + num_types++; + } else { + n_print (" %s (%s)\n", gst_object_get_name (GST_OBJECT (feature)), + g_type_name (G_OBJECT_TYPE (feature))); + num_other++; + } + num_features++; + features = g_list_next (features); + } + n_print ("\n"); + n_print (" %d features:\n", num_features); + if (num_elements > 0) + n_print (" +-- %d elements\n", num_elements); + if (num_types > 0) + n_print (" +-- %d types\n", num_types); + if (num_indexes > 0) + n_print (" +-- %d indexes\n", num_indexes); + if (num_other > 0) + n_print (" +-- %d other objects\n", num_other); + + n_print ("\n"); +} + +static int +print_element_features (const gchar * element_name) +{ + GstPluginFeature *feature; + + /* FIXME implement other pretty print function for these */ +#ifndef GST_DISABLE_INDEX + feature = gst_default_registry_find_feature (element_name, + GST_TYPE_INDEX_FACTORY); + if (feature) { + n_print ("%s: an index\n", element_name); + return 0; + } +#endif + feature = gst_default_registry_find_feature (element_name, + GST_TYPE_TYPE_FIND_FACTORY); + if (feature) { + n_print ("%s: a typefind function\n", element_name); + return 0; + } + + return -1; +} + +static int +print_element_info (GstElementFactory * factory, gboolean print_names) +{ + GstElement *element; + gint maxlevel = 0; + + factory = + GST_ELEMENT_FACTORY (gst_plugin_feature_load (GST_PLUGIN_FEATURE + (factory))); + + if (!factory) { + g_print ("element plugin couldn't be loaded\n"); + return -1; + } + + element = gst_element_factory_create (factory, NULL); + if (!element) { + g_print ("couldn't construct element for some reason\n"); + return -1; + } + + if (print_names) + _name = g_strdup_printf ("%s: ", GST_PLUGIN_FEATURE (factory)->name); + else + _name = NULL; + + print_factory_details_info (factory); + if (GST_PLUGIN_FEATURE (factory)->plugin_name) { + GstPlugin *plugin; + + plugin = gst_registry_find_plugin (gst_registry_get_default (), + GST_PLUGIN_FEATURE (factory)->plugin_name); + if (plugin) { + print_plugin_info (plugin); + } + } + + print_hierarchy (G_OBJECT_TYPE (element), 0, &maxlevel); + print_interfaces (G_OBJECT_TYPE (element)); + + print_pad_templates_info (element, factory); + print_element_flag_info (element); + print_implementation_info (element); + print_clocking_info (element); + print_index_info (element); + print_pad_info (element); + print_element_properties_info (element); + print_signal_info (element); + print_children_info (element); + + gst_object_unref (element); + gst_object_unref (factory); + g_free (_name); + + return 0; +} + + +static void +print_plugin_automatic_install_info_codecs (GstElementFactory * factory) +{ + GstPadDirection direction; + const gchar *type_name; + const gchar *klass; + const GList *static_templates, *l; + GstCaps *caps = NULL; + guint i, num; + + klass = gst_element_factory_get_klass (factory); + g_return_if_fail (klass != NULL); + + if (strstr (klass, "Demuxer") || + strstr (klass, "Decoder") || + strstr (klass, "Depay") || strstr (klass, "Parser")) { + type_name = "decoder"; + direction = GST_PAD_SINK; + } else if (strstr (klass, "Muxer") || + strstr (klass, "Encoder") || strstr (klass, "Pay")) { + type_name = "encoder"; + direction = GST_PAD_SRC; + } else { + return; + } + + /* decoder/demuxer sink pads should always be static and there should only + * be one, the same applies to encoders/muxers and source pads */ + static_templates = gst_element_factory_get_static_pad_templates (factory); + for (l = static_templates; l != NULL; l = l->next) { + GstStaticPadTemplate *tmpl = NULL; + + tmpl = (GstStaticPadTemplate *) l->data; + if (tmpl->direction == direction) { + caps = gst_static_pad_template_get_caps (tmpl); + break; + } + } + + if (caps == NULL) { + g_printerr ("Couldn't find static pad template for %s '%s'\n", + type_name, GST_PLUGIN_FEATURE_NAME (factory)); + return; + } + + caps = gst_caps_make_writable (caps); + num = gst_caps_get_size (caps); + for (i = 0; i < num; ++i) { + GstStructure *s; + gchar *s_str; + + s = gst_caps_get_structure (caps, i); + /* remove fields that are almost always just MIN-MAX of some sort + * in order to make the caps look less messy */ + gst_structure_remove_field (s, "pixel-aspect-ratio"); + gst_structure_remove_field (s, "framerate"); + gst_structure_remove_field (s, "channels"); + gst_structure_remove_field (s, "width"); + gst_structure_remove_field (s, "height"); + gst_structure_remove_field (s, "rate"); + gst_structure_remove_field (s, "depth"); + gst_structure_remove_field (s, "clock-rate"); + s_str = gst_structure_to_string (s); + g_print ("%s-%s\n", type_name, s_str); + g_free (s_str); + } + gst_caps_unref (caps); +} + +static void +print_plugin_automatic_install_info_protocols (GstElementFactory * factory) +{ + gchar **protocols, **p; + + protocols = gst_element_factory_get_uri_protocols (factory); + if (protocols != NULL && *protocols != NULL) { + switch (gst_element_factory_get_uri_type (factory)) { + case GST_URI_SINK: + for (p = protocols; *p != NULL; ++p) + g_print ("urisink-%s\n", *p); + break; + case GST_URI_SRC: + for (p = protocols; *p != NULL; ++p) + g_print ("urisource-%s\n", *p); + break; + default: + break; + } + g_strfreev (protocols); + } +} + +static void +print_plugin_automatic_install_info (GstPlugin * plugin) +{ + const gchar *plugin_name; + GList *features, *l; + + plugin_name = gst_plugin_get_name (plugin); + + /* not interested in typefind factories, only element factories */ + features = gst_registry_get_feature_list (gst_registry_get_default (), + GST_TYPE_ELEMENT_FACTORY); + + for (l = features; l != NULL; l = l->next) { + GstPluginFeature *feature; + + feature = GST_PLUGIN_FEATURE (l->data); + + /* only interested in the ones that are in the plugin we just loaded */ + if (g_str_equal (plugin_name, feature->plugin_name)) { + GstElementFactory *factory; + + g_print ("element-%s\n", gst_plugin_feature_get_name (feature)); + + factory = GST_ELEMENT_FACTORY (feature); + print_plugin_automatic_install_info_protocols (factory); + print_plugin_automatic_install_info_codecs (factory); + } + } + + g_list_foreach (features, (GFunc) gst_object_unref, NULL); + g_list_free (features); +} + +int +main (int argc, char *argv[]) +{ + static gboolean print_all = FALSE; + static gboolean print_aii = FALSE; + GOptionEntry options[] = { + {"print-all", 'a', 0, G_OPTION_ARG_NONE, &print_all, + N_("Print all elements"), NULL}, + {"print-plugin-auto-install-info", '\0', 0, G_OPTION_ARG_NONE, &print_aii, + N_("Print a machine-parsable list of features the specified plugin " + "provides.\n " + "Useful in connection with external automatic plugin " + "installation mechanisms"), NULL}, + GST_TOOLS_GOPTION_VERSION, + {NULL} + }; + GOptionContext *ctx; + GError *err = NULL; + +#ifdef ENABLE_NLS + bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR); + bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8"); + textdomain (GETTEXT_PACKAGE); +#endif + + if (!g_thread_supported ()) + g_thread_init (NULL); + + ctx = g_option_context_new ("[ELEMENT-NAME | PLUGIN-NAME]"); + g_option_context_add_main_entries (ctx, options, GETTEXT_PACKAGE); + g_option_context_add_group (ctx, gst_init_get_option_group ()); + if (!g_option_context_parse (ctx, &argc, &argv, &err)) { + g_print ("Error initializing: %s\n", err->message); + exit (1); + } + g_option_context_free (ctx); + + gst_tools_print_version ("gst-inspect"); + + if (print_all && argc > 2) { + g_print ("-a requires no extra arguments\n"); + return 1; + } + + /* if no arguments, print out list of elements */ + if (argc == 1 || print_all) { + print_element_list (print_all); + /* else we try to get a factory */ + } else { + GstElementFactory *factory; + GstPlugin *plugin; + const char *arg = argv[argc - 1]; + int retval; + + factory = gst_element_factory_find (arg); + /* if there's a factory, print out the info */ + if (factory) { + retval = print_element_info (factory, print_all); + gst_object_unref (factory); + } else { + retval = print_element_features (arg); + } + + /* otherwise check if it's a plugin */ + if (retval) { + plugin = gst_default_registry_find_plugin (arg); + + /* if there is such a plugin, print out info */ + if (plugin) { + if (print_aii) { + print_plugin_automatic_install_info (plugin); + } else { + print_plugin_info (plugin); + print_plugin_features (plugin); + } + } else { + GError *error = NULL; + + if (g_file_test (arg, G_FILE_TEST_EXISTS)) { + plugin = gst_plugin_load_file (arg, &error); + + if (plugin) { + if (print_aii) { + print_plugin_automatic_install_info (plugin); + } else { + print_plugin_info (plugin); + print_plugin_features (plugin); + } + } else { + g_print (_("Could not load plugin file: %s\n"), error->message); + g_error_free (error); + return -1; + } + } else { + g_print (_("No such element or plugin '%s'\n"), arg); + return -1; + } + } + } + } + + return 0; +}