drawingchecklist

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
drawingchecklist [2022/05/15 02:56] – [points] add label text font size support description brucemuttondrawingchecklist [2024/05/20 06:25] (current) – line label opaque bounding box brucemutton
Line 181: Line 181:
  
 **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.]]
  
Line 212: Line 219:
 # <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]
- 
-# <size:N> ## size of the text in points, where 1 =< N =< 127 [[New feature coming with 6.1.0 May 2022 (yet to verify behaviour]] 
  
 # "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"
Line 221: Line 226:
 #<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> within a string. [[TO DO: Check this is correct]] +## -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. 
-## The size in points of labels should be set 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 l ## Significant features in main passages  # -scale l ## Significant features in main passages 
Line 229: Line 234:
 # -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 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>
  
Line 452: Line 461:
  
 **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 459: Line 468:
   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 \\
 \\ \\
  • drawingchecklist.1652576177.txt.gz
  • Last modified: 3 years ago
  • by brucemutton