win32-loquendo 1.1.0-x86-mingw32 → 1.1.1-x86-mingw32

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZWRhNmQ0OGYxZjA1M2Q0NWEzYWJlZjQ2ZGE1ZDRkNzViY2NhMzU5Nw==
+    ODAxYWUzOGM0ZjA2ZmNjNmJlMDEyNTc4YTgxMGVkZDEwY2U2OWM4Ng==
   data.tar.gz: !binary |-
-    NGJlMDgwODE3YTJmZTA1MTVmMTMzNDRiZDI4NTZmYTI4MjAxYTVhMw==
+    YzRjODVlZTk5OTFmMzRkOGUxM2E3Y2FhMTk5ZmMzZDJlMTljZTQzMg==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    NTkyNjFhMTgxNTMxZmY4YzJiOGE3NGE2MTJiZmIzNjA3YzBlZDQzODAxNzJj
-    MGYxMDE3MjFmM2QyNGU5MDEwNjZhNTlkM2E3OTRmYjk1MzQwZTUzNTViMTMx
-    NDdlZjE0OGJiNDE0ZmQ1NGE4YjgzNGEzNmRhOTEwMWVmOGY5Y2I=
+    MGFmNDk0MDZlNWI1ZmU1YzljODZkMDNhYjBkZmZkMTRhYmU2MzI1NzVlYWJk
+    ZTc4MDY4MTJlODA3NWZmNmU3NDA4ZmMzMjlhNTFjMzgzNTZiZDY5MTUzOTUw
+    MTA3NTIwYjc3OWQ2ZTBmNmFkNmE2Y2U1YzYyNjU2MzFjMjEwMTU=
   data.tar.gz: !binary |-
-    OGNiN2RkMGMxYTVlNjE3ZTQ3YzBjNGFmNGRlNTk0MjVmM2JkY2NmZWFiMTlj
-    MTJlMzg5YTQ0NDE0MzZjNDJiZjBkNmNlZjYwZmFjYTk4MzFmMjBkMzI1ZWNj
-    OGU3YWM2NjEyNmI2YmQ1YzQxMzZhODQwMGY1YzM2MDMzOWNiNTA=
+    OThkNjgxNDExNzJmNzZlMmZlODRhNTJmN2UzZWRiMmRmMWUzNTBiNmE3NGZj
+    M2IxY2QyZGQzYmVmNTM2ODZhY2M3ZjdhZTA1MWNjZGFlNTU0MGQ4OWQ0YjAy
+    M2IyYTFkMmE3Njg4ZjU0OTc4ZTkzOWUwYzhiYjU2ZTMwY2NjNTY=

data/README.md

