Project map: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
Maxim@tygron.com (talk | contribs)
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:
The project map is the rectangular data space of your project. It is defined by a width and a height. Its location is defined by a world reference point, which is a coordinate relative to the [https://epsg.io/3857 EPSG:3857 WGS 84 / Pseudo-Mercator] coordinate system.
The project map is the rectangular data space of your project. It is defined by a width and a height. Its location is defined by a world reference point, which is a coordinate relative to the [https://epsg.io/3857 EPSG:3857 WGS 84 / Pseudo-Mercator] coordinate system.


The width and height are stored in the MAP_SIZE_M Setting item as an array of two Integers, representing the width and height.
The width and height are stored in the MAP_SIZE_M Setting item as an array of two integers.
The world reference point is stored in the WORLD_REFERENCE_POINT Setting item as an array of two Doubles, representing X and Y.
The world reference point is stored in the WORLD_REFERENCE_POINT Setting item as an array of two Doubles, representing X and Y.


When a project is generated, or new features are imported or drawn in a session, they are required to intersect with the project map. Only its intersection with this project map is imported. This holds for practically all [[item]]s, with the exception of [[Height Sector]]s and [[Terrain]]s.<br clear=both>
Generated projects and newly imported or drawn features must intersect with the project map; only the intersecting portions are imported. This holds for practically all [[item]]s, with the exception of [[Height Sector]]s and [[Terrain]]s.<br clear=both>
==Surrounding Map Bounds==
==Surrounding Map Bounds==
[[File:Project_surrounding_map.png|thumb|500px|The project map (red) and its surrounding map (satellite). Notice the satellite images and its corresponding [[height sector]]s and severally water bodies as [[terrain]]s.]]
[[File:Project_surrounding_map.png|thumb|500px|The project map (red) and its surrounding map (satellite). Notice the satellite images and their corresponding [[height sector]]s and several water bodies as [[terrain]]s.]]
When zooming out to view the [[project map]], you 'll notice that there is a region surrounding the project map that is covered with satellite images, Height sector information and terrain data. These provide some extra sense of orientation and lead to a more pleasantly looking boundary of your project.
Zooming out reveals a region surrounding the project map containing satellite images, height sector information, and terrain data. This provides better orientation and a visually cleaner project boundary.


The surrounding map extend is stored as a [[Setting]], SURROUNDING_MAP_EXTEND_M, which defines the extra boundary distances around the project map. Its total dimensions are calculated  as:
The surrounding map extent is stored as a [[Setting]], SURROUNDING_MAP_EXTEND_M, which defines the extra boundary distances around the project map. Its total dimensions are calculated  as:
<math>\begin{align}
<math>\begin{align}
  x_s & = d_x \cdot 2 + x_m \\
  x_s & = d_x \cdot 2 + x_m \\
Line 17: Line 17:


where:
where:
:<math>x_s \text{ and } y_s</math> are the dimensions of the surrounding map extends.
:<math>x_s \text{ and } y_s</math> are the dimensions of the surrounding map extents.
:<math>d_x \text{ and } d_y</math> are the configured distances around the project map, stored in the setting SURROUNDING_MAP_EXTEND_M.
:<math>d_x \text{ and } d_y</math> are the configured distances around the project map, stored in the setting SURROUNDING_MAP_EXTEND_M.
:<math>x_m \text{ and } y_m</math> are the project map dimensions, stored in the setting MAP_SIZE_M.
:<math>x_m \text{ and } y_m</math> are the project map dimensions, stored in the setting MAP_SIZE_M.
{{article end
|seealso=*[[Setting]]
*[[Project]]
*[[Overlay]]s
|api=*[[Api session event editor setting set setting]]
}}

Latest revision as of 07:18, 14 July 2026

The project details showing the Map size and the Location (World reference Point) of a project

The project map is the rectangular data space of your project. It is defined by a width and a height. Its location is defined by a world reference point, which is a coordinate relative to the EPSG:3857 WGS 84 / Pseudo-Mercator coordinate system.

The width and height are stored in the MAP_SIZE_M Setting item as an array of two integers. The world reference point is stored in the WORLD_REFERENCE_POINT Setting item as an array of two Doubles, representing X and Y.

Generated projects and newly imported or drawn features must intersect with the project map; only the intersecting portions are imported. This holds for practically all items, with the exception of Height Sectors and Terrains.

Surrounding Map Bounds

The project map (red) and its surrounding map (satellite). Notice the satellite images and their corresponding height sectors and several water bodies as terrains.
Zooming out reveals a region surrounding the project map containing satellite images, height sector information, and terrain data. This provides better orientation and a visually cleaner project boundary.

The surrounding map extent is stored as a Setting, SURROUNDING_MAP_EXTEND_M, which defines the extra boundary distances around the project map. Its total dimensions are calculated as: xs=dx2+xmys=dy2+ym

where:

xs and ys are the dimensions of the surrounding map extents.
dx and dy are the configured distances around the project map, stored in the setting SURROUNDING_MAP_EXTEND_M.
xm and ym are the project map dimensions, stored in the setting MAP_SIZE_M.