Command line options

Previous  Top  Next

ReadPlease PLUS 2003 -

Command line options are ONLY available in PLUS version

ReadPlease PLUS may be controlled from the command line. This type of control is used when you want to control ReadPlease from another program, or to automate how ReadPlease plays.

Note that you may need to specify the full path, so instead of this:

ReadPleasePlus2003.exe

you should use

"c:\Program Files\ReadPlease2003\ReadPleasePlus2003.exe"

and

"c:\Program Files\ReadPlease2003\ReadPleasePlus2003.exe" /file="c:\Test.txt"

(note the file is quoted as well and spaces are used as separators)

Notice the quotes which are required since a space is found in Program_Files, or in any folder or file name.

Command line operation of ReadPlease

ReadPlease recognizes command line arguments according to the following syntax:

ReadPleasePlus2003.exe /command1 /command2 /command3 ...

The slash character is used as a delimiter for a new command. Any number of commands can be entered, but only the last ones are effective if the same command is entered more than once. The parameter line is not case sensitive. Commands not in the list below have no effect.

State command

This command has the following syntax:

state=x

where x is an integer parameter having a value

of either 1 or 2;

This command is used to control the initial state of ReadPlease, with the following correspondence between parameter x and startup state:

1 => minimized

2 => screen centered.

If a state command is not present on the command line, RPP will get its initial state from its user configuration file.

Example:

ReadPleasePlus2003.exe /state=1 ( start minimized)

or specify entire path like this:

"c:\Program Files\ReadPlease Natural Voices\ReadPleaseNV.exe" /state=1

(note spaces are used as separators)

Tip

You can test out all of these commands by going to Start | Run,

and type the command line in there.

File command

This command has the following syntax:

ReadPleasePlus2003.exe /file=path to file

This command directs ReadPlease to load the file specified by the string inside of the quotes, and to start reading it. An error message will be shown if the file cannot be found.

Example:

ReadPleasePlus2003.exe /file="c:\Test.txt"

Text command

This command has the following syntax:

text="put your text to be spoken here"

This command directs ReadPlease to put the text argument in the Home Document and speak it.

Example:

ReadPleasePlus2003.exe /text="Hello, how do you feel today?"

(note spaces are used as separators)

Clip command

This command has the following syntax:

clip

This command directs ReadPlease to paste whatever is in the Clipboard to the document and start reading it. The content of the Clipboard is put at the place indicated by the auto Clipboard reading function, which is fetched from the user configuration file. For example, if the auto Clipboard is set to "Paste at end of document, and play", then the Clipboard content is pasted at the end of the document. On the other hand, if the auto Clipboard function is set to "Clear document, Paste and Play", the document will be cleared first. If the auto Clipboard is turned OFF, the Clipboard content will be inserted at the start of the document and played.

Example:

ReadPleasePlus2003.exe /clip /state=3

(note spaces are used as separators)

Action command

This command has the following syntax:

action=x

where x is a string parameter being equal to either "minimize" or "close". Any other value of x will have no effect.

This command tells ReadPlease what to do after having read what the command line specifies. If parameter x is set to "minimize", ReadPlease will minimize itself after having read whatever it has been told to. If x is set to "close", ReadPlease will close. This command has no effect if the command line does not specify something to read, which is the case if no /file or /clip command is present.

Example:

ReadPleasePlus2003.exe /clip /action=close

(note spaces are used as separators)