@@ -1,101 +1,106 @@
-# Win32::Loquendo
-
-Ruby interface to the Loquendo speech synthesis (text to speech / TTS) program.
-
-It also ships a command line utility `say` which allows you to get spoken
-text directly from the console.
-
-This gem only runs on Microsoft Windows as it relies both on the Win32 API as 
-well as the DLL files used by the Loquendo distribution. For that reason it 
-has been name spaced in the win32 module to make it abundantly clear which
-platform it supports.
-
-## Prerequisites
-
-* Must have Loquendo installed on the machine in order to use this gem.
-* ruby ffi library, will be installed automatically through rubygems
-
-## Installation
-
-    $ gem install win32-loquendo
-
-## API usage
-
-Basic example showing the three types of use
-
-    require 'win32/loquendo'
-
-    reader = Win32::Loquendo::Reader.new()
-
-    reader.say("Say it aloud")  # Send the text to the sound card
-
-    reader.say("Give me the data") do |data|
-      # do stuff with the string of PCM WAVE bytes
-    end
-
-    reader.write("audio.wav", "Save the spoken text to a file")
-
-Customize how the text is spoken
-
-    reader = Win32::Loquendo::Reader.new({
-      :sample_rate => 32000,       # Pick a sample rate in Hz
-      :channels    => 2,           # Stereo or mono (1 or 2 audio channels)
-      :voice       => "Elizabeth"  # Specify the default voice to use
-    })                             
-    
-    reader.say "Hi, this is Elizabeth speaking"  # Speak with the default voice.
-    reader.say "and this is Simon", "Simon"      # Override the default voice
-                                                 # for this utterance.
-
-    reader.voices.each do |name|              # List installed voices that can 
-      reader.say "My name is #{name}", name   # be used for speaking.
-    end
-      
-Note that you can customize a lot on the fly regarding how Loquendo speaks, by
-simply adding commands as part of the text being spoken. For example:
-
-* Trigger whatever pre-programmed demo phrase the voice used was shipped with.
-
-        reader.say("\\demosentence and I'm speaking through ruby win32-loquendo")
-   
-* Provide proper pronunciation for words using [X-SAMPA][*]
-
-        reader.say("Hello, or in Finnish; \SAMPA=;('t_de4ve)", "Dave")
-
-Finally you can launch speech prompts in parallel, overlapping to the degree 
-you'd like by running reader instances in separate threads. This example
-generates something eerily similar to Google's audio captchas, using 10 
-overlapping voices.
-
-    (0...40).to_a.shuffle.each_slice(4).map{|a| a.join(" ") }.map{|s|
-      Thread.new { Win32::Loquendo::Reader.new.say(s) }
-    }.each {|t|
-      t.join
-    }
-
-A note of caution: Only ever interact with a reader from one and the same thread.
-If used from different threads it will cause undefined behavior (errors, 
-hangs, crashes), since the library interact with C-code over FFI and such 
-interactions are not thread safe.
-
-## Command line usage
-
-The command line program is named `say`
-
-    Usage: say [OPTIONS] [TEXT]
-    
-    TEXT is the text you want to be spoken
-    
-    Options:
-      -c (1|2)  audio channels to use
-      -f FILE   write audio to FILE instead of speaking it aloud
-      -h        show this help text
-      -l        lists the available voices
-      -s N      sample rate in Hz
-      -v voice  is the voice to use for speaking
-
-To speak a phrase with the default voice, it's as easy as
-
-    say My PC can now speak, just like my Mac!
-
-[*]: http://en.wikipedia.org/wiki/X-SAMPA   
+# Win32::Loquendo
+
+Ruby interface to the Loquendo speech synthesis (text to speech / TTS) program.
+
+It also ships a command line utility `say` which allows you to get spoken
+text directly from the console.
+
+This gem only runs on Microsoft Windows as it relies both on the Win32 API as 
+well as the DLL files used by the Loquendo distribution. For that reason it 
+has been name spaced in the win32 module to make it abundantly clear which
+platform it supports.
+
+## Prerequisites
+
+* Must have Loquendo installed on the machine in order to use this gem.
+* ruby ffi library, will be installed automatically through rubygems
+
+## Installation
+
+    $ gem install win32-loquendo
+
+## API usage
+
+Basic example showing the three types of use
+
+    require 'win32/loquendo'
+
+    reader = Win32::Loquendo::Reader.new()
+
+    reader.say("Say it aloud")  # Send the text to the sound card
+
+    reader.say("Give me the data") do |data|
+      # do stuff with the string of PCM WAVE bytes
+    end
+
+    reader.write("audio.wav", "Save the spoken text to a file")
+
+Customize how the text is spoken
+
+    reader = Win32::Loquendo::Reader.new({
+      :sample_rate => 32000,       # Pick a sample rate in Hz
+      :channels    => 2,           # Stereo or mono (1 or 2 audio channels)
+      :voice       => "Elizabeth"  # Specify the default voice to use
+    })                             
+    
+    reader.say "Hi, this is Elizabeth speaking"  # Speak with the default voice.
+    reader.say "and this is Simon", "Simon"      # Override the default voice
+                                                 # for this utterance.
+
+    reader.voices.each do |name|              # List installed voices that can 
+      reader.say "My name is #{name}", name   # be used for speaking.
+    end
+      
+Note that you can customize a lot on the fly regarding how Loquendo speaks, by
+simply adding commands as part of the text being spoken. For example:
+
+* Trigger whatever pre-programmed demo phrase the voice used was shipped with.
+
+        reader.say("\\demosentence and I'm speaking through ruby win32-loquendo")
+   
+* Provide proper pronunciation for words using [X-SAMPA][*]
+
+        reader.say("Hello, or in Finnish; \SAMPA=;('t_de4ve)", "Dave")
+
+Finally you can launch speech prompts in parallel, overlapping to the degree 
+you'd like by running reader instances in separate threads. This example
+generates something eerily similar to Google's audio captchas, using 10 
+overlapping voices.
+
+    (0...40).to_a.shuffle.each_slice(4).map{|a| a.join(" ") }.map{|s|
+      Thread.new { Win32::Loquendo::Reader.new.say(s) }
+    }.each {|t|
+      t.join
+    }
+
+A note of caution: Only ever interact with a reader from one and the same thread.
+If used from different threads it will cause undefined behavior (errors, 
+hangs, crashes), since the library interact with C-code over FFI and such 
+interactions are not thread safe.
+
+## Command line usage
+
+The command line program is named `say`
+
+    Usage: say [OPTIONS] [TEXT]
+    
+    TEXT is the text you want to be spoken
+    
+    Options:
+      -c (1|2)  audio channels to use
+      -f FILE   write audio to FILE instead of speaking it aloud
+      -h        show this help text
+      -l        lists the available voices
+      -s N      sample rate in Hz
+      -v voice  is the voice to use for speaking
+
+To speak a phrase with the default voice, it's as easy as
+
+    say My PC can now speak, just like my Mac!
+
+You can also change the default voice, so you don't have to provide the `-v` 
+option all the time. To change the default voice, create the file 
+"`%HOME%/.win32-loquendo`" and enter the voice you want to use on the first 
+line in that file.
+
+[*]: http://en.wikipedia.org/wiki/X-SAMPA   

