SpéléoTopo — Aide utilisateur

1) Démarrage

SpéléoTopo est un éditeur/visualiseur de topographie spéléo basé sur VisualTopo .TROX (XML) et un format projet .stopo (JSON).

Barres d’outils et panneau latéral

Par clic droit sur une barre d’outils (zone vide ou poignée), un menu liste les barres avec les titres : Menu Import/Export, Menu Grille, Menu Vue / Préférences, Menu Outils DAO, puis une 5ᵉ option : Étendre l’espace de travail. Cette option masque uniquement le panneau latéral gauche (formulaire cavité, commentaires, zone Diagnostics) pour agrandir la zone blanche de dessin ; toutes les barres du haut restent visibles (ce n’est pas un plein écran). Ctrl+Shift+E permet de rebasculer si le panneau est masqué.

À l’ouverture du programme, le panneau latéral est affiché.

Pour les fichiers : utiliser l’entrypoint sans accent, pour éviter les soucis de chemins/encodage.

2) Formats & flux de travail

• Import source : .trox (VisualTopo XML) — seul format d’entrée.
• Projet : .stopo — sauvegarde : meta cavité, coordonnées, unités, visées, radiales, scraps, surfaces, commentaires, lignes topo, cadres (rectangles), etc.
• Fichier calculé Exports/3D : .stopo2 — généré depuis SpéléoTopo (📦 Générer .stopo2). Contient topo + dessin + préférences + symboles + caches calculés. Aucune entrée depuis .stopo2 dans SpéléoTopo.
• Export SVG : Ctrl+Shift+G — génère un fichier SVG Inkscape-compatible avec calques éditables (zone de travail courante).
• Export PDF : Ctrl+Shift+P — exporte la zone de travail en PDF (options A4/A3, Portrait/Paysage).
• Export KML : Ctrl+Shift+K — génère un fichier .kml compatible Google Earth / QGIS avec stations, cheminement, parois LRUD, radiales, scraps de paroi, surfaces et dossier Cadres (vue PLAN).
• Export Therion : Ctrl+Shift+T — génère un couple .th + .th2 pour Therion / Xtherion : centreline, splays/radiales, LRUD et dessin cartographique en PLAN et en COUPE DÉVELOPPÉE, y compris les cadres dans les .th2.
• Exports 3D : effectués dans ARIS_Speleo3D à partir du .stopo2.

Conseil : conserver le .trox comme source “autorité” et utiliser .stopo pour l’édition carto.

3) Import .TROX

Menu toolbar : 📥 Import .TROX (menu déroulant) :

• Nouveau projet depuis .TROX (Ctrl+I) : charge la topo depuis un .trox et réinitialise les éléments d’édition listés historiquement (scraps, surfaces, lignes topo cartographiques, symboles, textes — comme avant).
• Mise à jour topo depuis .TROX (Ctrl+Shift+I) : uniquement si un fichier .stopo est déjà enregistré sur disque (💾 Sauver). Remplace visées/radiales/meta/units par le .trox, conserve scraps, surfaces, lignes, symboles, textes, cadres, Nord, échelle. Avant import : avertissement + sauvegarde automatique du .stopo courant sous le nom …-Old.stopo (suffixe daté si le fichier existe déjà). Après recalcul topo, recalage automatique du dessin DAO : comparaison des stations (et s_dev) entre le backup et le nouveau calcul, translation moyenne appliquée aux symboles, textes, cadres, Nord, échelles et surfaces en coordonnées absolues ; surfaces ancrées PLAN recalculées depuis les stations. Puis enregistrement du projet mis à jour dans le même .stopo.
• Le fichier doit être un .trox (un .tro n’est pas accepté).
• Après import, l’application construit les stations et calcule les vues PLAN et COUPE DÉVELOPPÉE.
• Les visées radiales sont importées comme radiales (pas de station d’arrivée).

4) Projet .STOPO (.stopo)

Menu toolbar : 📂 Ouvrir .stopo / 💾 Sauver .stopo

• Ouvrir : recharge l’état complet du projet (meta + topo + édition).
• Sauver : enregistre toutes les données du projet courant.

L’entrée Nouveau projet depuis .trox réinitialise l’édition DAO comme auparavant. Pour mettre à jour la topo sans perdre le dessin, utilise Mise à jour topo avec un projet .stopo déjà sauvegardé.

5) Unités & conventions

