Drawing tools command line

The drawing tool command line is displayed near the bottom of the window when an image is being edited (it was first added in RealWorld Paint 2011.1. The command line displays a textual representation of the currently performed drawing command. The command line can be turned on and off via the Command line toolbar button or from the View menu.

Using the Line tool with the command line visible.

On the picture above, the small text area near the bottom of the window displays a textual representation of the current drawing tool state:

DrawTool.LINE(Document, 15, "JROUND", 47.5, 222.5, 47.5, 100.5, 127.5, 27.5, 207.5, 100.5, 207.5, 222.5, "CLOSE");

While working with a drawing tool (moving or adding points to a poly-line in my case), the text is continuously updated. The opposite is true as well. If the text in the text box is updated, the change is immediately shown on the canvas.

Drawing command format

Command line can display the draw command in 2 modes: Simple and Script. The mode is switchable in the layout configuration. The Script mode is the default one and while it has some seeming unimportant extras, it can be directly used in the JavaScript operation. The Simple version of the previous command would look like this:

LINE 15, "JROUND", 47.5, 222.5, 47.5, 100.5, 127.5, 27.5, 207.5, 100.5, 207.5, 222.5, "CLOSE"

Instead of number, simple expression (+, -, *, /, pi) may be used in the command line.

To find out what each number in the command line means, check out the descriptions of the individual drawing tools.

In the example command line mentioned above:

DrawTool.LINE(Document, 15, "JROUND", 47.5, 222.5, 47.5, 100.5, 127.5, 27.5, 207.5, 100.5, 207.5, 222.5, "CLOSE");

DrawTool and Document are part of the JavaScript syntactic junk and can be safely ignored.
LINE is the name of the line tool - all tool names use upper case letters.
15 is the line width.
"JROUND" means use round joins.
The numbers are pairs of x and y coordinates of the polyline points.
"CLOSE" directs the tool to connect the last point with the first one.

Not every tool is usable from script. For example pencil, brush or lasso need too many coordinates and it would not be practical to control them from the command line.

Recent comments

Anonymous

Signed comments carry more weight! Don't be a stranger - log-in or register. It only takes few seconds.