cli_reference FR

Référence de la ligne de commande

Guide des options en ligne de commande de QElectroTech.

Corrigé en septembre 2026. Cette page décrivait auparavant une option --dpi et des variables d'environnement QET_PLUGIN_PATH / QET_ELEMENT_PATH qui n'existent pas, et plaçait les arguments dans un ordre que l'analyseur ne comprend pas. Tout ce qui suit a été vérifié sur le code source.

Options générales

Ces options prennent leur valeur avec un signe =.

Option	Effet
--help	Afficher l'aide sur les options
-v, --version	Afficher la version
--license	Afficher la licence
--lang-dir=DOSSIER	Dossier contenant les fichiers de langue

Selon la façon dont le binaire a été compilé, ces redéfinitions de dossiers peuvent aussi être disponibles : --common-elements-dir=DOSSIER, --common-tbt-dir=DOSSIER, --config-dir=DOSSIER, --data-dir=DOSSIER. Lancez --help pour voir celles dont dispose votre version.

Ouvrir des fichiers

Un fichier projet se donne comme simple argument positionnel. Il n'existe pas d'option -o ni --open.

qelectrotech monprojet.qet
qelectrotech projet1.qet projet2.qet

QET n'autorise qu'une seule instance : lancer la commande alors que QET tourne déjà transmet les fichiers à la fenêtre existante.

Export sans interface

Passez l'un des indicateurs ci-dessous et QET ouvre le projet, fait le travail et se termine, sans jamais afficher de fenêtre.

Les arguments sont positionnels, contrairement aux options générales. La forme est toujours :

qelectrotech <indicateur> <projet.qet> <sortie>

L'indicateur vient avant le projet. L'ordre inverse ne fonctionne pas.

Indicateur	Sortie
--export-pdf	un PDF, tous les folios
--export-png / --export-svg	un dossier, une image par folio
--export-bom	CSV, nomenclature
--export-wiring	CSV, liste de câblage de-à
--export-cables	CSV, liste de câblage issue du XML du document
--export-wires	CSV, numéros de conducteurs
--export-nets	CSV, réseaux électriques
--export-links	CSV, renvois de folio
--info	JSON structurel (sur stdout si aucun chemin n'est donné)
--resave	.qet réécrit
--set-titleblock	.qet avec champs de cartouche renseignés
--check-elements	valide des fichiers .elmt ou un dossier

Plus --show-terminals, qui dessine les marqueurs de bornes dans les sorties PDF/PNG/SVG.

qelectrotech --export-pdf monprojet.qet sortie.pdf
qelectrotech --export-png monprojet.qet images/
qelectrotech --export-bom monprojet.qet nomenclature.csv
qelectrotech --check-elements mes_elements/

Il n'y a pas d'option de résolution : --export-png rend chaque folio à la taille de sa zone imprimable.

Codes de retour

0 succès · 1 le travail a échoué · 2 erreur d'appel. Utilisables directement avec set -e.

Dans un script

set -e
for f in projets/*.qet; do
    timeout 120 qelectrotech --export-pdf "$f" "pdf/$(basename "${f%.qet}").pdf"
done

QT_QPA_PLATFORM=offscreen suffit ; Xvfb n'est pas nécessaire. Prévoyez toujours un délai d'expiration : un projet enregistré par une version antérieure peut faire apparaître une fenêtre modale.

Variables d'environnement

QET ne définit pas de variable d'environnement propre pour les greffons ou les éléments. Utilisez les options --common-elements-dir= et compagnie ci-dessus lorsque votre version les propose.

Pour aller plus loin

• Automatiser QElectroTech — la ligne de commande en détail, le format XML des fichiers, et ce qui n'existe pas
• Construire depuis les sources