• Distances : mètres (m)
• Angles : degrés décimaux (deg) (gon acceptés à l’import et convertis si nécessaire)
• LRUD / GDHB : distances en mètres, perpendiculaires au point topo choisi (DimPt Dep/Arr)

6) Coordonnées d’entrée

Dans la sidebar :

• Coordonnée X, Coordonnée Y : stockées dans le projet (mètres si projection métrique).
• Type de coord : combo des référentiels courants (ex. UTM WGS84 — zone 31N (m)).

La valeur choisie est sauvegardée et rechargée depuis le .stopo.

7) Vue PLAN

Toolbar : 🗺️ Plan • 🖼️ Ajuster • Menu Grille : Sans grille / 1 m / 5 m / 10 m

• Affichage 1:1 (pas de déformation) + quadrillage sur toute la zone visible.
• Auto-fit centré au chargement d’un .trox ou .stopo (équivalent du bouton Ajuster).
• Parois : LRUD G/D + radiales (si activées).
• Scraps : wall / detail / water (si activés).
• Lignes topo : lignes métier (paroi, fracture, écoulement, etc.) si activées.
• Surfaces : zones remplies (eau/sable/blocs, etc.) (si activées).

8) Vue COUPE DÉVELOPPÉE

Toolbar : 📈 Coupe (développé/Z) • 🖼️ Ajuster • Menu Grille : Sans grille / 1 m / 5 m / 10 m

• Affiche une coupe développée : X = chaînage développé, Y = altitude Z.
• Affichage 1:1 (pas de déformation) + quadrillage.
• Auto-fit centré au changement de vue et au chargement (comme Ajuster).
• Parois en coupe via H/B (Up/Down) + radiales (si activées).

9) Parois GDHB & radiales

Dans Diagnostics :

• Afficher les parois (LRUD + Radiales) : toggle global.

PLAN

• GD : segments perpendiculaires à l’azimut au point topo (Dep/Arr selon DimPt).
• Radiales : segments depuis la station vers l’extrémité paroi (projection horizontale).

COUPE DÉVELOPPÉE

• HB : segments verticaux au point topo (Dep/Arr), dessinés dans l’espace (x_dev, z).

10) Scraps (PLAN & COUPE DÉVELOPPÉE)

Pré‑requis :

• Afficher le calque : 🧩 Scraps (Menu Grille).
• Éditer : sélectionner l’outil ✏ Scrap (Menu Outils DAO) — raccourci P.

Les scraps sont par vue : un scrap créé en PLAN ne s’affiche pas en COUPE DÉVELOPPÉE, et inversement (filtrage group_id=view:PLAN / view:COUPE_DEV).

Type courant + Snap

• Bouton ⚙ (Scraps) : choix du type courant : wall, detail, water, lower.
• Snap (aimant) : 🧲 Snap (PLAN) + tolérance (0.2 / 0.5 / 1 / 2 m). PLAN uniquement.
• Le champ “Scrap courant” rappelle le scrap sélectionné et/ou le type courant.

Créer un scrap

• Avec l’outil ✏ Scrap : clic gauche + glisser dans une zone vide → polyline freehand.
• Relâcher : le scrap est enregistré dans le projet (.stopo) et “attaché” à 2 stations (proches du début et de la fin).
• Le scrap créé prend le type courant.

Éditer (sommets)

• Clic gauche sur un scrap : sélection (surbrillance) + affichage des poignées.
• Drag gauche sur une poignée : déplacer un sommet (snap optionnel en PLAN).
• Ctrl + clic sur un segment : insère un sommet à l’endroit cliqué (puis drag immédiat).
• Alt + clic sur un sommet : supprime le sommet.

Menu contextuel (clic droit)

• Clic droit (sans glisser) : menu à l’emplacement souris (filtré par l’outil DAO actif).
• Clic droit + glisser : pan (le menu n’apparaît que si le drag n’a pas bougé).
• En outil ✏ Scrap : Sélection, Déplacer (sommet), Ajouter sommet, Ajouter scrap (dessiner), Supprimer, Inverser.

11) Surfaces (PLAN)

Les surfaces sont des zones remplies (polygones) pour matérialiser des éléments comme eau, sable, blocs, etc. Elles sont ancrées sur les stations : si le réseau topo bouge, elles restent cohérentes.

Pré‑requis :

