Skip to main content
Skip table of contents

File names, device names, and relative devices

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP.

A device type and its devices are said to be either relative or non-relative. This is a property of the device type, so all devices of a particular type are one or the other. For instance, device type 15, used for channels in input plugins, is non-relative, whereas device type 0, the disk filing system, is relative.

Files on a relative device are individually identified by file names and there may be arbitrarily many of them. However, a non-relative device has at most two files—one for reading and one for writing— and these are named simply by referring to the device name. Depending on its implementation, a non-relative device type may either refuse to open additional files on the device, or regard all files opened as referring to the same data.

A device is identified in PostScript by a string which starts with a percent sign ( % ) and optionally ends with another %. The % signs are not considered part of the device name: (%serial%) and (%serial) refer to the same device. Device names in the Harlequin RIP can be up to 50 bytes long (excluding the % signs). Case is significant: (%Serial%) and (%serial%) are different devices.

The GUI can be localized. These localized versions can use multi-byte character representations, so the distinction between bytes and characters is important.

A file is identified in the PostScript language by an arbitrary string, subject only to a maximum length. In the Harlequin RIP, file names can be up to 200 bytes long. However, the name space is unique only within one device, so to identify a file uniquely, the file name must be qualified by a device name, using a percent sign ( % ) to separate the two, and a leading % to indicate that the first part is the name of a device; for example: (%os%Usr/Start). The 200-byte limit does not include this device name.

Non-relative devices do not have named files and therefore to open a file on such a device, only the device name part is given (with or without the trailing % ); for example: (%serial). The distinction between a non-relative device and a file on that device is therefore blurred in the PostScript language.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.