You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/tutorials/Fundamentals.md
+16-16
Original file line number
Diff line number
Diff line change
@@ -9,14 +9,14 @@ In this tutorial, we shall be introduced to the fundamentals of iTowns : how it
9
9
10
10
## Data visualization with iTowns
11
11
12
-
The support to display anything within iTowns is called a `View`.
12
+
The support to display anything within iTowns is called a `{@link View}`.
13
13
14
-
To provide geographic data visualization, a `View` contains a combination of `Layers` which, in a digital map environment, are visual representations of any geographic data.
14
+
To provide geographic data visualization, a `{@link View}` contains a combination of [`Layers`]{@link Layer} which, in a digital map environment, are visual representations of any geographic data.
15
15
In other words, all data that are displayed using iTowns are supported by some `Layer`.
16
16
17
17
Each `View` in iTowns displays 3D data in a unique Coordinates Reference System (CRS).
18
18
Yet, the data displayed within a `View` do not necessarily have to be in the `View`'s CRS.
19
-
ITowns comes with two pre-made `View` types : `GlobeView` and `PlanarView`.
19
+
ITowns comes with two pre-made `View` types : `{@link GlobeView}` and `{@link PlanarView}`.
20
20
Each of these allows visualizing data from different types (raster or vector) and from different CRS.
21
21
On this matter, iTowns distinguishes two cases :
22
22
@@ -47,15 +47,15 @@ Regarding data formats, iTowns offers several possibilities : [vector tile](http
47
47
48
48
## The support for visualized data
49
49
50
-
It was earlier mentioned that data are displayed as `Layers` within iTowns.
50
+
It was earlier mentioned that data are displayed as [`Layers`]{@link Layer} within iTowns.
51
51
Several specific types of `Layers` exist, the use of which depends on the data to display :
52
52
53
-
-`ColorLayer` can be used to display raster graphics or vector data projected on the ground (left picture in the table bellow),
54
-
-`ElevationLayer` can be used to display 3D elevation models (center picture in the table bellow),
55
-
-`GeometryLayer` can be used to display 3D objects, such as geometric shapes or buildings modelling (right picture in the table bellow).
56
-
-`FeatureGeometryLayer` is a pre-configured `GeometryLayer` which simplifies its implementation in given cases.
57
-
-`PointCloudLayer` can be used to display 3D point clouds.
58
-
-`OrientedImageLayer` can be used to display some oriented images.
53
+
-`{@link ColorLayer}` can be used to display raster graphics or vector data projected on the ground (left picture in the table bellow),
54
+
-`{@link ElevationLayer}` can be used to display 3D elevation models (center picture in the table bellow),
55
+
-`{@link GeometryLayer}` can be used to display 3D objects, such as geometric shapes or buildings modelling (right picture in the table bellow).
56
+
-`{@link FeatureGeometryLayer}` is a pre-configured `{@link GeometryLayer}` which simplifies its implementation in given cases.
57
+
-`{@link PointCloudLayer}` can be used to display 3D point clouds.
58
+
-`{@link OrientedImageLayer}` can be used to display some oriented images.
@@ -66,14 +66,14 @@ Several specific types of `Layers` exist, the use of which depends on the data t
66
66
67
67
## Vector data appearance
68
68
69
-
ITowns can display vector data in two ways : the data can be displayed in a `View` as 3D objects, or as entities that are projected on the ground.
69
+
ITowns can display vector data in two ways : the data can be displayed in a `{@link View}` as 3D objects, or as entities that are projected on the ground.
70
70
You can see bellow pictures illustrating the two cases.
| Vector data projected on the ground | Vector data display as 3D objects |
75
75
76
-
In both ways, the appearance and positioning of the vector data can be adjusted by modifying the `Style` parameter of the `Layer` the data are displayed in.
76
+
In both ways, the appearance and positioning of the vector data can be adjusted by modifying the `{@link Style}` parameter of the `Layer` the data are displayed in.
77
77
The `Style` in iTowns comes with several properties :
78
78
-`fill` allows defining style rules for polygons interior,
79
79
-`stroke` allows defining style rules for lines and polygons edges,
@@ -98,17 +98,17 @@ The content of the label will be the content stored in the data under the `name`
98
98
99
99
### Vector data projected on the ground
100
100
101
-
When vector data are flattened on the ground, they are displayed in a `ColorLayer`.
101
+
When vector data are flattened on the ground, they are displayed in a `{@link ColorLayer}`.
102
102
In that case, the data basically consist in polygons, lines or points.
103
-
Their appearance can be adjusted by modifying the `Style` of the `ColorLayer`.
103
+
Their appearance can be adjusted by modifying the `{@link Style}` of the `{@link ColorLayer}`.
104
104
Yet, their positioning can't be modified since it is computed so that tey appear projected on the ground.
105
105
106
106
Tutorial on how to modify the appearance of some vector data displayed on the ground can be found [here]{@tutorial Vector-data-on-ground}.
107
107
108
108
### Vector data displayed as 3D objects
109
109
110
-
In the case of vector data represented as 3D objects, the data are displayed in a `GeometryLayer`.
111
-
The appearance and positioning of the vector data can be adjusted by modifying the `Style` of the `GeometryLayer`.
110
+
In the case of vector data represented as 3D objects, the data are displayed in a `{@link GeometryLayer}`.
111
+
The appearance and positioning of the vector data can be adjusted by modifying the `{@link Style}` of the `{@link GeometryLayer}`.
112
112
Two parameters allow modifying the data position :
113
113
-`base_altitude` which defines the altitude at the base of the 3D objects ;
114
114
-`extrusion_height` which defines the height of the 3D objects, giving them volume.
0 commit comments