Differences

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

--- sdk:scenerydev [2020/05/10 18:05] – jh
+++ sdk:scenerydev [2020/05/10 22:10] (current) – [Prerequisites] jh
@@ Line 1: / Line 1: @@
-===== Adding Scenery Objects =====
+====== Adding Scenery Objects ======
 Are you interested in importing objects into Aerofly FS 2 scenery? This is how you do it. Use this tutorial for creating your own objects as well!
@@ Line 6: / Line 6: @@
 ==== Prerequisites ====
-   * **Aerofly SDK Package** - Download it from [[https://www.aerofly.com/aerofly_fs_2/sdk/]]
+   * [[sdk:intro|Aerofly SDK]]
    * A supported 3D modelling software with *.tgi exporter, in this tutorial we used AC3D 8.0.50a
@@ Line 76: / Line 76: @@
 Save your file again.
+==== Export to TGI format ====
-, then use the export function. File – Export – Ipacs TGI files (.tgi) Enter the name  farmhouse and select again our destination directory **\Documents\Aerofly FS 2\aerofly_fs_2_sdk\scenery_workshop\farmhouse**
+When the preparations have been completed we use the export function to create the *.tgi file. Select File – Export – Ipacs TGI files (.tgi) Enter the name e.g. "farmhouse.tgi" and select your intermediate destination directory where all the .bmp textures are located, e.g. **\Documents\Aerofly FS 2\aerofly_fs_2_sdk\scenery_workshop\farmhouse\**
+The TGI Format is the intermediate geometry file that is the same regardless which modeling software you used. This way it doesn't matter which modelling software was used, the file is re-usable even if the modelling software is no longer supported or desired.
 {{:wiki:tutorial_house_export.jpg?400|}}
@@ Line 83: / Line 86: @@
 **Notes**
-   * Please use for your file names only small characters without blanks (IPACS suggests this to avoid problems with cross platform data transfer).
+   * Please use for your file names only small characters without blanks to enable cross platform compatibility
-   * The BMP files have to be squares as in our example (If this is not the case, you have to create a square and perhaps remap the texture position).
+   * The BMP files have to be squares with a power of two as in our example. E.g. 1024 x 1024 or 2048 x 2048. (If this is not the case, you have to create a square and perhaps remap the texture position).
-   * The BMP file requires the addition _color.bmp for the texture file.
+   * The BMP file requires the addition "_color.bmp" for the color texture file.
-You will need 2 more files: **content_converter_config.tmc** and a **farmhouse.tsc** file. Copy them to the directory. This is the final content of our directory.
+==== Converting to Engine Format ====
+You will need 2 more files: **content_converter_config.tmc** and a **farmhouse.tsc** file. You can copy the one from our example airport tutorial and rename the .tsc file to "farmhouse.tsc". Place them into the intermediate directory where the TGI file is located as well as the bmp textures.
 {{:wiki:tutorial_files.jpg?600|}}
-Before you run the final conversion, You will have to calculate the position.
+Before you run the final conversion, You will have to calculate the position of your object so that it shows up at the correct location.
-====Excursion to geographic coordinates====
+Find the coordinates of your desired location for the house as described in the [[sdk:scenery_coordinates|Geographic Coordinates]] wiki page.
-If you want to describe any position on earth in a unified system you may use geographic coordinates (as Aerofly FS 2 does).
+==== Setting the Coordinates in the TSC File ====
-We need 360 degrees to do a full circle, so the earth simplified as a bowl consists of 360 longitude lines. Longitude 0 is defined  through Greenwich, negative to the west  and positive to the east.  They meet again at the opposite side of the earth at -180/+180 degrees.
-It is half of a circle going from north pole to south pole.  So lat +90 is the north pole, 0 is the equator line, -90 is the south pole.
-{{:wiki:tutorial_lat_long.jpg?600|}}
-{{:wiki:tutorial_latlong_color.jpg?700|}}
+Open the file **farmhouse.tsc** with a text editor and change the "position" field.
-**Note** - Make sure that you take the sequence into account: Both ways **Lat/Lon** and **Lon/Lat** are common. (Aerofly FS 2 uses Lon/Lat).
+**Make sure to enter the coordinates as lon/lat (°E °N) and not the other way around** or your house will end up somewhere completely different!
-   * If you want to place an object at a certain position you may use this page for calculations: [[http://en.mygeoposition.com/]]
-   *  Search for Little River, California. We get the first approach to our target position.
-{{:wiki:tutorial_geocode.jpg?700|}}
-It displays Google map worldwide, so we can move and zoom into our desired position. Switch to Satellite, then click with the mouse to the favored point. This opens a window with the appropriate coordinates.
-{{:wiki:tutorial_geocode2.jpg?700|}}
-Open the file **farmhouse.tsc** with a text editor.
 {{:wiki:tutorial_code3.jpg?700|}}
-**Note** - Please compare the values with the coordinates from mygeoposition. You have to change the order of the coordinates, and it's restricted the input to 6 positions after decimal point.
 Open the file **content_converter_config.tmc** with a text editor. **Note** - You will have to enter the object only once.
@@ Line 124: / Line 113: @@
 {{:wiki:tutorial_code4.jpg?700|}}
-Last step: Run the converter. Click file with right mouse button, select Aerofly FS 2 Content Converter
+Last step: Run the converter.
+Click file with right mouse button, select Aerofly FS 2 Content Converter
 {{:wiki:tutorial_converter2.jpg?600|}}
 Do not interrupt the black shell window. After the process is finished, the tm.log documents the result of the conversion. Now there is a new subfolder farmhouse in the scenery places.
 {{:wiki:tutorial_files2.jpg?500|}}
-Start aerofly FS 2, open Location menu, move the map to the north of San Francisco.  Select the airfield Little River
+==== Check the Result ====
+Start Aerofly FS 2, open Location menu, move the map to the north of San Francisco.  Select the airfield Little River
 {{:wiki:little_river.jpg?600|}}
@@ Line 140: / Line 133: @@
 {{:wiki:parking.jpg?400|}}
-The position fits very well to our selection in mygeoposition. Be careful not to burn down the farmhouse with your afterburner.
+In the engine you should now see your new house. Make sure not to burn it down with your afterburners though ;-)
 {{:wiki:house_placement.jpg?600|}}
-**Important notes:**
+The converter has automatically copied the tsc file into your user directory.
+You can also change this file to move the house around without having to start the converter again. Just make sure that you copy your final result into your intermediate directory before you run the converter again.
-   * Rotation of the object has yet to be done in the 3D model. IPACS is aware of this.
-   * You can display coordinates inaerofly FS 2 by Strg – F1.
-   * It shows only 2 decimal places, IPACS may provide another tool for coordinate readout in future version.
-   * You can fine tune the coordinates in the resulting file **farmhouse.tsc** without need for new conversion.
 {{:wiki:tutorial_files3.jpg?400|}}