2018-07-07 07:04:23 +08:00
## fg-from-scratch
Windows utility to download, compile, and stage TerraGear and its dependencies
2019-09-30 11:41:01 +08:00
Copyright (C) 2018-2019 Scott Giese (xDraconian) scttgs0@gmail.com
2018-07-07 07:04:23 +08:00
### Purpose:
2019-09-30 11:41:01 +08:00
Simplify the process of producing a working version of the OSG, SimGear, FlightGear, and TerraGear for Windows users.
2018-07-07 07:04:23 +08:00
If you find this script useful, or not useful, please share your experience with me via a brief email.
### Approach:
Rather than leveraging the popular Win.3rdParty download, this script compiles all dependencies
on your hardware. This eliminates many of the problems associated with mixed compilation in which
2019-09-30 11:41:01 +08:00
your compiled binary comes into conflict with 3rd-party binaries.
2018-07-07 07:04:23 +08:00
2019-09-30 11:41:01 +08:00
vcpkg is leveraged to download and compile all the dependencies required.
2018-07-07 07:04:23 +08:00
### Supported Platform:
Windows 10
### Prerequisites:
2019-09-30 11:41:01 +08:00
Visual Studio Community 2017 +
2018-07-07 07:04:23 +08:00
https://www.visualstudio.com/downloads/
Include the C++ package which includes the MSVC 19.14 compiler
2019-09-30 11:41:01 +08:00
CMake 3.11.3 +
2018-07-07 07:04:23 +08:00
https://cmake.org/download/
The script assumes the installation folder is c:\Program Files\.
2019-09-30 11:41:01 +08:00
Qt 5.10.1 +
2018-07-07 07:04:23 +08:00
https://www.qt.io/download/
2018-08-02 11:00:51 +08:00
The script assumes the installation folder is C:\Qt\.
2018-07-07 07:04:23 +08:00
2019-09-30 11:41:01 +08:00
Git 2.17.1 +
2018-07-07 07:04:23 +08:00
https://git-scm.com/download/win/
The script assumes the installation folder is reflected on your PATH.
2019-09-30 11:41:01 +08:00
Author's configuration: Visual Studio Community 2019, CMake 3.15.3, Qt 5.13.1, Git 2.18.0
2018-07-07 07:04:23 +08:00
### Recommended:
Before running the script for the first time, set this environment variable:
setx /m VCPKG_DEFAULT_TRIPLET x64-windows
You can execute the above command via a Command Terminal or via Powershell Admin
### Usage:
The script is intended to be run multiple times. During the first execution, all the packages are downloaded and compiled. Any time the script is executed afterward, the packages will update themselves.
2019-09-30 11:41:01 +08:00
< i > Note: Because failures can occur, the script will continue to download packages even after the first execution.< / i >
2018-07-07 07:04:23 +08:00
Run the command script interactively. No log is produced.
fg-from-scratch.cmd
2019-09-30 11:41:01 +08:00
Run the command script and routes STDOUT and STDERR to a log file.
2018-07-07 07:04:23 +08:00
fg-from-scratch.cmd > scratch.log 2>& 1
2019-09-30 11:41:01 +08:00
**Fix for the "White Text" issue** - pass either -wt or - -whitetext as an argument:
fg-from-scratch.cmd -wt > scratch.log 2>& 1
The above command will force the usage of James' customized OSG source repo to leverage his workaround.
2018-07-07 07:04:23 +08:00
Options for monitoring the log file while the script is running:
Start the script and then
- Load the log file into Notepad++ (https://notepad-plus-plus.org/).
- Turn on feature "Monitor" via Notepad++
- **[Preferred]** Load the log file into WinTail (http://www.baremetalsoft.com/wintail/)
2019-09-30 11:41:01 +08:00
### TerraGear Example Project
2018-07-07 07:04:23 +08:00
Refer to CustomSceneryProjects/Test folder for an example of scenery generation.
generate.cmd > generate.log 2>& 1
