2716
ediciones
Cambios
m
1 revisión importada
<!-- Explicit new line here -->
{{Documentation subpage}}
== Usage ==
=== Purpose ===
The purpose of this template is to allow accurate placement of an image and/or text label over another source image, irrespective of scaling of the source image. It is based on the {{tl|Image label}} template. However, a drawback with that template is that the placement gets slightly inaccurate if you scale the source image (because of the way calculations are done), and thus you might have to manually recalculate the placement.
This template also has similarities with the {{tl|Overlay}} template. That template however sadly doesn't allow for scaling. It is also limited to 30 labels, although for most purposes that is probably more than enough.
This template is however much more bloated than either of those templates, and you might want to consider if you can use one of the templates that are simpler and easier to use.
=== Example usage ===
<div style="float:right; margin:0 0 0 1em;">
{{Image label begin | image=Beach Smile.jpg | width=250 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label end}}
</div>
This template assumes you first introduce a background image by calling {{tl|Image label begin}}. By doing so this also requires it to be ended with {{tl|Image label end}}. Example with two smilies [[Image:Face-grin.svg|15px]] placed as the “eyes” on this beach image.
<pre style="overflow:auto;">{{Image label begin | image=Beach Smile.jpg | width=250 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label end}}</pre>
For full list of available options/parameters see further below. In this example the following are used
* <code>width = 250</code> is the width of the scaled image. This should correspond to the width you supplied when using {{tl|Image label begin}}.
* <code>x_orig = 2749</code> is in this example the width of the original beach image, which can be found out through various methods. One way to find out is the way Wikipedia/Commons lists it below the image where it says “Full resolution” when you view the image information and its license.
* <code>x = 1079</code> is the x-coordinate on the full resolution image where the [[Image:Face-grin.svg|15px]] is to be placed. There are various methods to find out this, and depends on what tools you have available.
* <code>y = 1033</code> is the y-coordinate on the full resolution image where the [[Image:Face-grin.svg|15px]] is to be placed.
* <code>image = Face-grin.svg</code> is the image to be used as a marker, since the default marker image [[Image:Red pog.svg|9px]] is not used.
* <code>marker_size = 15</code> is the width of the marker image [[Image:Face-grin.svg|15px]].
<div style="float:right; margin:0 0 0 1em;">
{{Image label begin | image=Beach Smile.jpg | width=150 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label end}}
</div>
If scaling the beach image down (or up), the only changes that need to be done is changing every occurrence of the width parameter, and the placement of overlying marker images (and their corresponding text) should scale accordingly.
<pre style="overflow:auto;">{{Image label begin | image=Beach Smile.jpg | width=150 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label end}}</pre>
=== Minimal use skeleton ===
<pre>{{Image label marker
| x_marker_orig =
| y_marker_orig =
| x_scaled =
| x_orig =
| text =
}}</pre>
If you want to use a different marker/image than the default [[commons:Category:Map pointers, dotset 1|<code>Red pog.svg</code>]] [[Image:Red pog.svg|7px]], you can add it with
<pre> | image =
| marker_size =</pre>
=== Full skeleton ===
<pre>{{Image label marker
| x_marker_orig =
| y_marker_orig =
| x_scaled =
| y_scaled =
| x_orig =
| y_orig =
| text =
| image =
| marker_size =
| x_adjust =
| y_adjust =
| x_textadjust =
| y_textadjust =
| show_image =
| text_color =
| text_align =
| text_width =
| font_size =
| style =
}}</pre>
Please note that many of these parameters are used in calculations. Due to constraints the template will think a parameter that is given, but is actually empty or contains spaces, still has a value and thus will give an error during calculations. The error might look something like this: {{#expr: 0+ }}.
== Examples ==
=== «Riksforsamlingen på Eidsvoll 1814» painted by [[Oscar Wergeland]] ===
{{Image label begin | image=Eidsvoll riksraad 1814.jpeg | width=800 | float=left | title=Riksforsamlingen på Eidsvoll 1814}}
{{Image label marker |x=92 |y=988 |text=<span style="background:rgba(220,20,60,0.75);"> '''1''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=180 |y=1085 |text=<span style="background:rgba(220,20,60,0.75);"> '''2''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=305 |y=1110 |text=<span style="background:rgba(220,20,60,0.75);"> '''3''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=360 |y=1095 |text=<span style="background:rgba(220,20,60,0.75);"> '''4''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=440 |y=1100 |text=<span style="background:rgba(220,20,60,0.75);"> '''5''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=510 |y=1085 |text=<span style="background:rgba(220,20,60,0.75);"> '''6''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=585 |y=1090 |text=<span style="background:rgba(220,20,60,0.75);"> '''7''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=793 |y=1091 |text=<span style="background:rgba(220,20,60,0.75);"> '''8''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=841 |y=1083 |text=<span style="background:rgba(220,20,60,0.75);"> '''9''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=912 |y=1083 |text=<span style="background:rgba(220,20,60,0.75);"> '''10''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1071 |y=1088 |text=<span style="background:rgba(220,20,60,0.75);"> '''11''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1134 |y=1086 |text=<span style="background:rgba(220,20,60,0.75);"> '''12''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1235 |y=1081 |text=<span style="background:rgba(220,20,60,0.75);"> '''13''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1373 |y=1096 |text=<span style="background:rgba(220,20,60,0.75);"> '''14''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1559 |y=1089 |text=<span style="background:rgba(220,20,60,0.75);"> '''15''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=23 |y=1190 |text=<span style="background:rgba(220,20,60,0.75);"> '''16''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=70 |y=1197 |text=<span style="background:rgba(220,20,60,0.75);"> '''17''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=109 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''18''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=130 |y=1229 |text=<span style="background:rgba(220,20,60,0.75);"> '''19''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=152 |y=1197 |text=<span style="background:rgba(220,20,60,0.75);"> '''20''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=174 |y=1194 |text=<span style="background:rgba(220,20,60,0.75);"> '''21''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=205 |y=1193 |text=<span style="background:rgba(220,20,60,0.75);"> '''22''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=238 |y=1190 |text=<span style="background:rgba(220,20,60,0.75);"> '''23''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=296 |y=1250 |text=<span style="background:rgba(220,20,60,0.75);"> '''24''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=315 |y=1220 |text=<span style="background:rgba(220,20,60,0.75);"> '''25''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=330 |y=1237 |text=<span style="background:rgba(220,20,60,0.75);"> '''26''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=360 |y=1227 |text=<span style="background:rgba(220,20,60,0.75);"> '''27''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=368 |y=1250 |text=<span style="background:rgba(220,20,60,0.75);"> '''28''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=390 |y=1243 |text=<span style="background:rgba(220,20,60,0.75);"> '''29''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=430 |y=1267 |text=<span style="background:rgba(220,20,60,0.75);"> '''30''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=469 |y=1259 |text=<span style="background:rgba(220,20,60,0.75);"> '''31''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=466 |y=1281 |text=<span style="background:rgba(220,20,60,0.75);"> '''32''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=488 |y=1295 |text=<span style="background:rgba(220,20,60,0.75);"> '''33''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=545 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''34''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=552 |y=1283 |text=<span style="background:rgba(220,20,60,0.75);"> '''35''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=613 |y=1248 |text=<span style="background:rgba(220,20,60,0.75);"> '''36''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=714 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''37''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=766 |y=1248 |text=<span style="background:rgba(220,20,60,0.75);"> '''38''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=824 |y=1279 |text=<span style="background:rgba(220,20,60,0.75);"> '''39''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=935 |y=1339 |text=<span style="background:rgba(220,20,60,0.75);"> '''40''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=973 |y=1213 |text=<span style="background:rgba(220,20,60,0.75);"> '''41''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1109 |y=1326 |text=<span style="background:rgba(220,20,60,0.75);"> '''42''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1129 |y=1244 |text=<span style="background:rgba(220,20,60,0.75);"> '''43''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1313 |y=1246 |text=<span style="background:rgba(220,20,60,0.75);"> '''44''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1412 |y=1243 |text=<span style="background:rgba(220,20,60,0.75);"> '''45''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1457 |y=1285 |text=<span style="background:rgba(220,20,60,0.75);"> '''46''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1576 |y=1222 |text=<span style="background:rgba(220,20,60,0.75);"> '''47''' </span> |text-color=white |font-size=10px |x-textadjust=-1 |y-textadjust=-4 |image=Red Arrow Left.svg |marker-size=9 |x-adjust=4.5 |y-adjust=0 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1528 |y=1373 |text=<span style="background:rgba(220,20,60,0.75);"> '''48''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=155 |y=1425 |text=<span style="background:rgba(220,20,60,0.75);"> '''49''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=343 |y=1387 |text=<span style="background:rgba(220,20,60,0.75);"> '''50''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=395 |y=1405 |text=<span style="background:rgba(220,20,60,0.75);"> '''51''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=427 |y=1397 |text=<span style="background:rgba(220,20,60,0.75);"> '''52''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=498 |y=1403 |text=<span style="background:rgba(220,20,60,0.75);"> '''53''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=563 |y=1402 |text=<span style="background:rgba(220,20,60,0.75);"> '''54''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=612 |y=1421 |text=<span style="background:rgba(220,20,60,0.75);"> '''55''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=660 |y=1432 |text=<span style="background:rgba(220,20,60,0.75);"> '''56''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=783 |y=1521 |text=<span style="background:rgba(220,20,60,0.75);"> '''57''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1684 |y=898 |text=<span style="background:rgba(220,20,60,0.75);"> '''58''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1915 |y=1132 |text=<span style="background:rgba(220,20,60,0.75);"> '''59''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2040 |y=1124 |text=<span style="background:rgba(220,20,60,0.75);"> '''60''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2170 |y=1128 |text=<span style="background:rgba(220,20,60,0.75);"> '''61''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2319 |y=1174 |text=<span style="background:rgba(220,20,60,0.75);"> '''62''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2364 |y=936 |text=<span style="background:rgba(220,20,60,0.75);"> '''63''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2451 |y=1175 |text=<span style="background:rgba(220,20,60,0.75);"> '''64''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2470 |y=921 |text=<span style="background:rgba(220,20,60,0.75);"> '''65''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2524 |y=1137 |text=<span style="background:rgba(220,20,60,0.75);"> '''66''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2617 |y=1180 |text=<span style="background:rgba(220,20,60,0.75);"> '''67''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2718 |y=1117 |text=<span style="background:rgba(220,20,60,0.75);"> '''68''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2889 |y=1180 |text=<span style="background:rgba(220,20,60,0.75);"> '''69''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2968 |y=1113 |text=<span style="background:rgba(220,20,60,0.75);"> '''70''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3089 |y=1164 |text=<span style="background:rgba(220,20,60,0.75);"> '''71''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3184 |y=1081 |text=<span style="background:rgba(220,20,60,0.75);"> '''72''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3279 |y=837 |text=<span style="background:rgba(220,20,60,0.75);"> '''73''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3295 |y=1079 |text=<span style="background:rgba(220,20,60,0.75);"> '''74''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1896 |y=1342 |text=<span style="background:rgba(220,20,60,0.75);"> '''75''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1952 |y=1292 |text=<span style="background:rgba(220,20,60,0.75);"> '''76''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2018 |y=1327 |text=<span style="background:rgba(220,20,60,0.75);"> '''77''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2072 |y=1324 |text=<span style="background:rgba(220,20,60,0.75);"> '''78''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2173 |y=1299 |text=<span style="background:rgba(220,20,60,0.75);"> '''79''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2252 |y=1330 |text=<span style="background:rgba(220,20,60,0.75);"> '''80''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2522 |y=1346 |text=<span style="background:rgba(220,20,60,0.75);"> '''81''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2749 |y=1405 |text=<span style="background:rgba(220,20,60,0.75);"> '''82''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2945 |y=1426 |text=<span style="background:rgba(220,20,60,0.75);"> '''83''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3081 |y=1411 |text=<span style="background:rgba(220,20,60,0.75);"> '''84''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label end}}
{{Clear}}
== Calculations ==
{| style="border:#c0c0c0 solid 1px; padding:0px 0px 5px 5px; margin:0px 0px 5px 5px; float:right;"
|-
| y<sub>orig</sub>
y<sub>scaled</sub><!-- = {{sfrac|x<sub>scaled</sub>|x<sub>orig</sub>}} * y<sub>orig</sub> -->
| <div style="position:relative; float:left; width:250px; height=166px;">
<div>[[Image:Southern California Coastal Range in Mist.jpg|250px|left]]</div>
<div style="position:absolute; float:left; left:45px; top:45px;">[[Image:Red pog.svg|10px]]</div>
<div style="position:absolute; float:left; left:60px; top:40px;">x<sub>marker_orig</sub><!-- + x<sub>adjust</sub> --><br/>y<sub>marker_orig</sub><!-- + y<sub>adjust</sub></div> --></div>
</div>
|- style="text-align:center;"
|
| x<sub>orig</sub>
x<sub>scaled</sub>
|}
<!--
x_relative = x_marker_orig / x_orig * x_scaled - marker_size / 2 + x_adjust
y_relative = y_marker_orig / y_orig * y_scaled - marker_size / 2 + y_adjust
where
y_scaled = x_scaled / x_orig * y_orig
-->Default calculations used for placing the marker image. With the use of the template's parameter options <var>x<sub>adjust</sub></var> and <var>y<sub>adjust</sub></var> the placement can be slightly modified.
:<math>x_{marker} = {x_{marker\_orig} \over x_{orig}} \cdot x_{scaled} - {marker\_size \over 2} + x_{adjust}</math>
and
:<math>y_{marker} = {y_{marker\_orig} \over y_{orig}} \cdot y_{scaled} - {marker\_size \over 2} + y_{adjust}</math>
Where <var>y<sub>scaled</sub></var> by default is calculated from the percentage the image is resized
:<math>y_{scaled} = {x_{scaled} \over x_{orig}} \cdot y_{orig}</math>
<!--
x_relative = x_marker_orig / x_orig * x_scaled + marker_size / 2 + x_adjust + x_textadjust
y_relative = y_marker_orig / y_orig * y_scaled - marker_size / 2 + y_adjust + y_textadjust
where
y_scaled = x_scaled / x_orig * y_orig
-->Default calculations for the text placement, more specifically the upper left corner of the text's bounding box. The calculation inherits <var>x<sub>adjust</sub></var> and <var>y<sub>adjust</sub></var> from the marker image's placement. With the use of the template's parameter options <var>x<sub>textadjust</sub></var> and <var>y<sub>textadjust</sub></var> the text placement can be additionally modified.
:<math>x_{text} = {x_{marker\_orig} \over x_{orig}} \cdot x_{scaled} + {marker\_size \over 2} + x_{adjust} + x_{textadjust}</math>
and
:<math>y_{text} = {y_{marker\_orig} \over y_{orig}} \cdot y_{scaled} - {marker\_size \over 2} + y_{adjust} + y_{textadjust}</math>
==Template parameters==
None of the template parameters are technically required, however not supplying a few of them will make the template behave oddly, or make the use of this template unnecessary. For this reason some of the parameters are listed as "required".
{| class="wikitable" style="background-color:transparent;"
! Parameter name
! Alternate names
! Required
! Description
! Recommended values
|-
| x_marker_orig
| '''x'''<br/>x-marker-orig
| '''yes'''
| The horizontal <var>x</var>-location on the original image where you want the centre of the marker to be located.
| 1 … <var>x<sub>orig</sub></var>
|-
| y_marker_orig
| '''y'''<br/>y-marker-orig
| '''yes'''
| The vertical <var>y</var>-location on the original image where you want the centre of the marker to be located.
| {{nowrap|1 … <var>y<sub>orig</sub></var>}}
|-
| x_scaled
| '''scale'''<br/>width<br/>x-scaled
| '''yes'''
| The width of the resized image in pixels. Default is scaling it down (or up) to <code>250</code> pixels.
| {{nowrap|1 … <var>x<sub>orig</sub></var>}}
|-
| y_scaled
| height<br/>y-scaled
| no
| The calculated height of the resized image in pixels. Note that the actual image height is implicitly set with {{Tl|Image label begin}}. Thus <var>y<sub>scaled</sub></var> is mainly used internally, and by default it is calculated based on <var>x<sub>scaled</sub></var>. If you do use this parameter, then you should also fill in a value for <var>y<sub>orig</sub></var> or the calculations will end up wrong.
| {{nowrap|1 … <var>y<sub>orig</sub></var>}}
|-
| x_orig
| width_orig<br/>x-orig<br/>width-orig
| '''yes'''
| The width of the original image in pixels. If this value isn't corresponding with the original image's actual width, the calculations may be faulty.
| {{nowrap|1 … ?}}
|-
| y_orig
| height_orig<br/>y-orig<br/>height-orig
| no
| The height of the original image in pixels. If this value isn't corresponding with the original image's actual height, the calculations may be faulty. You need to fill in a value for this parameter if you already used the <var>y<sub>scaled</sub></var> parameter option, otherwise the calculations will end up wrong.
| {{nowrap|1 … ?}}
|-
| text
|
| no
| The text accompanying the marker image and shown close to the calculated <var>(x, y)</var> position. Default is no text.
| Any text
|-
| image
|
| no
| The image placed at the calculated <var>(x, y)</var> position. Default is [[commons:Category:Map pointers, dotset 1|<code>Red pog.svg</code>]] [[Image:Red pog.svg|7px]].
| [[commons:|Any image]]
|-
| marker_size
| marker-size
| no
| The size (height and width) of the marker image that is placed. Default is <code>7</code> pixels wide. If the size is set to <code>0</code>, then no image will be shown. It is assumed the shown marker image is a square so the height is equal to its width. If it is not a square you can modify the placement with the <var>x<sub>adjust</sub></var> and/or <var>y<sub>adjust</sub></var> options.
| {{nowrap|0 … ?}}
|-
| x_adjust
| x-adjust
| no
| A number of pixels you want the marker image to be moved horizontally after the initial scaling calculation has been done. Use for example if after calculation a rounding error moves the marker image a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-x<sub>scaled</sub></var> … <var>+x<sub>scaled</sub></var>}}
|-
| y_adjust
| y-adjust
| no
| A number of pixels you want the marker image to be moved vertically after the initial scaling calculation has been done. Use for example if the marker image is not a square, or if after calculation a rounding error moves the marker image a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-y<sub>scaled</sub></var> … <var>+y<sub>scaled</sub></var>}}
|-
| x_textadjust
| x-textadjust
| no
| A number of pixels you want the text's upper left corner to be moved horizontally after the initial scaling calculation has been done. Use for example if after calculation a rounding error or the font size moves the text's upper left corner a bit off from its wanted position. If a marker image was shown the default value is <code>3</code> pixels to give a little room between the image and the text. Otherwise the default is <code>0</code>.
| {{nowrap|<var>-x<sub>scaled</sub></var> … <var>+x<sub>scaled</sub></var>}}
|-
| y_textadjust
| y-textadjust
| no
| A number of pixels you want the text's upper left corner to be moved vertically after the initial scaling calculation has been done. Use for example if after calculation a rounding error or the font size moves the text's upper left corner a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-y<sub>scaled</sub></var> … <var>+y<sub>scaled</sub></var>}}
|-
| show_image
| showimage<br/>show-image
| no
| If this parameter contains anything else than its default value <code>yes</code> then the marker image will not be shown. Another way to do the same is to set the <var>marker_size</var> to <code>0</code>.
| Any text or value
|-
| text_color
| color<br/>text-color
| no
| [[Cascading Style Sheets|CSS]]-option specifying the color of the text accompanying the marker image. This value follows the valid options for specifying a [[Web colors|web color]] with CSS. Default is <code>black</code>.
| [[Web colors#HTML color names|predefined color name]] or<br/>
{{nowrap|<code>#000000</code> … <code>#FFFFFF</code>}} or<br/>
{{nowrap|<code>[[Web colors#CSS colors|rgb]](</code><var>red</var><code>,</code> <var>green</var><code>,</code> <var>blue</var><code>)</code>}}
|-
| text_align
| text-align
| no
| [[Cascading Style Sheets|CSS]]-option specifying the [[Typographic alignment|alignment]] of the accompanying marker text. Default value is <code>left</code>.
| <code>left</code>, <code>right</code>, <code>center</code>, <code>justify</code>
|-
| text_width
| text-width
| no
| [[Cascading Style Sheets|CSS]]-option specifying the column width of the text accompanying the marker image. By default this is not set and follows the browser's calculations. Note that you need to add the units <code>px</code> or <code>%</code> etc., or otherwise the CSS the template generates will be incorrect.
| <code>auto</code>, {{nowrap|1<code>px</code> … <var>+x<sub>scaled</sub></var><code>px</code>}}, {{nowrap|1<code>%</code> … 100<code>%</code>}}
|-
| font_size
| font-size
| no
| [[Cascading Style Sheets|CSS]]-option specifying the font size of the text accompanying the marker image. This value follows the valid options for specifying a font size with CSS. Predefined relative font sizes are <code>xx-small</code>, <code>x-small</code>, <code>small</code>, <code>medium</code>, <code>large</code>, <code>x-large</code>, <code>xx-large</code>, or it can be specified with a number in [[Point (typography)|points]] <code>pt</code>, [[pixel]]s <code>px</code>, [[Em (typography)|ems]] <code>em</code>, percent <code>%</code>, <code>cm</code>, etc. By default this is not set and follows the text, font and style around the image.
| F.ex. 10<code>pt</code>, 20<code>px</code>, 1.5<code>em</code>, 125<code>%</code>, …
|-
| style
|
| no
| Any other [[Cascading Style Sheets|CSS]] you want applied to the text. You need to write this out in full and as valid CSS. This will be applied to the whole text's (rectangle) bounding box, so if you want some CSS applied to only parts of the text you should not use this option, but instead use<br />
{{nbsp|4}}<code><nowiki><span style="some valid CSS;">some text</span></nowiki></code><br />
on the specific parts of the text itself.
| Any valid CSS
|}
== See also ==
* {{tl|Annotated image}}, allows text notes to overlap image, allows cropping
* {{tl|Image label}}, an alternative
* {{tl|Overlay}} - places up to 30 marker images of various chooseable kinds over a base image with optional grid and legend
* {{tl|Superimpose}} - places one image over another
* {{tl|Superimpose2}} - places up to 50 image layers over one another
* {{tl|Location map}} - places a single image over another at a map coordinate location
* {{tl|Lageplan}}, related template to Location map with specific features
<includeonly>
<!-- Categories and Interwikis -->
[[Category:Graphics templates]]
</includeonly>
{{Documentation subpage}}
== Usage ==
=== Purpose ===
The purpose of this template is to allow accurate placement of an image and/or text label over another source image, irrespective of scaling of the source image. It is based on the {{tl|Image label}} template. However, a drawback with that template is that the placement gets slightly inaccurate if you scale the source image (because of the way calculations are done), and thus you might have to manually recalculate the placement.
This template also has similarities with the {{tl|Overlay}} template. That template however sadly doesn't allow for scaling. It is also limited to 30 labels, although for most purposes that is probably more than enough.
This template is however much more bloated than either of those templates, and you might want to consider if you can use one of the templates that are simpler and easier to use.
=== Example usage ===
<div style="float:right; margin:0 0 0 1em;">
{{Image label begin | image=Beach Smile.jpg | width=250 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label end}}
</div>
This template assumes you first introduce a background image by calling {{tl|Image label begin}}. By doing so this also requires it to be ended with {{tl|Image label end}}. Example with two smilies [[Image:Face-grin.svg|15px]] placed as the “eyes” on this beach image.
<pre style="overflow:auto;">{{Image label begin | image=Beach Smile.jpg | width=250 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=250 | x_orig=2749 }}
{{Image label end}}</pre>
For full list of available options/parameters see further below. In this example the following are used
* <code>width = 250</code> is the width of the scaled image. This should correspond to the width you supplied when using {{tl|Image label begin}}.
* <code>x_orig = 2749</code> is in this example the width of the original beach image, which can be found out through various methods. One way to find out is the way Wikipedia/Commons lists it below the image where it says “Full resolution” when you view the image information and its license.
* <code>x = 1079</code> is the x-coordinate on the full resolution image where the [[Image:Face-grin.svg|15px]] is to be placed. There are various methods to find out this, and depends on what tools you have available.
* <code>y = 1033</code> is the y-coordinate on the full resolution image where the [[Image:Face-grin.svg|15px]] is to be placed.
* <code>image = Face-grin.svg</code> is the image to be used as a marker, since the default marker image [[Image:Red pog.svg|9px]] is not used.
* <code>marker_size = 15</code> is the width of the marker image [[Image:Face-grin.svg|15px]].
<div style="float:right; margin:0 0 0 1em;">
{{Image label begin | image=Beach Smile.jpg | width=150 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label end}}
</div>
If scaling the beach image down (or up), the only changes that need to be done is changing every occurrence of the width parameter, and the placement of overlying marker images (and their corresponding text) should scale accordingly.
<pre style="overflow:auto;">{{Image label begin | image=Beach Smile.jpg | width=150 | float=right | title=Example }}
{{Image label marker | x=1079 | y=1033 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label marker | x=1601 | y=1020 | image=Face-grin.svg | marker_size=15 | width=150 | x_orig=2749 }}
{{Image label end}}</pre>
=== Minimal use skeleton ===
<pre>{{Image label marker
| x_marker_orig =
| y_marker_orig =
| x_scaled =
| x_orig =
| text =
}}</pre>
If you want to use a different marker/image than the default [[commons:Category:Map pointers, dotset 1|<code>Red pog.svg</code>]] [[Image:Red pog.svg|7px]], you can add it with
<pre> | image =
| marker_size =</pre>
=== Full skeleton ===
<pre>{{Image label marker
| x_marker_orig =
| y_marker_orig =
| x_scaled =
| y_scaled =
| x_orig =
| y_orig =
| text =
| image =
| marker_size =
| x_adjust =
| y_adjust =
| x_textadjust =
| y_textadjust =
| show_image =
| text_color =
| text_align =
| text_width =
| font_size =
| style =
}}</pre>
Please note that many of these parameters are used in calculations. Due to constraints the template will think a parameter that is given, but is actually empty or contains spaces, still has a value and thus will give an error during calculations. The error might look something like this: {{#expr: 0+ }}.
== Examples ==
=== «Riksforsamlingen på Eidsvoll 1814» painted by [[Oscar Wergeland]] ===
{{Image label begin | image=Eidsvoll riksraad 1814.jpeg | width=800 | float=left | title=Riksforsamlingen på Eidsvoll 1814}}
{{Image label marker |x=92 |y=988 |text=<span style="background:rgba(220,20,60,0.75);"> '''1''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=180 |y=1085 |text=<span style="background:rgba(220,20,60,0.75);"> '''2''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=305 |y=1110 |text=<span style="background:rgba(220,20,60,0.75);"> '''3''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=360 |y=1095 |text=<span style="background:rgba(220,20,60,0.75);"> '''4''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=440 |y=1100 |text=<span style="background:rgba(220,20,60,0.75);"> '''5''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=510 |y=1085 |text=<span style="background:rgba(220,20,60,0.75);"> '''6''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=585 |y=1090 |text=<span style="background:rgba(220,20,60,0.75);"> '''7''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=793 |y=1091 |text=<span style="background:rgba(220,20,60,0.75);"> '''8''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=841 |y=1083 |text=<span style="background:rgba(220,20,60,0.75);"> '''9''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=912 |y=1083 |text=<span style="background:rgba(220,20,60,0.75);"> '''10''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1071 |y=1088 |text=<span style="background:rgba(220,20,60,0.75);"> '''11''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1134 |y=1086 |text=<span style="background:rgba(220,20,60,0.75);"> '''12''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1235 |y=1081 |text=<span style="background:rgba(220,20,60,0.75);"> '''13''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1373 |y=1096 |text=<span style="background:rgba(220,20,60,0.75);"> '''14''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1559 |y=1089 |text=<span style="background:rgba(220,20,60,0.75);"> '''15''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=23 |y=1190 |text=<span style="background:rgba(220,20,60,0.75);"> '''16''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=70 |y=1197 |text=<span style="background:rgba(220,20,60,0.75);"> '''17''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=109 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''18''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=130 |y=1229 |text=<span style="background:rgba(220,20,60,0.75);"> '''19''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=152 |y=1197 |text=<span style="background:rgba(220,20,60,0.75);"> '''20''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=174 |y=1194 |text=<span style="background:rgba(220,20,60,0.75);"> '''21''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=205 |y=1193 |text=<span style="background:rgba(220,20,60,0.75);"> '''22''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=238 |y=1190 |text=<span style="background:rgba(220,20,60,0.75);"> '''23''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=296 |y=1250 |text=<span style="background:rgba(220,20,60,0.75);"> '''24''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=315 |y=1220 |text=<span style="background:rgba(220,20,60,0.75);"> '''25''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=330 |y=1237 |text=<span style="background:rgba(220,20,60,0.75);"> '''26''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=360 |y=1227 |text=<span style="background:rgba(220,20,60,0.75);"> '''27''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=368 |y=1250 |text=<span style="background:rgba(220,20,60,0.75);"> '''28''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=390 |y=1243 |text=<span style="background:rgba(220,20,60,0.75);"> '''29''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=430 |y=1267 |text=<span style="background:rgba(220,20,60,0.75);"> '''30''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=469 |y=1259 |text=<span style="background:rgba(220,20,60,0.75);"> '''31''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=466 |y=1281 |text=<span style="background:rgba(220,20,60,0.75);"> '''32''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=488 |y=1295 |text=<span style="background:rgba(220,20,60,0.75);"> '''33''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=545 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''34''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=552 |y=1283 |text=<span style="background:rgba(220,20,60,0.75);"> '''35''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=613 |y=1248 |text=<span style="background:rgba(220,20,60,0.75);"> '''36''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=714 |y=1215 |text=<span style="background:rgba(220,20,60,0.75);"> '''37''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=766 |y=1248 |text=<span style="background:rgba(220,20,60,0.75);"> '''38''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=824 |y=1279 |text=<span style="background:rgba(220,20,60,0.75);"> '''39''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=935 |y=1339 |text=<span style="background:rgba(220,20,60,0.75);"> '''40''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=973 |y=1213 |text=<span style="background:rgba(220,20,60,0.75);"> '''41''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1109 |y=1326 |text=<span style="background:rgba(220,20,60,0.75);"> '''42''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1129 |y=1244 |text=<span style="background:rgba(220,20,60,0.75);"> '''43''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1313 |y=1246 |text=<span style="background:rgba(220,20,60,0.75);"> '''44''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1412 |y=1243 |text=<span style="background:rgba(220,20,60,0.75);"> '''45''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1457 |y=1285 |text=<span style="background:rgba(220,20,60,0.75);"> '''46''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1576 |y=1222 |text=<span style="background:rgba(220,20,60,0.75);"> '''47''' </span> |text-color=white |font-size=10px |x-textadjust=-1 |y-textadjust=-4 |image=Red Arrow Left.svg |marker-size=9 |x-adjust=4.5 |y-adjust=0 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1528 |y=1373 |text=<span style="background:rgba(220,20,60,0.75);"> '''48''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=155 |y=1425 |text=<span style="background:rgba(220,20,60,0.75);"> '''49''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=343 |y=1387 |text=<span style="background:rgba(220,20,60,0.75);"> '''50''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=395 |y=1405 |text=<span style="background:rgba(220,20,60,0.75);"> '''51''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=427 |y=1397 |text=<span style="background:rgba(220,20,60,0.75);"> '''52''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=498 |y=1403 |text=<span style="background:rgba(220,20,60,0.75);"> '''53''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=563 |y=1402 |text=<span style="background:rgba(220,20,60,0.75);"> '''54''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=612 |y=1421 |text=<span style="background:rgba(220,20,60,0.75);"> '''55''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=660 |y=1432 |text=<span style="background:rgba(220,20,60,0.75);"> '''56''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=783 |y=1521 |text=<span style="background:rgba(220,20,60,0.75);"> '''57''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1684 |y=898 |text=<span style="background:rgba(220,20,60,0.75);"> '''58''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1915 |y=1132 |text=<span style="background:rgba(220,20,60,0.75);"> '''59''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2040 |y=1124 |text=<span style="background:rgba(220,20,60,0.75);"> '''60''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2170 |y=1128 |text=<span style="background:rgba(220,20,60,0.75);"> '''61''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2319 |y=1174 |text=<span style="background:rgba(220,20,60,0.75);"> '''62''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2364 |y=936 |text=<span style="background:rgba(220,20,60,0.75);"> '''63''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2451 |y=1175 |text=<span style="background:rgba(220,20,60,0.75);"> '''64''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2470 |y=921 |text=<span style="background:rgba(220,20,60,0.75);"> '''65''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2524 |y=1137 |text=<span style="background:rgba(220,20,60,0.75);"> '''66''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2617 |y=1180 |text=<span style="background:rgba(220,20,60,0.75);"> '''67''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2718 |y=1117 |text=<span style="background:rgba(220,20,60,0.75);"> '''68''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2889 |y=1180 |text=<span style="background:rgba(220,20,60,0.75);"> '''69''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2968 |y=1113 |text=<span style="background:rgba(220,20,60,0.75);"> '''70''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3089 |y=1164 |text=<span style="background:rgba(220,20,60,0.75);"> '''71''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3184 |y=1081 |text=<span style="background:rgba(220,20,60,0.75);"> '''72''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3279 |y=837 |text=<span style="background:rgba(220,20,60,0.75);"> '''73''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3295 |y=1079 |text=<span style="background:rgba(220,20,60,0.75);"> '''74''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=-14 |image=Red Arrow Down.svg |marker-size=9 |x-adjust=0 |y-adjust=-4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1896 |y=1342 |text=<span style="background:rgba(220,20,60,0.75);"> '''75''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=1952 |y=1292 |text=<span style="background:rgba(220,20,60,0.75);"> '''76''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2018 |y=1327 |text=<span style="background:rgba(220,20,60,0.75);"> '''77''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2072 |y=1324 |text=<span style="background:rgba(220,20,60,0.75);"> '''78''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2173 |y=1299 |text=<span style="background:rgba(220,20,60,0.75);"> '''79''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2252 |y=1330 |text=<span style="background:rgba(220,20,60,0.75);"> '''80''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2522 |y=1346 |text=<span style="background:rgba(220,20,60,0.75);"> '''81''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2749 |y=1405 |text=<span style="background:rgba(220,20,60,0.75);"> '''82''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=2945 |y=1426 |text=<span style="background:rgba(220,20,60,0.75);"> '''83''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label marker |x=3081 |y=1411 |text=<span style="background:rgba(220,20,60,0.75);"> '''84''' </span> |text-color=white |font-size=10px |x-textadjust=-9 |y-textadjust=4 |image=Red Arrow Up.svg |marker-size=9 |x-adjust=0 |y-adjust=4.5 |x-orig=3330 |y-orig=2234 |width=800 }}
{{Image label end}}
{{Clear}}
== Calculations ==
{| style="border:#c0c0c0 solid 1px; padding:0px 0px 5px 5px; margin:0px 0px 5px 5px; float:right;"
|-
| y<sub>orig</sub>
y<sub>scaled</sub><!-- = {{sfrac|x<sub>scaled</sub>|x<sub>orig</sub>}} * y<sub>orig</sub> -->
| <div style="position:relative; float:left; width:250px; height=166px;">
<div>[[Image:Southern California Coastal Range in Mist.jpg|250px|left]]</div>
<div style="position:absolute; float:left; left:45px; top:45px;">[[Image:Red pog.svg|10px]]</div>
<div style="position:absolute; float:left; left:60px; top:40px;">x<sub>marker_orig</sub><!-- + x<sub>adjust</sub> --><br/>y<sub>marker_orig</sub><!-- + y<sub>adjust</sub></div> --></div>
</div>
|- style="text-align:center;"
|
| x<sub>orig</sub>
x<sub>scaled</sub>
|}
<!--
x_relative = x_marker_orig / x_orig * x_scaled - marker_size / 2 + x_adjust
y_relative = y_marker_orig / y_orig * y_scaled - marker_size / 2 + y_adjust
where
y_scaled = x_scaled / x_orig * y_orig
-->Default calculations used for placing the marker image. With the use of the template's parameter options <var>x<sub>adjust</sub></var> and <var>y<sub>adjust</sub></var> the placement can be slightly modified.
:<math>x_{marker} = {x_{marker\_orig} \over x_{orig}} \cdot x_{scaled} - {marker\_size \over 2} + x_{adjust}</math>
and
:<math>y_{marker} = {y_{marker\_orig} \over y_{orig}} \cdot y_{scaled} - {marker\_size \over 2} + y_{adjust}</math>
Where <var>y<sub>scaled</sub></var> by default is calculated from the percentage the image is resized
:<math>y_{scaled} = {x_{scaled} \over x_{orig}} \cdot y_{orig}</math>
<!--
x_relative = x_marker_orig / x_orig * x_scaled + marker_size / 2 + x_adjust + x_textadjust
y_relative = y_marker_orig / y_orig * y_scaled - marker_size / 2 + y_adjust + y_textadjust
where
y_scaled = x_scaled / x_orig * y_orig
-->Default calculations for the text placement, more specifically the upper left corner of the text's bounding box. The calculation inherits <var>x<sub>adjust</sub></var> and <var>y<sub>adjust</sub></var> from the marker image's placement. With the use of the template's parameter options <var>x<sub>textadjust</sub></var> and <var>y<sub>textadjust</sub></var> the text placement can be additionally modified.
:<math>x_{text} = {x_{marker\_orig} \over x_{orig}} \cdot x_{scaled} + {marker\_size \over 2} + x_{adjust} + x_{textadjust}</math>
and
:<math>y_{text} = {y_{marker\_orig} \over y_{orig}} \cdot y_{scaled} - {marker\_size \over 2} + y_{adjust} + y_{textadjust}</math>
==Template parameters==
None of the template parameters are technically required, however not supplying a few of them will make the template behave oddly, or make the use of this template unnecessary. For this reason some of the parameters are listed as "required".
{| class="wikitable" style="background-color:transparent;"
! Parameter name
! Alternate names
! Required
! Description
! Recommended values
|-
| x_marker_orig
| '''x'''<br/>x-marker-orig
| '''yes'''
| The horizontal <var>x</var>-location on the original image where you want the centre of the marker to be located.
| 1 … <var>x<sub>orig</sub></var>
|-
| y_marker_orig
| '''y'''<br/>y-marker-orig
| '''yes'''
| The vertical <var>y</var>-location on the original image where you want the centre of the marker to be located.
| {{nowrap|1 … <var>y<sub>orig</sub></var>}}
|-
| x_scaled
| '''scale'''<br/>width<br/>x-scaled
| '''yes'''
| The width of the resized image in pixels. Default is scaling it down (or up) to <code>250</code> pixels.
| {{nowrap|1 … <var>x<sub>orig</sub></var>}}
|-
| y_scaled
| height<br/>y-scaled
| no
| The calculated height of the resized image in pixels. Note that the actual image height is implicitly set with {{Tl|Image label begin}}. Thus <var>y<sub>scaled</sub></var> is mainly used internally, and by default it is calculated based on <var>x<sub>scaled</sub></var>. If you do use this parameter, then you should also fill in a value for <var>y<sub>orig</sub></var> or the calculations will end up wrong.
| {{nowrap|1 … <var>y<sub>orig</sub></var>}}
|-
| x_orig
| width_orig<br/>x-orig<br/>width-orig
| '''yes'''
| The width of the original image in pixels. If this value isn't corresponding with the original image's actual width, the calculations may be faulty.
| {{nowrap|1 … ?}}
|-
| y_orig
| height_orig<br/>y-orig<br/>height-orig
| no
| The height of the original image in pixels. If this value isn't corresponding with the original image's actual height, the calculations may be faulty. You need to fill in a value for this parameter if you already used the <var>y<sub>scaled</sub></var> parameter option, otherwise the calculations will end up wrong.
| {{nowrap|1 … ?}}
|-
| text
|
| no
| The text accompanying the marker image and shown close to the calculated <var>(x, y)</var> position. Default is no text.
| Any text
|-
| image
|
| no
| The image placed at the calculated <var>(x, y)</var> position. Default is [[commons:Category:Map pointers, dotset 1|<code>Red pog.svg</code>]] [[Image:Red pog.svg|7px]].
| [[commons:|Any image]]
|-
| marker_size
| marker-size
| no
| The size (height and width) of the marker image that is placed. Default is <code>7</code> pixels wide. If the size is set to <code>0</code>, then no image will be shown. It is assumed the shown marker image is a square so the height is equal to its width. If it is not a square you can modify the placement with the <var>x<sub>adjust</sub></var> and/or <var>y<sub>adjust</sub></var> options.
| {{nowrap|0 … ?}}
|-
| x_adjust
| x-adjust
| no
| A number of pixels you want the marker image to be moved horizontally after the initial scaling calculation has been done. Use for example if after calculation a rounding error moves the marker image a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-x<sub>scaled</sub></var> … <var>+x<sub>scaled</sub></var>}}
|-
| y_adjust
| y-adjust
| no
| A number of pixels you want the marker image to be moved vertically after the initial scaling calculation has been done. Use for example if the marker image is not a square, or if after calculation a rounding error moves the marker image a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-y<sub>scaled</sub></var> … <var>+y<sub>scaled</sub></var>}}
|-
| x_textadjust
| x-textadjust
| no
| A number of pixels you want the text's upper left corner to be moved horizontally after the initial scaling calculation has been done. Use for example if after calculation a rounding error or the font size moves the text's upper left corner a bit off from its wanted position. If a marker image was shown the default value is <code>3</code> pixels to give a little room between the image and the text. Otherwise the default is <code>0</code>.
| {{nowrap|<var>-x<sub>scaled</sub></var> … <var>+x<sub>scaled</sub></var>}}
|-
| y_textadjust
| y-textadjust
| no
| A number of pixels you want the text's upper left corner to be moved vertically after the initial scaling calculation has been done. Use for example if after calculation a rounding error or the font size moves the text's upper left corner a bit off from its wanted position. Default is <code>0</code>.
| {{nowrap|<var>-y<sub>scaled</sub></var> … <var>+y<sub>scaled</sub></var>}}
|-
| show_image
| showimage<br/>show-image
| no
| If this parameter contains anything else than its default value <code>yes</code> then the marker image will not be shown. Another way to do the same is to set the <var>marker_size</var> to <code>0</code>.
| Any text or value
|-
| text_color
| color<br/>text-color
| no
| [[Cascading Style Sheets|CSS]]-option specifying the color of the text accompanying the marker image. This value follows the valid options for specifying a [[Web colors|web color]] with CSS. Default is <code>black</code>.
| [[Web colors#HTML color names|predefined color name]] or<br/>
{{nowrap|<code>#000000</code> … <code>#FFFFFF</code>}} or<br/>
{{nowrap|<code>[[Web colors#CSS colors|rgb]](</code><var>red</var><code>,</code> <var>green</var><code>,</code> <var>blue</var><code>)</code>}}
|-
| text_align
| text-align
| no
| [[Cascading Style Sheets|CSS]]-option specifying the [[Typographic alignment|alignment]] of the accompanying marker text. Default value is <code>left</code>.
| <code>left</code>, <code>right</code>, <code>center</code>, <code>justify</code>
|-
| text_width
| text-width
| no
| [[Cascading Style Sheets|CSS]]-option specifying the column width of the text accompanying the marker image. By default this is not set and follows the browser's calculations. Note that you need to add the units <code>px</code> or <code>%</code> etc., or otherwise the CSS the template generates will be incorrect.
| <code>auto</code>, {{nowrap|1<code>px</code> … <var>+x<sub>scaled</sub></var><code>px</code>}}, {{nowrap|1<code>%</code> … 100<code>%</code>}}
|-
| font_size
| font-size
| no
| [[Cascading Style Sheets|CSS]]-option specifying the font size of the text accompanying the marker image. This value follows the valid options for specifying a font size with CSS. Predefined relative font sizes are <code>xx-small</code>, <code>x-small</code>, <code>small</code>, <code>medium</code>, <code>large</code>, <code>x-large</code>, <code>xx-large</code>, or it can be specified with a number in [[Point (typography)|points]] <code>pt</code>, [[pixel]]s <code>px</code>, [[Em (typography)|ems]] <code>em</code>, percent <code>%</code>, <code>cm</code>, etc. By default this is not set and follows the text, font and style around the image.
| F.ex. 10<code>pt</code>, 20<code>px</code>, 1.5<code>em</code>, 125<code>%</code>, …
|-
| style
|
| no
| Any other [[Cascading Style Sheets|CSS]] you want applied to the text. You need to write this out in full and as valid CSS. This will be applied to the whole text's (rectangle) bounding box, so if you want some CSS applied to only parts of the text you should not use this option, but instead use<br />
{{nbsp|4}}<code><nowiki><span style="some valid CSS;">some text</span></nowiki></code><br />
on the specific parts of the text itself.
| Any valid CSS
|}
== See also ==
* {{tl|Annotated image}}, allows text notes to overlap image, allows cropping
* {{tl|Image label}}, an alternative
* {{tl|Overlay}} - places up to 30 marker images of various chooseable kinds over a base image with optional grid and legend
* {{tl|Superimpose}} - places one image over another
* {{tl|Superimpose2}} - places up to 50 image layers over one another
* {{tl|Location map}} - places a single image over another at a map coordinate location
* {{tl|Lageplan}}, related template to Location map with specific features
<includeonly>
<!-- Categories and Interwikis -->
[[Category:Graphics templates]]
</includeonly>
