gstreamer 1.2.6 → 2.0.0

data/lib/gst/element.rb

@@ -0,0 +1,48 @@
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+module Gst
+  class Element
+    def stop
+      set_state(State::NULL)
+    end
+
+    def ready
+      set_state(State::READY)
+    end
+
+    def pause
+      set_state(State::PAUSED)
+    end
+
+    def play
+      set_state(State::PLAYING)
+    end
+
+    alias_method :link_element, :link
+    def link_elements(*elements)
+      elements.each do |element|
+        link_element(element)
+      end
+    end
+    alias_method :link, :link_elements
+
+    def >>(element)
+      link_element(element)
+      element
+    end
+  end
+end

data/lib/gst.rb

@@ -1,36 +1,101 @@
-require 'rational'
-require 'glib2'
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+require "gobject-introspection"
 
 base_dir = Pathname.new(__FILE__).dirname.dirname.expand_path
 vendor_dir = base_dir + "vendor" + "local"
 vendor_bin_dir = vendor_dir + "bin"
-GLib.prepend_environment_path(vendor_bin_dir)
-if vendor_bin_dir.exist?
-  require 'pango'
-  require 'gdk_pixbuf2'
-end
-begin
-  major, minor, _ = RUBY_VERSION.split(/\./)
-  require "#{major}.#{minor}/gstreamer.so"
-rescue LoadError
-  require "gstreamer.so"
-end
+GLib.prepend_dll_path(vendor_bin_dir)
+vendor_girepository_dir = vendor_dir + "lib" + "girepository-1.0"
+GObjectIntrospection.prepend_typelib_path(vendor_girepository_dir)
 
-argv_without_help_options = ARGV.reject do |option|
-  /\A-h|--help\z/ =~ option
+if vendor_dir.exist?
+  require "cairo"
+  require "gdk_pixbuf2"
+  require "pango"
 end
-Gst.init(argv_without_help_options)
 
 module Gst
-  class Plugin
-    def each_feature(&block)
-      Registry.default.each_feature(name, &block)
+  LOG_DOMAIN = "GStreamer"
+  GLib::Log.set_log_domain(LOG_DOMAIN)
+
+  @initialized = false
+  class << self
+    def init(*argv)
+      return if @initialized
+      @initialized = true
+      loader = Loader.new(self, argv)
+      loader.load("Gst")
+      require "gst/bin"
+      require "gst/bus"
+      require "gst/element"
+      init_base
+    end
+
+    private
+    def init_base
+      require "gst/base_loader"
+      base_loader = BaseLoader.new(self)
+      base_loader.load("GstBase")
     end
   end
 
-  class Structure
-    def inspect
-      super.gsub(/>\z/, ": #{to_s}>")
+  class Loader < GObjectIntrospection::Loader
+    def initialize(base_module, init_arguments)
+      super(base_module)
+      @init_arguments = init_arguments
+    end
+
+    private
+    def pre_load(repository, namespace)
+      init_check = repository.find(namespace, "init_check")
+      succeeded, argc, argv, error = init_check.invoke(1 + @init_arguments.size,
+                                                       [$0] + @init_arguments)
+      @init_arguments.replace(argv[1..-1])
+      raise error unless succeeded
+    end
+
+    def post_load(repository, namespace)
+      require_extension
+      self.class.start_callback_dispatch_thread
+    end
+
+    def require_extension
+      begin
+        major, minor, _ = RUBY_VERSION.split(/\./)
+        require "#{major}.#{minor}/gstreamer.so"
+      rescue LoadError
+        require "gstreamer.so"
+      end
+    end
+
+    def load_function_info(info)
+      return if info.name == "init"
+      super
+    end
+
+    RENAME_MAP = {
+      "uri_protocol_is_valid"     => "valid_uri_protocol?",
+      "uri_protocol_is_supported" => "supported_uri_protocol?",
+      "uri_is_valid"              => "valid_uri?",
+      "uri_has_protocol"          => "uri_has_protocol?",
+    }
+    def rubyish_method_name(function_info)
+      RENAME_MAP[function_info.name] || super
     end
   end
 end

data/sample/helloworld.rb

