Tutoriel : Programmation de scripts

Traduction automatique

Ce tutoriel présente l'interface QCAD ECMAScript en examinant les différentes possibilités d'exécuter et d'intégrer des scripts dans QCAD.

Introduction

QCAD est livré avec une interface de script très puissante et complète, vous permettant d'accéder à la quasi-totalité de l'API QCAD ainsi qu'à l'API Qt via ECMAScript (JavaScript)..

Utilisation des scripts dans QCAD

Il y a plusieurs façons d'exécuter et d'intégrer un script dans QCAD. Certaines sont traitées dans des tutoriels séparés :

  • Le shell de script
    C'est un bon point de départ pour expérimenter et faire vos premiers pas avec les scripts.
  • Exécution de scripts à partir d'un fichier
    Exécution de scripts non interactifs plus complexes. 
  • Exécution de scripts à partir du terminal
    Lorsque vous utilisez QCAD dans le cadre d'un processus automatisé, les scripts peuvent être exécutés à partir du terminal (ligne de commande) d'un système d'exploitation.
    • Avec l'interface graphique de QCAD
      Pour démarrer l'interface graphique de QCAD et ensuite exécuter un script, utilisez le commutateur -exec. Cet exemple démarre QCAD et ensuite lance l'action pour ouvrir un fichier : 
      qcad -exec scripts/File/OpenFile/OpenFile.js
    • Sans l'interface graphique de QCAD
      Si un script ne nécessite pas l'interface graphique QCAD ou crée sa propre interface graphique, utilisez le commutateur -autostart à la place : 
      qcad -autostart myscript.js
      Le script passé à QCAD par le biais de -autostart peut contenir n'importe quel type de code de script, d'un simple print("Hello World"); sur un outil de ligne de commande à une application complète pilotée par une interface graphique.
  • Actions de script interactif
    Les actions de script sont des scripts qui créent un menu et/ou un bouton d'outil et permettent généralement à l'utilisateur d'interagir avec un dessin, par exemple en cliquant sur des coordonnées, en cliquant sur des entités ou en entrant des paramètres.
  • Scripts d'outils en ligne de commande
    Ces scripts mettent en œuvre un outil en ligne de commande. Les outils en ligne de commande sont généralement utilisés pour traiter automatiquement un grand nombre de dessins ou sur des serveurs web dans le cadre d'un service web.