Version 6.0.x
New requests
-
setImageBlackMode sets the black mode of images.
-
listGpioSignals2 returns an object for each signal, with
active,edgeCountandactiveCount, the same as getGpioSignal. listGpioSignals keeps returning a boolean for each signal, and is deprecated. -
waitForGpioSignalChange waits for a signal to change, using the
generationthat getGpioSignal and listGpioSignals2 return. -
listGpioSignalEdgeMappings, addGpioSignalEdgeMappings and removeGpioSignalEdgeMappings list, add and remove single mappings of signal edges to actions.
-
blade:enablePrintheadMaintenance enables the printhead maintenance mode on a Blade printer, like marvin1:enablePrintheadMaintenance.
Changed requests
-
stateis now calledactive, 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,activeCountandgeneration. -
getGpi returns
edgeCountandactiveCount, and listGpi returnsactiveCount. -
The counters of getTrigger are called
edgeCount,activeCountandbounceCount. The old namesedgeCounter,activeCounterandbounceCounterstill work, but are deprecated. -
getPrintHistory and the print history REST endpoints accept the resolutions
MONTHSandYEARS, but no longerMINUTES, and returntotal, 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 withcopiedLabelName. -
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
notificationsand theirnotificationRagStatus. Its InkStatus objects, now also for Blade printers, havereserveLevel,bulkSupplyID,bulkStateandfaults, and no longer have the stateCALIBRATING. An ink supply whose bulk supply is notGREENis at leastAMBER. -
listPrinters returns
channelCountandphWidth, and the printer typesRISO1andIRIX1are now calledBLADEandRAZOR. -
getCurrentPrintJob leaves out
descriptionwhen 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.withinTargetstatistic. - With a target length, a repeat print goes on the next product, aligned within its own target length.
- The printer settings
targetLengthandalignmentgive the default target length and alignment of print jobs, and a zerotargetLengthmeans no target length.
GPIO
- Notifications drive the signals
notification.green,notification.amber,notification.redandnotification.<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:
| Deprecated | Replacement |
|---|---|
| marvin1:haltInkSystem | haltInkSystem |
| marvin1:standbyInkSystem | standbyInkSystem |
| marvin1:startInkSystem | startInkSystem |
| marvin1:stopInkSystem | stopInkSystem |
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 withlegacyTextRendering, and labels of older formats, keep the layout of earlier versions, see Format versions and Text rendering. - Text objects accept
direction, and thehAlignvaluesSTARTandEND.
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
- getLabelPixmap and its REST endpoint are removed.