flite 0.0.3.1 → 0.1.0

data/lib/flite.rb

@@ -36,12 +36,22 @@ RUBY_VERSION =~ /(\d+).(\d+)/
 require "flite_#{$1}#{$2}0"
 
 module Flite
+  # @private
   @@default_voice = Flite::Voice.new
 
+  # Returns the voice used by {String#speak} and {String#to_speech}.
+  #
+  # @return [Flite::Voice]
   def self.default_voice
     @@default_voice
   end
 
+  # Set the voice used by {String#speak} and {String#to_speech}.
+  # When <code>name</code> is a {Flite::Voice}, use it.
+  # Otherwise, use a new voice created by <code>Flite::Voice.new(name)</code>.
+  #
+  # @param [Flite::Voice or String] name voice or voice name
+  # @see Flite::Voice#initialize
   def self.default_voice=(name)
     if name.is_a? Flite::Voice
       @@default_voice = name
@@ -49,10 +59,43 @@ module Flite
       @@default_voice = Flite::Voice.new(name)
     end
   end
+
+  if RUBY_PLATFORM =~ /mingw32|win32/
+    self.sleep_time_after_speaking = 0.3
+  end
 end
 
 class String
-  def to_speech(out = nil)
-    Flite.default_voice.speech(self, out)
+  # Speaks <code>self</code>
+  #
+  # @example
+  #   "Hello Flite World!".speak
+  def speak
+    Flite.default_voice.speak(self)
+  end
+
+  # @overload to_speech(audio_type = :wave, opts = {})
+  #
+  #  Converts <code>self</code> to audio data.
+  #
+  #  @example
+  #    # Save speech as wav
+  #    File.binwrite('hello_flite_world.wav',
+  #                  'Hello Flite World!'.to_speech())
+  #
+  #    # Save speech as mp3
+  #    File.binwrite('hello_flite_world.mp3',
+  #                  'Hello Flite World!'to_speech(:mp3))
+  #
+  #    # Save speech as mp3 whose bitrate is 128k.
+  #    File.binwrite('hello_flite_world.mp3',
+  #                  'Hello Flite World!'.to_speech(:mp3, :bitrate => 128))
+  #
+  #  @param [Symbol] audo_type :wave or :mp3 (when mp3 support is enabled)
+  #  @param [Hash]   opts  audio encoder options
+  #  @return [String] audio data
+  #  @see Flite.supported_audio_types
+  def to_speech(*args)
+    Flite.default_voice.to_speech(self, *args)
   end
 end

data/lib/flite/version.rb

@@ -1,3 +1,3 @@
 module Flite
-  VERSION = "0.0.3.1"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flite
 version: !ruby/object:Gem::Version
-  version: 0.0.3.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Kubo Takehiro
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-13 00:00:00.000000000 Z
+date: 2015-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -53,7 +53,8 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: |
-  Ruby-flite is a small speech synthesis library using CMU flite[http://cmuflite.org].
+  Ruby-flite is a small speech synthesis library for ruby using
+  CMU flite[http://cmuflite.org].
 
   CMU Flite (festival-lite) is a small, fast run-time synthesis engine
   developed at CMU and primarily designed for small embedded machines
@@ -63,7 +64,8 @@ description: |
 email:
 - kubo@jiubao.org
 executables:
-- saytime.rb
+- saytime
+- speaking-web-server
 extensions:
 - ext/flite/extconf.rb
 extra_rdoc_files: []
@@ -72,10 +74,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/saytime.rb
+- bin/saytime
+- bin/speaking-web-server
 - ext/flite/extconf.rb
 - ext/flite/rbflite.c
 - ext/flite/rbflite.h
+- ext/flite/win32_binary_gem.c
 - flite.gemspec
 - lib/flite.rb
 - lib/flite/version.rb