Differences

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

--- sdk:scenery:tutorial [2020/05/10 20:31] – jh
+++ sdk:scenery:tutorial [2020/05/10 20:44] (current) – [Scenery Workshop] jh
@@ Line 1: / Line 1: @@
 ====== Scenery Workshop ======
+We're providing an example airport with our SDK. Please check out the [[sdk:intro|SDK introduction]] for the download links.
 ===== Kingman Example Airport =====
@@ Line 27: / Line 29: @@
 You now have all required intermediate files to start the conversion to Aerofly FS 2 using the Aerofly FS 2 Content Converter.
+===== Notes using the Content Converter =====
+**Note** - These steps have all been completed for the Kingman airport example. You just need to have the Aerofly FS 2 content converter installed to follow this step.
+Before the Aerofly FS 2 Content Converter can be started, several conditions have to be met. Otherwise the Content Converter throws an error and does not proceed.
+  *The input and output folders have to be set to valid file paths that fit the specific folder structure of your machine. To configure these paths edit the 'content_converter_config.tmc' text file in the project folder with a UNICODE capable text editor.
+  *All files referenced by the 3D model file have to be in the input folder.
+  *They have to be 'flat' in the input folder, meaning that they can't be in a sub-folder. If a texture is not found in the same folder as the exported .tgi files, the Content Converter will interrupt the conversion process.
+  *Files that don't belong to the project, especially unused images can cause the Content Converter to fail. If an areal image was used as a positioning guidance it must not be contained in the same folder as the 3D model. Such files can be put into a sub-directory or somewhere else.
+  *All 3D models referenced in the airport .tsc file must have been exported as .tgi files beforehand. For the Kingman airport those are 'kigm_kingman_rwy.tgi', 'kigm_kingman_obj.tgi', 'kigm_kingman_decal.tgi' and 'kigm_kingman_atc.tgi'.
+  *The .tsc file has to be contained within the project folder.
+  *The Content Converter only updates the output files if the intermediate files are newer than the already converted output files.
+===== Starting the Converter =====
+When the above conditions are met the Aerofly FS 2 Content Converter can be executed.
+Within a project folder right click on the file 'content_converter_config.tmc' and select the context menu entry 'Run with Aerofly FS 2 Content Converter'. The Content Converter will then try to convert all intermediate 3D model files (.tgi) and textures in .bmp, .png and .tif format within the current (input) folder.\\ The converted files will be saved in the output directory defined in the .tmc configuration file. Usually, this is the folder 'Aerofly FS 2/scenery/places' in the current Windows user Documents folder. Writing the files into these directories automatically installs the scenery or aircraft for the Aerofly FS 2 Flight Simulator.\\ \\ The converter can also be started by a batch file with the scenery configuration file as a parameter for the Aerofly FS 2 Content Converter executable. An example batch file 'convert_kingman.bat' is provided for the sample airport Kingman, but the file should be edited (right click, edit) before the first execution to confirm the file paths within the batch file are set correctly.
+===== Result =====
+After the converter has finished the scenery should already be installed ready for use in our user documents Aerofly FS 2 folder, inside the scenery/places/ sub directory.