• Afficher le calque : 🟦 Surfaces (Menu Grille).
• Éditer : sélectionner l’outil 🟦 Surface (Menu Outils DAO) — raccourci A.

Les surfaces sont PLAN uniquement (pas d’affichage/édition en COUPE DÉVELOPPÉE).

Type courant + palette

• Bouton ⚙ (Surfaces) : choix du type courant (par défaut : water, sand, blocks).
• Types personnalisés : ➕ Ajouter type… / 🗑 Supprimer type courant (au moins 1 type doit rester).
• Palette (type courant) : couleur de remplissage, couleur de contour, et opacité (valeurs rapides).

Snap (PLAN)

• Toggle : 🧲 Snap (PLAN) + tolérance (0.2 / 0.5 / 1 / 2 m).
• Le snap s’applique au dessin et au déplacement de sommets.
• Commande : 🧲 Snapper tous les sommets (surface sélectionnée).
• Guides utilisés : stations, points LRUD (G/D), extrémités de radiales, et sommets des autres surfaces.

Créer une surface

• Avec l’outil 🟦 Surface : clic gauche + glisser dans une zone vide → polyline freehand.
• Relâcher : la surface est enregistrée dans le projet (.stopo).
• La surface créée prend le type courant.

Éditer (sommets)

• Clic gauche sur une surface : sélection + affichage des poignées.
• Drag gauche sur une poignée : déplacer un sommet (snap optionnel).
• Ctrl + clic sur un bord : insère un sommet.
• Alt + clic sur un sommet : supprime le sommet.

Supprimer

• Suppr / Backspace : supprimer la surface sélectionnée (outil Surface).
• Ou via le menu contextuel : 🗑️ Supprimer surface.

Menu contextuel (clic droit)

• Clic droit (sans glisser) : menu filtré par l’outil DAO actif.
• En outil 🟦 Surface : Sélection, Ajouter sommet, Supprimer sommet, Supprimer surface, et Type courant.

12) Lignes topo / Topo lines

Les lignes topo sont des lignes cartographiques sémantiques destinées à compléter le dessin sans modifier le réseau topographique. Elles sont par vue : une ligne créée en PLAN ne s’affiche ni ne s’édite en COUPE DÉVELOPPÉE, et inversement.

Pré-requis :

• Afficher le calque : 〰 Lignes topo (Menu Grille).
• Éditer : sélectionner l’outil 〰 Ligne topo / Topo line (Menu Outils DAO) — raccourci L.

Types de lignes

• Types métier disponibles : wall, detail, border, water_flow, fracture, slope_break, ceiling_step, floor_step.
• Le menu ⚙ des lignes permet de choisir le type courant et le rôle de contour.

Rôle de contour (outline role)

• none : ligne descriptive sans rôle de contour.
• outer : contour extérieur.
• inner : contour intérieur / séparation interne.
• shared : frontière partagée.

En pratique, les rôles de contour sont surtout pertinents pour les lignes de type wall et border.

Créer une ligne

• En outil 〰 Ligne topo : clic gauche pour ajouter des points successifs.
• Double-clic ou Entrée : terminer la ligne.
• Échap : annuler la ligne en cours.
• Un clic proche du premier point peut servir à fermer la ligne lorsque la géométrie est suffisante.

Éditer

• Clic gauche sur une ligne : sélection.
• Drag gauche sur une poignée : déplacer un sommet.
• Ctrl + clic sur un segment : ajouter un sommet.
• Alt + clic sur un sommet : supprimer un sommet.
• Le menu contextuel permet aussi : déplacer la ligne, inverser, ouvrir/fermer, supprimer.

Scrap, filtres et debug

• Une ligne peut être rattachée au scrap sélectionné ou détachée.
• Les outils d’inspection permettent de filtrer : lignes invalides, sans scrap, par type, par rôle de contour ou par scrap sélectionné.
• Le mode debug peut afficher les labels techniques et colorer les lignes selon outline_role.

PLAN / COUPE DÉVELOPPÉE

• PLAN : rendu en coordonnées planimétriques, utile pour parois, fractures, limites et écoulements.
• COUPE DÉVELOPPÉE : rendu sur le développé/altitude, utile pour marches, plafonds, cassures et détails de coupe.

13) Symboles

Pré‑requis :

• Afficher le calque : 🧷 Symboles (Menu Grille).
• Éditer : sélectionner l’outil 📌 Symbole (Menu Outils DAO) — raccourci S.

