Skip to main content

Ortho4XP Tile Validator

Project description

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.

Getting Started

There are three ways to run the program:

  1. If you installed via the pip3 installer, you’ll have an executable named otv available, so you should be able to:

    1. cd into your Ortho4XP directory
    2. run otv
  2. Download the latest release from PyPi or GitHub and extract it into a folder. From the command line, run:

    python3 bin/ovt YourOrtho4XPdir

    (Obviously; change “YourOrtho4XPdir” to wherever you’ve stored your Ortho Tiles)

  3. If you’re on windows, and prefer an EXE, download the latest release from the GitHub Releases page, then:

    1. Extract and unzip bin/ (save it anywhere)
    2. Create a shortcut to the unzipped otv.exe on your desktop (must be a shortcut).
    3. Go to the Properties of the shortcut and change the “Start In” field to point to your Ortho4XP directory.
    4. In the Target field, add a ” -P” on the end of the command (i.e. “… otv.exe -P”) - along with any other options you would like.

    Then you can simply double click the shortcut to run the utility anytime.

More Info

  • Running otv without any additional arguments will give you a help message:

    usage: Ortho4XP Tile Validator [-h] [-P] [-q | -v] [-V] [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; use the current directory
    optional arguments:
      -h, --help      show this help message and exit
      -P, --pause     Pause the program before exiting (good for batch files)
      -q, --quiet     Suppresses all output; exit value indicates errors found
      -v, --verbose   Increase output verbosity (may be repeated)
      -V, --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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for otv, version 1.0.0rc6
Filename, size File type Python version Upload date Hashes
Filename, size otv-1.0.0rc6-py3-none-any.whl (10.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size otv-1.0.0rc6.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page