@@ -0,0 +1,75 @@
+#!/usr/bin/env ruby
+#
+# This sample code is a port of
+# gstreamer/tests/examples/helloworld/helloworld.c. It is licensed
+# under the terms of the GNU Library General Public License, version
+# 2 or (at your option) later.
+#
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+require "gst"
+
+if ARGV.length < 1
+  puts "usage: #{$0} <media file or uri>"
+  exit(false)
+end
+
+Gst.init
+
+playbin = Gst::ElementFactory.make("playbin")
+if playbin.nil?
+  puts "'playbin' gstreamer plugin missing"
+  exit(false)
+end
+
+# take the commandline argument and ensure that it is a uri
+if Gst.valid_uri?(ARGV.first)
+  uri = ARGV.first
+else
+  uri = Gst.filename_to_uri(ARGV.first)
+end
+playbin.uri = uri
+
+# create and event loop feed gstreamer bus messages to it
+loop = GLib::MainLoop.new
+
+bus = playbin.bus
+bus.add_watch do |bus, message|
+  case message.type
+  when Gst::MessageType::EOS
+    puts "End-of-stream"
+    loop.quit
+  when Gst::MessageType::ERROR
+    error, debug = message.parse_error
+    puts "Debugging info: #{debug || 'none'}"
+    puts "Error: #{error.message}"
+    loop.quit
+  end
+  true
+end
+
+# start play back and listed to events
+playbin.play
+begin
+  loop.run
+rescue Interrupt
+  puts "Interrupt"
+rescue => error
+  puts "Error: #{error.message}"
+ensure
+  playbin.stop
+end

data/sample/mp3parselaunch.rb

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#
+# This sample code is a port of
+# gstreamer/tests/examples/launch/mp3parselaunch.c. It is licensed
+# under the terms of the GNU Library General Public License, version
+# 2 or (at your option) later.
+#
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+require "gst"
+
+def event_loop(pipe)
+  running = true
+  bus = pipe.bus
+
+  while running
+    message = bus.poll(Gst::MessageType::ANY, Gst::CLOCK_TIME_NONE)
+    raise "message nil" if message.nil?
+
+    case message.type
+    when Gst::MessageType::EOS
+      running = false
+    when Gst::MessageType::WARNING
+      warning, debug = message.parse_warning
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Warning: #{warning.message}"
+    when Gst::MessageType::ERROR
+      error, debug = message.parse_error
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Error: #{error.message}"
+      running = false
+    end
+  end
+end
+
+Gst.init
+
+if ARGV.length < 1
+  puts "usage: #{$0} <mp3 file>"
+  exit(false)
+end
+
+bin, error = Gst.parse_launch("filesrc name=my_filesrc ! mad ! autoaudiosink")
+if bin.nil?
+  $stderr.puts "Parse error: #{error.message}"
+  exit(false)
+end
+
+filesrc = bin.get_by_name("my_filesrc")
+filesrc.location = ARGV[0]
+
+# start playing
+bin.play
+
+# Run event loop listening for bus messages until EOS or ERROR
+event_loop(bin)
+
+# stop the bin
+bin.stop

data/sample/queue.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#
+# This sample code is a port of
+# gstreamer/tests/examples/queue/queue.c. It is licensed under
+# the terms of the GNU Library General Public License, version
+# 2 or (at your option) later.
+#
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+require "gst"
+
+# This example uses the queue element to create a buffer between 2 elements.
+# The scheduler automatically uses 2 threads, 1 to feed and another to consume
+# data from the queue buffer
+
+# Event loop to listen to events posted on the Gst::Bus from the pipeline. Exits
+# on EOS or ERROR events
+def event_loop(pipe)
+  running = true
+  bus = pipe.bus
+
+  while running do
+    message = bus.poll(Gst::MessageType::ANY, -1)
+
+    case message.type
+    when Gst::MessageType::EOS
+      running = false
+    when Gst::MessageType::WARNING
+      warning, debug = message.parse_warning
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Warning: #{warning.message}"
+    when Gst::MessageType::ERROR
+      error, debug = message.parse_error
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Error: #{error.message}"
+      running = false
+    end
+  end
+end
+
+Gst.init
+
+if ARGV.length < 1
+  puts "usage: #{$0} <filename>"
+  exit(false)
+end
+
+# create a new pipeline to hold the elements
+pipeline = Gst::Pipeline.new("pipeline")
+raise "'pipeline' gstreamer plugin missing" if pipeline.nil?
+
+# create a disk reader
+filesrc = Gst::ElementFactory.make("filesrc", "disk_source")
+raise "'filesrc' gstreamer plugin missing" if filesrc.nil?
+filesrc.location = ARGV.first
+
+decode = Gst::ElementFactory.make("mad", "decode")
+raise "'mad' gstreamer plugin missing" if decode.nil?
+
+queue = Gst::ElementFactory.make("queue", "queue")
+raise "'queue' gstreamer plugin missing" if queue.nil?
+
+# and an audio sink
+audiosink = Gst::ElementFactory.make("alsasink", "play_audio")
+raise "'alsasink' gstreamer plugin missing" if audiosink.nil?
+
+# add objects to the main pipeline
+pipeline << filesrc << decode << queue << audiosink
+filesrc >> decode >> queue >> audiosink
+
+# start playing
+pipeline.play
+
+# listen for EOS
+event_loop(pipeline)
+
+pipeline.stop