Symbole courant + taille

• Bouton ⚙ (Symboles, barre Graphisme) : taille d’insertion (0.5× / 1× / 1.5× / 2×), entrée Aperçu et choix… / Visual picker… (fenêtre avec onglets par catégorie et vignettes du tracé ; l’onglet ouvert correspond au symbole courant lorsque c’est possible), et suppression du symbole sélectionné sur le dessin.
• Le champ « Symbole courant » affiche le libellé du symbole qui sera inséré par Ajouter.
• Menu Vue : ◆ Symboles / Symbols ouvre la planche PDF de référence (Fichier_symboles.pdf), en complément du choix interactif ci‑dessus.

Ajouter un symbole

• En outil 📌 Symbole : clic droit → Symboles → Ajouter.
• Le symbole inséré est le symbole courant (pas forcément le symbole sélectionné).

Sélection / déplacement / rotation

• Clic gauche sur un symbole : sélection.
• Drag gauche : déplacement (par défaut).
• Rotation : attraper la poignée (petit handle) ou clic droit → Rotation, puis drag.
• R : rotation +15° sur le symbole sélectionné.
• Suppr / Backspace : suppression du symbole sélectionné.

PLAN vs COUPE DÉVELOPPÉE

• PLAN : position (x,y) directe.
• COUPE DÉVELOPPÉE : insertion possible si la coupe est “prête” (stations + s_dev). Les symboles sont ancrés à une station (station + ds/dz) pour rester stables si le chaînage évolue.

14) Texte (Titre / Infos / Cartouche / Commentaire)

Pré‑requis :

• Afficher le calque : 📝 Texte (Menu Grille).
• Éditer : sélectionner l’outil 🅣 Texte (Menu Outils DAO) — raccourci T.

Type courant

• Bouton ⚙ (Texte) : choix du type courant : Titre / Infos / Cartouche / Commentaire.
• Le champ “Texte courant” rappelle le type courant (ou un aperçu de la sélection).
• Polices : Préférences → Polices (Titre, Infos, Cartouche, Commentaire).

Ajouter

• En outil 🅣 Texte : clic droit → Texte → Ajouter → choisir le type.
• Une saisie multi‑ligne permet de saisir/modifier le contenu (même pour Titre/Infos/Cartouche).
• Valeurs par défaut : Titre = nom de cavité, Infos = club + altitude + référentiel (si renseignés).

Éditer / déplacer / supprimer

• Clic gauche sur un texte : sélection.
• Drag gauche : déplacer le texte (outil Texte uniquement).
• Clic droit → Éditer / Supprimer (ou via le bouton ⚙ : “Éditer sélection”, “Supprimer sélection”).
• Suppr / Backspace : supprimer la sélection.

Les textes sont enregistrés dans .stopo et inclus dans .stopo2 (pour ARIS_SpeleoExport / ARIS_Speleo3D). Ils sont aussi par vue (group_id=view:PLAN / view:COUPE_DEV).

15) Cadres (rectangles)

Les cadres sont des rectangles vides pour encadrer textes, cartouches ou zones graphiques. Ils sont par vue (PLAN / COUPE DÉVELOPPÉE), enregistrés dans .stopo (frame_items) et pris en charge par les exports listés ci‑dessous.

Pré‑requis : sélectionner l’outil ▢ Cadre / Frame (Menu Outils DAO) — raccourci C.

Créer et éditer

• Clic gauche + glisser sur le vide : nouveau rectangle.
• Clic gauche + glisser sur un cadre existant : déplacement.
• Clic droit (sans glisser) : menu — épaisseur du trait (1 à 5) pour la valeur par défaut ou pour le cadre sélectionné, sélection, suppression, aide rapide.

Exports

• SVG : calques Cadres (PLAN) et Cadres (COUPE_DEV).
• PDF : comme le reste du dessin (rendu canvas, même vue que à l’écran).
• KML : dossier Cadres — seulement les cadres de la vue PLAN, contours fermés géoréférencés (Google Earth / QGIS).
• Therion : dans chaque .th2 (plan et coupe), les cadres sont exportés comme des lignes wall fermées (usage décoratif ; à retravailler dans Xtherion si la sémantique Therion doit être affinée).

16) Diagnostics boucles

Menu Vue / Préférences : 💬 Com — par défaut le panneau bas affiche Diagnostics boucles ; cocher Com affiche les Commentaires.

