Vocola files:

Vocola VCL and VCH files are usually located in the Documents\Natlink\Vocola folder. The main file for the Quadstick Manager Program is QuadStick.vcl. Whenever the QMP is the front-most window, this file controls how Vocola maps spoken phrases to Quadstick commands. It “includes” two VCH files: _qs_common.vch and _includes.vch. _qs_common.vch contains the voice commands that are considered common to all games. _includes.vch is automatically generated by the QMP to include any game specific vch files in the user’s vocola folder.

When creating a

The format for a voice command file is fully documented on the Vocola website . The general form is:

some short phase = some text to substitute or command to run;

The text phrases can be condensed by creating lists of related words that are searched when matching a phase containing a reference to the list:

<buttons> = Command( $1 ",1,100,200" );

The items within the Command parentheses follow this format for activating output buttons:

output_name,state, value, duration

where:

output_name is from the outputs list.

state is 0=off, 1=on, -1=toggle state.

value is an integer percent 0-100.

duration is in milliseconds or -1 for permanent.

Example, press D-Pad North button with half force for 200 milliseconds:

Vocola file: <buttons> <pct> = Command( $1 ",1," $2 ",200" );

Command seen by Quadstick: dpad_n,1,50,200

Example, press and hold Circle button continuously (until new command or reset):

Vocola file: <buttons> on = Command( $1 ",1,100,-1" );

Command seen by Quadstick: circle,1,100,-1

Action Buttons
Square	<nothing>		Pushes button with 100% force for 200 ms
Circle	%		Pushes button with % force for 200 ms
Triangle	% for ## seconds		Pushes button with % force for ## seconds
Xray	For ## seconds		Pushes button with 100% force for ## seconds
Home	On		Holds button down with 100% force
Select	Off		Releases button
Start	Toggle		Releases or Holds button
Left One
Left Two
Left Three
Right One
Right Two
Right Three

D-Pad
North			D-Pad Up
North East			D-Pad Up and Right
East			D-Pad Right
South East			D-Pad Down and Right
South			D-Pad Down
South West			D-Pad Down and Left
West			D-Pad Left
North West			D-Pad Up and Left


Analog Sticks
Player	Up	<%>	Holds stick in specified direction by <%>
Look	Down	<%>	(default = 100%)
	Left	<%>
	Right	<%>


Lip Sensor Control
Swap	Square		Switches Lip input with named output
And	Circle		Adds named output to Lip input
	Triangle
	Xray
	Home
	Select
	Start
	Clear		Clears out Swap funtion


Quadstick Control
Reset			All outputs cleared
Quit
Stop

Mode ##			Switch directly to mode ##
Full Screen			Toggles Full Screen display
Help			Display help text message
Reboot Quad Stick			Restarts the Quadstick

Load	Call of Duty		Loads cod.csv file
	Default		Loads config.csv file

Plus direct commands for controlling the operation of the Quadstick:

Command	Description
mode,#	Change selected profile mode to new value
reset	Clear all output states and values to zero
boot	Reboot Quadstick
help	Print a Help messong
load,filename.csv	Load new configuration profile
echo	Turn on local echo (for debugging)
swap,output_name	Exchange inputs for Lip Sensor with another output
and,output_name	Add a second output to the Lip Sensor
print	Print out the active profile
debug	Print out internal values

Preference settings can be changed via command. The general command format is:

preference_name, new value

Examples:

Vocola file: set volume <pct> = Command( "volume," $1);

When “set volume 25” is spoken, the command seen by the Quadstick is:

volume,25

Vocola file: set brightness <pct> = Command( "brightness," $1);

When “set brightness 50” is spoken, the command seen by the Quadstick is:

brightness,50