gstreamer 1.2.6 → 2.0.0

data/ext/gstreamer/rbgst-element-factory.c

@@ -1,249 +0,0 @@
-/* -*- c-file-style: "ruby"; indent-tabs-mode: nil -*- */
-/*
- *  Copyright (C) 2011  Ruby-GNOME2 Project Team
- *  Copyright (C) 2007  Ruby-GNOME2 Project Team
- *  Copyright (C) 2003, 2004 Laurent Sansonetti <lrz@gnome.org>
- *
- *  This library is free software; you can redistribute it and/or
- *  modify it under the terms of the GNU Lesser General Public
- *  License as published by the Free Software Foundation; either
- *  version 2.1 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
- *  Lesser General Public License for more details.
- *
- *  You should have received a copy of the GNU Lesser General Public
- *  License along with this library; if not, write to the Free Software
- *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
- *  MA  02110-1301  USA
- */
-
-#include "rbgst-private.h"
-
-#define RG_TARGET_NAMESPACE cElementFactory
-#define SELF(self) RVAL2GST_ELEMENT_FACTORY(self)
-
-/* Class: Gst::ElementFactory
- * Creates Gst::Element instances.
- */
-
-/*
- * Class method: make(factory_name, element_name)
- * factory_name: a name of an existing factory.
- * element_name: a name which will be attributed to the element.
- *
- * Creates a new Gst::Element of the type defined by the given element factory.
- *
- * If element name is ommited (or nil), then the element will receive a guaranteed 
- * unique name, consisting of the element factory name and a number. 
- * If name is given, it will be given the name supplied.
- *
- *  # Creates a 'mad' GStreamer element, named 'foo':
- *  elem1 = Gst::ElementFactory.make("mad", "foo")
- *    
- *  # This line does exactly the same thing:
- *  elem2 = Gst::ElementFactory.find("mad").create("foo")
- *
- * Returns: a newly created object based on Gst::Element.
- */
-static VALUE
-rg_s_make(int argc, VALUE *argv, G_GNUC_UNUSED VALUE self)
-{
-    GstElement *element;
-    VALUE fname, ename;
-    VALUE ret;
-
-    rb_scan_args(argc, argv, "11", &fname, &ename);
-
-    element = gst_element_factory_make(RVAL2CSTR(fname),
-                                       RVAL2CSTR_ACCEPT_NIL(ename));
-
-    if (element == NULL)
-        return Qnil;
-
-    /* This add another ref to the element, but it was already ours so
-     * unref it again */
-    ret = GOBJ2RVAL(element);
-    GOBJ2RVAL_UNREF(element);
-    return ret;
-}
-
-/*
- * Class method: find(factory_name)
- * factory_name: a name of an existing factory.
- *
- * Searches for an element factory of the given name.
- *
- * Returns: a Gst::ElementFactory object if found, nil otherwise.
- */
-static VALUE
-rg_s_find (G_GNUC_UNUSED VALUE self, VALUE factory_name)
-{
-    GstElementFactory *factory = gst_element_factory_find (RVAL2CSTR (factory_name));
-    return factory != NULL 
-                ? RGST_ELEMENT_FACTORY_NEW (factory)
-                : Qnil;
-}
-
-/*
- * Method: create(element_name=nil)
- * element_name: a name which will be attributed to the element.
- *
- * Creates a new element of the type defined by the element factory.
- *
- * If element name is ommited (or nil), then the element will receive a guaranteed 
- * unique name, consisting of the element factory name and a number. 
- * If name is given, it will be given the name supplied.
- *
- * Returns: a newly created object based on Gst::Element.
- */
-static VALUE
-rg_create(int argc, VALUE *argv, VALUE self)
-{
-    GstElement *element;
-    VALUE name;
-
-    rb_scan_args(argc, argv, "01", &name);
-
-    element = gst_element_factory_create(SELF(self), RVAL2CSTR_ACCEPT_NIL(name));
-    return GOBJ2RVAL(element);
-}
-
-static VALUE
-rg_to_s (VALUE self)
-{
-    GstElementFactory *factory = RGST_ELEMENT_FACTORY (self); 
-    return rb_str_new_with_format ("Element: %s (%s)",
-                                  GST_PLUGIN_FEATURE_NAME(factory),
-                                  factory->details.longname);
-}
-
-/*
- * Method: pad_templates
- *
- * Requests all pad templates of factory.
- *
- * Returns: an array of Gst::PadTemplate objects.
- */
-static VALUE
-rg_pad_templates (VALUE self)
-{
-    GstElementFactory *factory;
-    const GList *list;
-    VALUE arr;
-
-    arr = rb_ary_new();
-    factory = RGST_ELEMENT_FACTORY(self);
-    for (list = gst_element_factory_get_static_pad_templates(factory);
-         list != NULL;
-         list = g_list_next(list)) {
-        GstStaticPadTemplate *pad = list->data;
-        rb_ary_push(arr, GST_STATIC_PAD_TEMPLATE2RVAL(pad));
-    }
-    return arr;
-}
-
-/*
- * Method: each_pad_template { |pad_template| ... }
- *
- * Calls the block for each pad template of the factory, passing a
- * reference to the Gst::PadTemplate as parameter.
- *
- * Returns: always nil. 
- */
-static VALUE
-rg_each_pad_template (VALUE self)
-{
-    return rb_ary_yield (rg_pad_templates (self));
-}
-
-/*
- * Method: details
- *
- * Gets some public information about the factory, 
- * mostly for the benefit of editors.
- *
- * This information is encapsulated in a Hash object, 
- * with the following (String) keys:
- *
- *   * longname: long (English) element name.
- *   * klass: type of element, as hierarchy.
- *   * description: a short description about the element.
- *   * author: some information about the author(s).
- *
- * Here is an example.
- *
- *  # Prints all details related to the 'mad' element:
- *  Gst::ElementFactory.find("mad").details do |k, v| 
- *      p "#{k}: #{v}"
- *  end 
- *
- * Returns: a Hash.
- */
-static VALUE
-rg_details (VALUE self)
-{
-    GstElementFactory *factory;
-    VALUE hash;
-
-    factory = RGST_ELEMENT_FACTORY (self); 
-
-    hash = rb_hash_new();
-
-    rb_hash_aset (hash, CSTR2RVAL ("longname"), CSTR2RVAL (factory->details.longname));
-    rb_hash_aset (hash, CSTR2RVAL ("klass"), CSTR2RVAL (factory->details.klass)); 
-    rb_hash_aset (hash, CSTR2RVAL ("description"), CSTR2RVAL (factory->details.description));
-    rb_hash_aset (hash, CSTR2RVAL ("author"), CSTR2RVAL (factory->details.author));
-
-    return hash;
-}
-
-static VALUE
-rg_long_name(VALUE self)
-{
-    return CSTR2RVAL(gst_element_factory_get_longname(SELF(self)));
-}
-
-static VALUE
-rg_klass(VALUE self)
-{
-    return CSTR2RVAL(gst_element_factory_get_klass(SELF(self)));
-}
-
-static VALUE
-rg_description(VALUE self)
-{
-    return CSTR2RVAL(gst_element_factory_get_description(SELF(self)));
-}
-
-static VALUE
-rg_author(VALUE self)
-{
-    return CSTR2RVAL(gst_element_factory_get_author(SELF(self)));
-}
-
-void
-Init_gst_elementfactory (VALUE mGst)
-{
-    VALUE RG_TARGET_NAMESPACE;
-
-    RG_TARGET_NAMESPACE = G_DEF_CLASS(GST_TYPE_ELEMENT_FACTORY,
-                                        "ElementFactory",
-                                        mGst);
-
-    RG_DEF_SMETHOD(make, -1);
-    RG_DEF_SMETHOD(find, 1);
-
-    RG_DEF_METHOD(create, -1);
-    RG_DEF_METHOD(details, 0);
-    RG_DEF_METHOD(to_s, 0);
-    RG_DEF_METHOD(pad_templates, 0);
-    RG_DEF_METHOD(each_pad_template, 0);
-
-    RG_DEF_METHOD(long_name, 0);
-    RG_DEF_METHOD(klass, 0);
-    RG_DEF_METHOD(description, 0);
-    RG_DEF_METHOD(author, 0);
-}