chiark / gitweb /
first cut of distance labels
[trains.git] / layout / informat.txt
index ee0126f0fa75e898ae2211642757e170c7f67505..29f5fe1925a19c422f51c2b34ad18cedabf609a7 100644 (file)
@@ -183,14 +183,14 @@ Commands
   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).
 
@@ -212,16 +212,19 @@ Command-line options
  -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
@@ -238,19 +241,25 @@ Command-line options
               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
@@ -289,8 +298,22 @@ Special comments in PostScript:
  %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