Differences

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

--- sdk:aircraft:definition [2018/09/20 09:43] – [Aircraft Definition] jh
+++ sdk:aircraft:definition [2018/09/20 12:36] (current) – [Aircraft Files] jh
@@ Line 1: / Line 1: @@
 ====== Aircraft Definition======
-An Aerofly FS 2 aircraft is defined in plain [[simulator:text_files|text files]], more specifically a [[aircraft:tmc|description .tmc]] file and several [[aircraft:tmd|.tmd definition]] files. They can be edited with the [[simulator:text_files#recommended_text_editors|recommended text editors]]. The 'aircraftname.[[aircraft:tmd|tmd]]' file contains the main definition of an aircraft as is referred to as 'THE' tmd file. It describes the aircraft as a collection of objects that can have different attributes and connections to each other in an object-oriented approach. Each object in the definition serves a simple purpose but connected to other objects aircraft complexity is created.
+===== Aircraft Folder =====
+All individual aircraft are located in a folder called 'aircraft' which, for all default aircraft, is located in the [[simulator:path#installation_folder|installation folder]] of the Aerofly FS 2 and for custom made user aircraft it is located in the [[simulator:path#user_folder|user folder]]. Inside that 'aircraft' folder there are individual sub-folders for each aircraft. These sub-folders, (e.g. ''aircraft\a320'') contain all the files needed for an aircraft. They can be divided into two groups:
+   * 3D model, textures and sounds files converted into the engine format
+   * Aircraft definition as plain text files
+The folder's name is the internal aircraft name. In the following, we will use xxxx for this internal name. There are no sub-folders except for the repaints.
-===== Aircraft Folder =====
+===== Aircraft Files =====
+An Aerofly FS 2 aircraft is described in few plain [[simulator:text_files|text files]], more specifically a [[aircraft:tmc|description .tmc]] file and several [[aircraft:tmd|definition .tmd]] files. They can be edited with the [[simulator:text_files#recommended_text_editors|recommended text editors]] and have a certain [[simulator:text_files#syntax|syntax]]. The 'aircraftname.[[aircraft:tmd|tmd]]' file is the main definition of an aircraft and is referred to as 'THE' tmd file. This file is split into several sections: The dynamic sections defines the physical behavior of the aircraft, system logic, inputs and controls of the aircraft; the graphics section animates the visual 3D model of the aircraft and the sound section defines the way the aircraft sound files should be played.
-All individual aircraft are located in a folder called ''aircraft'' which is located either in the [[simulator:path#installation_folder|installation folder]] of the Aerofly FS 2 for all default aircraft or in the [[simulator:path#user_folder|user folder]] for all custom made aircraft. Inside that ''aircraft'' folder there are individual sub-folders for each aircraft. These sub-folders, (e.g. ''aircraft\a320'') contain all the files needed for an aircraft. They can be divided into two groups: the 3D model and the aircraft definition.
 ===== File Types =====
-An aircraft in Aerofly FS 2 is defined by the files contained in one folder. The folder's name is the internal aircraft name. In the following, we will use xxxx for this internal name. There are no sub-folders except for the repaints. Aerofly FS 2 and the Aircraft Converter use the following files:
+Let us break down what each file in an Aerofly FS 2 aircraft folder does:
 | Intermediate folder | Aerofly FS 2 aircraft folder | Description |
@@ Line 16: / Line 20: @@
 | xxxx.tgi            |                              | Binary 3D model file created by the export plugins for 3D Studio Max or Cinema 4D.                                           |
 |                     | xxxx.tmb                     | Binary 3D model that contains information like the vertex positions, texture coordinates, and material/texture assignments. Generated by the converter from the .tgi file. |
-| [[aircraft:tmc|xxxx.tmc]] | [[aircraft:tmc|xxxx.tmc]] | Description file of the aircraft that contains the text shown in the aircraft menu together with the preview image. Also contains parameters to change the initialization of the aircraft: the orientation how the aircraft is placed on the runway, the maximum and minimum airspeed, landing speed and maximum altitude.                                |
+| [[aircraft:tmc|xxxx.tmc]] | [[aircraft:tmc|xxxx.tmc]] | Description file of the aircraft that contains the text shown in the aircraft menu next to the preview image in several languages, the overall size, weight and performance data as well as parameters to define the initialization of the aircraft: the orientation how the aircraft is placed on the runway, the maximum and minimum allowed airspeed, approach speed and maximum altitude.                                |
-| [[aircraft:tmd|xxxx.tmd]] | [[aircraft:tmd|xxxx.tmd]] | Defines camera positions, the complete physics definition of the aircraft including engine and aerodynamic parameters, logic circuits, electrical systems, fuel systems and so on, as well as the graphics animation and sound definition.        |
+| [[aircraft:tmd|xxxx.tmd]] | [[aircraft:tmd|xxxx.tmd]] | Defines camera positions, the complete physics definition of the aircraft including airframe, engine and aerodynamic parameters, logic circuits, electrical systems, fuel systems and so on, as well as the graphics animation and sound definition.        |
 | [[aircraft:tmd_preset|xxxx_takeoff.tmd xxxx_clean.tmd xxxx_landing.tmd]] | [[aircraft:tmd_preset|xxxx_takeoff.tmd xxxx_clean.tmd xxxx_landing.tmd]] | Used to set certain dynamics parameters that should be different from the standard values in the 'xxxx.tmd' for different aircraft configurations. When placed on the runway the takeoff configuration is set. Landing configuration is set when an approach location is selected, clean configuration otherwise. |
 |                     | [[aircraft:controls|controls.tmd]] | Defines positions and sizes where interaction with the mouse or VR controllers is possible.                                     |
@@ Line 28: / Line 32: @@
 |                     | .tsb                       | Converted sound files that are created from .wav files by the converter tool. |
 | model.tmc           |                            | Configuration file for aircraft conversion. Used to set non-default values for texture sizes, bump map strength and texture parameters if necessary. |
+**Note**
 The '.tgi', '.tmc' and '.tmd' files must have the same name as the folder / must use the aircraft's internal name, in our case 'xxxx.tgi', 'xxxx.tmc' and 'xxxx.tmd'.