Käsurea tööriistade skriptid

Sissejuhatus

Skripte saab kasutada QCAD-i funktsioone ära kasutavate käsurea tööriistade loomiseks. Selline skript võib näiteks genereerida joonise parameetrite põhjal, teisendada joonise või analüüsida joonist.

Näide

Käsurea tööriista skripti põhistruktuur võib välja näha näiteks allpool näidatud kujul. See on ka täielikult töötav näidisskript, mida saab kasutada käsurea tööriistana, et lisada antud joonisele joon punktist 0,0 punkti 100,100 ja eksportida see joonis uue failinimega:

include("scripts/simple.js");
include("scripts/Tools/arguments.js");

function printHelp() {
    print("Usage: " + args[1] + " [OPTION]... <drawing file>");
    print();
    print("This tool does...");
    print();
    print("  -f, -force          Overwrite existing output file");
    print("  -h, -help           Display this help");
    print("  -o, -outfile=FILE   Set output file to FILE");
    print("  -p, -parameter      Some parameter...");
    print("  ...");
    printGenericUsage();
    print();
}

function main() {
    if (testArgument(args, "-h", "-help")) {
        printHelp();
        return;
    }

    if (args.length < 3) {
        print("No input file given. Try -h for help.");
        return;
    }

    var inFile = args[args.length - 1];
    if (inFile.indexOf("-") === 0) {
        print("No input file. Try -h for help.");
        return;
    }

    var fi = new QFileInfo(inFile);
    if (!fi.isAbsolute()) {
        inFile = RSettings.getLaunchPath() + QDir.separator + inFile;
        fi = new QFileInfo(inFile);
    }

    var outFile = getArgument(args, "-o", "-outfile");
    if (outFile !== undefined) {
        outFile = getAbsolutePathForArg(outFile);
    }
    else {
        print("No output file. Try -h for help.");
    }

    if (new QFileInfo(outFile).exists() && !testArgument(args, "-f", "-force")) {
        print("Output file exists already, not overwriting: ", outFile);
        print("Use -f to force overwrite");
        return;
    }

    // create new document (off screen):
    var doc = new RDocument(new RMemoryStorage(), new RSpatialIndexNavel());
    var di = new RDocumentInterface(doc);

    // import given file:
    if (di.importFile(inFile) != RDocumentInterface.IoErrorNoError) {
        di.destroy();
        print("Cannot import file:", inFile);
        return;
    }

    // add line to drawing (using QCAD Simple API):
    startTransaction(di);
    addLine(0, 0, 100, 100);
    endTransaction();

    // export to given file (-o)
    if (!di.exportFile(outFile)) {
        di.destroy();
        print("Cannot export file:", outFile);
        return;
    }

    di.destroy();
}

if (typeof(including) == 'undefined' || including === false) {
    main();
}

Käsurea tööriistade skriptide käivitamine

Oletame, et see skript on salvestatud asukohta scripts/Tools/ExTool/ExTool.js.

Selle saab siis käivitada järgmiselt:

qcad -autostart scripts/Tools/ExTool/ExTool.js -f -o out.dxf in.dxf

Kui skript käivitatakse veebiteenuse osana, andke kindlasti kaasa ka lülitid -no-gui ja -allow-multiple-instances, et anda QCAD-ile teada, et graafilist liidest pole saadaval ja mitut isendit saab paralleelselt käivitada:

qcad -no-gui -allow-multiple-instances -autostart scripts/Tools/ExTool/ExTool.js -f -o out.dxf in.dxf

Serveris annaksite tavaliselt kaasa ka -platform offscreen, et töötada peata (st ilma X11-serverita Linuxis):

qcad -platform offscreen -no-gui -allow-multiple-instances -autostart scripts/Tools/ExTool/ExTool.js -f -o out.dxf in.dxf