|
$play_var [IIF] |
  
|
|
$play_var [IIF] |
|
Speak the Contents of a Variable
$play_var @varname playtype|filename [prefix [suffix]]
This command plays (speaks) the numeric (or other) contents of a CopiaFacts variable. When this command is used, either no $image_desc command must be given in the same .IIF file, or the default $image_desc keyword digits must be given.
The parameters on this command are used as follows:
| varname | the name of the variable of which the value is to be spoken, or a constant value (without @). |
| playtype | one of the following keywords: |
| digits | speak individual digits (e.g. "two-five") using the default digit playback file. |
| amount | speak the integer and two-digit decimal place value (if present) of a numeric value, usually as a monetary amount (e.g. "twenty-five-dollars and fifty cents"), using the default amount playback file. |
| filename | the name of the indexed multiple-segment voice file to be used to speak the amount. This file must be created with the FFAMOUNT program and its embedded speaking algorithm will be used. |
| prefix/suffix | some files produced by FFAMOUNT can have a table of different prefix and suffix phrases, allowing the same file to be used to describe different types of variable. If you are using this type of file you can use these fields to select the prefix and suffix numbers. If no entry is made, the default is 1 (the first prefix or suffix). To suppress the prefix or suffix, use a value of zero. |
Remember that you cannot use the variable resulting from a $get_var command in the same .IIF file that contains the $get_var command. To speak back an entered $get_var value, you can either use $validate "digits" which uses only the default digits file, or you can transfer to a $next_box which will speak the value of the variable with $play_var.
Example:
$play_var @ID digits 0
Topic url: http://www.copia.com/support/refmanual/index.html?%24play_var.htm