Index: doc/user/06_feature/ddraft/index.html =================================================================== --- doc/user/06_feature/ddraft/index.html (revision 18845) +++ doc/user/06_feature/ddraft/index.html (revision 18846) @@ -81,5 +81,104 @@ they cross a cutting edge. A split means a single line object becomes multiple line objects or a single arc object becomes multiple arc objects. +

Command line drafting

+

+The above features are pcb-rnd actions designed to fit in the action framework, +to work together with the original pcb-rnd drawing tools, like the line tool. +An alternative to that is using the new, ddraft command line interpreter, which +offers a different syntax, optimized for drafting. +

+There are two ways to use the ddraft command line interpreter: +

+

+When used as a CLI mode, mouse clicks on the drawing will also edit the +command line at the cursor. The generic rule is that a click will replace +an already entered numerical value or inserts a missin numerical value, but +all instruction keywords are typed on the keyboard. Instructions can +be abbreviated; the shortest form accepted is the shortest prefix that +is unique among the instruction keywords. For example "li" means "line" +and "rel" or even "re" works for "relative". +

+The first instruction is the drawing command, which is one of the following. +

+ +
ddraft drawing commands +
command syntax summary purpose +
line + line [from] coord to coord + draw line segments on the current layer, using the current routing style +
+

+Parts enclosed in [] are optional. A coord description is a sequence +of absolute and relative coordinates: +

+ +
ddraft drawing commands +
keyword next instruction (argument) example purpose +
absolute + xcoord,ycoord + abs 1mm,15mm + an absolute coordinate; units are optional; must not contain space +
* + *1mm,15mm +
  + 1mm,15mm + +
relative + xcoord,ycoord + rel 1mm,15mm + a relative coordinate meaasured from the absolute coord specified so far; units are optional; must not contain space +
@ + @1mm,15mm + +
angle + degree + ang 15 + an absolute angle in degrees; always measured from the X axis; should be used together with length +
< + <15 + +
relative angle + degree + rel ang 15 + a relative angle in degrees; always measured from the X axis; should be used together with length +
@< + @<15 + + + +
length + coord + len 3.1mm + length or distance to move from the previos coordinate; always relative; used together with an angle +
~ + ~3.1mm + +
+

+For example the sequence +5mm,100mil relative 1mm,1mm relative angle 30 length 2mm +means: +

+Equivalent alternative forms for the same sequence: +
+5mm,100mil rel 1mm,1mm rel ang 30 len 2mm
+5mm,100mil @1mm,1mm @<30~2mm
+5,100mil @1,1 @<30~2
+
+The last one assumes unit is set to mm. + + +