| Both sides previous revision Previous revision Next revision | Previous revision |
| drawingchecklist [2020/08/24 06:47] – finish routine update with new points, lines and areas brucemutton | drawingchecklist [2024/05/20 06:25] (current) – line label opaque bounding box brucemutton |
|---|
| * 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. | * 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. | * 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]] | * See also the [[faq#surveys_and_drawings|faq page]] |
| |
| 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 water__'' \\ | ''__point water__'' \\ |
| ''__point water-flow__ # water-flow:intermittent water-flow:paleo'' ## paleo = scallop flow direction\\ | ''__point water-flow__ # water-flow:intermittent water-flow:paleo'' ## paleo = scallop flow direction\\ |
| ''__point water-drip__'' \\ | ''__point water-drip__'' [SBE]\\ |
| |
| ''__point bat__'' | ''__point bat__'' [SBE]\\ |
| ''__point bedrock__'' # shows bedding or joint direction (point orientation is perpendicular to bedding/joint orientation) \\ | ''__point bedrock__'' # shows bedding or joint direction (point orientation is perpendicular to bedding/joint orientation) \\ |
| ''__point clay__'' \\ | ''__point clay__'' \\ |
| ''__point mud__'' \\ | ''__point mud__'' [SBE]\\ |
| ''__point mudcrack__'' \\ | ''__point mudcrack__'' [SBE]\\ |
| ''__point sand__'' \\ | ''__point sand__'' \\ |
| ''__point pebbles__'' \\ | ''__point pebbles__'' \\ |
| ''__point helictites__'' \\ | ''__point helictites__'' \\ |
| ''__point moon-milk__'' \\ | ''__point moon-milk__'' \\ |
| ''__point pendant__'' \\ | ''__point pendant__'' [SBE]\\ |
| ''__point popcorn__'' \\ | ''__point popcorn__'' \\ |
| ''__point raft__'' \\ | ''__point raft__'' \\ |
| ''__point pillars-with-curtains__'' \\ | ''__point pillars-with-curtains__'' \\ |
| |
| ''__point volcano__'' \\ | ''__point volcano__'' [SBE]\\ |
| |
| ''__point bones__'' \\ | ''__point bones__'' [SBE]\\ |
| ''__point human-bones__'' \\ | ''__point human-bones__'' [SBE]\\ |
| ''__point paleo-material__'' # bones etc\\ | ''__point paleo-material__'' # bones etc\\ |
| |
| ''__point root__'' \\ | ''__point root__'' \\ |
| ''__point tree-trunk__'' \\ | ''__point tree-trunk__'' [SBE]\\ |
| ''__point vegetable-debris__'' \\ | ''__point vegetable-debris__'' \\ |
| ''__point seed-germination__'' \\ | ''__point seed-germination__'' [SBE]\\ |
| |
| **Passage Ends** \\ | **Passage Ends** \\ |
| |
| **Man made, Equipment**\\ | **Man made, Equipment**\\ |
| ''__point alter__'' \\ | ''__point alter__'' [SBE]\\ |
| ''__point anchor__'' \\ | ''__point anchor__'' \\ |
| ''__point archeo-excavation__'' \\ | ''__point archeo-excavation__'' [SBE]\\ |
| ''__point archeo-material__'' \\ | ''__point archeo-material__'' \\ |
| ''__point audio__'' \\ | ''__point audio__'' [SBE]\\ |
| ''__point bridge__'' \\ | ''__point bridge__'' \\ |
| ''__point camp__'' \\ | ''__point camp__'' \\ |
| ''__point electric-light__'' \\ | ''__point electric-light__'' [SBE]\\ |
| ''__point ex-voto__'' \\ | ''__point ex-voto__'' [SBE]\\ |
| ''__point fixed-ladder__'' \\ | ''__point fixed-ladder__'' \\ |
| ''__point gate__'' \\ | ''__point gate__'' [SBE]\\ |
| ''__point handrail__'' \\ | ''__point handrail__'' \\ |
| ''__point masonry__'' \\ | ''__point masonry__'' [SBE]\\ |
| ''__point nameplate__'' \\ | ''__point nameplate__'' [SBE]\\ |
| ''__point no-equipment__'' \\ | ''__point no-equipment__'' \\ |
| ''__point photo__'' \\ | ''__point photo__'' [SBE]\\ |
| ''__point rope-ladder__'' \\ | ''__point rope-ladder__'' \\ |
| ''__point rope__'' \\ | ''__point rope__'' \\ |
| ''__point traverse__'' \\ | ''__point traverse__'' \\ |
| ''__point via-ferrata__'' \\ | ''__point via-ferrata__'' \\ |
| ''__point walkway__'' \\ | ''__point walkway__'' [SBE]\\ |
| ''__point wheelchair__'' \\ | ''__point wheelchair__'' [SBE]\\ |
| ''__point no-wheelchair__'' \\ | ''__point no-wheelchair__'' [SBE]\\ |
| ===== lines ===== | ===== 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. \\ | **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. \\ |
| |
| **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__'' \\ |