examples

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
examples [2019/06/30 22:42] – [Colour Scales - Lookups] expand description brucemuttonexamples [2023/12/03 07:41] (current) – Document select map -colour behaviour brucemutton
Line 432: Line 432:
  
 **lookup altitude examples** **lookup altitude examples**
 +
 +The default automatic altitude colour bands take their highest and lowest values from the highest and lowest survey stations for the parts of the survey that are used in the rendering. It takes all the survey stations within the "cave" (ie. not in a "flags surface" section), from whichever surveys and subsurveys are going to be used in the rendering (if you are using a map, it will be whichever surveys and subsurveys have some of their parts included in that map), and finds the highest and lowest station. This happens even if the highest and lowest stations within those surveys are not even rendered because they are not included in a scrap.
 +
 +The legend will then be divided up into 7 numbers; the highest station, the lowest station, and 5 equally spaced values in between. These values are then rounded to the nearest integer when rendering (this rounding will also happen when displaying legend lookup values). This makes it quite possible that no scrap will ever be the colour of the highest and lowest stations, since scraps normally have more than one station in them, and the scrap altitude and colour will be taken from the average of those. The colour, as with lookup colours, will be faded the appropriate distance between the nearest colour values on either side.
 +
 +This also means that for a cave with very little vertical range, the default legend may show "10, 10, 11, 11, 11, 12, 12", when in actual fact, the numbers are all part way between 10 and 12.
 +
 +Using a lookup table allows you to take much more control, giving neater colour intervals (like one colour every 10 metres), or allowing the highest and lowest scraps to actually be the top and bottom colours.
  
   lookup altitude -title "Altitude legend"   lookup altitude -title "Altitude legend"
Line 442: Line 450:
   endlookup   endlookup
  
-It should generate red -> blue scale with desired values. +It should generate red -> blue scale with desired values. Note that this is a linear fade with red at one end, blue at the other, and purple in the middle; it does **not** rotate the hue via orange, yellow or green in the middle.
  
 You may specify multiple lookup tables for same criterion using an index, ie  ":" separator in label You may specify multiple lookup tables for same criterion using an index, ie  ":" separator in label
Line 471: Line 479:
   endlookup   endlookup
 This will produce a single colour for passage between 1500 and 1600 m and between 1800 and 1900 m, and leave all other passage, above, in between, and below, uncoloured. This will produce a single colour for passage between 1500 and 1600 m and between 1800 and 1900 m, and leave all other passage, above, in between, and below, uncoloured.
 +
 +The default altitude rainbow is not made with a continuous range of colour hues. Instead, it is made with 7 discrete colours, with altitudes between them fading between the discrete colours. This means that you can use a lookup table to exactly replicate this colour behaviour, using the following colour values which match the default ones used by Therion (shown here within the range of altitudes from 4 to 96 metres):
 +
 +  lookup altitude:manualrainbow
 +    96 [100 25 25]
 +    81 [100 87.25 25]
 +    65 [49.75 100 25]
 +    50 [25 100 61.75]
 +    35 [25 74.5 100]
 +    20 [37 25 100]
 +    4 [99.25 25 100]
 +  endlookup
  
 **lookup date examples** **lookup date examples**
Line 492: Line 512:
 Same should work with scraps.  Same should work with scraps. 
  
-With maps you may specify colour of a particular map when selecting it your thconfig, without the need for a lookup+**Specifying individual map colours at compile time** 
 + 
 +With maps you may specify colour of a particular map when selecting it in your thconfig, overriding or without the need for any layout or lookup statements 
 + 
 +  select map1 -colour [100 0 0] 
 +   
 +The Therion Book 6.1.7 suggests that map command-like options include colour, however this seems to be incorrect.  The -colour option seems to be select parameter (not a map parameter) and can be described like this... 
 + 
 +**‘select’** 
 + 
 +Description: selects objects (surveys and maps) for export… 
 + 
 +Options: 
 +… 
 + 
 +• colo[u]r <colour>  set the map colour when selecting a map; this option overrides the specified colour palette ONLY when the layout specifies colour map-fg [map], [scrap] or [<colour>].  It has no effect when the layout specifies colour map-fg [altitude].  It has no effect when the layout specifies colour map-fg [topo-date] or [explo-date], for the scraps whose associated surveys have dates assigned. 
 + 
 +In summary: 
 + 
 +Select map -colour overrides layout or lookup colour map-fg statements when… 
 + 
 +  * colour map-fg [r g b] 
 +  * colour map-fg scrap 
 +  * colour map-fg map 
 + 
 +Select map -colour does not override layout or lookup colour map-fg statements when…
  
-  select map1 -color [100 0 0]  # This does not work for me.  Bruce +  * colour map-fg altitude 
-Make sure you don't have any 'colour map-fg' statements howeveras if present they will override [I THINK]+  * colour map-fg topo-date, unless the map has no date 
 +  colour map-fg explo-dateunless the map has no date
  
  
  • examples.1561927357.txt.gz
  • Last modified: 5 years ago
  • by brucemutton