(v13) D_OPEN

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

D_OPEN Selector

Parameter: NULL pointer do not use.

The RIP calls D_OPEN at the beginning of each page it wishes to be output.

The plugin is not required to do anything for the RIP during this call, but in many cases, there are other things that can sensibly be done at this point, such as checking the readiness of the output device, and initiating media loading.

From this call until (and including) D_WAIT_ON_CLOSE , the deviceDefinition 's d_page pointer will point to a pageHeader structure containing data about the page to be output.

Any errors should be indicated by returning a suitable value in the d_error field of the deviceDefinition parameter (See the DERR macro). On success, and recoverable errors, the return value should be NOERR . ‐1 should only be returned in the event of catastrophic failure.