Differences

This shows you the differences between two versions of the page.

--- sdk:scenery_tsc_file [2020/05/10 19:26] – jh
+++ sdk:scenery_tsc [2020/05/10 20:12] – [Scenery Definition File (TSC)] jh
@@ Line 1: / Line 1: @@
-===== TSC File =====
+===== Scenery Definition File (TSC) =====
 The TSC file is a [[simulator:text_files|text file]] that can be edited with a regular text editor. The file can contain coordinates for an airport, a custom scenery object, runways, helipads and a lot more.
 Theses TSC files are placed in subdirectories of "places" folder in the scenery directory. For the creation of new scenery we have to set up a new TSC file and save it in our intermediate scenery folder.
+> **We recomment reading through the [[sdk:scenery|Scenery introduction tutorial]]** first\\
+> which provices a bit more background.
 Let's break down the content of the TSC file.
@@ Line 9: / Line 12: @@
 ==== How to optain the coordinates ====
-Please visit the [[sdk:geographic_coordinates|Geographic Coordinates]] tutorial to see how you can find out the coordinates that you need for your scenery projects.
+Please visit the [[sdk:scenery_coordinates|Geographic Coordinates]] tutorial to see how you can find out the coordinates that you need for your scenery projects.
@@ Line 26: / Line 29: @@
 | icao      | This is the unique airport ICAO code (leave empty if it's not an airport or if the airport doesn't have an ICAO identifier) |
 | country   | Country in which this scenery is located  |
-| coordinate_system | Coordinates in this file are defined in this coordinate system. Typically "lonlat" |
+| coordinate_system | Coordinates in this file are defined in this coordinate system. Typically "lonlat". Some also have "web_mercator" |
 | position  | These are the center coordinates (lon/lat in decimal degrees) for your project |
 | height    | Height above ground in meters (usually zero for on ground) |
@@ Line 37: / Line 40: @@
 Individual geometries of the 3D model are used for specific functions such as (generic) objects, ground and decals. These functions are assigned as individual blocks within the tsc file.
+You can defined multiple blocks of the same type if needed.
+Please also read the documentation of the [[sdk:scenery|different object classes]].
+<code>
+        <[list_tmsimulator_scenery_object][objects][]
+            <[tmsimulator_scenery_object][element][0]
+                <[string8][type][ground]>
+                <[string8][geometry][keyw_key_west_intl_rwy]>
+                <[vector3_float64][position][-81.760022 24.554775 0]>
+                <[float64][orientation][0]>
+                <[int32][autoheight_override][-1]>
+            >
+        >
+</code>
 ^Parameter  ^ Description                                               ^
-| type      | Type of geometry that is being defined (object, ground, decal) |
+| type      | Type of geometry that is being defined (object, ground, decal, object_transparent_atc) |
 | geometry  | Name of the object in the 3D model (e.g. ewy_keywest_obj) |
-| position  | Coordinates (lon/lat) and altitude (in meters) where the object should be placed   |
+| position  | Coordinates (lon/lat) and altitude (in meters) where the object should be placed |
+| orientation | Rotates the object above the up axis, angle in degrees   |
+| autoheight_override | Can force the object above ground |
+==== Animated Objects ====
+Animated objects require an animation to be set before exporting. The exporter then creates a .tma file that contains the keyframe animation data. Both the geometry (.tmb file name) as well as the animation file (.tma file name) are then added to the respective lines in the objects_animated elements.
+<code>
+        <[list_tmsimulator_scenery_object_animated][objects_animated][]
+            <[tmsimulator_scenery_object_animated][element][0]
+                <[string8][geometry][animations_guy_talking]>
+                <[string8][animation][animations_guy_talking]>
+                <[vector3_float64][position][11.350648 47.257897 0]>
+                <[float64][rot_in_degree][0]>
+                <[float64][duration][0]>
+                <[float64][time_scale][1]>
+                <[bool][autoheight][true]>
+            >
+        >
+</code>
+^Parameter  ^ Description                                               ^
+| geometry  | File name of the geometry |
+| animation | File name of the animation |
+| position  | Lon/lat coordinates and altitude in meters of the geometry origin (without animations applied) |
+| rot_in_degree | Rotation of the object around the up direction (without animations applied) |
+| duration | Duration of the animation sequence, zero for auto |
+| time_scale | Timelapse factor 1 = real time, 2 = twice the speed, 0.5 = half the speed |
+| autoheight | places object onto the terrain when loaded. When false then the altitude has to be set to meters above mean sea level |
-**Runways**
+==== Runways ====
 Each runway is defined in the tsc as a set of coordinates (lon/lat).
@@ Line 81: / Line 129: @@
 | appltsys1 / ...2   | Approach light system installed for the first and second approach end        |
 | papi1 / ...2       | This side of the of the precision approach path indicators (PAPI)     |
-| reil1 / ...2       | Runway end identifier lights (REIL)     |
+| papi1_glide_slope     | Glide slope angle of the PAPI lights in degrees |
+| papi1_custom_position | Manual offset of the PAPI lights in meters |
+| papi1_spacing         | Distance between individual PAPI lights in meters |
+| reil1 / ...2          | Runway end identifier lights (REIL)     |
 === Approach Lighting System (ALS) ===
@@ Line 132: / Line 183: @@
 | reil_omni | reil  in all directions  |
+==== Helipads ====
-==== Parking Positions ====
+Helipads are defined in the tsc file as well:
-Towards the end of the file you can define individual parking positions.
+Example:
+<code>
+        <[list_tmsimulator_helipad][helipads][]
+            <[tmsimulator_helipad][element][0]
+                <[string8][name][H1]>
+                <[string8][type_name][building]>
+                <[vector2_float64][position][-81.7599657782887 24.5549091932849]>
+                <[float64][radius][8]>
+                <[float64][heading][89.13]>
+                <[float64][height][0]>
+            >
+        >
+</code>
 ^Parameter  ^ Description                                               ^
-| position  | Lon/lat Coordinates of the parking position |
+| name      | Name of the helipad |
+| type_name | Name of the helipad type (e.g. building) |
+| position  | Lon/lat coordinates of the helipad |
+| radius    | Maximum rotor radius in meters |
 | heading   | Direction of the parking position in degrees from true North |
-| name      | Name of the parking position (e.g. West or East apron, etc.)|
+| height    | Height above ground in meters |
+==== Parking Positions ====
+Towards the end of the file you can define individual parking positions.
+Example:
 <code>
         <[list_tmsimulator_parking_position][parking_positions][]
@@ Line 156: / Line 229: @@
         >
 </code>
+^Parameter  ^ Description                                               ^
+| position  | Lon/lat coordinates of the parking position |
+| heading   | Direction of the parking position in degrees from true North |
+| name      | Name of the parking position (e.g. West or East apron, etc.)|