• Afficher la liste : montre/masque le tableau des boucles.
• Afficher noms des stations : labels sur la vue.
• Afficher parois (LRUD + radiales) : affiche ou masque les parois.
• Masquer le tracé et points Topo : masque réseau/stations (pratique pour carto).
• Étendre l’espace de travail : même action que la 5ᵉ option du menu clic droit sur les barres — masque uniquement le panneau latéral pour agrandir le dessin.

17) Préférences (couleurs/polices)

• Couleurs : styles des traits (cheminement, parois, scraps…).
• Surfaces : palette par type (remplissage/contour/opacité) + snap (PLAN).
• Symboles : mode de couleur globale, par catégorie ou selon le symbole (library), avec épaisseur et transparence.
• Polices : titre, infos, cartouche, commentaire.
• Grille : Sans grille ou pas 1/5/10 m + style.
• Lignes topo : options d'inspection, debug visuel, labels debug, filtres par scrap, type et rôle de contour.

Les préférences sont persistées localement (JSON) dans le dossier utilisateur (~/.speleo_topo/user_parametres.txt).

18) Exports SVG / PDF / KML / Therion

SpéléoTopo permet d’exporter la vue courante, un export géoréférencé pour Google Earth / SIG et un export Therion pour reprise cartographique externe :

Export SVG

• Raccourci : Ctrl+Shift+G
• Menu toolbar : 🖋️ Générer .svg
• Génère un fichier SVG Inkscape-compatible avec calques éditables.
• Exporte le contenu visible (réseau topo, scraps, surfaces, lignes topo, symboles, textes, cadres, Nord, Échelle) selon la vue courante.

Export PDF

• Raccourci : Ctrl+Shift+P
• Menu toolbar : 📄 Export .pdf
• Exporte la zone de travail en PDF, au format A4 ou A3, en portrait ou paysage, avec marges.
• Le PDF suit la vue courante et sert surtout de rendu final imprimable (y compris les cadres, comme sur le canvas).

Export KML

• Raccourci : Ctrl+Shift+K
• Menu toolbar : 🌍 Export .kml (Google Earth)
• Génère un fichier .kml compatible Google Earth Pro et QGIS.
• Exporte selon les options : stations, cheminement, parois LRUD, radiales, scraps de paroi, surfaces et dossier Cadres (PLAN).
• La conversion géographique vers WGS84 est faite à partir de X, Y et du Type de coord du projet.
• L’export KML est destiné à la vue PLAN géoréférencée, pas à la mise en page finale.

Export Therion

• Raccourci : Ctrl+Shift+T
• Menu toolbar : 🦁 Export .th/.th2 (Therion)
• Génère un fichier .th pour la centreline et deux fichiers .th2 pour le dessin : PLAN et COUPE DÉVELOPPÉE.
• Le .th contient les visées, les radiales / splays, les LRUD et un fix sur la première station de référence.
• Les .th2 contiennent les scraps, surfaces, lignes topo, symboles et cadres (rectangles en line wall fermée), avec coordonnées locales en mètres.
• Usage visé : reprise du dessin dans Therion ou Xtherion, pas remplacement du PDF de présentation.

SVG et PDF suivent la vue courante. KML dépend surtout du géoréférencement (cadres PLAN uniquement). L’export Therion produit des fichiers de travail séparés pour la topographie et le dessin (cadres dans les deux .th2).

19) Nord & Échelle

Les outils 🧭 Nord et 📏 Échelle permettent d’ajouter des repères graphiques sur la carte :

Nord (boussole)

• Outil : 🧭 Nord (Menu Outils DAO) — raccourci N
• Disponible uniquement en vue PLAN.
• Ajout / positionnement : clic droit sur le canvas → Ajouter Nord / Positionner.
• Déplacer : clic droit → Déplacer Nord, puis glisser à gauche.
• Clic gauche : ne positionne pas le Nord ; tout passe par le menu contextuel.
• Menu contextuel (clic droit) : Ajouter, Déplacer, Supprimer, Texte gras, Taille, Épaisseur, Zoom clavier ±.

Échelle graphique

