User Tools

Site Tools


sdk:aircraft:introduction

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
sdk:aircraft:introduction [2017/02/06 13:30]
jh
sdk:aircraft:introduction [2018/09/30 16:11]
jh [Getting started]
Line 1: Line 1:
 ====== Aircraft Development ====== ====== Aircraft Development ======
-After completing the [[sdk:​aircraft:​tutorial|aircraft tutorial]] we will now take a closer look at the aircraft development process. 
-This section gives a brief overview of how Aerofly FS 2 simulates an aircraft, the units and coordinates systems and the different file types that are used by Aerofly FS 2 and the Aircraft Converter. 
  
-===== Aircraft Folder ​=====+===== Getting Started ======
  
-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.+We recommend starting with the [[sdk:aircraft:tutorial|aircraft tutorial]] that introduces ​the aircraft ​development process step by stepCreating a new aircraft ​can be split into two major objectives: the creation of the [[sdk:​aircraft:​modelling|3D model]] and the [[sdk:aircraft:definition|definition of the aircraft]].
  
-==== Simulation ====+===== Aerofly ​Simulation ​=====
  
-Aerofly FS 2 uses an object-based approach to simulate an aircraft for maximum flexibility. This means that each aircraft is defined in terms of many objects (also called (function) blocks or elements in commercial general purpose simulation packages), instead of a fixed set of variables that every aircraft ​must use. In addition to very general objects that can be used for any type of simulation, there are many objects specialized for flight simulation like aerodynamics forces, engines and propellers, avionics objects and many more. The designer ​of the aircraft is free to add any number of objects and connections to an aircraft by adding it to the dynamics section of the aircraft'​s .tmd file.+Aerofly FS 2 uses an object-based approach to simulate an aircraft for maximum flexibility. This means that each aircraft is defined in terms of many objects (also called (function) blocks or elements in commercial general purpose simulation packages), instead of a fixed set of variables that describes an aircraft as a whole. In short this means that there are a lot of building blocks that all work together to describe the aircraft. In addition to very general objects that can be used for any type of simulation, there are many objects specialized for flight simulation like aerodynamics forces, engines and propellers, avionics objects and many more. The programmer ​of the aircraft is free to add any number of objects and connections to an aircraft by adding it to the dynamics section of the aircraft'​s .tmd file.
  
 Please refer to the [[sdk:​aircraft:​definition|Aircraft Definition]] page of this document for further information. Please refer to the [[sdk:​aircraft:​definition|Aircraft Definition]] page of this document for further information.
  
-==== Units and Coordinate Systems ​==== +===== Limitations ​=====
-Aerofly FS 2 uses the international system of units (SI) exclusively. This means that all lengths and dimensions are meters, masses are in kilograms, forces are in Newtons, power values are in Watts, speeds are in meters per second. +
-Any rotation uses the positive mathematical direction (anti-clockwise),​ and all angles are measured in radians (1 rad = 180/p degrees = 57.3°). +
-Fractions are used instead of percentages (20% would be written as 0.2). +
- +
-The coordinate system the entire aircraft is defined in the 3D model of the aircraft. The origin is usually placed close to the center of gravity but does not have to be. The forward flight direction defines the x-axis of the aircraft'​s coordinate system. +
-The y-axis points towards the left of the aircraft, the z-axis points straight up. One unit in the coordinate system represents a real world length of one meter. The 3D model may use a scale factor which is removed when the aircraft is exported. +
- +
-==== 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: +
- +
-| Intermediate folder | Aerofly FS 2 aircraft folder | Description | +
-|                     ​| ​                             |             | +
-| 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. | +
-| xxxx.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. ​                               | +
-| xxxx.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. ​       | +
-| xxxx_takeoff.tmd xxxx_clean.tmd xxxx_landing.tmd | 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. | +
-| controls.tmd ​       |                            | Defines positions and sizes where interaction with the mouse or VR controllers is possible. ​                                    | +
-| .bmp .tif .png      |                            | Source texture files. Must be square power-of-two bitmaps. BMPs 24 bit RGB only. TIF and PNG RGB or RGBA. Bump maps can use 16 / 48 bit to avoid terracing. | +
-|                     | .ttx                       | Converted and compressed texture files | +
-| preview_xxxx.png ​   |                            | Preview file rendered by the converter | +
-|                     | preview.ttx ​               | Compressed preview texture for aircraft menu | +
-| repaint.tmr ​        | repaint.tmr ​               | Repaint or livery description file defining the repaint'​s name in the user interface. ​                                            | +
-| .wav                |                            | Source sound file. Must be PCM 22050 Hz mono | +
-|                     | .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. | +
- +
-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'​. +
- +
-==== Limitations ​====+
 The Aircraft Converter that comes with this SDK is the same tool we use to convert aircraft. There are no limitations on objects or functions you can use to create your aircraft. The Aircraft Converter that comes with this SDK is the same tool we use to convert aircraft. There are no limitations on objects or functions you can use to create your aircraft.
  
-However, the SDK doesn'​t support custom display programming yet. While you can re-use all existing displays, there is no way to get your display code into the simulator. This will be addressed in future versions of the SDK.  +However, the SDK doesn'​t support custom display programming yet. While you can re-use all existing displays, there is currently ​no way to get your display code into the simulator. This might be addressed in future versions of the SDK. Please contact us directly if you want to implement custom displays.
  
sdk/aircraft/introduction.txt · Last modified: 2018/09/30 16:11 by jh