.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "SENDPRAAT" "1" "April 22, 2013" "" "User Commands"
.hy
.SH NAME
.PP
sendpraat - doing phonetics by computer
.SH SYNOPSIS
.PP
\f[B]sendpraat\f[R] [\f[I]timeOut\f[R]] \f[I]program\f[R]
{\f[I]message\f[R] \&...}
.SH DESCRIPTION
.PP
This manual page documents the sendpraat command.
It was written for the Debian distribution because the original program
does not have a manual page.
.PP
\f[B]sendpraat\f[R] is a program for sendings messages to a running
program that uses the Praat shell, like \f[B]praat\f[R](1).
.SH ARGUMENTS
.TP
\f[I]timeOut\f[R]
the number of seconds that sendpraat will wait for an answer before
writing an error message.
A \f[I]timeOut\f[R] of 0 means that the message will be sent
asynchronously, i.e., that sendpraat will return immediately without
issuing any error message.
.TP
\f[I]program\f[R]
the name of a running program that uses the Praat shell.
.TP
\f[I]message\f[R] \&...
a sequence of Praat shell lines (commands and directives).
Each line is a separate argument.
Lines that contain spaces should be put inside double quotes.
.SH EXAMPLES
.IP
.nf
\f[C]
sendpraat 0 praat Quit
\f[R]
.fi
.PP
Causes the program \f[B]praat\f[R] to quit (gracefully).
This works because \[lq]Quit\[rq] is a fixed command in Praat\[cq]s
Control menu.
Sendpraat will return immediately.
.IP
.nf
\f[C]
sendpraat 1000 praat \[dq]Play reverse\[dq]
\f[R]
.fi
.PP
Causes the program \f[B]praat\f[R], which can play sounds, to play the
selected Sound objects backwards.
This works because \[lq]Play reverse\[rq] is an action command that
becomes available in Praat\[cq]s dynamic menu when Sounds are selected.
Sendpraat will allow \[lq]praat\[rq] at most 1000 seconds to perform
this.
.IP
.nf
\f[C]
sendpraat praat \[dq]execute \[ti]/MyResearch/MyProject/MyScript.praat\[dq]
\f[R]
.fi
.PP
Causes the program \[lq]praat\[rq] to execute a script.
Sendpraat will allow \f[B]praat\f[R] at most 10 seconds (the default
time out).
.IP
.nf
\f[C]
sendpraat als \[dq]for i from 1 to 5\[dq] \[dq]Draw circle... 0.5 0.5 0.1*i\[dq] \[dq]endfor\[dq]
\f[R]
.fi
.PP
Causes the program als to draw five concentric circles into its Picture
window.
.SH SEE ALSO
.PP
\f[B]praat\f[R] has an on-line documentation; just launch
\f[B]praat\f[R] and look at the Help menu entry.
.PP
For further information, see the Praat website (http://www.praat.org).
A good Beginner\[cq]s Guide, written by Sidney Wood, is available at
https://person2.sol.lu.se/SidneyWood/praate/frames.html
.SH AUTHOR
.PP
This manual page was written by Rafael Laboissi\[`e]re
<rafael@laboissiere.net> for the Debian system (but may be used by
others).
It was based on the information provided by the help message of the
\f[B]sendpraat\f[R] program itself.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 3 any later
version published by the Free Software Foundation.
.PP
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL-3.