gstreamer 0.90.6

data/ext/gstreamer/rbgsttag.c

@@ -0,0 +1,111 @@
+/*
+ * Copyright (C) 2003-2005 Laurent Sansonetti <lrz@gnome.org>
+ *
+ * This file is part of Ruby/GStreamer.
+ *
+ * Ruby/GStreamer 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.
+ *
+ * Ruby/GStreamer 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 Ruby/GStreamer; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
+ */
+
+#include "rbgst.h"
+
+/* Module: Gst::Tag
+ * Helper module to the tagging interface.
+ */
+
+/*
+ * Class method: exists?(tag)
+ * tag: the name of the tag.
+ *
+ * Checks if the given tag is already registered.
+ *
+ * Returns: true if the tag is registered, false otherwise.
+ */
+static VALUE
+rb_gst_tag_exists (VALUE self, VALUE tag)
+{
+    return CBOOL2RVAL (gst_tag_exists (RVAL2CSTR (tag)));
+}
+
+/*
+ * Class method: fixed?(tag)
+ * tag: the name of the tag.
+ *
+ * Checks if the given tag is fixed. A fixed tag can only contain one value. 
+ * Unfixed tags can contain lists of values.
+ *
+ * Returns: true if the tag is fixed, false otherwise.
+ */
+static VALUE
+rb_gst_tag_fixed (VALUE self, VALUE tag)
+{
+    return CBOOL2RVAL (gst_tag_is_fixed (RVAL2CSTR (tag)));
+}
+
+/*
+ * Class method: get_nick(tag)
+ * tag: the name of the tag.
+ *
+ * Returns: the human-readable name of this tag.
+ */
+static VALUE
+rb_gst_tag_get_nick (VALUE self, VALUE tag)
+{
+    return CSTR2RVAL (gst_tag_get_nick (RVAL2CSTR (tag)));
+}
+
+/*
+ * Class method: get_description(tag)
+ * tag: the name of the tag.
+ *
+ * Returns: the human-readable description of this tag.
+ */
+static VALUE
+rb_gst_tag_get_description (VALUE self, VALUE tag)
+{
+    return CSTR2RVAL (gst_tag_get_description (RVAL2CSTR (tag)));
+}
+
+/*
+ * Class method: get_flag(tag)
+ * tag: the name of the tag.
+ *
+ * Gets the flag of the given tag.
+ *
+ * Returns: the flag of this tag (see Gst::Tag::Flag).
+ */
+static VALUE
+rb_gst_tag_get_flag (VALUE self, VALUE tag)
+{
+    return GFLAGS2RVAL (gst_tag_get_flag (RVAL2CSTR (tag)),
+                        GST_TYPE_TAG_FLAG);
+}
+
+void
+Init_gst_tag (void)
+{
+    VALUE m = rb_define_module_under (mGst, "Tag");
+
+    rb_define_module_function (m, "exists?", rb_gst_tag_exists, 1);
+    rb_define_module_function (m, "get_nick", rb_gst_tag_get_nick, 1);
+    rb_define_module_function (m, "get_description", 
+                                rb_gst_tag_get_description, 1);
+    rb_define_module_function (m, "get_flag", rb_gst_tag_get_flag, 1);
+    rb_define_module_function (m, "fixed?", rb_gst_tag_fixed, 1);
+
+    G_DEF_CLASS (GST_TYPE_TAG_FLAG, "Flag", m);
+    G_DEF_CONSTANTS (m, GST_TYPE_TAG_FLAG, "GST_TAG_");
+    G_DEF_CLASS (GST_TYPE_TAG_MERGE_MODE, "MergeMode", m);
+    G_DEF_CONSTANTS (m, GST_TYPE_TAG_MERGE_MODE, "GST_TAG_");
+}

data/ext/gstreamer/rbgsttagsetter.c

@@ -0,0 +1,50 @@
+/*
+ * Copyright (C) 2003-2005 Laurent Sansonetti <lrz@gnome.org>
+ *
+ * This file is part of Ruby/GStreamer.
+ *
+ * Ruby/GStreamer 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.
+ *
+ * Ruby/GStreamer 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 Ruby/GStreamer; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
+ */
+
+#include "rbgst.h"
+
+/* Class: Gst::TagSetter
+ * Element interface that allows the setting and retrieval of media metadata.
+ */
+
+/*
+ * Method: merge(structure, merge_mode)
+ * structure: a Ruby hash representing the tag list of merge from.
+ * merge_mode: the mode to merge with (see Gst::Tag::MergeMode).
+ *
+ * Merges the given tag list in the setter's list using the given mode.
+ *
+ * Returns: self.
+ */
+static VALUE
+rb_gst_tag_setter_merge (VALUE self, VALUE structure, VALUE merge_mode)
+{
+    gst_tag_setter_merge_tags(RGST_TAG_SETTER(self),
+                              RVAL2GST_STRUCT(structure),
+                              RVAL2GENUM(merge_mode, GST_TYPE_TAG_MERGE_MODE));
+    return self;
+}
+
+void
+Init_gst_tag_setter (void)
+{
+	VALUE c = G_DEF_INTERFACE (GST_TYPE_TAG_SETTER, "TagSetter", mGst);
+	rb_define_method (c, "merge", rb_gst_tag_setter_merge, 2);	
+}