data/sample/typefind.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+#
+# This sample code is a port of
+# gstreamer/tests/examples/typefind/typefind.c. It is licensed
+# under the terms of the GNU Library General Public License, version
+# 2 or (at your option) later.
+#
+# Here is the original copyright header:
+#   Copyright (C) <2005> Stefan Kost
+#   Copyright (C) <2006> Tim-Philipp Müller
+#
+# Copyright (C) 2013  Ruby-GNOME2 Project Team
+#
+# 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
+
+require "gst"
+require "rexml/document"
+
+def event_loop(pipe)
+  running = true
+  bus = pipe.bus
+
+  while running do
+    message = bus.poll(Gst::MessageType::ANY, Gst::CLOCK_TIME_NONE)
+    raise "message nil" if message.nil?
+
+    case message.type
+    when Gst::MessageType::EOS
+      running = false
+    when Gst::MessageType::WARNING
+      warning, debug = message.parse_warning
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Warning: #{warning.message}"
+    when Gst::MessageType::ERROR
+      error, debug = message.parse_error
+      puts "Debugging info: #{debug || 'none'}"
+      puts "Error: #{error.message}"
+      running = false
+    end
+  end
+end
+
+Gst.init
+
+if ARGV.length < 1
+  puts "usage: #{$0} <filename>"
+  exit(false)
+end
+
+# create a new pipeline to hold the elements
+pipeline = Gst::Pipeline.new("pipeline")
+raise "'pipeline' gstreamer plugin missing" if pipeline.nil?
+
+# create a file reader
+filesrc = Gst::ElementFactory.make("filesrc", "file_source")
+raise "'filesrc' gstreamer plugin missing" if filesrc.nil?
+filesrc.location = ARGV.first
+
+typefind = Gst::ElementFactory.make("typefind", "typefind")
+raise "'typefind' gstreamer plugin missing" if typefind.nil?
+
+sink = Gst::ElementFactory.make("fakesink", "sink")
+raise "'fakesink' gstreamer plugin missing" if sink.nil?
+
+# add objects to the main pipeline
+pipeline << filesrc << typefind << sink
+
+typefind.signal_connect("have-type") do |element, probability, caps|
+  caps_str = caps.to_s
+  xml = REXML::Document.new
+  xml << REXML::XMLDecl.new
+  capabilities = xml.add_element("Capabilities")
+  cap1 = capabilities.add_element("Cap1")
+  cap1.add_text(caps_str)
+  xml.write($stdout, 2)
+  puts
+end
+
+filesrc >> typefind >> sink
+
+# start playing
+pipeline.play
+
+# Run event loop listening for bus messages until EOS or ERROR
+event_loop(pipeline)
+
+# stop the bin
+pipeline.stop

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gstreamer
 version: !ruby/object:Gem::Version
-  version: 1.2.6
+  version: 2.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-04 00:00:00.000000000 Z
+date: 2013-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: glib2
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.2.6
+        version: 2.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,7 +26,23 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.2.6
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: gobject-introspection
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 description: Ruby/GStreamer is a Ruby binding for GStreamer.
 email: ruby-gnome2-devel-en@lists.sourceforge.net
 executables: []
@@ -34,94 +50,23 @@ extensions:
 - ext/gstreamer/extconf.rb
 extra_rdoc_files: []
 files:
-- README
 - Rakefile
 - extconf.rb
 - lib/gst.rb
+- lib/gst/base_loader.rb
+- lib/gst/bin.rb
+- lib/gst/bus.rb
+- lib/gst/element.rb
 - ext/gstreamer/depend
 - ext/gstreamer/extconf.rb
