Have you:
- Built dozens if not hundreds of Ortho4XP tiles, but now get mysterious crashes when scenery tries to load?
- Had your Ortho4XP process crash during the night and don't know which tiles completed successfully?
I have. So I wrote a utility to scan through all the Ortho4XP tiles and validate them, reporting any tiles that have errors so I can fix them in Ortho4XP.
If you already have Python(v3) installed and working, you can use
pip3
to install:
$ pip3 install otv
Otherwise, head over to GitHub or PyPi and download the latest release.
There are three ways to run the program:
If you installed via the
pip3
installer, you'll have an executable named otv available, so you should be able to:- cd into your Ortho4XP directory
- run
otv
Download the latest release from PyPi or GitHub and extract it into a folder. From the command line, run:
python3 bin/otv YourOrtho4XPdir
(Obviously; change "YourOrtho4XPdir" to wherever you've stored your Ortho Tiles)
If you're on windows, and prefer an EXE, download the latest release from GitHub or PyPi, then:
- Extract the package (anywhere on your filesystem)
- Create a shortcut from
bin/otv.exe
on your desktop (must be a shortcut). - Go to the Properties of the shortcut and change the "Start In" field to point to your Ortho4XP directory.
Then you can simply double click the shortcut to run the utility anytime.
Running otv without any additional arguments will give you a help message:
usage: Ortho4XP Tile Validator [-q | -v] [-p | --no-pause] [--no-progress] [-h] [--version] [tile_directory] Scan all Ortho4XP Tiles and report any problems positional arguments: tile_directory Directory where Tiles are stored (usually your Ortho4XP dir) - If not provided; will use the current directory display output: -q, --quiet Suppresses all output; exit value indicates errors found -v, -V, --verbose Increase verbosity (repeat to increase verbosity more) alter defaults: -p, -P, --pause Pause the program before exiting (default for Windows) --no-pause Disable auto-pause --no-progress Disables the progress bar display help and information: -h, --help show this help message and exit --version show program's version number and exit
Currently, it checks for things like:
- missing or empty data directories (Earth Nav Data, Terrain, Textures)
- missing references to textures from each terrain file
- textures which exist but aren't referenced from a terrain
You can find the pip page on PyPi and the source code on GitHub (both provide package downloads)
OTV is currently in beta, so if you're interested, please try it out and let me know how it works for you. I would appreciate any feedback and/or bug reports.
- On Windows, the utility will pause after each run, even if running
from a command line. This is done because most Windows users will be
running the util from a Shortcut, so the pause is necessary without
having to specifically add it. You can use the
--no-pause
option to disable this functionality