Qu’est-ce qu’un fichier .thconfig ?

Un fichier .thconfig est le fichier qui donne toutes les instructions pour produire un document finale. Il est composé de 3 parties :

  1. une première partie qui indique les fichiers de données et de dessin qu’il va falloir utiliser pour générer un produit final
  2. une seconde partie qui définit les propriétés de la sortie
  3. une dernière partie qui indique quels exports nous voulons.

Appel aux fichiers de données et de dessin à utiliser

Au début du fichier .thconfig, nous appelons les fichiers grâce à la commande source :

source bout-trou1.th   # le fichier de données topo
source bout-trou1.th2  # le fichier de dessin

# éventuellement un fichier de relief (MNT)
source mnt.th

Evidemment, c’est dans le cas où ce fichier .thconfig est dans le dossier où se trouve les fichiers appelés. Sinon, il faut indiquer les chemins des fichiers, sans quoi ils ne seront pas trouvés. Par exemple :

source MesDonneesTopo/bout-trou1.th

Dans le cas d’une cavité complexe ou d’un système de cavité, nous pouvons remplacer l’appel aux données topos et aux dessins par un fichier maitre comme le précédent topoglobale.th qui contiendra les appels à fichiers (topos et dessins), ainsi que les jonctions de topos et de dessins.

Le début du fichier thconfig deviendra alors :

source topoglobale.th 

# éventuellement un fichier de relief (MNT)
source mnt.th

Mise en page et propriétés de la sortie

La partie mise en page est contenu dans un bloc de mise en page, le bloc

layout <identifiant>
   # Instructions du bloc layout
endlayout

L’identifiant (= le nom de la mise en page) est obligatoire parce qu’il sera appelé dans la partie « exports ».

Il est bien évidement possible définir différents blocs de mises en page, pour chaque export spécifique que nous voulons.

Beaucoup de commandes peuvent être utilisées dans un bloc de mise en page. Elles ne sont pas obligatoire parce qu’elles possèdent toutes des valeurs par défaut qui seront utilisées si elles ne sont pas définies par l’utilisateur.

Les commandes à l’intérieur d’un bloc de mise en page vont varier suivant le type d’export que nous voulons. Nous pouvons les classer en quatres grandes catégories :

  • les commandes de gestion du dessin
  • les commandes de gestion du cartouche
  • les commandes de gestion des pdf
  • les commandes de construction d’un atlas topographique

La gestion du dessin

Les commandes de gestion du dessin permettent :

  • de définir la langue à utiliser 
    • language fr # pour le français
  • de définir projection, échelles,… 
    • # "cs" Pour projeter la topo dans le système UTM32 nord  
cs UTM32N

# "base-scale" specifie l'échelle à laquelle nous avons dessiné nos croquis. Par defaut, c est 1/200. Ici, c'est au 1/1000
base-scale 1 1000

# "scale" : spécification de l'échelle d'impression
# La combinaison entre scale et base-scale contrôle la grosseur des lignes, la taille du texte et des symboles... 
# Il peut être intéressant de jouer avec
scale 1 1000

# "scale-bar" Echelle graphique, ici de 100 m ampleur
scale-bar 100 m

# Pour faire une rotation
#rotate 2.25
  • de définir si nous voulons une grille et comment 
    • # "grid" Spécifier qu'il faut imprimer une grille au dessous de la topo. "Grid" peut prendre les options off (par de grille), bottom (placée en dessous) ou top (placée au dessus)
grid bottom

# Spécifier le pas de la grille, ici 100x100x100 m (Trois dimensions, oui, ça sert pour la coupe aussi) 
grid-size 100 100 100 m

# Affiche les coordonnées de la grille <off (pas de coordonnées) / all (sur tous les croisements) / border (uniquement aux niveau des croix aux bords de la carte>
grid-coords all
  • de définir quelle banque de figurés nous voulons utiliser 
    • # "symbol-set" : charge une banque de figurés préformatés
# Les banques existantes sont UIS (Europe), ASF (Australie), AUT (Autriche), BCRA (British), NSS (USA), NZSS (Nouvelle Zélande), SBE (Brésilein) et SKBB
# Il est possible d'en créer soi même si besoin
symbol-set UIS

# pour modifier un seul type de symbole :
#symbol-assign <point/lien/area/group/special> <symbol-type (le nom du symbole)> <symbol-set>

# Si nous voulons cacher (hide en anglais) un objet particulier, par exemple ici la ligne du cheminement topo
symbol-hide line survey
  • de définir les couleurs de la topographie 
    • # Une couleur de fond, 85% blanc = 15% noir
color map-bg 85
# Une couleur de topo (RVB)
color map-fg [100 100 80]
# Si nous voulons colorer la cavité en fonction de l'altitude, nous pouvons le faire avec la commande (attention, il faut plusieurs calques/scraps à des altitudes différentes)
color map-fg altitude

# la topo est transparente (on peut voir les galeries sous-jacentes) (Par defaut, donc, pas vraiment besoin de le spécifier)
transparency on

# Définition du pourcentage de transparence, seulement si transparency est "on"
opacity 75

# Si dans les données appelées, nous avons appelé un MNT avec une image drappée dessus, alors, il est possible de choisir si nous voulons l'afficher avec la commande :
# "surface <top (au dessus)/ bottom (en dessous) / off (pas d'image)>"
surface bottom
# Dans le cas où nous l'affichons, nous pouvons jouer sur son opacité, entre [0-100] ; Par défaut, c'est 70
surface-opacity 70