data/ext/gstreamer/rbgstxml.c

@@ -0,0 +1,189 @@
+/*
+ * Copyright (C) 2003, 2004 Laurent Sansonetti <lrz@gnome.org>
+ *
+ * This file is part of Ruby/GStreamer.
+ *
+ * Ruby/GStreamer 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.
+ *
+ * Ruby/GStreamer 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 Ruby/GStreamer; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
+ */
+
+#include "rbgst.h"
+
+/* Class: Gst::XML
+ * Convert Gst::Element objects into an XML presentation. 
+ */
+
+/*
+ * Class method: new
+ *
+ * Creates a new Gst::XML parser object.  
+ *
+ * Returns: a newly created Gst::XML object.
+ */
+static VALUE
+rb_gst_xml_new (VALUE self)
+{
+	GstXML *xml = gst_xml_new ();
+	if (xml != NULL)
+		G_INITIALIZE (self, xml);
+	return Qnil;
+}
+
+/*
+ * Class method: write_file(element, filename)
+ * element: a Gst::Element.
+ * filename: a file name.
+ *
+ * Converts the given element into XML and writes the formatted XML 
+ * to the specified file name.
+ *  
+ * Returns: true on success, false on failure.
+ */
+static VALUE
+rb_gst_xml_write_file (VALUE self, VALUE element, VALUE filename)
+{
+	FILE *file = fopen (RVAL2CSTR (filename), "w");
+	gboolean ret = FALSE;
+	if (file != NULL) {
+		ret = gst_xml_write_file (RGST_ELEMENT (element), file) != -1; 
+		fclose (file);
+	}
+	return CBOOL2RVAL (ret);
+}
+
+/*
+ * Method: parse_file(filename, rootname=nil)
+ * filename: a file name.
+ * rootname: a root name (optional).
+ *
+ * Fills the Gst::XML object with the corresponding elements from 
+ * the XML file name.  Optionally it will only build the element 
+ * from the element node root (if it is not nil).  
+ *
+ * This feature is useful if you only want to build a specific 
+ * element from an XML file but not the pipeline it is embedded in.
+ *
+ * Pass "-" as file name to read from stdin.  You can also pass a 
+ * URI of any format that libxml supports, including http.
+ *  
+ * Returns: true on success, false on failure.
+ */
+static VALUE
+rb_gst_xml_parse_file (int argc, VALUE *argv, VALUE self)
+{
+	VALUE fname, rootname;
+	rb_scan_args (argc, argv, "11", &fname, &rootname);	
+	return CBOOL2RVAL (gst_xml_parse_file (RGST_XML (self),
+					       (const guchar*) RVAL2CSTR (fname),
+					       (const guchar*)(NIL_P (rootname) 
+                                                               ? NULL 
+                                                               : RVAL2CSTR (rootname))));
+}
+
+/*
+ * Method: parse_memory(string, rootname=nil)
+ * string: an XML description inside a string.
+ * rootname: a root name (optional).
+ *
+ * Basically the same as Gst::XML#parse_file except that this method will
+ * take the XML directly from the memory.
+ *  
+ * Returns: true on success, false on failure.
+ */
+static VALUE
+rb_gst_xml_parse_memory (int argc, VALUE *argv, VALUE self)
+{
+	VALUE memory, rootname;
+	gchar *cstr;
+    
+	rb_scan_args (argc, argv, "11", &memory, &rootname);	
+	cstr = RVAL2CSTR (memory);
+	return CBOOL2RVAL (gst_xml_parse_memory (RGST_XML (self),
+						 (guchar*)cstr, 
+						 strlen (cstr), 
+						 (const gchar*)(NIL_P (rootname) 
+                                                                ? NULL 
+                                                                : RVAL2CSTR (rootname))));
+}
+
+/*
+ * Method: get_element(element_name)
+ * element_name: the name of an element.
+ *
+ * This method is used to get a reference to the Gst::Element 
+ * corresponding to name in the pipeline description.  You would use 
+ * this if you have to do anything to the element after loading.
+ *
+ * Returns: a reference to a Gst::Element object if found, otherwise
+ * returns nil.
+ */
+static VALUE
+rb_gst_xml_get_element (VALUE self, VALUE element_name)
+{
+	GstElement *element = gst_xml_get_element (RGST_XML (self),
+						   (const guchar*)RVAL2CSTR (element_name));
+	return element != NULL
+		? RGST_ELEMENT_NEW (element)
+		: Qnil;
+}
+
+/*
+ * Method: topelements
+ *
+ * Retrieves a list of all toplevel elements.
+ *
+ * Returns: an array of Gst::Element objects.
+ */
+static VALUE
+rb_gst_xml_get_topelements (VALUE self)
+{
+	GList *list;
+	VALUE arr;
+
+	arr = rb_ary_new ();
+	for (list = gst_xml_get_topelements (RGST_XML (self));
+	     list != NULL;
+	     list = g_list_next (list))
+		rb_ary_push (arr, RGST_ELEMENT_NEW (list->data)); 
+	return arr;
+}
+
+/*
+ * Method: each_topelement { |element| ... }
+ *
+ * Calls the block for each topelement, passing a reference to
+ * a Gst::Element object as parameter.
+ *
+ * Returns: always nil.
+ */
+static VALUE
+rb_gst_xml_each_topelement (VALUE self)
+{
+	return rb_ary_yield (rb_gst_xml_get_topelements (self));
+}
+
+void
+Init_gst_xml (void)
+{
+	VALUE c = G_DEF_CLASS (GST_TYPE_XML, "XML", mGst);
+	
+	rb_define_singleton_method (c, "write_file", rb_gst_xml_write_file, 2);
+	
+	rb_define_method (c, "initialize", rb_gst_xml_new, 0);
+	rb_define_method (c, "parse_file", rb_gst_xml_parse_file, -1);
+	rb_define_method (c, "parse_memory", rb_gst_xml_parse_memory, -1);
+	rb_define_method (c, "get_element", rb_gst_xml_get_element, 1);
+	rb_define_method (c, "topelements", rb_gst_xml_get_topelements, 0);
+	rb_define_method (c, "each_topelement", rb_gst_xml_each_topelement, 0);
+}

