(v13) Declaring that a page is ready for output
This page applies to Harlequin v13.1r0 and later; and to Harlequin MultiRIP but not Harlequin Core
The RIP calls the D_OPEN
selector when it is ready to send a page to the plugin for output. By the time this call is made, the RIP will have set the deviceDefinition
's d_page
pointer to point to a pageHeader
describing the page.
The plugin might prime the output device to ready it for output at this point. Alternatively, it could choose to defer this until the first bands of output data are received.
See (v13) D_OPEN
for a description of D_OPEN
.
The plugin should check the raster format of the output data. If the format is incorrect, the plugin should reject the job, by setting the d_error
field in the deviceDefinition
to DERR(DETYPE_CANCEL, DERR_INVALID_DATA)
For example, if a page containing an 8‐bit raster is sent to a plugin that can only handle 1‐bit rasters, the page ought to be rejected.