| Both sides previous revision Previous revision Next revision | Previous revision |
| drawingchecklist [2022/06/11 00:16] – label text <size:N> and <size:N%> brucemutton | drawingchecklist [2025/04/21 06:59] (current) – [points] reference multiplesections page brucemutton |
|---|
| |
| **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.]] |
| |
| #<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:N> or <size:N%> within a string. The label retains the property set by -scale, regardless of any <size:*> parameter that it may contain. | ## -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. | ## 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 xs ## station names, air draught dates, less important information | # -scale xs ## station names, air draught dates, less important information |
| |
| # -scale <number> ## relative to -scale m (1.0 ≡ medium symbol size). Applicable for all point and line symbols v5.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 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 | # <size:N> ## size of the text in points, where 1 =< N =< 127 |
| ## Both these <size:*> settings are problematic, as they don't automatically relate back to the font point size settings defined for xl, l, m, s and xs. [Add to wishlist] | |
| |
| # -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 | 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> | </code> |
| |
| |
| **Passage Size, Features, Fills and Speleothems** \\ | **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]]. \\ |
| |
| |
| |
| **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 \\ |
| \\ | \\ |