abortive segment movpos-specific mapping arrangements (actually unneeded because...

[trains.git] / layout / informat.txt

diff --git a/layout/informat.txt b/layout/informat.txt
index 9a4cab79dbd0c7190cc036a3454657fe1f660269..0b71b89deae826b9e78b41ed50348fe8e85c90d9 100644 (file)
--- a/layout/informat.txt
+++ b/layout/informat.txt
@@ -92,9 +92,12 @@ Commands
 
    S       D
    ----    ----
-   N       N'     remaps an entire segment including all features
-   N/M     M'     remaps a particular moveable feature; N is the
-                    unmapped name (if applicable)
+   N       N'         remaps an entire segment including all features
+   N/M     M'         remaps a particular moveable feature; N is the
+                        unmapped name (if applicable)
+   N/[MP]  N'/[M'P']  remaps a specific moveable feature position to a
+                        specific other moveable feature position;
+                       empty M and M' mean the fixed portions.
 
   The effect is that (sub)segments or features used in segment
   commands are translated when the segment command is read; the
@@ -194,6 +197,20 @@ Commands
   namespace as a new loc PL (unless PL already exists).  P may be `='
   to indicate an empty prefix (default is not to export locs).
 
+ segcmap S P...
+  Map segment S to colours using postscript commands P... (which
+  should be a postscript fragment to modify the graphics state,
+  typically `N setgray' or the like.  This is used for the drawing
+  element Q (see below).  S should be the bare segment (no movfeat or
+  `-').
+
+ segend L S
+  Notes that segment S (which should not specify a movfeat but may
+  specify `-') has an end at location L.  This is fed back from
+  extractgraph's run on a previous result of running layout, and used
+  to determine where to place the segment labels for E.  NOT YET
+  IMPLEMENTED
+
 Command-line options
 
  -D       turn on debug (level 1)  } currently only debug levels are
@@ -209,19 +226,22 @@ Command-line options
               in each direction.  xp is multiplied by 270mm; yp
               is multiplied by 190mm.
 
- -e<layersel>[ARSCcLlMNOm]...
+ -e<layersel>[ARSCcLlDdMNOm]...
           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 distances
             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
@@ -230,14 +250,17 @@ Command-line options
             subsegment encoding
               G  draw only subsegment encoding                 Garcslmno
 
- -E<layersel>[ARSCLMNOarsclmno]...
+ -E<layersel>[ARSCLDMNOarscldmno]...
           enable (capitals) or disable (lowercase) drawing of
           individual elements
               A  draw track swept area, with ticks
               R  draw track rails
+              Q  draw track segment fills according to segcmap
+             E  label track segments according to segend
               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