Skip to content

Artek Utilities

Artek Utilities is a free Ignition module that adds PDF and image functions to scripting. With it, a script can turn PDF pages into images a report or a view can show, merge or split PDFs, make a PDF smaller, add a text watermark, read a PDF's text and document information, and resize an image or set a phone photo upright.

Where Artek Utilities fits Artek Utilities adds PDF and image functions to Ignition scripting on 8.1 and 8.3. Gateway, Perspective, Designer and Vision scripts call them with bytes and get bytes back, to save as files, store in a database or attach to reports and email. Ignition (8.1 or 8.3) Gateway scripts timers, events, WebDev Perspective scripts run on the gateway Designer and Vision script console, clients Artek Utilities PDF functions merge, split, watermark, compress, text and metadata, PDF to image Image functions resize, dimensions, fix photo orientation Your files and data bytes in, bytes out: files, database, reports, downloads, email
Scripts pass PDF or image bytes in and get bytes back.

Every function takes file contents as a byte array, so it works the same on uploaded files, files read from disk and documents stored in a database.

What it adds

Eleven scripting functions in two groups:

Group Namespace Functions
PDF system.artek convertPDFToImage, mergeMultiPDF, splitPDFPages, compressPDF, addWatermark, extractTextFromPDF, getPDFMetadata
Images system.artek.imagehelper getImageDimensions, resizeImage, processImageWithOrientation, getByteArraySize

Each function is described, with its arguments and return value, in Scripting functions.

Which build to install

There is one signed build per Ignition line. Both builds use the same module ID, com.artek.utilities, and the same version, 1.0.0. Install the one that matches your gateway.

Your gateway Install Minimum Ignition version
Ignition 8.1 Artek-Utilities-ign81.modl 8.1.0
Ignition 8.3 Artek-Utilities-ign83.modl 8.3.0

The two builds offer the same functions with the same arguments.

Where the functions run

The module installs into the Gateway, Designer and Vision Client scopes, so the functions are available in:

  • gateway scripts (timer, tag change, message handler and other Gateway Event Scripts),
  • Perspective scripts, which run on the gateway,
  • Designer scripts, including the Script Console,
  • Vision Client scripts.

License

Artek Utilities is free. It is licensed under the Apache License 2.0 and provided AS IS, without warranties or conditions of any kind. The gateway shows the license text when you install the module, and you can also read it on artekis.io.

The module does not need an Ignition license of its own.

Signing

Both builds are signed with the Artek, LLC certificate, SHA-1 fingerprint 99e472815b3417abab93e1c744c76699c73375d2. The gateway checks the signature when you install the module and rejects a modified file.

Next steps