Skip to content

Latest commit

 

History

History
156 lines (89 loc) · 3.66 KB

File metadata and controls

156 lines (89 loc) · 3.66 KB

Moving Map

Shows a moving map, with the current GPS location at the centre of the map. The zoom level can be set to show a smaller or larger surrounding area.

<component type="moving_map" size="256" />

05-moving-map-0.png

Sizing

Moving map is always the same width as its height, use size to set the size

<component type="moving_map" size="64" zoom="7" />

05-moving-map-1.png

Positioning

Use x and y to set the position on screen

<component type="moving_map" x="64" y="64" size="64" zoom="7" />

05-moving-map-2.png

Zoom

Zoom levels can be set with zoom

Zoom levels range from 0 (the whole world) to 20 (a mid-sized building) - although not all map providers will provide tiles for zoom levels 19 & 20. Zoom levels 18 and below should be widely supported.

For more information on zoom levels see: Zoom Levels on the OpenStreetMap wiki.

<component type="moving_map" size="256" zoom="4" />

05-moving-map-3.png

<component type="moving_map" size="256" zoom="10" />

05-moving-map-4.png

<component type="moving_map" size="256" zoom="17" />

05-moving-map-5.png

Opacity

Set the opacity using opacity. It defaults to 1.0 which is completely opaque. 0.0 would be completely transparent. The gopro video will be visible through the component, if it is not completely opaque.

<component type="moving_map" zoom="7" opacity="0.6" />

05-moving-map-6.png

Rounded Corners

Corners can be rounded with corner_radius.

<component type="moving_map" size="256" corner_radius="40" zoom="7"/>

05-moving-map-7.png

if corner_radius == half the width (ie. the radius) then the corners will be so rounded that the map becomes a circle

<component type="moving_map" size="256" corner_radius="128" zoom="8" />

05-moving-map-8.png

Map Rotation

Map rotation can be turned off with rotate.

<component type="moving_map" size="256" rotate="false" />

05-moving-map-9.png

Map Provider & Styles

The map provider, and the map style, can be selected using the command line arguments when running the dashboard program. Currently, it's not possible to have multiple different map styles and providers in the same dashboard.

It is possible to have multiple moving maps, though

<component type="moving_map" size="128" zoom="4" /> 
<component type="moving_map" x="64" y="64" size="128" corner_radius="64" zoom="7"/>

05-moving-map-10.png

Fade out

Corners can be faded out using parent frame's fo where you can specify how many pixels to use for the fade out.

<frame width="200" height="200" bg="255,255,255">

</frame>
<frame width="200" height="200" cr="50" fo="40">
  <component type="moving_map" size="200"/>
</frame>

05-moving-map-11.png

Copyright

All maps are © OpenStreetMap contributors

Please see Copyright https://www.openstreetmap.org/copyright

Provider Copyright

Other map renderings may require additional attribution. This can be placed on the video using a text component, or referenced elsewhere in user documentation. The gopro-dashboard-overlay project is not responsible for the copyright usage of its users.