Lines using various cap and join modes.
The Closed option only affects a poly-line that has at least 3 vertices. In that case, the last vertex is connected to the first one.
The Cap mode of the Line tool controls how to decorate the ends of a line. You may select either nothing, a rounded cap or a square cap. Square cap means that the line reaches behind the end point (by an amount equal to width of the line divided by 2).
The Join mode controls how to draw the interior vertices of a poly-line. They may either be rounded, beveled, or sharp (miter joins). This setting only affects poly-lines, not simple straight lines.
The Width option controls the width of the line in pixels. This value must be greater than 0 and it does not need to be a whole number. For example, width of 2.8 pixels is allowed.
The Dashing pattern is a sequence of "-" (minus) and " " (space) characters and controls how to dash the line. "-" indicates a line segment equal to line width, while " " means nothing will be drawn. Note that the ends of dash segments are decorated according to the selected Cap mode. Choosing Square caps will effectively cover a single gap in the dashing. You may want to use a different Cap mode or place two or more consecutive spaces in the dash pattern.
With the Line tool selected (in the toolbar above the canvas), click on the canvas and keep holding the left mouse button. Then move the mouse and release the button. This will create a straight line.
After you release the button, control handles will appear. Line has two kinds of control handles:
Initially, there will be 2 vertex control handles at the end of the line and 1 segment control handle in the middle of the line. You can drag the control handles with your mouse. Dragging the vertex handle will move the vertex. Dragging the segment handle will split the segment into two parts and a new vertex will be added to the line (making it a poly-line).
The whole poly-line can be moved with the arrow keys or by dragging it.
If you are working in a vector layer, you may also scale and rotate the poly-line by holding down the SHIFT key while dragging the line.
Any fill style can be used with a Line tool and in some cases, additional control handles of the fill style will be shown. Currently, outlines are not supported for Lines.
LINE tool can be used from scripts. The command in script must have the following arguments:
DrawTool.LINE(Document, 5, "- -", "JROUND", "CROUND", 10, 10, 90, 10, 10, 90);