| Both sides previous revision Previous revision Next revision | Previous revision |
| drawingchecklist [2020/08/24 07:08] – Note about SBE symbols brucemutton | drawingchecklist [2024/05/20 06:25] (current) – line label opaque bounding box brucemutton |
|---|
| 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; | 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) | (Note that irrespective of visibility settings, any point and any line point can be joined manually) |
| ## apply the following to wall 'line point' options as required | ## 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 bedrock # default thick solid line |
| subtype clay # < 0.06mm ie silt & clay to a geologist | subtype clay # < 0.06mm ie silt & clay to a geologist |
| subtype # pit -height [10 m] ##usually refers to pit from surface, not underground pit or shaft | 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 unsurveyed |
| subtype presumed | subtype presumed |
| |
| **Labels** \\ | **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.]] | 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.]] |
| |
| <code> -text "LabelText" | <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 | # <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" | # "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" |
| #<rtl> </rtl> ## beginning and end of right-to-left text" | #<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 xl ## main passage names |
| # -scale l ## Significant features in main passages | # -scale l ## Significant features in main passages |
| # -scale xs ## station names, air draught dates, less important information | # -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 | # -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 | relative to the scrap as viewed in Xtherion, NOT to the finished output |
| (So it pays to scan your sketches or rotate your 'paperless' images to match the | (So it pays to scan your sketches or rotate your 'paperless' images to match the |
| intended finished output orientation). | intended finished output rotation). |
| </code> | </code> |
| |
| ''__point traverse__'' \\ | ''__point traverse__'' \\ |
| ''__point via-ferrata__'' \\ | ''__point via-ferrata__'' \\ |
| ''__point walkway__'' \\ | ''__point walkway__'' [SBE]\\ |
| ''__point wheelchair__'' [SBE]\\ | ''__point wheelchair__'' [SBE]\\ |
| ''__point no-wheelchair__'' [SBE]\\ | ''__point no-wheelchair__'' [SBE]\\ |
| |
| **Labels** \\ | **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.\\ | 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). \\ | 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 arrow -context point label -scale xs #visibility of this arrow will be controlled as though it were a point label of scale xs | 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 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 \\ |
| \\ | \\ |
| **Passages** \\ | **Passages** \\ |
| ''__[[drawingchecklist#wall|line wall]]__'' \\ | ''__[[drawingchecklist#wall|line wall]]__'' \\ |
| ''__line abyss-entrance__'' \\ | ''__line abyss-entrance__'' [SBE]\\ |
| ''__line dripline__'' \\ | ''__line dripline__'' [SBE]\\ |
| ''__line floor-step__'' \\ | ''__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 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 overhang__'' \\ | ''__line overhang__'' \\ |
| |
| ''__line fault__'' \\ | ''__line fault__'' [SBE]\\ |
| ''__line joint__'' \\ | ''__line joint__'' [SBE]\\ |
| |
| **Passage Fills** \\ | **Passage Fills** \\ |
| |
| ''__line border__ # border:invisible border:visible border:temporary border:presumed'' \\ | ''__line border__ # border:invisible border:visible border:temporary border:presumed'' \\ |
| ''__line rimstone-dam__'' \\ | ''__line rimstone-dam__'' [SBE]\\ |
| ''__line rimstone-pool__'' \\ | ''__line rimstone-pool__'' [SBE]\\ |
| ''__line moon-milk__'' \\ | ''__line moon-milk__'' \\ |
| ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\ | ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\ |
| ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\ | ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\ |
| ''__line flowstone__'' ## tick on down slope side\\ | ''__line flowstone__'' ## tick on down slope side\\ |
| ''__line low-ceiling__'' \\ | ''__line low-ceiling__'' [SBE]\\ |
| ''__line pit-chimney__'' \\ | ''__line pit-chimney__'' [SBE]\\ |
| \\ | \\ |
| **Man made, Equipment** \\ | **Man made, Equipment** \\ |
| |
| ''__line via-ferrata__'' \\ | ''__line via-ferrata__'' \\ |
| ''__line walkway__'' \\ | ''__line walkway__'' [SBE]\\ |
| ===== areas ===== | ===== areas ===== |
| **Workflow to create a new area with XTherion;** \\ | **Workflow to create a new area with XTherion;** \\ |
| ''__area blocks__'' # more than ~2m?\\ | ''__area blocks__'' # more than ~2m?\\ |
| \\ | \\ |
| ''__area mudcrack__'' \\ | ''__area mudcrack__'' [SBE]\\ |
| ''__area flowstone__'' \\ | ''__area flowstone__'' \\ |
| ''__area moonmilk__'' \\ | ''__area moonmilk__'' \\ |
| \\ | \\ |
| ''__area pillar__'' \\ | ''__area pillar__'' [SBE]\\ |
| ''__area pillar-with-curtains__'' \\ | ''__area pillar-with-curtains__'' [SBE]\\ |
| ''__area stalactite__'' \\ | ''__area stalactite__'' [SBE]\\ |
| ''__area stalactite-stalagmite__'' \\ | ''__area stalactite-stalagmite__'' [SBE]\\ |
| ''__area stalagmite__'' \\ | ''__area stalagmite__'' [SBE]\\ |
| \\ | \\ |
| ''__area ice__'' \\ | ''__area ice__'' \\ |