Template:OSM Location map/ArcText/doc

From Wikipedia, the free encyclopedia

Text on an arc[edit]

ArcText is a facility to place text on an arc within {{OSM Location map}}:

How to use arc-text, with starter-examples for different arc-patterns.
Below are some 'starter values' for different patters, but having selected your basic version, trial and correction will still be needed 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. Paste the settings that are nearest to your needs into the template code, and adjust as required.

Three sets of ArcText parameters are available, demoted A, B and C

Shallow smile:
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = -170
|       arc-gapA = -1.2
|    arc-radiusA = 1.6
Deeper smile:
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
D
e
e
p
e
r
S
m
i
l
e
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = -150
|       arc-gapA = -3.5
|    arc-radiusA = 0.4
wide eyebrow:
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
E
y
e
b
r
o
w
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = -20
|       arc-gapA = 3
|    arc-radiusA = 0.8
opening bracket (reading up):
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
o
p
e
n
i
n
g
b
r
a
c
k
e
t
(
u
p
)
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = -110
|       arc-gapA = 1.5
|    arc-radiusA = 0.6
opening bracket (reading down):
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
o
p
e
n
i
n
g
b
r
a
c
k
e
t
(
d
o
w
n
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = -60
|       arc-gapA = -2
|    arc-radiusA = 0.5
closing bracket (reading up):
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
c
l
o
s
i
n
g
b
r
a
c
k
e
t
(
u
p
)
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = 120
|       arc-gapA = -1.5
|    arc-radiusA = 0.8
closing bracket (reading down):
Map
About OpenStreetMaps
Maps: terms of use
200m
220yds
none
c
l
o
s
i
n
g
b
r
a
c
k
e
t
(
d
o
w
n
.
|     arc-coordA = {{coord| | }}
|      arc-textA =  
| arc-text-sizeA = <!-- default is 12 -->
|arc-text-colorA = <!-- default is dark grey-->
|     arc-angleA = 60
|       arc-gapA = 2.5
|    arc-radiusA = 0.4
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 -->
This template now works independently of the zoom and latitude values being used. Unlike the original version of this template, which had some variation in an arc at different latitudes and at different zoom levels. The program will produce the same arc, gap size etc, regardless of location and zoom level. Changes in radius continues to have an effect on the gap size, with a larger radius opening out the gap somewhat, due to the way the arc and spacing are calculated.

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.