win32-sound 0.5.1 → 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f4bdc665ebd9e6b35140e5e48801e271060720c5
+  data.tar.gz: a22dd1421d0be46d57584ecc444bbdfdd6351400
+SHA512:
+  metadata.gz: 7af84db083e9b8839e8ceedcbba0f03c2f79c4024fd0b221ffb019d6e7982a2b8b54700b26d1d57b1b97c38774236e216bc5b952acb4361dd7d36e848babdd26
+  data.tar.gz: 819948dce743c4e8126e704c0f5fd317a9488a24a700a619423cbe2a42fa3e6850a03715279817a9d2c1f88230c9687bdabf95b8c6552c525bd5ba47f1143bb1

data/CHANGES

@@ -1,66 +1,73 @@
-== 0.5.1 - 10-Apr-2013
-* Updated HANDLE prototype in underlying FFI code. This affects
-  64 bit versions of Ruby.
-
-== 0.5.0 - 28-Jun-2012
-* Now uses FFI instead of win32-api. This means it works with JRuby, too.
-* Corresponding updates to the tests, Rakefile, gemspec, etc.
-* Removed the Sound::Error exception class. If an underlying FFI function
-  fails then a SystemCallError (Errno::XXX) is raised instead.
-
-== 0.4.3 - 21-May-2011
-* Refactored Rakefile, removing an old gem install task and adding a
-  default task and a clean task.
-* Altered the gemspec, including a platform change to 'universal-win32', and
-  removed a deprecated specification method.
-
-== 0.4.2 - 6-Aug-2009
-* Changed the license to Artistic 2.0.
-* Updated to use the Windows::Sound module from the windows-pr library.
-* Fixed the Sound::ALIAS value. It was wrongly set to SND_ALIAS_ID.
-* Several gemspec updates, including the license and description.
-* The Sound.get_wave_volume method is now a true alias.
-* Renamed the test file to test_win32_sound.rb.
-* Renamed the example file to example_win32_sound.rb to avoid any possible
-  confusion with actual test files.
-* Added the 'example' rake task.
-
-== 0.4.1 - 27-Jul-2007
-* Changed SoundError to Sound::Error.
-* Added a Rakefile with tasks for installation and testing.
-* Removed the install.rb file. Installation is now handled via a rake task.
-* Documentation updates.
-
-== 0.4.0 - 26-Feb-2006
-* Now pure Ruby only.
-* Documentation updates and reorganization.
-* Added a gemspec.
-* Minor test suite changes.
-
-== 0.3.0 - 29-May-2005
-* Changed the Sound.volume= method (which didn't work) to
-  Sound.set_wave_volume because it takes up to two values and only affects
-  the wave volume, not the master volume.
-* Renamed the Sound.volume method to Sound.wave_volume.
-* Fixed a bug in the Sound.wave_volume method.
-* Created the Sound.get_wave_volume alias for Sound.wave_volume.
-* Fixed the Sound.set_wave_volume method.
-* Test adjustments and additions to reflect API changes.
-* Now Unicode friendly.
-* Removed the sound.rd file.  The sound.txt file is now rdoc friendly.
-
-== 0.2.1 - 1-Mar-2005
-* Moved the 'examples' directory to the toplevel directory
-* Made the CHANGES and README files rdoc friendly
-* Some cleanup in sound.h.
-
-== 0.2.0 - 13-Jul-2004
-* Moved the SoundError class under the Win32 module namespace
-* Replaced the deprecated STR2CSTR() function with the StringValuePtr()
-  function.  This means that as of version 0.2.0, this package requires
-  Ruby 1.8.0 or later.
-* Moved the test.rb script to doc/examples
-* Added the README file (oops).
-
-== 0.1.0 - 14-Feb-2004
-* Initial release
+== 0.6.0 - 30-Jul-2014
+* Added the play_freq method. This lets you play a frequency for a
+  specified duration at a given volume. Big thanks go out to Dominic
+  Muller for the patch.
+* Reorganization of FFI related code into their own files.
+* Updated the gem:create and gem:install rake tasks.
+
+== 0.5.1 - 10-Apr-2013
+* Updated HANDLE prototype in underlying FFI code. This affects
+  64 bit versions of Ruby.
+
+== 0.5.0 - 28-Jun-2012
+* Now uses FFI instead of win32-api. This means it works with JRuby, too.
+* Corresponding updates to the tests, Rakefile, gemspec, etc.
+* Removed the Sound::Error exception class. If an underlying FFI function
+  fails then a SystemCallError (Errno::XXX) is raised instead.
+
+== 0.4.3 - 21-May-2011
+* Refactored Rakefile, removing an old gem install task and adding a
+  default task and a clean task.
+* Altered the gemspec, including a platform change to 'universal-win32', and
+  removed a deprecated specification method.
+
+== 0.4.2 - 6-Aug-2009
+* Changed the license to Artistic 2.0.
+* Updated to use the Windows::Sound module from the windows-pr library.
+* Fixed the Sound::ALIAS value. It was wrongly set to SND_ALIAS_ID.
+* Several gemspec updates, including the license and description.
+* The Sound.get_wave_volume method is now a true alias.
+* Renamed the test file to test_win32_sound.rb.
+* Renamed the example file to example_win32_sound.rb to avoid any possible
+  confusion with actual test files.
+* Added the 'example' rake task.
+
+== 0.4.1 - 27-Jul-2007
+* Changed SoundError to Sound::Error.
+* Added a Rakefile with tasks for installation and testing.
+* Removed the install.rb file. Installation is now handled via a rake task.
+* Documentation updates.
+
+== 0.4.0 - 26-Feb-2006
+* Now pure Ruby only.
+* Documentation updates and reorganization.
+* Added a gemspec.
+* Minor test suite changes.
+
+== 0.3.0 - 29-May-2005
+* Changed the Sound.volume= method (which didn't work) to
+  Sound.set_wave_volume because it takes up to two values and only affects
+  the wave volume, not the master volume.
+* Renamed the Sound.volume method to Sound.wave_volume.
+* Fixed a bug in the Sound.wave_volume method.
+* Created the Sound.get_wave_volume alias for Sound.wave_volume.
+* Fixed the Sound.set_wave_volume method.
+* Test adjustments and additions to reflect API changes.
+* Now Unicode friendly.
+* Removed the sound.rd file.  The sound.txt file is now rdoc friendly.
+
+== 0.2.1 - 1-Mar-2005
+* Moved the 'examples' directory to the toplevel directory
+* Made the CHANGES and README files rdoc friendly
+* Some cleanup in sound.h.
+
+== 0.2.0 - 13-Jul-2004
+* Moved the SoundError class under the Win32 module namespace
+* Replaced the deprecated STR2CSTR() function with the StringValuePtr()
+  function.  This means that as of version 0.2.0, this package requires
+  Ruby 1.8.0 or later.
+* Moved the test.rb script to doc/examples
+* Added the README file (oops).
+
+== 0.1.0 - 14-Feb-2004
+* Initial release

data/MANIFEST

@@ -1,8 +1,10 @@
-* MANIFEST
-* CHANGES
-* README
-* Rakefile
-* win32-sound.gempsec
-* examples/sound_test.rb
-* lib/win32/sound.rb
-* test/tc_sound.rb
+* MANIFEST
+* CHANGES
+* README
+* Rakefile
+* win32-sound.gempsec
+* examples/sound_test.rb
+* lib/win32/sound.rb
+* lib/win32/windows/functions.rb
+* lib/win32/windows/structs.rb
+* test/test_win32_sound.rb

data/README

@@ -1,56 +1,57 @@
-= Description
-  A library for playing and controlling sounds on MS Windows.
-
-= Prerequisites
-  * ffi
-  * test-unit 2 (Development only)
-
-= Installation
-  gem install win32-sound
-
-= Synopsis
-  require 'win32/sound'
-  include Win32
-
-  # Play a wav file
-  Sound.play("somefile.wav")
-
-  # Play a system sound
-  Sound.play("SystemAsterisk",Sound::ALIAS)
-
-  # Get the current volume of the waveform-audio output device.
-  p Sound.volume.join(", ") # left channel, right channel
-
-= Acknowledgements
-  API ideas derived (or not) from Perl's Win32::Sound module and Python's
-  winsound package.
-
-= Known Bugs
-  None that I'm aware of. Please report any bugs on the project page
-  at https://github.com/djberg96/win32-sound.
-   
-= Future Plans
-  Add ability to retrieve information about WAV files.
-  Add MIDI support?
-
-= Developer's Notes
-  The MessageBeep() function, which the Python "winsound" module contains,
-  is intentionally omitted here. I felt it was redundant, because you can
-  achieve the same effect with something like this:
-
-    Sound.play("SystemAsterisk", Sound::ALIAS).
-	
-= License
-  Artistic 2.0
-
-= Copyright
-  (C) 2004-2013, Daniel J. Berger, All Rights Reserved
-
-= Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-
-= Author(s)
-  Daniel Berger
-  Park Heesob
+= Description
+  A library for playing and controlling sounds on MS Windows.
+
+= Prerequisites
+  * ffi
+  * test-unit 2 (Development only)
+
+= Installation
+  gem install win32-sound
+
+= Synopsis
+  require 'win32/sound'
+  include Win32
+
+  # Play a wav file
+  Sound.play("somefile.wav")
+
+  # Play a system sound
+  Sound.play("SystemAsterisk",Sound::ALIAS)
+
+  # Get the current volume of the waveform-audio output device.
+  p Sound.volume.join(", ") # left channel, right channel
+
+= Acknowledgements
+  API ideas derived (or not) from Perl's Win32::Sound module and Python's
+  winsound package.
+
+= Known Bugs
+  None that I'm aware of. Please report any bugs on the project page
+  at https://github.com/djberg96/win32-sound.
+   
+= Future Plans
+  Add ability to retrieve information about WAV files.
+  Add MIDI support?
+
+= Developer's Notes
+  The MessageBeep() function, which the Python "winsound" module contains,
+  is intentionally omitted here. I felt it was redundant, because you can
+  achieve the same effect with something like this:
+
+    Sound.play("SystemAsterisk", Sound::ALIAS).
+	
+= License
+  Artistic 2.0
+
+= Copyright
+  (C) 2004-2014, Daniel J. Berger, All Rights Reserved
+
+= Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+
+= Author(s)
+  Daniel Berger
+  Park Heesob
+  Dominic Muller

data/Rakefile

@@ -1,31 +1,36 @@
-require 'rake'
-require 'rake/testtask'
-require 'rake/clean'
-
-CLEAN.include("**/*.gem", "**/*.rbc")
-
-namespace :gem do
-  desc "Create the win32-sound gem"
-  task :create => [:clean] do
-    spec = eval(IO.read("win32-sound.gemspec"))
-    Gem::Builder.new(spec).build
-  end
-
-  desc "Install the win32-sound library"
-  task :install => [:create] do
-    file = Dir["*.gem"].first
-    sh "gem install #{file}"
-  end
-end
-
-desc 'Run the example program'
-task :example do
-  ruby '-Ilib examples\example_win32_sound.rb'
-end
-
-Rake::TestTask.new do |t|
-  t.warning = true
-  t.verbose = true
-end
-
-task :default => :test
+require 'rake'
+require 'rake/testtask'
+require 'rake/clean'
+
+CLEAN.include("**/*.gem", "**/*.rbc")
+
+namespace :gem do
+  desc "Create the win32-sound gem"
+  task :create => [:clean] do
+    spec = eval(IO.read("win32-sound.gemspec"))
+    if Gem::VERSION.to_f < 2.0
+      Gem::Builder.new(spec).build
+    else
+      require 'rubygems/package'
+      Gem::Package.build(spec)
+    end
+  end
+
+  desc "Install the win32-sound library"
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+desc 'Run the example program'
+task :example do
+  ruby '-Ilib examples\example_win32_sound.rb'
+end
+
+Rake::TestTask.new do |t|
+  t.warning = true
+  t.verbose = true
+end
+
+task :default => :test

data/examples/example_win32_sound.rb

@@ -1,48 +1,56 @@
-#######################################################################
-# example_win32_sound.rb (win32-sound)
-#
-# A example script to demonstrate the win32-sound library and for
-# general futzing. You can run this via the 'rake example' task.
-#
-# Modify as you see fit.
-#######################################################################
-require 'win32/sound'
-include Win32
-
-wav = "c:\\windows\\media\\chimes.wav"
-
-puts "VERSION: " + Sound::VERSION
-#puts "Devices: " + Sound.devices.join(", ")
-
-#Sound.volume = [77,128] # my personal settings
-
-orig_left, orig_right = Sound.wave_volume
-puts "Volume was: #{orig_left}, #{orig_right}"
-
-#Sound.volume = 140
-#puts "Volume is now: " + Sound.volume.join(", ")
-
-#Sound.volume = [orig_left,orig_right]
-#puts "Volume is now: " + Sound.volume.join(", ")
-
-puts "Playing 'SystemAsterisk' sound"
-sleep 1
-Sound.play("SystemAsterisk",Sound::ALIAS)
-
-puts "Playing 'chimes' sound once"
-sleep 1
-Sound.play(wav)
-
-puts "Playing 'chimes' sound in a loop for 3 seconds"
-sleep 1
-Sound.play(wav,Sound::ASYNC|Sound::LOOP)
-sleep 3
-Sound.stop
-
-puts "Playing default sound"
-sleep 1
-Sound.play("Foofoo", Sound::ALIAS)
-
-puts "Playing a beep"
-sleep 1
-Sound.beep(500, 10000)
+#######################################################################
+# example_win32_sound.rb (win32-sound)
+#
+# A example script to demonstrate the win32-sound library and for
+# general futzing. You can run this via the 'rake example' task.
+#
+# Modify as you see fit.
+#######################################################################
+require 'win32/sound'
+include Win32
+
+wav = "c:\\windows\\media\\chimes.wav"
+
+puts "VERSION: " + Sound::VERSION
+#puts "Devices: " + Sound.devices.join(", ")
+
+#Sound.volume = [77,128] # my personal settings
+
+orig_left, orig_right = Sound.wave_volume
+puts "Volume was: #{orig_left}, #{orig_right}"
+
+#Sound.volume = 140
+#puts "Volume is now: " + Sound.volume.join(", ")
+
+#Sound.volume = [orig_left,orig_right]
+#puts "Volume is now: " + Sound.volume.join(", ")
+
+puts "Playing 'SystemAsterisk' sound"
+sleep 1
+Sound.play("SystemAsterisk",Sound::ALIAS)
+
+puts "Playing 'chimes' sound once"
+sleep 1
+Sound.play(wav)
+
+puts "Playing 'chimes' sound in a loop for 3 seconds"
+sleep 1
+Sound.play(wav,Sound::ASYNC|Sound::LOOP)
+sleep 3
+Sound.stop
+
+puts "Playing default sound"
+sleep 1
+Sound.play("Foofoo", Sound::ALIAS)
+
+puts "Playing a beep"
+sleep 1
+Sound.beep(500, 2000)
+
+puts "Playing multiple frequencies simultaneously"
+sleep 1
+threads = []
+[440, 660].each do |freq|
+  threads << Thread.new { Sound.play_freq(freq) }
+end
+threads.each { |th| th.join }