| **🇫🇷 Français | 🇬🇧 English** |
✅ DÉPÔT OFFICIEL
Ce dépôt GitHub est le dépôt officiel d’ORTHO4XP V3.
ORTHO4XP V3 est développé et maintenu par Roland (Ypsos), dans le respect du projet original Ortho4XP, créé par Oscar Pilote.
Les forks, versions renommées ou projets dérivés sont des projets indépendants.
Pour télécharger la version officielle et obtenir les dernières mises à jour, utilisez toujours ce dépôt GitHub.
Conçue, réalisée et maintenue par Roland (Ypsos) — assisté de Claude (IA, Anthropic) comme outil d’aide au développement.
La version moderne d’Ortho4XP
Installation automatique • Sans terminal • Pour X-Plane 12
Ortho4XP V3 est libre sous GPL v3. D’autres projets peuvent reprendre son architecture et ses modules. C’est l’esprit du logiciel libre.
Règle de la licence : lorsqu’une partie du travail développé pour ORTHO4XP V3 est réutilisée, la paternité d’origine doit être conservée. La stabilité et la compatibilité des versions dérivées ne sont pas garanties.
La version officielle maintenue ici reste gratuite, sans demande de donation ni bouton de soutien financier.
Dépôt officiel : https://github.com/Ypsos/ORTHO4XP_V3
| Logiciel original | Créé par Oscar Pilote → github.com/oscarpilote/Ortho4XP |
| Version 1.40 maintenue | Fork par Shred86 → github.com/shred86/Ortho4XP |
| Cette V3 | Refonte modernisée par Roland (Ypsos), autour du moteur d’origine préservé — assisté de Claude (Anthropic) |
Auteur principal de l’architecture moderne V3 (Event Bus, Pipeline, Memory Manager, Provider Scoring, Altimétrie, JOSM, Correction image, Visualisateur, etc.) : Roland (Ypsos).
Cette version reste la référence officielle et la plus à jour du projet original.
Ortho4XP est un outil puissant, longtemps réservé à ceux qui acceptaient le terminal, Python manuel et les fichiers de configuration. La V3 repose sur trois principes :
Le moteur d’origine est préservé. Le calcul du mesh (cœur du travail d’Oscar Pilote) n’a pas été touché. Tous les ajouts sont des modules autonomes : si l’un manque ou échoue, Ortho4XP démarre et fonctionne quand même.
Les barrières tombent. Installation en un clic, aucun terminal, opérations autrefois manuelles devenues des boutons : retouche des textures, édition OSM dans JOSM, emprises de provider, nivellement, aéroports. Exemple : la procédure altimétrique de 41 étapes manuelles dans QGIS tient désormais dans un seul clic.
De nouvelles capacités apparaissent. Mer photoréaliste conforme aux orthophotos, correction colorimétrique adaptée au zoom et validée pour le HDR de X-Plane 12, notation automatique de la qualité des images, surveillance mémoire… Rien de tout cela n’existe dans les versions antérieures.
En résumé : un simmer doit pouvoir fabriquer ses tuiles sans jamais écrire une ligne de code — et obtenir un meilleur résultat qu’auparavant.
| Fonctionnalité | Ortho4XP 1.40 (Shred86) | Ortho4XP V3 (Roland) |
|---|---|---|
| Installation | Scripts bash/bat manuels dans le terminal | ✅ Launcher graphique — 1 clic, aucun terminal |
| Python | Non géré automatiquement | ✅ Python 3.12 détecté et installé automatiquement |
| Environnement | Dépendances sur le système hôte | ✅ Environnement isolé venv/ — système intact |
| Compatibilité | macOS Intel, Windows | ✅ Apple Silicon M1–M4, Intel, Windows 10/11, Linux |
| Performance | Python 3.x standard | ✅ Python 3.12 — 15 à 20 % plus rapide sur les calculs mesh |
| Détection matériel | Manuelle | ✅ Sentinelle CPU/RAM — slots sécurisés automatiques |
| Lancement | Terminal obligatoire | ✅ Lanceur natif .app / .vbs / .desktop |
| Interface | Fenêtre standard | ✅ Interface adaptée 4K — polices agrandies automatiquement |
| GDAL / rasterio | osgeo.gdal (dépendance système) | ✅ rasterio dans venv — 100 % autonome |
| Transparence eau XP12 | Non géré — tuiles BC1 opaques | ✅ Transparence native XP12 — textures BC3 avec canal alpha |
| Patches mer photoréalistes | Absent | ✅ Générateur intégré — mer conforme aux orthophotos |
| Providers / Zoomlevel mer | — | ✅ Compatible tout provider (BI, Esri, IGN…) et tout ZL |
| Color Normalize | Absent | ✅ Correction colorimétrique automatique vers sRGB neutre |
| Color Check | Absent | ✅ Interface de vérification et correction des couleurs |
| Correction d’imagerie | Aucune | ✅ Module dédié — visualisation DDS, retouche externe, retéléchargement ciblé |
| Altimétrie / DEM | Configuration manuelle | ✅ Module dédié — structure de dossiers auto, préparation des fichiers |
| Bathymétrie | Absent | ✅ Module dédié — intégration des données de profondeur / relief sous-marin |
| Édition OSM (JOSM) | Manipulation manuelle des fichiers | ✅ Module Avancé — JOSM lancé automatiquement, fichiers protégés |
| Emprises / Extents | Écriture manuelle des .ext |
✅ Dessin dans JOSM → publication auto en .ext + archive OSM ; génération par pays (noms FR/EN, relance auto si serveur occupé) |
| Nivellement / Aéroports | Patches à écrire à la main | ✅ Modèles générés auto, code OACI lu dans les données de la tuile |
| Altimétrie : procédure QGIS | 41 étapes manuelles + tableur .ods |
✅ Un seul bouton — reprojection, découpe, fusion et custom_dem auto |
| QGIS | — | ✅ Intégré au module Altimétrie — mémorisé et ouvert sur le résultat |
| Qualité des providers | Aucune mesure | ✅ Scoring automatique — bruit, compression, nuages, dérive, risque de jointure |
| Gestion mémoire | Aucune | ✅ Surveillance RAM en temps réel et nettoyage automatique du cache |
| Previews | Basique | ✅ Outil Previews avec curseurs et configuration visuelle |
| Console de log | Fenêtre figée | ✅ Barre de défilement + navigation clavier |
| Robustesse réseau | Échec sur serveur occupé | ✅ Rotation des serveurs Overpass, reprise auto, gestion des dalles blanches |
| Langues | Anglais | ✅ Interface complète français et anglais |
| Portabilité | Lié au système | ✅ Dossier autonome — déplaçable sur disque externe |
| Validation XP12 | Non testée spécifiquement | ✅ Tuiles produites et validées dans X-Plane 12 |
Bouton 🛠 Avancé (JOSM) : gère de bout en bout les travaux d’édition géographique autrefois manuels.
| Vous voulez… | Le module s’occupe de… |
|---|---|
| Définir une emprise de provider | Créer le fichier d’édition, ouvrir JOSM, puis publier automatiquement l’emprise (.ext + archive OSM) |
| Niveler un terrain | Générer le patch de la tuile avec le bon tag d’altitude |
| Corriger un aéroport ou une piste | Lire le code OACI dans les données de la tuile et nommer le patch correctement |
| Modifier les données OSM | Proposer un bouton par couche présente (eau, trait de côte, aéroports, routes) |
ℹ️ JOSM et QGIS ne sont pas fournis. Installez-les depuis leurs sites officiels ; l’interface les mémorise et les lance ensuite automatiquement.
Intégrer un MNT demandait 41 étapes manuelles dans QGIS + un tableur .ods. Le module le fait en un clic :
| Étape manuelle | Ce que fait le module |
|---|---|
| Raster / Projections / Warp | Reprojection auto en EPSG:4326 (système source lu dans le fichier) |
| Changement NoData | Appliqué automatiquement |
| Calcul d’emprise dans le tableur | Découpe à l’emprise de la tuile + débord 0,1° pour raccord sans couture |
| Raster / Divers / Fusion | Fusion des dalles |
| Export + saisie du champ DEM | Écriture du .tif final et renseignement auto de custom_dem |
Le module crée aussi la structure de dossiers au premier lancement. Les fichiers sources ne sont jamais modifiés. Liens symboliques acceptés.
QGIS à portée de main : boutons « Choisir QGIS » et « Ouvrir dans QGIS » mémorisent l’installation et ouvrent le .tif produit.
Tous sont autonomes : aucun fichier du moteur d’origine n’est modifié. Si un module manque, Ortho4XP démarre quand même.
| Module | Apport |
|---|---|
| Patches mer | Mer conforme aux orthophotos, tout provider et ZL — fin du damier bleu et des triangles transparents |
| Color Normalize | Correction sRGB neutre adaptée au zoom (forte en vue large, légère en ZL18+). Validation HDR XP12 |
| Color Check | Comparaison avant/après, aperçu de fusion, correction par lot, masques de protection |
| Color Apply | Applique les corrections au bon moment de la chaîne. Sources jamais modifiées |
| Correction d’imagerie | Visualise les textures, sélection, retouche externe (GIMP…), regénération ciblée |
| Altimétrie / DEM | Procédure QGIS de 41 étapes → 1 bouton |
| Bathymétrie | Intégration des données de profondeur / relief sous-marin |
| Avancé (JOSM) | Édition géographique, emprises, nivellement, aéroports |
| Provider Score | Note chaque image : bruit, compression, nuages, dérive, risque de jointure — désigne le meilleur provider |
| Gestion mémoire | Surveillance RAM temps réel + nettoyage auto avant saturation |
Plusieurs thèmes sont disponibles. L’utilisateur peut modifier un tableau existant ou créer des couleurs personnalisées à partir d’une roue de couleur.
Fenêtre de sélection des textures à modifier :
Choix de l’application de retouche (exemple : GIMP) :
Outil qui ajoute le support du provider PCRS_IGN et un générateur automatique de fichiers .lay.
Fonctionnalités :
.lay 100 % automatisée (O4_lay_generator.py)O4_Custom_URL.pyPresets intégrés : IGN Ortho France (France + DOM-TOM) et PCRS_IGN
Crédit preset IGN Ortho France : contribution de domisilasol (Dominique), X-Plane.fr
Analyse automatique multicritères des fournisseurs d’imagerie (Bing, ESRI, Google, etc.).
Fonctionnalités :
Gestion des droits : fenêtre d’avertissement pour les fournisseurs réservés à un usage strictement personnel. Le choix « Je quitte » empêche l’utilisation des sources interdisant la redistribution gratuite des tuiles.
Création visuelle des fichiers .comb (fournisseurs, zones, priorités) via le bouton 🛠 Avancé.
Fonctionnalités principales :
.comb préexistant.laySécurité :
Nouveau bouton « 📄 Pas à pas — utilisation des modules » dans le menu Avancé.
Docs/ et liste automatiquement les tutoriels disponiblesConvention de nommage : <Titre>_FR.pdf et <Titre>_EN.pdf dans Docs/.
Fichier modifié : src/O4_Menu_Avance.py (aucun fichier de langue impacté).
⚠️ Étape obligatoire avant tout — Téléchargez d’abord le lanceur pré-nettoyé (sans blocage Gatekeeper) :
⬇️ Télécharger le lanceur Mac pré-installé
ORTHO4XP_V3Lanceur_Installation_Prerequis.app directement dans le dossier ORTHO4XP_V3ORTHO4XP_V3 dans votre dossier Applications (/Users/votre_nom/Applications/)Lanceur_Installation_Prerequis.appLANCEUR_INSTALL_WINDOWS.batLANCEUR_INSTALL_LINUX.shMerci en particulier à Jojo, référence technique sur Ortho4XP, QGIS et JOSM ; et à Cricri, pour les tests et validations sous Windows et Linux.
Merci à domisilasol (Dominique) pour la correction du triangulateur triangle.exe sous Windows : recompilation pour Windows 64 bits d’un bug qui empêchait la génération des fichiers de maillage (.1.node / .1.ele) lors de la création d’emprises. Source et binaire fournis, conformément à la licence de Triangle (Jonathan R. Shewchuk).
Merci à Len0y pour avoir proposé et contribué à séparer le « provider scoring » en une étape 4 dédiée, distincte de la génération DSF (étape 3) — permettant de lancer la notation des providers séparément, une fois tous les réglages vérifiés.
Merci à Jasum pour la proposition et le cahier des charges de l’assistant graphique de fichiers .comb (O4_comb_generator.py).
Merci également à tous ceux qui remontent leurs retours sur les forums.
| Idée, conception, réalisation, développement | Roland (Ypsos) |
| Assistance au développement (outil IA) | Claude (Anthropic) |
| Œuvre originale | Oscar Pilote (Ortho4XP) |
| Adaptation 1.40 | Shred86 |
| Référence technique | Jojo |
| Tests Windows / Linux | Cricri |
| Autres contributeurs | domisilasol(Dominique), Jasum, Len0y |
Distribué sous GNU GPL v3 dans le respect de la licence du projet original.
Voir AVERTISSEMENT_LICENCE_LEGAL.md pour les détails complets.
JOSM, QGIS et GIMP sont des logiciels tiers indépendants, distribués sous leurs propres licences.
Données altimétriques (relief) : Modèles numériques de terrain LiDAR de Sonny — Sonny’s LiDAR Digital Terrain Models of Europe — disponibles sur sonny.4lima.de. Licenciés sous Creative Commons Attribution 4.0 (CC BY 4.0).
✅ OFFICIAL REPOSITORY
This GitHub repository is the official repository for ORTHO4XP V3.
ORTHO4XP V3 is developed and maintained by Roland (Ypsos), in respect of the original Ortho4XP project created by Oscar Pilote.
Forks, renamed versions, or derivative projects are independent projects.
To download the official version and get the latest updates, always use this GitHub repository.
Developed and maintained by Roland (Ypsos) with assistance from Claude AI (Anthropic).
The modern version of Ortho4XP
Automatic installation • No terminal required • For X-Plane 12
Ortho4XP V3 is free software under GPL v3. Other projects may reuse its architecture and modules. This is the spirit of open source.
License rule only: when part of the work developed for ORTHO4XP V3 is reused, the original authorship must be preserved. Stability and compatibility of derivative versions are not guaranteed.
The official version maintained here remains completely free, with no donation requests or support buttons.
Official repository: https://github.com/Ypsos/ORTHO4XP_V3
| Original software | Created by Oscar Pilote → github.com/oscarpilote/Ortho4XP |
| Maintained Version 1.40 | Fork by Shred86 → github.com/shred86/Ortho4XP |
| This V3 | Complete overhaul by Roland (Ypsos) with assistance from Claude (Anthropic AI) |
Main author of the modern V3 architecture (Event Bus, Pipeline, Memory Manager, Provider Scoring, Altimetry, JOSM, Image Correction, Viewer, etc.): Roland (Ypsos).
This version remains the official reference and the most up-to-date version of the original project.
Ortho4XP is a powerful tool, but for a long time it was only within reach of those willing to open a terminal, install Python by hand and write configuration files. V3 rests on three principles:
The original engine is preserved. The mesh computation (the heart of Oscar Pilote’s work) has not been touched. Every addition is a self-contained module: if one is missing or fails, Ortho4XP still starts and works.
The barriers come down. One-click installation, no terminal, and operations once reserved for experts turned into buttons: texture retouching, OSM editing in JOSM, provider extents, terrain flattening, airports. The clearest example: the elevation workflow — 41 manual steps in QGIS — now fits into a single click.
Entirely new capabilities appear. A photorealistic sea matching the orthophotos, colour correction adapted to the zoom level and validated for X-Plane 12 HDR, automatic quality rating of every downloaded image, memory monitoring… None of this exists in earlier versions.
In short: a simmer should be able to build tiles without ever writing a line of code — and get a better result than before.
| Feature | Ortho4XP 1.40 (Shred86) | Ortho4XP V3 (Roland) |
|---|---|---|
| Installation | Manual bash/bat scripts in the terminal | ✅ Graphical launcher — 1 click, no terminal |
| Python | Not managed automatically | ✅ Python 3.12 detected and installed automatically |
| Environment | Dependencies on the host system | ✅ Isolated venv/ environment — system untouched |
| Compatibility | macOS Intel, Windows | ✅ Apple Silicon M1–M4, Intel, Windows 10/11, Linux |
| Performance | Standard Python 3.x | ✅ Python 3.12 — 15 to 20 % faster on mesh computations |
| Hardware detection | Manual | ✅ CPU/RAM sentinel — automatic safe slots |
| Launch | Terminal required | ✅ Native launcher .app / .vbs / .desktop |
| Interface | Standard window | ✅ 4K-ready interface — fonts enlarged automatically |
| GDAL / rasterio | osgeo.gdal (system dependency) | ✅ rasterio inside venv — 100 % self-contained |
| XP12 water transparency | Not handled — opaque BC1 tiles | ✅ Native XP12 transparency — BC3 textures with alpha channel |
| Photorealistic sea patches | Absent | ✅ Built-in generator — sea matching the orthophotos |
| Sea providers / Zoom level | — | ✅ Works with any provider (BI, Esri, IGN…) and any zoom level |
| Color Normalize | Absent | ✅ Automatic color correction toward neutral sRGB |
| Color Check | Absent | ✅ Color verification and correction interface |
| Imagery correction | None | ✅ Dedicated module — view tile textures, retouch externally, targeted re-download |
| Elevation / DEM | Manual configuration | ✅ Dedicated module — folder structure created automatically, file preparation |
| Bathymetry | Absent | ✅ Dedicated module — integration of depth data / underwater relief |
| OSM editing (JOSM) | Manual file handling | ✅ Advanced module — JOSM detected and launched automatically, files protected |
| Extents | .ext files written by hand |
✅ Draw the extent in JOSM → automatic publication as .ext + OSM archive; by-country generation (FR/EN names, auto-retry if the server is busy) |
| Flattening / Airports | Patches written by hand | ✅ Templates generated automatically, ICAO code read from the tile data |
| Elevation: QGIS procedure | 41 manual steps in QGIS + .ods spreadsheet |
✅ A single button — reprojection, clipping, merging and custom_dem filled in automatically |
| QGIS | — | ✅ Built into the Elevation module — remembered and opened on the result |
| Provider quality | No measurement | ✅ Automatic scoring — noise, compression, clouds, colour drift, seam risk |
| Memory management | None | ✅ Real-time RAM monitoring and automatic cache cleanup |
| Previews | Basic | ✅ Previews tool with sliders and visual configuration |
| Log console | Frozen window | ✅ Scrollbar + keyboard navigation |
| Network robustness | Failure on busy server | ✅ Overpass server rotation, auto retry, white-tile handling |
| Languages | English | ✅ Full French and English interface |
| Portability | Tied to the system | ✅ Self-contained folder — movable to an external drive |
| XP12 validation | Not specifically tested | ✅ Tiles produced and validated in X-Plane 12 |
A 🛠 Advanced (JOSM) button opens a window that handles geographic editing tasks end-to-end.
| You want to… | The module takes care of… |
|---|---|
| Define a provider extent | Creating the editing file, opening JOSM, then automatically publishing the extent (.ext + OSM archive) |
| Flatten terrain | Generating the tile patch with the correct altitude tag |
| Fix an airport or a runway | Reading the ICAO code from the tile data and naming the patch correctly |
| Edit OSM data | Offering one button per layer actually present (water, coastline, airports, roads) |
ℹ️ JOSM and QGIS are not bundled. Install them from their official websites; the interface remembers them and launches them automatically afterwards.
Until now, adding a digital elevation model meant a 41-step manual procedure in QGIS plus an .ods spreadsheet. The Elevation module does that work in one click:
| Step of the manual procedure | What the module does |
|---|---|
| Raster / Projections / Warp | Automatic reprojection to EPSG:4326 (source coordinate system read from the file) |
| Changing the NoData value | Applied automatically |
| Working out the extent in the spreadsheet | Clipping to the tile extent, widened by the 0.1° overlap margin |
| Raster / Miscellaneous / Merge | Tiles merged |
| Export then filling in the DEM field | Final .tif written and custom_dem filled in automatically |
The module also creates the folder structure on first launch. Source files are never modified. Symbolic links are accepted.
QGIS stays within reach: the “Choose QGIS” and “Open in QGIS” buttons remember your installation and open the produced .tif directly.
They all follow the same design rule: a self-contained file that modifies no part of the original engine. If a module is missing or fails, Ortho4XP still starts and works.
| Module | What it brings |
|---|---|
| Sea patches | Sea matching the orthophotos, any provider and zoom level — no more blue checkerboard or transparent triangles |
| Color Normalize | Automatic colour correction toward neutral sRGB, adapted to the zoom level. X-Plane 12 HDR validation |
| Color Check | Before/after comparison, fusion preview, batch correction, protection masks |
| Color Apply | Applies saved corrections at the right point in the chain. Source files are never modified |
| Imagery correction | Displays tile textures, lets you select them, retouch in an external editor (GIMP…), regenerate only what needs it |
| Elevation / DEM | The 41-step QGIS procedure reduced to one button |
| Bathymetry | Integration of depth data / underwater relief |
| Advanced (JOSM) | Geographic data editing, extents, terrain flattening and airports |
| Provider Score | Rates every downloaded image: noise, compression artefacts, cloud cover, colour drift, seam risk — points to the best provider |
| Memory management | Monitors RAM in real time and clears the cache before saturation |
Several interface colors are already available. Users can modify colors within an existing palette or create custom colors using a color wheel.
Selecting the textures to edit:
Choosing the image editor (example: GIMP):
This tool adds PCRS_IGN provider support and an automatic .lay configuration file generator.
What the tool does:
.lay generation (O4_lay_generator.py)O4_Custom_URL.pyBuilt-in presets: IGN Ortho France (France + overseas territories) and PCRS_IGN
IGN Ortho France preset credit: contribution from domisilasol (Dominique), X-Plane.fr
Automated multi-criteria analysis system for satellite imagery providers (Bing, ESRI, Google, etc.).
Features:
Rights Management & Distribution Protection: Integrated warning window for providers restricted to strictly personal use. Selecting “Exit” prevents the use of sources that prohibit free redistribution of tiles.
Until now, creating .comb files required a text editor. This is now fully automated and visual via the 🛠 Advanced button.
Key Features:
.comb file.lay generatorSecurity:
New button « 📄 Step-by-step — using the modules » in the Advanced menu.
Docs/ folder and lists available tutorials automaticallyNaming convention: <Title>_FR.pdf and <Title>_EN.pdf in Docs/.
Modified file: src/O4_Menu_Avance.py (no language file impacted).
⚠️ Mandatory first step — First download the pre-cleaned launcher (no Gatekeeper block):
⬇️ Download the pre-installed Mac launcher
ORTHO4XP_V3Lanceur_Installation_Prerequis.app directly into the ORTHO4XP_V3 folderORTHO4XP_V3 folder into your Applications folder (/Users/your_name/Applications/)Lanceur_Installation_Prerequis.appLANCEUR_INSTALL_WINDOWS.batLANCEUR_INSTALL_LINUX.shSpecial thanks to Jojo, the technical reference on Ortho4XP, QGIS and JOSM; and to Cricri, for testing and validating on Windows and Linux.
Thanks to domisilasol (Dominique) for the fix of the triangle.exe mesh generator on Windows: recompiled for 64-bit Windows to solve a bug that prevented the mesh files (.1.node / .1.ele) from being generated during extent creation. Source and binary provided, in accordance with the Triangle license (Jonathan R. Shewchuk).
Thanks to Len0y for proposing and contributing the separation of “provider scoring” into a dedicated step 4, distinct from the DSF build (step 3) — allowing provider scoring to be run separately, once all settings have been checked.
Thanks to Jasum for the proposal and specification of the graphical .comb file assistant (O4_comb_generator.py).
Thanks as well to everyone posting feedback on the forums.
| Idea, design, implementation, development | Roland (Ypsos) |
| Development support (AI tool) | Claude (Anthropic) |
| Original work | Oscar Pilote (Ortho4XP) |
| 1.40 adaptation | Shred86 |
| Technical reference | Jojo |
| Windows / Linux testing | Cricri |
| Other contributorss | domisilasol(Dominique), Jasum, Len0y |
Distributed under GNU GPL v3 in accordance with the license of the original project.
See AVERTISSEMENT_LICENCE_LEGAL.md for full details.
JOSM, QGIS and GIMP are independent third-party applications, distributed under their own licenses.
Altimetric data (relief): Sonny’s LiDAR Digital Terrain Models of Europe — available on sonny.4lima.de. Licensed under Creative Commons Attribution 4.0 (CC BY 4.0).