data/bin/say

@@ -10,7 +10,7 @@ def usage
        "  -h        show this help text",
        "  -l        lists the available voices",
        "  -s N      sample rate in Hz",
-       "  -v voice  is the voice to use for speaking"
+       "  -v voice  is the voice to use for speaking (default: #{Win32::Loquendo::Reader.default_voice})"
   exit(1)
 end
 

data/lib/win32/loquendo.rb

@@ -15,14 +15,18 @@ module Win32
       # @option opts [Integer] :channels (2) denotes Stereo or mono, 2 or 1 channel.
       # @option opts [String]  :voice (Elisabeth) default voice to use unless
       #                              overridden when calling {#say} or {#write}.
+      # @note To change the default voice, create the file "%HOME%/.win32-loquendo"
+      #       and enter the voice you want to use on the first line.
       def initialize(opts={})
         @opts = {
           :sample_rate => 32000,
           :channels    => 2,
-          :voice       => "Elizabeth"
+          :voice       => self.class.default_voice
         }.merge(opts)
         @speaking = false
 
+        info "using voice: #{@opts[:voice]}"
+
         # Sanity checking of input parameters
         unless @opts[:sample_rate].kind_of?(Integer) && @opts[:sample_rate] > 0
           raise LoquendoException, ":sample_rate must be an integer and larger than zero, but %s was specified" % @opts[:sample_rate].to_s
@@ -104,6 +108,15 @@ module Win32
         buff.read_string.split(";")
       end
 
+      def self.default_voice
+        fn = ENV['HOME'] + "./.win32-loquendo"
+        if File.exists?(fn)
+          File.readlines(fn).first.strip
+        else
+          "Elizabeth"
+        end
+      end
+
       private #################################################################
 
       def say_aloud(text, voice = @opts[:voice])

data/lib/win32/loquendo/version.rb

@@ -1,5 +1,5 @@
 module Win32
   module Loquendo
-    VERSION = "1.1.0"
+    VERSION = "1.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: win32-loquendo
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: x86-mingw32
 authors:
 - Jonas Tingeborn