with South).
For `part', each FR (`formal result') and AR (`actual result')
- specifies that the loc FR inside O is exported into the global
+ specifies that the loc FR inside O is exported into the calling
namespace as a new loc AR. Either FR or AR may start with `-'.
- Also, each loc L inside O is exported into the global namespace as a
+ Also, each loc L inside O is exported into the calling namespace as a
new loc N_L (unless N_L already exists). If A is not specified then
N_F is used.
For `obj[flip]' if prefix P (syntax is that of an identifier) is
- specified, each other loc L inside O is exported into the global
+ specified, each other loc L inside O is exported into the calling
namespace as a new loc PL (unless PL already exists). P may be `='
to indicate an empty prefix (default is not to export locs).
-e<layersel>[ARSCcLlMNOm]...
Turn on and off drawing of elements in groups.
These are abbreviations for various -E... options.
- track -E....
- A full track ARScg
- R rails only aRscg
- S rails and sleepers only aRScg
- C centrelines only arsCg
- c swept area and ticks only Arscg
- r no lines drawn at all arcs
+ track -E.....
+ A full track ARScgd
+ R rails only aRscgD
+ S rails and sleepers only aRScgd
+ C centrelines only arsCgd
+ c swept area and ticks only Arscgd
+ r no lines drawn at all arsc
labels at locs
L label top-level locs (turns on bars for them too) LMg
l do not label any locs l
+ label distances
+ D label all distances D
+ d do not label any locs d
bars at locs (thick lines perp to track dir'n)
M bars for top-level locs only Mnog
N bars for top-level locs and those in obj's MNog
S draw track sleepers
C draw track centrelines
L label locs
+ D label distances along the track
M mark locs with a bar
N mark locs with a bar in objs
O mark locs with a bar in parts
G draw subsegment encoding
- -GL output segment colour map request list
- use with -eG or -EG to write out the list of subsegment
- specs which will need colours, one per line (and not
- necessarily only once each)
-
-q quiet: do not print info to stderr
(default: prints bounding box, at the moment)
+[-GL output segment colour map request list ]
+[ use with -eG or -EG to write out the list of subsegment ]
+[ specs which will need colours, one per line (and not ]
+[ necessarily only once each) ]
+ -GL, -GR, -GP are to do with segment encoding and subsegment specs
+ and that kind of thing. The comment above is the most useful
+ documentation and is out of date. See also layout's argument
+ parser, segencolayers.gen-make, Makefile, segcmap.h, segcmapassign,
+ etc.
+
<layersel> (for -e and -E) works as follows:
When file says `layer KL', default drawing element set is set
%L bbox no locs, no bbox
there were no locs, so there is no bounding box
usu because input file was just obj defns and showlibrary
+ %L segmentpart I KL [-]S D X0 Y0 A0 X1 Y1 A1
+ records that a piece of subsegment S is drawn in the subsegment
+ encoding. The piece is of length D, in layer KL (which may be
+ the empty string, depending on layer configurations), and runs
+ from the loc X0,Y0,A0 to X1,Y1,A1. I is a counter which starts
+ at 0 and is simply there to help cross-reference between
+ various programs and formats.
Scope S is
O! when defining object or part O
N:T scope T but inside part (introduced with `part') N } when
O::T scope T but inside obj (introduced with `obj[flip]') O } placing
+
+
+See also:
+ layout-data.h for info regarding layout data deliverables for use by
+ control and UI software
+ redactgraph.c, extractgraph for info regarding extraction and
+ preparation of those deliverables