Skip to main content

Version 6.0.x

New requests​

Changed requests​

  • state is now called active, both in the results of getGpioSignal and getGpi, and as the parameter of waitForGpioSignal, waitForGpi and waitForTrigger. Results carry both names, and the wait methods accept either, so a request can carry both and work with versions before v6.0 too.

  • getGpioSignal returns edgeCount, activeCount and generation.

  • getGpi returns edgeCount and activeCount, and listGpi returns activeCount.

  • The counters of getTrigger are called edgeCount, activeCount and bounceCount. The old names edgeCounter, activeCounter and bounceCounter still work, but are deprecated.

  • getPrintHistory and the print history REST endpoints accept the resolutions MONTHS and YEARS, but no longer MINUTES, and return total, the number of labels printed up to the end of the range. Days and longer are in the printer's local time, and weeks start on Monday.

  • Print jobs accept copyLabel, to take a copy of the label when the job is selected, and getCurrentPrintJob returns such a job with copiedLabelName.

  • Images have a black mode, which getImage, getImageInfo, listImages and the image REST endpoints return, and which can be given when creating an image. New images print pure black with black ink only by default.

  • getPrinterStatus returns the raised notifications and their notificationRagStatus. Its InkStatus objects, now also for Blade printers, have reserveLevel, bulkSupplyID, bulkState and faults, and no longer have the state CALIBRATING. An ink supply whose bulk supply is not GREEN is at least AMBER.

  • listPrinters returns channelCount and phWidth, and the printer types RISO1 and IRIX1 are now called BLADE and RAZOR.

  • getCurrentPrintJob leaves out description when the job was selected without one, instead of returning an empty string.

Printing​

  • Triggers within the target length of the previous product are ignored, and counted in the new triggers.ignored.withinTarget statistic.
  • With a target length, a repeat print goes on the next product, aligned within its own target length.
  • The printer settings targetLength and alignment give the default target length and alignment of print jobs, and a zero targetLength means no target length.

GPIO​

  • Notifications drive the signals notification.green, notification.amber, notification.red and notification.<owner>.<key>, see Built-in signals.

Renamed requests​

The ink system requests take any printer with ink supplies, and lose their marvin1: prefix. The old names still work, but are deprecated. The new names were also the names before v4.0, and kept working as deprecated aliases, so they work with all versions:

DeprecatedReplacement
marvin1:haltInkSystemhaltInkSystem
marvin1:standbyInkSystemstandbyInkSystem
marvin1:startInkSystemstartInkSystem
marvin1:stopInkSystemstopInkSystem

startInkSystem and standbyInkSystem fail with a message that says why when an ink supply refuses.

Labels​

  • Text is rendered with kerning and ligatures, and the label format is 4. Labels with legacyTextRendering, and labels of older formats, keep the layout of earlier versions, see Format versions and Text rendering.
  • Text objects accept direction, and the hAlign values START and END.

Fonts​

  • Fonts can be font collections (.ttc and .otc), and variable fonts offer each named instance as a style.

Text Line protocol​

  • A line also ends at a CR, as many barcode scanners send by default (v6.0.1), see Wire format.

Removed requests​