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. +
+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. +
+
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: +
+
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.
+
+
+