Work in progress diagram drawing talon commands currently compatible with Vectr and Inkscape. Because of issues with trying to operate Vectr through voice commands, the project will no longer support working with it long term. Undocumented commands might undergo serious change.
Proper documentation is in progress.
Note that this command set is very large and can take a while to load on some computers when you first open a supported drawing application and when you first open the "are you sure" menu on each talon session. Attempts will be made to reduce the command set size without meaningfully reducing functionality. The current command set size may prevent these commands from working with dragon.
For some functionality to work, you must use commands to specify the upper left and bottom right corners of the canvas you will be drawing on. You specify the upper left corner by moving the mouse to it and saying "update canvas origin". You specify the bottom right corner by moving the mouse to it and saying "update canvas ending".
The canvas is remembered on a per application basis, so you do not have to respecify it every time you switch between supported drawing applications.
The canvas specifying commands can be found in canvas.talon.
Position specifiers are ways to specify positions to commands. Some commands will number positions. Those positions can be specified by number. Locations on the alpha grid (see below) are specified with the phonetic alphabet words corresponding to the letters in vertical, horizontal order. Positions on the current graph are specified by how many tick marks to move along each axis each separated by the word by (for example: minus five by ten means five tick marks to the left and ten tick marks up on a standard two dimensional graph). The number of tick marks can be specified with a decimal number that can be positive or negative, but the numbers on both sides of the decimal point can only be between 0 and 99 in magnitude.
Saying "move" followed by a position specifier moves the cursor to the specified position.
Direction specifiers are used by some commands to specify directions: up, down, left, right, peft (up and left), pight (up and right), neft (down and left), or night (down and right).
The alpha grid denotes positions on the canvas by dividing it into a 26 by 26 grid.
Saying "alpha grid show" shows the grid.
Saying "alpha grid hide" hides the grid.
Saying "alpha grid toggle lines" changes whether or not the lines corresponding to the alpha grid positions should be displayed.
The word grid is optional in these commands.
Some commands will automatically number positions so that they can be referred to by number.
Saying "numbering show" shows the numbering. Note that only numbers within the canvas as specified with the above canvas commands will be shown.
Saying "numbering hide" hides the numbering.
Saying "numbering clear" opens up an are you sure dialog. Saying "yes I am sure" will clear the current numbering. Saying "no" closes the dialogue without clearing the numbering.
Saying "number this", "number here", or "number that" manually numbers the current mouse position.
The numbering is stored in a file and should be preserved across sessions.
Saying "line (direction specifier) (an integer between 1 and 99)" will draw a line from the cursor's current position to a position in the direction specified by the specified integer amount. Saying "line up five" draws a line up from the cursor by five units.
Saying "line (an integer between 1 and 99) (one of the direction specifiers that denotes 2 directions) (an integer between 1 and 99)" will draw a line from the cursor's current position to a position in the direction specified. The first integer determines how much the cursor is moved in the first direction, and the second integer determines how much the cursor is moved in the second direction.
Saying "dash line (direction specifier) (an integer between 1 and 99)" will draw a dashed line from the cursor's current position to a position in the direction specified by the specified integer amount. The word line is optional.
Saying "dash line (an integer between 1 and 99) (one of the direction specifiers that denotes 2 directions) (an integer between 1 and 99)" will draw a dashed line from the cursor's current position to a position in the direction specified. The first integer determines how much the cursor is moved in the first direction, and the second integer determines how much the cursor is moved in the second direction. The word line is optional.
Saying "(position specifier) stripe (position specifier)" will draw a line between the position specifiers.
Saying "(position specifier) stripe (position specifier) with (number)" will draw a line between the specified positions labeled in the middle with the number.
Saying "(position specifier) vector (position specifier)" will draw an arrow from the first specified position to the second.
Saying "(position specifier) vector (position specifier) with (number)" will draw an arrow from the first specified position to the second labeled in the middle with the number.
Saying "(position specifier) dash stripe (position specifier)" will draw a dashed line in between the specified positions.
Saying "cross out (position specifier)" draws an x at the specified position. The word out is optional.
Saying "arrowhead new (an integer number specifying the angle in which the arrowhead should point in degrees)" will draw an arrowhead pointing in the specified direction. The word new is optional.
Saying "lines (an integer between 1 and 99) by (an integer between 1 and 99)" will draw a rectangle around the cursor with the width specified by the first integer and the height specified by the second integer.
Saying "(dub or double) lines (an integer between 1 and 99) by (an integer between 1 and 99)" will draw a double line rectangle around the cursor with width specified by the first integer and height specified by the second integer.
Saying "lines (an integer between 1 and 99) by (an integer between 1 and 99) by (an integer between 1 and 99)" will draw 2 vertically stacked rectangles with the width determined by the first integer, the height of the top rectangle determined by the second integer, and the height of the bottom rectangle determined by the third integer.
Saying "lines (an integer between 1 and 99) by (an integer between 1 and 99) by (an integer between 1 and 99)" does the same thing as the previous command but with the the outer rectangle drawn with double lines.
Saying "(position specifier) lines (position specifier)" draws a rectangle between the specified positions.
Saying "(position specifier) (par or parallel) lines (position specifier) gap (an integer between 1 and 99)" draws parallel lines centered at the imaginary line between the position specifiers with the amount of gap between the lines determined by the integer. The word lines is optional.
Saying "diamond (an integer between 1 and 99) by (an integer between 1 and 99)" draws a diamond with the width determined by the first integer and the height determined by the second integer.
Saying "(dub or double) diamond (an integer between 1 and 99) by (an integer between 1 and 99)" draws a double line diamond with the width determined by the first integer and the height determined by the second integer.
Saying "text" creates a text field at the cursor's location.
Saying "char (phonetic alphabet word for a letter)" creates a text field at the cursor with the specified letter in upper case.
Saying "label (position specifier)" creates a text field at the specified position.
Saying "change (position specifier)" edits the text field at the specified location and selects all its text.
Saying "fresh (position specifier)" edits the text field at the specified location and moves the text cursor to the end of the text field's first line.
Saying "(position specifier) (value or val) (number)" creates a text field with the specified number as its text at the specified position.
Saying "done" or "finish" unselects.
You have to change the default configuration for these commands to work with Inkscape. Set the stroke to black by shift clicking the color black from the fill color options (you should see the fill color options on the bottom of the screen). Draw a circle using the command "draw point". Click the circle so that it is selected. Set the fill color to none by clicking the white square with an x in the middle to the left of the fill option colors. Now open the preferences page. You open the preferences page by going to edit and then preferences. If you want to do that by keyboard, you can press alt e to open the edit options, press end to get to preferences, and press enter to select preferences. Go to tools and then pencil. Choose "this tool's own style" and then "Take from selection". Now close preferences and set the fill to black (you should see the fill color options on the bottom of the screen). You should now be finished updating the Inkscape settings.
If you want to use commands that draw a shape with the pencil tool and fill it in, put the cursor over the fill color option for black and say "update fill". You will need to do this again if you move the Inkscape window or change it in a manner that changes the position of the fill black button if you want those kinds of commands to still work. This is not required for the draw point command to work.
Thank you to whatIV for contributing the original alpha grid code and the function for drawing dashed curves.