Template:OSM Location map/ArcText/doc

Text on an arc

mudé

This sub-template is used by {{OSM Location map}} to provide a facility to place text that follows an arc across the map. In conjection with other labels, markers and map features, this allows text for larger geographic features to convey a sense of a broader area, or to follow the curve of a river, mountain range, coastline, etc. This works entirely separately from the other labels in the template. It does not attach itself to any mark or dot, and does not create any fullscreen markers. It requires coordinates for the location of the first letter, and additional parameters for the starting angle, radius of arc and gap between letters. Text size and color can also be specified, or inherited from Default settings.

Blank starter-code for text on an arcs, with starter-examples for different arc-patterns.
| arc-coordA={{coord|xxx|yyyy}}   <!-- coordinates of first letter -->
|  arc-textA=  <!-- Add your text here -->
| arc-angleA=  <!-- in degrees, -180 to 180. 0 will start as horizontal, -90 straight up, 90 straight down  -->
|   arc-gapA=  <!-- 1= a notional 'standard'. 0.2 is very tight, 10 is very wide--> 
|              <!-- negative gap will invert the letters and run the other way around the circle -->
| arc-radiusA= <!-- 1= a notional 'standard' 0.5 is quite a tight circle, 8 is so wide as to be almost flat -->
| arc-text-sizeA = <!-- standard font sizes. If undefined, default is 12 -->
| arc-text-colorA= <!-- sets text color. #000000 color hexes and standardised OSM Location map colors are accepted -->
| ellipse-factorA=1.0 <!-- 1= notionally circular, 0.5 to 1.0 will flattern top and bottom, above 1.0 flattens the sides -->
Details about using artc-text, with starter-examples for different arc-patterns.
The nature of the earth's coordinate system means that there will be some variation in an arc at different latitudes and at different zoom levels. The program makes corrections for this, but there will still be residual variation. Similarly, changes in radius will also have some effect on the gap size, with a larger radius opening out the gap somewhat. There will therefore need to be considerable trial and correction to get the shape and effect desired. As a general rule, identify the coordinates of the required start-point, then choose a starter-pattern from the selection below, and then adjust parameters to fit the requirement of the map.
Shallow smile:
arc-angleA=-170
arc-gapA=-1.2
arc-radiusA=1.6
Deeper smile:
arc-angleA=-150
arc-gapA=-3
arc-radiusA=0.7
wide eyebrow:
arc-angleA=-20
arc-gapA=3
arc-radiusA=0.8
opening bracket (reading up):
arc-angleA=-110
arc-gapA=1.5
arc-radiusA=0.6
opening bracket (reading down):
arc-angleA=-60
arc-gapA=-2
arc-radiusA=0.5
closing bracket (reading up):
arc-angleA=120
arc-gapA=-1.5
arc-radiusA=0.8
closing bracket (reading down):
arc-angleA=60
arc-gapA=2.5
arc-radiusA=0.4