Differences

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

--- drawingchecklist [2019/11/14 09:55] – [station] each scrap needs two stations brucemutton
+++ drawingchecklist [2025/04/21 06:59] (current) – [points] reference multiplesections page brucemutton
@@ Line 29: / Line 29: @@
   * Keep scraps small and simple.  Break them at changes of elevation (say more than 5% of expected cave depth).  This allows better representation of colour by elevation maps as each scrap can only have one colour.
   * Assuming you have two monitors keep the previous output open on one while editing in the Xtherion drawing editor on the other.
+  * Use points lines and areas that have consistent looking symbol options available.  The Brazilian Speleological Society [SBE] symbols have a unique look, and so I have identified entities below that only have SBE symbols available.  You may wish to either favour or avoid these.
   * See also the [[faq#surveys_and_drawings|faq page]]
@@ Line 130: / Line 131: @@
 To clarify this last point it's worth noting that there are two different ways of making a wall line invisible, which are treated differently by the automatic scrap join algorithm;
-  line wall -subtype invisible # The wall line is not displayed, and will be ignored by the scrap join algorithm. Typical use is to 'close' an open end of a scrap if it is wider than it is long, or to define the shape of the open end of a scrap, say, at an entrance.
+  line wall -subtype invisible # The entire wall line is not displayed, and will be ignored by the scrap join algorithm. The wall shape is plotted with preview below, but not with preview above. Typical use is to 'close' an open end of a scrap if it is wider than it is long, or to define the shape of the open end of a scrap, say, at an entrance.
-  line wall -visibility off # The wall line is not displayed, but can be used by the automatic scrap join algorithm when it chooses which points to join. ie A normal wall in all respects, just invisible. Can be used to define the shape of the open end of a scrap, say, at an entrance or if a wall is made from really huge blocks you want to draw their shapes.
+  line wall -visibility off # The entire wall line is not displayed, but can be used by the automatic scrap join algorithm when it chooses which points to join.  The wall shape is plotted with both preview below and preview above. ie A normal wall in all respects, just invisible. Can be used to define the shape of the open end of a scrap, say, at an entrance or if a wall is made from really huge blocks you want to draw their shapes.
 (Note that irrespective of visibility settings, any point and any line point can be joined manually)
@@ Line 150: / Line 151: @@
 ## apply the following to wall 'line point' options as required
-  altitude .   ## include the dot, adds the altitude of the nearest survey station to the wall
+  altitude .   ## include the dot, adds a label showing the altitude of the nearest survey station to the wall
   subtype bedrock # default thick solid line
   subtype clay # < 0.06mm ie silt & clay to a geologist
@@ Line 162: / Line 163: @@
   subtype # pit -height [10 m]  ##usually refers to pit from surface, not underground pit or shaft
-  subtype invisible
+  subtype invisible  # preview above outlines are not displayed for wall segments that have subtype invisible set.  Preview below outlines are displayed.
   subtype unsurveyed
   subtype presumed
@@ Line 180: / Line 181: @@
 **Labels** \\
-''__point label__ -text "xx" #-scale m -align l'' ## Recommended for general usage. Point label always gives you text of the size you specify, at default character spacing.  Suggest you do not use ''-orientation'', results in slight angle variations due to morphing.  See also [[drawingchecklist#lines|Line label]]\\
+''__point label__ -text "xx" #-scale m -align l'' ## Recommended for general usage. \\
+<code>
+# Point label always gives you text of the size you specify, at default character spacing.
+# The label text has an opaque bounding box that obscures most objects beneath it.  If this is frustrating, then line label might be a better option.
+# Suggest you do not use -orientation as it results in slight label rotation variations due to morphing.
+</code>
+See also [[drawingchecklist#lines|Line label]]  \\
+\\
 Placeholder TO DO: Make an entry about boxed labels, and how to use them.  Based on [[https://www.mail-archive.com/therion@speleo.sk/msg07230.html|this forum conversation]] and [[https://www.mail-archive.com/therion@speleo.sk/msg07234.html|this one.]]
@@ Line 204: / Line 212: @@
 <code> -text "LabelText"
-# "<br><left><right><centre>" ## formats multi-line text justification, <left> is the default.  <br> = newline
+# "<br><left><right><centre>" ## formats multi-line text justification within a label, <left> is the default.  <br> = newline
 # <thsp> ## thin space
-# <rm> ## roman font
+# <rm> ## change to roman font from this point on ...
-# <it> ## roman italic font
+# <it> ## ... roman italic font ...
-# <bf> ## roman bold font
+# <bf> ## ... roman bold font ...
-# <ss> ## sans serif font [default for point label]
+# <ss> ## ... sans serif font ... [default for point label]
-# <si> ## sans serif italic font[default for point remark]
+# <si> ## ... sans serif italic font ... [default for point remark]
 # "Type here undefined language text, or text to appear if specified language text does not match one of the following<lang:en>Type here the English language translation<lang:mi>Type here Te Reo Maori translation"
@@ Line 218: / Line 226: @@
 #<rtl>   </rtl> ## beginning and end of right-to-left text"
+## -scale sets the size of the entire label string, unless it is modified by <size:S>, <size:N> or <size:N%> within a string.  The label retains the property set by -scale, regardless of any <size:*> parameter that it may contain. ie if you invoke min-symbol-scale, the entire label will be shown or hidden based on the -scale property, irrespective of any <size:*> controls within the -text string.
+## In general the size in points of labels should be set, preferably, by using the fonts-setup layout statement if you want to override Therion's default settings.
 # -scale xl ## main passage names
 # -scale l ## Significant features in main passages
@@ Line 224: / Line 234: @@
 # -scale xs ## station names, air draught dates, less important information
-# -scale <number> ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1
+# -scale <number> ## relative to -scale m (0.5 ≡ xs, 1.0 ≡ m, 2.0 ≡ xl symbol size, ). Applicable for all point and line symbols v5.4.1
+# <size:S>  ## size of text using predefined scales xs, s, m, l or xl.  Applicable v6.1.1
+# <size:N%> ## size of text relative to the -scale parameter for this label, where 1 =< N =< 999.  Therion rounds N% to nearest 10% before it is applied to the label.
+# <size:N>  ## size of the text in points, where 1 =< N =< 127
 # -align r  # l c tl tr bl br ## right, left, centre of insertion point, etc
-relative to the scrap as viewed in Xtherion, NOT to the finished output
+Alignment offsets are relative to the orientation of each point as viewed in Xtherion, NOT to the finished output (such that -align t offsets in the direction of the orientation arrow).
-(So it pays to scan your sketches or rotate your 'paperless' images to match the
+Since orientation for most points is generally zero, it pays to scan your sketches or rotate your 'paperless' images to match the intended finished output rotation)
-intended finished output orientation).
 </code>
 ''__point map-connection__'' ## place one of these on a scrap that you may decide to offset.  It causes Therion to generate a dashed line between the main map and the offset map. My convention is that I only place a point map-connection in locations where a person can travel from a passage that is not offset, to the passage that is offset.  This maximises the maps usefulness for navigation purposes.
+''__point danger__'' \\
 **Passage Size, Features, Fills and Speleothems** \\
-''__point section__ -scrap <prefix>-<Survey>Plan-x1 -align top-right'' ## Use to insert a cross-section scrap, drawn with ''-projection none'', into your plan, extended or elevation scraps.  The ''-align'' parameter is particularly important to position the section well when you may want to output at differing scales.  See [[drawingchecklist#scrap|scrap]] above and [[drawingchecklist#lines|line section]] below.  \\
+''__point section__ -scrap <prefix>-<Survey>Plan-x1 -align top-right'' ## Use to insert a cross-section scrap, drawn with ''-projection none'', into your plan, extended or elevation scraps.  The ''-align'' parameter is particularly important to position the section well when you may want to output at differing scales.  See [[drawingchecklist#scrap|scrap]] above and [[drawingchecklist#lines|line section]] below.  See also [[multiplesections|Making multiple cross sections at once]]. \\
@@ Line 288: / Line 303: @@
 ''__point water__'' \\
 ''__point water-flow__ # water-flow:intermittent water-flow:paleo'' ## paleo = scallop flow direction\\
+''__point water-drip__'' [SBE]\\
+''__point bat__'' [SBE]\\
 ''__point bedrock__''  # shows bedding or joint direction (point orientation is perpendicular to bedding/joint orientation) \\
 ''__point clay__'' \\
+''__point mud__'' [SBE]\\
+''__point mudcrack__'' [SBE]\\
 ''__point sand__'' \\
 ''__point pebbles__'' \\
@@ Line 306: / Line 325: @@
 ''__point clay-tree__'' \\
 ''__point curtain__'' \\
+''__point curtains__'' \\
 ''__point crystal__'' \\
 ''__point disk__'' \\
+''__point disk-pillar__'' \\
+''__point disk-pillars__'' \\
+''__point disk-stalactite__'' \\
+''__point disk-stalactites__'' \\
+''__point disk-stalagmite__'' \\
+''__point disk-stalagmites__'' \\
 ''__point flowstone__'' \\
 ''__point flute__'' \\
@@ Line 313: / Line 339: @@
 ''__point gypsum-flower__'' \\
 ''__point helictite__'' \\
+''__point helictites__'' \\
 ''__point moon-milk__'' \\
+''__point pendant__'' [SBE]\\
 ''__point popcorn__'' \\
 ''__point raft__'' \\
@@ Line 334: / Line 362: @@
 ''__point stalagmite__'' \\
 ''__point stalagmites__'' \\
+''__point stalactite-stalagmite__'' \\
+''__point stalactites-stalagmites__'' \\
 ''__point pillar__'' \\
 ''__point pillars__'' \\
+''__point pillar-with-curtains__'' \\
+''__point pillars-with-curtains__'' \\
+''__point volcano__'' [SBE]\\
-''__point paleo-material__'' \\
+''__point bones__'' [SBE]\\
+''__point human-bones__'' [SBE]\\
+''__point paleo-material__'' # bones etc\\
 ''__point root__'' \\
+''__point tree-trunk__'' [SBE]\\
 ''__point vegetable-debris__'' \\
+''__point seed-germination__'' [SBE]\\
 **Passage Ends** \\
@@ Line 389: / Line 428: @@
 **Man made, Equipment**\\
+''__point alter__'' [SBE]\\
 ''__point anchor__'' \\
+''__point archeo-excavation__'' [SBE]\\
 ''__point archeo-material__'' \\
+''__point audio__'' [SBE]\\
 ''__point bridge__'' \\
 ''__point camp__'' \\
+''__point electric-light__'' [SBE]\\
+''__point ex-voto__'' [SBE]\\
 ''__point fixed-ladder__'' \\
+''__point gate__'' [SBE]\\
+''__point handrail__'' \\
+''__point masonry__'' [SBE]\\
+''__point nameplate__'' [SBE]\\
 ''__point no-equipment__'' \\
+''__point photo__'' [SBE]\\
 ''__point rope-ladder__'' \\
 ''__point rope__'' \\
 ''__point steps__'' \\
 ''__point traverse__'' \\
+''__point via-ferrata__'' \\
+''__point walkway__'' [SBE]\\
+''__point wheelchair__'' [SBE]\\
+''__point no-wheelchair__'' [SBE]\\
 ===== lines =====
 **Workflow to create a new line with XTherion;** Ctrl+L, THEN type or select the line type, then draw the line, adding any subtypes point by point as you go. \\
@@ Line 407: / Line 460: @@
 **Labels** \\
-''__line arrow__ # -head both -head none -head begin'' \\
+''__line arrow__ # -head end (default) -head both -head none -head begin'' \\
 Often arrows are associated with a label (or remark or date) and it is of benefit if the visibility of such arrows is controlled by the same statements that control the visibility of the label.\\
 If you assign the context of the label to the arrow, you can achieve this using ''symbol-hide point label'' (or ''point remark'' or ''point date'' or ''line label'' or ''group text'', as appropriate). \\
@@ Line 414: / Line 467: @@
   line arrow -context point label -scale xs #visibility of this arrow will be controlled as though it were a point label of scale xs
-''__line label__ -text "Label Text" # -scale s'' ## Line label gives you text fitted to the curve and length of the line.  If the line is longer than is necessary for the specified size (text height), then the characters are spaced out to fit the line.  If the line is too short, the text size is reduced so that the text will fit.  see also [[drawingchecklist#points|Point Label]] \\
+''__line label__ -text "Label Text" # -scale s'' ## Line label gives you text fitted to the curve and length of the line.
+<code>
+# If the line is longer than is necessary for the specified scale (text height), then the characters are spaced out to fit the line.
+# If the line is too short, the text scale is reduced so that the text will fit.
+# Unlike point label, each character has its own opaque bounding box, so line label does not obscure so much of any objects that render beneath it.
+</code>
+see also [[drawingchecklist#points|Point Label]] \\
 ''__line pit__'' (or ''line wall:pit'') ''-height [+10 m]''  ## -ve and ? values not allowed, as they are for ''point height''.  At present, only AUT symbolset responds to height, by filling in triangles where height > 20m \\
 \\
@@ Line 423: / Line 482: @@
 **Passages** \\
 ''__[[drawingchecklist#wall|line wall]]__''  \\
+''__line abyss-entrance__'' [SBE]\\
+''__line dripline__'' [SBE]\\
 ''__line floor-step__'' \\
 ''__line pit__ # -height [10 m] '' ## pit or shaft within the cave, not from surface.  At present, only AUT symbolset responds to height, by filling in triangles where height > 20m\\
 ''__line floor-meander__'' \\
+''__line gradient__'' \\
 ''__line slope__'' # must specify l-size for at least one line point, and optionally orientation at one or more line points, ''-border on'' ## to get a line at the top edge\\
 ''__line contour__ # -gradient <none|center>'' ## to specify no tick marks, at centre only,eg
@@ Line 455: / Line 517: @@
 ''__line ceiling-meander__'' \\
 ''__line overhang__'' \\
-\\
+''__line fault__'' [SBE]\\
+''__line joint__'' [SBE]\\
 **Passage Fills** \\
 ''__line border__ # border:invisible  border:visible border:temporary border:presumed'' \\
-''__line moon-milk__''\\
+''__line rimstone-dam__'' [SBE]\\
+''__line rimstone-pool__'' [SBE]\\
+''__line moon-milk__'' \\
 ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\
 ''__line rock-edge__'' ## internal edge of large boulder \\
 ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\
 ''__line flowstone__''  ## tick on down slope side\\
+''__line low-ceiling__'' [SBE]\\
+''__line pit-chimney__'' [SBE]\\
 \\
 **Man made, Equipment** \\
+''__line handrail__'' \\
+''__line rope__'' \\
 ''__line steps__ -attr c 4'' ## v5.3.11 A bit different to most lines. Draw a rectangle (or other polygon) matching the outline shape of the stairs and add the option ''-attr c'' and then write the number of stair treads.
 This line type detects whether it is drawn in elevation or in plan, and plots appropriately.
@@ Line 475: / Line 547: @@
   line xxxx -scale <number> ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1 <need to verify syntax>
+''__line via-ferrata__'' \\
+''__line walkway__'' [SBE]\\
 ===== areas =====
 **Workflow to create a new area with XTherion;** \\
@@ Line 500: / Line 574: @@
 ''__area debris__''  # < ~2m? \\
 ''__area blocks__''  # more than ~2m?\\
+\\
+''__area mudcrack__'' [SBE]\\
 ''__area flowstone__'' \\
 ''__area moonmilk__'' \\
+\\
+''__area pillar__'' [SBE]\\
+''__area pillar-with-curtains__'' [SBE]\\
+''__area stalactite__'' [SBE]\\
+''__area stalactite-stalagmite__'' [SBE]\\
+''__area stalagmite__'' [SBE]\\
+\\
 ''__area ice__'' \\
 ''__area snow__''