summaryrefslogtreecommitdiff
path: root/graphics/circuit_macros/doc/defines.tex
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/circuit_macros/doc/defines.tex')
-rw-r--r--graphics/circuit_macros/doc/defines.tex95
1 files changed, 71 insertions, 24 deletions
diff --git a/graphics/circuit_macros/doc/defines.tex b/graphics/circuit_macros/doc/defines.tex
index 6b8f615fe2..8e21bba0ec 100644
--- a/graphics/circuit_macros/doc/defines.tex
+++ b/graphics/circuit_macros/doc/defines.tex
@@ -287,9 +287,9 @@
C,P: {\tt dimen\_}$/4$, E,K: {\tt dimen\_}$/5$)
arg5 = wid (defaults F: {\sl height}*0.3,
C,P: {\sl height}*0.4, E,K: {\sl height}) \seesect{Twoterminal:}}
-\macrodef{cbreaker}{cbreaker}{(\linespec,L|R,D|T|TS)}
+\macrodef{cbreaker}{cbreaker}{(\linespec,L|R,D|Th|TS)}
{cct}
- {circuit breaker to left or right, {\tt D}=with dots; {\tt T}=thermal;
+ {circuit breaker to left or right, {\tt D}=with dots; {\tt Th}=thermal;
{\tt TS}=squared thermal\seesect{Twoterminal:}}
\macrodef{ccoax}{ccoax}{(at {\sl location}, M|F, {\sl diameter})}
{cct}
@@ -318,9 +318,26 @@
{\tt R}=reversed polarity\seesect{Twoterminal:}}
\macrodef{contact}{contact}{({\sl chars})}
{cct}
- {single-pole contact: {\tt P}= three position, {\tt O}= normally open,
- {\tt C}= normally closed, {\tt I}= circle contacts, {\tt R}= right
- orientation
+ {single-pole contact:
+ {\tt O}= normally open,
+ {\tt C}= normally closed (default),
+ {\tt I}= open circle contacts,
+ {\tt P}= three position,
+ {\tt R}= right orientation,
+ {\tt T}= T contacts,
+ {\tt U}= U contacts
+ \seesect{Composite:}}
+\macrodef{contacts}{contacts}{({\sl count, chars})}
+ {cct}
+ {multiple ganged single-pole contacts:
+ {\tt P}= three position,
+ {\tt O}= normally open,
+ {\tt C}= normally closed,
+ {\tt D}= dashed ganging line over contact armatures
+ {\tt I}= open circle contacts,
+ {\tt R}= right orientation,
+ {\tt T}= T contacts,
+ {\tt U}= U contact lines parallel to drawing direction
\seesect{Composite:}}
\macrodef{contline}{contline}{({\sl line})}
{gen}
@@ -526,7 +543,7 @@ B|CR|D|G|L|LE[R]|P[R]|S|Sh|T|V|v|w|Z|chars,%
label},{\sl label},{\sl chars})}
{cct}
{general triple label; {\sl chars:}
- X displacement is from the centre of the last
+ $x$ (drawing direction) displacement is from the centre of the last
line rather than the centre of the last {\tt [ ]};
L,R,A,B align labels ljust, rjust, above,
or below (absolute) respectively \seesect{Labels:}}
@@ -591,29 +608,30 @@ B|CR|D|G|L|LE[R]|P[R]|S|Sh|T|V|v|w|Z|chars,%
{cct}
{SPST switch left or right, W=baseline, B=contact blade,
dB=contact blade to the right of drawing direction,
- K=vertical closing contact line,
+ Bm = mirror contact blade,
+ Bo = contact blade more widely open,
+ Cb = circuit-breaker function,
+ Co = contactor function,
C = external operating mechanism,
D = circle at contact and hinge,
(dD = hinge only, uD = contact only)
E = emergency button,
- EL = early close
- (or late open),
+ EL = early close (or late open),
LE = late close (or early open),
F = fused,
H = time delay closing,
uH = time delay opening,
- HH = time delay
- opening and closing,
- K = vertical closing contact,
+ HH = time delay opening and closing,
+ K=vertical closing contact line,
L = limit,
M = maintained (latched),
MM = momentary contact on make,
MR = momentary contact on release,
- MMR = momentary contact
- on make and release,
+ MMR = momentary contact on make and release,
O = hand operation button,
P = pushbutton,
- T = thermal control linkage,
+ Th = thermal control linkage,
+ Tr = tripping,
Y = pull switch,
Z = turn switch
\seesect{Twoterminal:}}
@@ -696,7 +714,8 @@ B|CR|D|G|L|LE[R]|P[R]|S|Sh|T|V|v|w|Z|chars,%
\macrodef{fitcurve}{fitcurve}{(V,n,[e.g. dotted],m (default 0))}
{gen}
{Draw a spline through positions V[m], $ldots$ V[n]: Works only with dpic.}
-\macrodef{FlipFlop}{FlipFlop}{(D|T|RS|JK,{\sl label},{\sl boxspec})}
+\macrodef{FlipFlop}{FlipFlop}{(D|T|RS|JK,{\sl label},{\sl boxspec},%
+ {\sl pinlength})}
{log}
{flip-flops,
{\sl boxspec}=e.g.\ ht x wid y \seesect{Logicgates:}}
@@ -715,10 +734,12 @@ B|CR|D|G|L|LE[R]|P[R]|S|Sh|T|V|v|w|Z|chars,%
in future}.
Similar to {\tt FlipFlop6}.}
\macrodef{FlipFlopX}{FlipFlopX}{({\sl boxspec, label, leftpins, toppins,
- rightpins, bottompins})}
+ rightpins, bottompins, pinlength})}
{log}
- {General flipflop. Each of args 3 to 6 is null or a string of {\sl pinspecs}
- separated by semicolons ({\tt;}). {\sl Pinspecs} are either empty
+ {General flipflop.
+ Arg 1 modifies the box (labelled Chip) default specification.
+ Each of args 3 to 6 is null or a string of {\sl pinspecs}
+ separated by semicolons ({\tt;}). A {\sl Pinspec} is either empty
or of the form
{\tt[}{\sl pinopts}{\tt]:[}{\sl label}{\tt[:}{\sl Picname}{\tt]]}.
The first colon draws the pin.
@@ -729,12 +750,13 @@ B|CR|D|G|L|LE[R]|P[R]|S|Sh|T|V|v|w|Z|chars,%
replaces the default name.
A {\sl pinspec} label is text placed at the pin base. Semicolons are
not allowed in labels; use, e.g., {\tt \char92{}char59\char123\char125}
- instead,
- and to put a bar over a label, use {\tt lg\_bartxt(}{\sl label}{\tt)}.
+ instead.
+ To put a bar over a label, use {\tt lg\_bartxt(}{\sl label}{\tt)}.
The {\sl pinopts} are {\tt[N|L|M][E]};
{\tt N}=pin with not circle;
{\tt L}=active low out; {\tt M}=active low in;
- {\tt E}=edge trigger \seesect{Logicgates:}}
+ {\tt E}=edge trigger \seesect{Logicgates:}. Optional arg 7 is the length
+ of pins}
\macrodef{for\_}{for_}{({\sl start},{\sl end},{\sl increment},`{\sl actions}')}
{gen}
{integer for loop with index variable {\tt m4x} \seesect{Looping:}}
@@ -1259,6 +1281,9 @@ nw,nn,ne,ns,pin lgth,style, other commands})}
\macrodef{pc\_\_}{pc__}{}
{gen}
{absolute points}
+\macrodef{pvcell}{pvcell}{({\sl linespec, width, height})}
+ {cct}
+ {PV cell}
\macrodef{px\_\_}{px__}{}
{gen}
{absolute SVG screen pixels}
@@ -1338,15 +1363,37 @@ nw,nn,ne,ns,pin lgth,style, other commands})}
{\tt R}=right orientation; {\tt C}=closed contact;
e.g., {\tt reed(,,dimen\_/5,shaded "lightgreen"}
\seesect{Composite:}}
+\macrodef{relay}{relay}{({\sl number of poles, chars})}
{cct}
{relay: n poles (default 1), {\sl chars:} {\tt O}=normally open,
{\tt C}=normally closed, {\tt P}=three position, default double throw,
{\tt L}=drawn left (default),
- {\tt R}=drawn right, {\tt T}=thermal.
+ {\tt R}=drawn right, {\tt Th}=thermal.
Argument 3={\tt [L|R]} is deprecated but works for
backward compatibility
\seesect{Composite:}}
-\macrodef{resetdir\_)}{resetdir_)}{}
+\macrodef{relaycoil}{relaycoil}{({\sl chars, wid, ht,} R|L|U|D|{\sl degrees})}
+ {cct}
+ {chars:
+ {\tt X}=or default: external lines from A2 and B2;
+ {\tt AX}=external lines at positions A1,A3;
+ {\tt BX}=external lines at positions B1,B3;
+ {\tt NX}=no lines at positions A1,A2,A3,B1,B2,B3;
+ {\tt SO}=slow operating;
+ {\tt SOR}=slow operating and release;
+ {\tt SR}=slow release;
+ {\tt HS}=hight speed;
+ {\tt HS}=hight speed;
+ {\tt NAC}=unaffected by AC current;
+ {\tt AC AC}=current;
+ {\tt ML}=mechanically latched;
+ {\tt PO}=polarized;
+ {\tt RM}=remanent;
+ {\tt RH}=remanent;
+ {\tt TH}=thermal;
+ {\tt EL}=electronic
+ \seesect{Composite:}}
+\macrodef{resetdir\_}{resetdir_)}{}
{gen}
{resets direction set by {\tt setdir\_}}
\macrodef{resetrgb}{resetrgb}{}