La gestion du cartouche

Le cartouche est le cadre associé à la topographie, qui donne des informations sur cette topographie, comme l’échelle, la flèche du nord, les auteurs, la légende…

De base, nous pouvons la gérer avec ces instructions :

# "map-header" : Spécifier la position du cartouche. Nous indiquons les cordonnes du point de la topo ou l'on veut le cartouche:
#     0 0, c'est en bas, a gauche
#     100 100, c'est en haut, a droite
# La manchette a des "points cardinaux" : n (en haut-milieu), s (en bas- milieu), ne (coin en haut à droite), sw (coin en bas à gauche), etc. 
# Il faut spécifier un de ces points. C'est lui qui sera placé aux coordonnées spécifiée.
# Par exemple, ici, nous pouvons spécifier que le coin en bas à gauche (SW) du cartouche sera placés en haut (y = 105) et à gauche (x = 0) de la topo :
map-header 0 105 nw

# Voulons nous voir (off) ou pas (on ; en ce cas, il sera sur fond blanc) l'arrière plan du cartouche ?
map-header-bg off

# Afficher la légende des symboles
# "legend off" = pas de légende ; "legend on" = légende des symboles utilisés ; "legend all" = tous les symboles de la banque de symboles + les symboles définis par l'utilisateur
legend on

# Par défaut, la légende est de 14 cm de largeur
legend-width 21 cm

# Par défaut, la légende est affichée sur 2 colonnes. Nous pouvons le changer pour 3 colonnes, par exemple :
legend-columns 3

# Ajouter un commentaire sous le titre
map-comment "Samoëns, 74, France"

# Afficher les statistiques d'explo par équipe/nom. C'est lourd
# si la cavité est importante et qu'il y a beaucoup d'explorateurs
statistics explo-length off

# Afficher le développement topographié
statistics topo-length off

# Afficher les copyrights inclus dans les dessins
statistics copyright all

Avec un usage avancé, il est possible de modifier en profondeur ce cartouche.

La gestion des données des pdf

Il est possible d’inscrire des métadatas dans les pdf (qui apparaitront dans les propriétés du document). Par exemple :
# Définition du titre
doc-title "Ma cavité"

# Définition de l'Auteur
doc-author "Auteur du document"

# Définitions de mots clefs
doc-keywords "mots clef 1, mots clefs 2..."

# définition du sujet
doc-subject "description du sujet"

# Autoriser (on) ou non (off) les calques dans le pdf :
layers on

Les commandes du bloc layout sont nombreuses. Nous n’avons développé ici que celles qui sont utilisées le plus souvent. Pour en savoir plus, il faut se référer au thbook.

Nous pouvons aussi écrire plusieurs blocs de mise en page dans le même fichier de compilation. Généralement, nous en avons au moins trois :

  • un premier, très court et très basique, pour définir l’export du squelette topographique (xvi) qui nous sera utile pour le dessin,
  • un second pour le plan pdf
  • un troisième pour la coupe pdf
  • et parfois un quatrième pour l’atlas

Quels exports ?

Comme décrit précédemment, nous pouvons exporter différents types de produits :

  • une carte en 2 dimensions (map)
  • un modèle en 3 dimensions (model)
  • un atlas en 2-D (atlas)
  • des listes (cave-list ; survey-list ; continuation-list)
  • la base de données sql (database)

Ces exports se font au moyen de la commande :

export <type> <-options>

Le type correspond à map, model, atlas, cave-list, survey-list, continuation-list ou database

Les options principalement utilisées sont :

  • -output (ou -o) <fichier> : nom du fichier exporté. Par défaut, c’est « cave »
  • -format (ou -fmt) <format> : format du fichier exporté. Pdf, dxf, svg, xhtml, survex, esri, kml, xvi and bbox pour map ; loch, compass, survex, dxf, esri, vrml 3dmf et kml pour model ; html, txt, kml ou dbf pour les listes ; sql ou csv pour database
  • -projection <id> où <id> définit si la projection est plan, extended (coupe développée) ou projected (coupe projetée) ; valable uniquement pour le type map
  • -layout <id> : Indique quel bloc de mise en page utiliser (<id> = nom du bloc que nous avons défini) ; C’est pour les types map et atlas

Donc, si nous voulons exporter en pdf le plan d’une grotte, suivant la mise en page que nous appelé « mamiseenpage » et que nous voulons que cet export s’appelle LaGrotte, alors, nous écrirons à la fin du fichier de configuration :

export map -proj plan -fmt pdf -layout mamiseenpage -o LaGrotte.pdf

Si nous voulons exporter uniquement le squelette xvi de la topographie en coupe développée pour pouvoir dessiner ensuite, nous écrirons :

export map -proj extended -fmt xvi -layout mamiseenpageXVI -o LaGrotte.xvi

Si nous voulons un export 3D au format lox pour loch, nous rajouterons :

export model -o LaGrotte.lox

Si nous voulons une liste des entrées avec les coordonnées :

export cave-list -fmt html -location on -o LaGrotte-Entrees.html

Au final, notre fichier de configuration .thconfig pourrait ressembler à cet exemple [Lien à rajouter].