-- ext/gstreamer/misc.c
-- ext/gstreamer/rbgst-bin.c
-- ext/gstreamer/rbgst-buffer.c
-- ext/gstreamer/rbgst-bus.c
-- ext/gstreamer/rbgst-caps.c
-- ext/gstreamer/rbgst-child-proxy.c
-- ext/gstreamer/rbgst-clock.c
-- ext/gstreamer/rbgst-element-factory.c
-- ext/gstreamer/rbgst-element.c
-- ext/gstreamer/rbgst-event.c
-- ext/gstreamer/rbgst-ghost-pad.c
-- ext/gstreamer/rbgst-index-factory.c
-- ext/gstreamer/rbgst-install-plugins-context.c
-- ext/gstreamer/rbgst-install-plugins-return.c
-- ext/gstreamer/rbgst-install-plugins.c
-- ext/gstreamer/rbgst-message.c
-- ext/gstreamer/rbgst-mini-object.c
-- ext/gstreamer/rbgst-object.c
-- ext/gstreamer/rbgst-pad-template.c
-- ext/gstreamer/rbgst-pad.c
-- ext/gstreamer/rbgst-pipeline.c
-- ext/gstreamer/rbgst-plugin-feature.c
-- ext/gstreamer/rbgst-plugin.c
-- ext/gstreamer/rbgst-private.c
-- ext/gstreamer/rbgst-private.h
-- ext/gstreamer/rbgst-query.c
-- ext/gstreamer/rbgst-seek.c
-- ext/gstreamer/rbgst-static-caps.c
-- ext/gstreamer/rbgst-static-pad-template.c
-- ext/gstreamer/rbgst-structure.c
-- ext/gstreamer/rbgst-system-clock.c
-- ext/gstreamer/rbgst-type-find-factory.c
-- ext/gstreamer/rbgst-value.c
-- ext/gstreamer/rbgst-x-overlay.c
 - ext/gstreamer/rbgst.c
-- ext/gstreamer/rbgst.h
-- ext/gstreamer/rbgstclockentry.c
-- ext/gstreamer/rbgstformat.c
-- ext/gstreamer/rbgstindex.c
-- ext/gstreamer/rbgstindexentry.c
-- ext/gstreamer/rbgstparse.c
-- ext/gstreamer/rbgstquerytype.c
-- ext/gstreamer/rbgstregistry.c
-- ext/gstreamer/rbgsttag.c
-- ext/gstreamer/rbgsttagsetter.c
-- ext/gstreamer/rbgstxml.c
-- sample/audio-player.rb
-- sample/gst-gi.rb
-- sample/gst-inspect.rb
-- sample/install-plugins.rb
-- sample/media-type.rb
-- sample/media-type2.rb
-- sample/ogg-audio-player.rb
-- sample/type-find.rb
-- sample/video-player.rb
-- sample/xml-player.rb
-- test/gst-test-utils.rb
-- test/run-test.rb
-- test/test_bin.rb
-- test/test_buffer.rb
-- test/test_caps.rb
-- test/test_element.rb
-- test/test_element_factory.rb
-- test/test_event.rb
-- test/test_index_factory.rb
-- test/test_install-plugins.rb
-- test/test_message.rb
-- test/test_mini_object.rb
-- test/test_object.rb
-- test/test_pad.rb
-- test/test_plugin.rb
-- test/test_plugin_feature.rb
-- test/test_seek.rb
-- test/test_static_caps.rb
-- test/test_static_pad_template.rb
-- test/test_structure.rb
-- test/test_thread_handling.rb
-- test/test_type_find_factory.rb
-- test/test_value.rb
+- sample/helloworld.rb
+- sample/mp3parselaunch.rb
+- sample/queue.rb
+- sample/typefind.rb
 homepage: http://ruby-gnome2.sourceforge.jp/
 licenses: []
-post_install_message: This library is experimental.
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib

data/README

@@ -1,33 +0,0 @@
-Ruby/GStreamer
-==============
-
-Ruby/GStreamer is a Ruby binding for GStreamer.
-
-Requirements
-------------
-
-    Ruby:       http://www.ruby-lang.org/
-    GStreamer:  http://gstreamer.freedesktop.org/
-
-Install
--------
-
-    0. install Ruby (>= 1.8.x) and GStreamer (>= 0.10.x).
-    1. ruby extconf.rb
-    2. make
-    3. su
-    4. make install
-
-Copying
--------
-
-    Copyright (c) 2002-2005 Ruby-GNOME2 Project Team
-
-    This program is free software.
-    You can distribute/modify this program under the terms of
-    the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1.
-
-Project Website
----------------
-
-    http://ruby-gnome2.sourceforge.jp