aboutsummaryrefslogtreecommitdiff
path: root/externals/gridflow/devices4ruby/README
diff options
context:
space:
mode:
authorN.N. <matju@users.sourceforge.net>2005-10-04 02:12:44 +0000
committerN.N. <matju@users.sourceforge.net>2005-10-04 02:12:44 +0000
commita7dc40f29086515c31667490c03211812b84e2ed (patch)
tree71e6e490e08d6afb03295098f6beb204f616ad6b /externals/gridflow/devices4ruby/README
parent31beef22c1f976ee0d0b7d10157e726f234cff4e (diff)
added the remainder of the files (or almost) from GF 0.8.0
svn path=/trunk/; revision=3651
Diffstat (limited to 'externals/gridflow/devices4ruby/README')
-rw-r--r--externals/gridflow/devices4ruby/README27
1 files changed, 27 insertions, 0 deletions
diff --git a/externals/gridflow/devices4ruby/README b/externals/gridflow/devices4ruby/README
new file mode 100644
index 00000000..740b5165
--- /dev/null
+++ b/externals/gridflow/devices4ruby/README
@@ -0,0 +1,27 @@
+devices/linux
+
+AUTHOR
+
+ Mathieu Bouchard <matju@sympatico.ca>
+ irc: irc.openprojects.net / #ruby-lang / matju
+ (note: I can't read Japanese; write in French or English please)
+
+OVERVIEW
+
+This is a collection of simple modules that you extend IO objects with, to
+give them support for specific devices. For example:
+
+ require "linux/SoundMixer"
+ f = File.open "/dev/mixer"
+ f.extend Linux::SoundMixer
+
+ # f now has special accessors for driver variables, e.g:
+
+ f.treble = left_speaker_percent + 256 * right_speaker_percent
+
+The modules are made of automatically generated methods, much like Ruby's
+accessors. those generators are called ioctl_reader, ioctl_writer,
+ioctl_accessor. Writing expects an integer in -2**31...2**31; reading will
+return the same. You may browse the source to find out which accessors are
+available, and it's easy to add support for more features.
+