Ce tutoriel présente l'interface QCAD ECMAScript à travers le Script Shell.
Table des matières
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). Une bonne façon d'expérimenter avec les scripts est le QCAD Script Shell.
Lancement de l'interpréteur de commandes de script
L'interpréteur de script peut être affiché à l'aide du menu Divers > Développment > Shell Script.
L'interpréteur de script apparaît sous la forme d'un widget avec une ligne de commande en bas et un historique de ligne de commande qui montre les commandes entrées précédemment et leur sortie.
Exécution des commandes
Appelez la fonction pour ajouter une ligne en la saisissant dans la ligne de commande en bas :
addLine(0,0, 100,100)
Appuyez sur la touche Entrée pour soumettre la commande.
QCAD ajoute une ligne de 0,0 à 100,100 au dessin en cours.
La fonction addLine fait partie de l'API simple QCAD, une façon simplifiée d'accéder à une partie limitée de l'API QCAD. Vous pouvez trouver une liste de toutes les fonctions de l'API simple QCAD sur la page de documentation de l'API simple QCAD.
Scripts sur plusieurs lignes
Les boucles (si, pour, pendant, pendant, ....) sont généralement saisies sur plusieurs lignes. Vous pouvez le faire de la même manière dans la console de script, par exemple en saisissant ces lignes, une par une et en appuyant sur Entrée :
for (i=0; i<=10; i++) {
addLine(i*10,0, i*10,100);
}
Aucune indentation n'est nécessaire.
Ce script ajoute 11 lignes parallèles de x=0 à x=100 avec une distance de 10 unités.
Copier / Coller des scripts
Des scripts plus complexes avec plusieurs lignes peuvent être écrits dans un éditeur de texte externe et ensuite copier/coller dans la console de script. Le script est exécuté dès qu'il est collé.
Répétition de la dernière commande utilisée
Utilisez les touches fléchées ascendante et descendante pour parcourir les commandes saisies précédemment et les modifier ou les relancer.
Effacer l'historique de la ligne de commande
Utilisez Ctrl-L (⌘L) pour effacer l'historique de la ligne de commande.