hornetseye-v4l2 0.2.0 → 0.2.1

data/README.md

@@ -2,3 +2,46 @@ hornetseye-v4l2
 ======
 This Ruby extension provides camera input using Video for Linux version 2.
 
+**Author**:       Jan Wedekind
+**Copyright**:    2010
+**License**:      GPL
+
+Synopsis
+--------
+
+This Ruby extension provides the class {Hornetseye::V4L2Input} for capturing video frames using Video for Linux version 2 (V4L2).
+
+Installation
+------------
+*hornetseye-v4l2* requires the V4L2 heasers. If you are running Debian or (K)ubuntu, you can install them like this:
+
+    $ sudo aptitude install linux-libc-dev
+
+To install this Ruby extension, use the following command:
+
+    $ sudo gem install hornetseye-v4l2
+
+Alternatively you can build and install the Ruby extension from source as follows:
+
+    $ rake
+    $ sudo rake install
+
+Usage
+-----
+
+Simply run Interactive Ruby:
+
+    $ irb
+
+You can open a V4L2-compatible camera as shown below. This example will open the camera and switch to a resolution selected by the user. Finally the camera input is displayed in a window. This example requires *hornetseye-xorg* in addition to this Ruby extension.
+
+    require 'rubygems'
+    require 'hornetseye_v4l2'
+    require 'hornetseye_xorg'
+    include Hornetseye
+    camera = V4L2Input.new '/dev/video' do |modes|
+      modes.each_with_index { |mode,i| puts "#{i + 1}: #{mode}" }
+      modes[ STDIN.readline.to_i - 1 ]
+    end
+    X11Display.show { camera.read }
+

data/Rakefile

@@ -7,7 +7,7 @@ require 'rake/loaders/makefile'
 require 'rbconfig'
 
 PKG_NAME = 'hornetseye-v4l2'
-PKG_VERSION = '0.2.0'
+PKG_VERSION = '0.2.1'
 CFG = RbConfig::CONFIG
 CXX = ENV[ 'CXX' ] || 'g++'
 RB_FILES = FileList[ 'lib/**/*.rb' ]
@@ -46,7 +46,7 @@ desc 'Compile Ruby extension (default)'
 task :all => [ SO_FILE ]
 
 file SO_FILE => OBJ do |t|
-   sh "#{CXX} -shared -o #{t.name} #{OBJ} -lv4l2 #{$LIBRUBYARG}"
+   sh "#{CXX} -shared -o #{t.name} #{OBJ} #{$LIBRUBYARG}"
 end
 
 task :test => [ SO_FILE ]

data/lib/hornetseye-v4l2/v4l2input.rb

@@ -40,7 +40,7 @@ module Hornetseye
           end
           desired = action.call frame_types
           unless frame_types.member? desired
-            raise "Frame type #{desired} not supported by camera"
+            raise "Frame type #{desired.inspect} not supported by camera"
           end
           index[ frame_types.index( desired ) ]
         end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 2
-  - 0
-  version: 0.2.0
+  - 1
+  version: 0.2.1
 platform: ruby
 authors: 
 - Jan Wedekind