data/ext/gstreamer/ruby-gstreamer.pc

@@ -0,0 +1,3 @@
+Name: Ruby/GStreamer
+Description: Ruby bindings for Streaming media framework
+Version: 0.90.6

data/extconf.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+require 'pathname'
+require 'mkmf'
+require 'rbconfig'
+require 'fileutils'
+
+package = "gstreamer"
+
+base_dir = Pathname(__FILE__).dirname.expand_path
+ext_dir = base_dir + "ext" + package
+mkmf_gnome2_dir = base_dir + 'lib'
+
+ruby = File.join(RbConfig::CONFIG['bindir'],
+                 RbConfig::CONFIG['ruby_install_name'] +
+                 RbConfig::CONFIG["EXEEXT"])
+
+build_dir = Pathname("ext") + package
+FileUtils.mkdir_p(build_dir.to_s) unless build_dir.exist?
+extconf_rb_path = ext_dir + "extconf.rb"
+system(ruby, "-C", build_dir.to_s, extconf_rb_path.to_s, *ARGV) || exit(false)
+
+create_makefile(package)
+FileUtils.mv("Makefile", "Makefile.lib")
+
+File.open("Makefile", "w") do |makefile|
+  makefile.puts(<<-EOM)
+all:
+	(cd ext/#{package} && $(MAKE))
+	$(MAKE) -f Makefile.lib
+
+install:
+	(cd ext/#{package} && $(MAKE) install)
+	$(MAKE) -f Makefile.lib install
+
+site-install:
+	(cd ext/#{package} && $(MAKE) site-install)
+	$(MAKE) -f Makefile.lib site-install
+
+clean:
+	(cd ext/#{package} && $(MAKE) clean)
+	$(MAKE) -f Makefile.lib clean
+
+distclean:
+	(cd ext/#{package} && $(MAKE) distclean)
+	$(MAKE) -f Makefile.lib distclean
+	@rm -f Makefile.lib
+EOM
+end

data/lib/gst.rb

@@ -0,0 +1,19 @@
+require 'rational'
+require 'glib2'
+require 'gst.so'
+
+Gst.init
+
+module Gst
+  class Plugin
+    def each_feature(&block)
+      Registry.default.each_feature(name, &block)
+    end
+  end
+
+  class Structure
+    def inspect
+      super.gsub(/>\z/, ": #{to_s}>")
+    end
+  end
+end

data/sample/audio-player.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+require 'gst'
+
+if ARGV.size != 1
+  puts "Usage: #{$0} audio-file"
+  exit
+end
+
+file = ARGV.first
+
+pipeline = Gst::Pipeline.new
+
+file_src = Gst::ElementFactory.make("filesrc")
+file_src.location = file
+
+decoder = Gst::ElementFactory.make("decodebin")
+
+audio_convert = Gst::ElementFactory.make("audioconvert")
+
+audio_resample = Gst::ElementFactory.make("audioresample")
+
+audio_sink = Gst::ElementFactory.make("autoaudiosink")
+
+pipeline.add(file_src, decoder, audio_convert, audio_resample, audio_sink)
+file_src >> decoder
+audio_convert >> audio_resample >> audio_sink
+
+decoder.signal_connect("new-decoded-pad") do |element, pad|
+  sink_pad = audio_convert["sink"]
+  pad.link(sink_pad)
+end
+
+loop = GLib::MainLoop.new(nil, false)
+
+bus = pipeline.bus
+bus.add_watch do |bus, message|
+  case message.type
+  when Gst::Message::EOS
+    loop.quit
+  when Gst::Message::ERROR
+    p message.parse
+    loop.quit
+  end
+  true
+end
+
+pipeline.play
+begin
+  loop.run
+rescue Interrupt
+ensure
+  pipeline.stop
+end