• Outil : 📏 Échelle (Menu Outils DAO) — raccourci E
• Barre d’échelle (barrettes métriques) — visible en PLAN ou COUPE selon la vue.
• Ajout / positionnement : clic droit sur le canvas → Ajouter Échelle / Positionner.
• Déplacer : clic droit → Déplacer Échelle, puis glisser à gauche.
• Réglage métier : Valeur par barrette (m) dans le menu contextuel.
• Clic gauche : ne crée pas l’échelle ; l’ajout passe par le menu contextuel.
• Menu contextuel : Valeur par barrette, Ajouter, Déplacer, Supprimer, Taille texte, Épaisseur, Texte gras, sous-menu Afficher l’unité (m) (Oui/Non).

Nord et Échelle sont inclus dans les exports SVG et PDF ; les cadres aussi (voir § 15 et § 18).

20) Raccourcis souris / clavier

Navigation

• Zoom : molette
• Pan : clic droit + glisser
• Menu contextuel : clic droit (sans glisser) sur le canvas (menu filtré par l’outil DAO actif)
• Ajuster : bouton 🖼️ Ajuster (PLAN / COUPE) ou touche F

Aide rapide (« point vert »)

• Barre Menu Grille : icône clavier / pastille verte → Shift+F1 : même contenu que la boîte Aide rapide (raccourcis navigation, DAO, exports…).
• F1 : ouvre l’aide générale (ce fichier Fichier_Aide.html).

Barres d’outils

• Clic droit sur une barre (zone vide ou poignée) : menu des quatre barres (Menu Import/Export, Menu Grille, Menu Vue / Préférences, Menu Outils DAO) + Étendre l’espace de travail.
• Ctrl+Shift+E : basculer « Étendre l’espace de travail » (panneau latéral).

Projet (fichiers)

• Ctrl+I : import .TROX (nouveau projet) • Ctrl+Shift+I : mise à jour topo depuis .TROX (projet .stopo requis)
• Ctrl+O : ouvrir .stopo
• Ctrl+S : sauver le projet
• Ctrl+Shift+2 : générer .stopo2

Exports

• Ctrl+Shift+G : générer le .svg
• Ctrl+Shift+P : exporter le .pdf
• Ctrl+Shift+K : exporter le .kml
• Ctrl+Shift+T : exporter le .th / .th2 Therion

Vue / panneau latéral

• 💬 Com (barre Vue) : coché = Commentaires ; décoché (défaut au lancement) = Diagnostics boucles.

Outils DAO

• H : 🖐 Main (sélection/inspection)
• P : ✏ Scrap (édition scraps)
• L : 〰 Ligne topo (édition lignes topo)
• A : 🟦 Surface (édition surfaces — PLAN)
• S : 📌 Symbole (édition symboles)
• T : 🅣 Texte (édition textes)
• N : 🧭 Nord (boussole — vue PLAN)
• E : 📏 Échelle (barre d’échelle)
• C : ▢ Cadre / Frame (rectangles décoratifs)

Lignes topo

• Création : clics successifs
• Terminer : double-clic ou Entrée
• Annuler : Échap
• Ctrl + clic segment : ajouter un sommet
• Alt + clic sommet : supprimer un sommet
• Suppr/Backspace : supprimer la ligne sélectionnée

Symboles

• Choisir le symbole courant : menu ⚙ (barre Graphisme) → Aperçu et choix… — grille par catégories avec vignettes ; validation au clic sur un symbole.
• Sélection : clic gauche sur un symbole
• Déplacement : drag gauche (outil 📌 Symbole)
• Rotation : drag de la poignée ou clic droit → Rotation
• R : rotation +15° • Suppr/Backspace : supprimer

Scraps

• Dessin : clic gauche + glisser en zone vide (outil ✏ Scrap)
• Déplacer un sommet : drag sur une poignée
• Ctrl + clic segment : ajouter un sommet
• Alt + clic sommet : supprimer un sommet

Surfaces (PLAN)

• Dessin : clic gauche + glisser en zone vide (outil 🟦 Surface)
• Déplacer un sommet : drag sur une poignée (snap optionnel)
• Ctrl + clic segment : ajouter un sommet (insertion sur l’arête la plus proche)
• Alt + clic sommet : supprimer un sommet
• Suppr/Backspace : supprimer la surface sélectionnée

Texte

• Sélection : clic gauche sur un texte
• Déplacement : drag gauche (outil 🅣 Texte)
• Suppr/Backspace : supprimer

Cadres

• Nouveau / déplacer : clic gauche + glisser (outil ▢ Cadre / Frame)
• Menu : clic droit sans glisser — épaisseur, suppression, etc.

