theshell.ch/site/pages/cmd/basic/say.html
devitg d2d1d75763 Team Basic: Adding openshell and commands man, open, say
git-svn-id: svn+ssh://atelier.inf.usi.ch/home/bevilj/group-1@73 a672b425-5310-4d7a-af5c-997e18724b81
2018-11-09 13:06:37 +00:00

71 lines
2.6 KiB
HTML

---
layout: page
author: De Vita Gianmarco
title: SAY
---
<p>You can convert text into audible speech just by writing the command
<code>say</code> followed by a string. This is possible thanks to the
Speech Synthesis manager.</p>
{% highlight ruby linenos %}
Device-name:Current-position username$ say string
{% endhighlight %}
<p>Naturally, the wide presence of flags for this command allows you to use
this command for many different tasks. Notice that using more flag
simultaneously, you will be able to solve more complex operations.</p>
<h3>Read a particular file</h3>
<p>By writing the command followed by the flag <code>-f</code> and, instead
of the string, by the path of a text file, you will get as output a voice
reading the content of that file.</p>
{% highlight ruby linenos %}
Device-name:Current-position username$ say -f path/text.txt
{% endhighlight %}
<h3>Specify the reading voice</h3>
<p>By writing the flag <code>-v</code> followed by a person name and a string, you
can decide which voice should read the string.</p>
{% highlight ruby linenos %}
Current-position username$ say -v name string
{% endhighlight %}
<p><b>Notice.</b> Of course, you're not expected to know every possible voice,
so, by writing "?" as argument of the command (including also the flag -v),
you will get a list of all the available voices.</p>
{% highlight ruby linenos %}
Current-position username$ say -v ?
{% endhighlight %}
<h3>Specify the Speech Rate</h3>
<p>By writing the flag <code>-r</code> followed by a rate and then by a
string, you can decide the reading speed in words per minute.</p>
{% highlight ruby linenos %}
Current-position username$ say -r rate string
{% endhighlight %}
<h3>Store the output in an audible file</h3>
<p>You can save the result of the command in an audible file. To do that,
you have just to write after the command the flag <code>-o</code> followed
by the path/name of the output file and then the string that has to be read.</p>
{% highlight ruby linenos %}
Current-position username$ say -o path/audiofile.*format string
{% endhighlight %}
<h3>Exercise - Flags combinations</h3>
<p>As said above, you can use more flags in the same command, once you know
well them. See the examples below and try to guess the output. You can
copy these commands into your terminal to verify your answers.</p>
{% highlight ruby linenos %}
Current-position username$ say -v Alex -f hello_world.txt
{% endhighlight %}
{% highlight ruby linenos %}
Current-position username$ say -o hi.aac -f hello_world.txt
{% endhighlight %}