21) Dépannage

Le logiciel se ferme sans message

• Le plus fréquent : exception Python non visible (mode exe). Relancer depuis un terminal si possible, ou activer un log si disponible.
• Vérifier que le .stopo est bien un fichier JSON valide (si modifié manuellement).

Je ne vois pas les parois

• Vérifier la case Afficher les parois (LRUD + Radiales).
• En PLAN : seules G/D sont affichées. En COUPE : seules H/B.

Je peux zoomer mais pas me déplacer

• Pan = clic droit + glisser.
• Cliquer d’abord dans la zone de dessin (canvas) pour lui donner le focus.

Le menu contextuel n’apparaît pas

• Le menu est déclenché par clic droit sans glisser (un drag déclenche le pan).
• Si tu as commencé à glisser : relâcher sans déplacement réel (sinon pas de menu).

Je ne peux pas dessiner / éditer un scrap

• Afficher 🧩 Scraps (Menu Grille).
• Sélectionner l’outil ✏ Scrap (raccourci P).

Je ne peux pas dessiner / éditer une surface

• Afficher 🟦 Surfaces (Menu Grille).
• Sélectionner l’outil 🟦 Surface (raccourci A).
• Activer le mode édition ⚙ (Surfaces) si besoin.
• En cas de “points qui accrochent” : désactiver 🧲 Snap (PLAN) ou réduire la tolérance.

Je ne peux pas créer / éditer une ligne topo

• Afficher 〰 Lignes topo (Menu Grille).
• Sélectionner l’outil 〰 Ligne topo (raccourci L).
• Terminer une ligne par double-clic ou Entrée, l’annuler par Échap.
• Si la ligne n’est pas visible, vérifier la vue courante : une ligne PLAN n’apparaît pas en COUPE DÉVELOPPÉE.

Je ne peux pas ajouter un symbole

• Afficher 🧷 Symboles (Menu Grille).
• Sélectionner l’outil 📌 Symbole (raccourci S).
• Définir le symbole courant : menu ⚙ (Symboles) → Aperçu et choix….
• Ajouter via clic droit → Symboles → Ajouter.

Je ne peux pas ajouter un texte

• Afficher 📝 Texte (Menu Grille).
• Sélectionner l’outil 🅣 Texte (raccourci T).
• Ajouter via clic droit → Texte → Ajouter.

Je ne vois pas / ne peux pas créer un cadre

• Sélectionner l’outil ▢ Cadre / Frame (raccourci C).
• Création : clic gauche + glisser sur une zone vide du canvas (pas un simple clic ni un clic droit).
• Un cadre créé en PLAN n’apparaît pas en COUPE DÉVELOPPÉE, et inversement.

Je ne peux pas ajouter le Nord ou l’Échelle

• Sélectionner l’outil 🧭 Nord ou 📏 Échelle.
• L’ajout se fait par clic droit sans glisser sur le canvas, puis via le menu contextuel.
• Un clic gauche ne crée pas ces repères ; il sert surtout au déplacement quand le mode Déplacer a été demandé.

22) Note sur l’auteur

Pascal Mouneyrat est un informaticien (Windev, Python, PHP, JavaScript…), aujourd’hui à la retraite. Spéléologue depuis 1976, ancien conseiller technique secours CT de 1989 à 1995.

Il pratique également la plongée souterraine avec bouteilles et recycleur depuis 1995.

23) L’association ARIS

Pascal Mouneyrat est le webmaster du site spelebase.fr, site de l’ARIS (Association de Recherche et d’Inventaire Spéléologique).

Le site centralise des ressources techniques et met à disposition plusieurs logiciels développés par l’auteur pour la spéléologie, regroupés dans une rubrique dédiée “Logiciels / Applications”.

Le logiciel SpeleoTopo est disponible sur ce site en téléchargement, ainsi que ce document d’aide.

24) Remerciements

Je tiens à souligner les informations recueillies qui m’ont permis de proposer ce logiciel en m’inspirant de plusieurs logiciels, ressources et auteurs :

• Éric David pour le format TROX de son logiciel VISUAL TOPO.
• Jean‑Pierre Cassou (GH Cave Draw) pour ses conseils et des extraits de code que j’ai analysés.
• Stacho Mudrak et Martin Budaj (THERION) pour les formats permettant un export compatible Therion.

25) Participer aux tests