(v13) Issuing status reports and warning messages

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

The plugin can produce a status report or warning message in the Output Controller by filling

d_error in with an error type of DETYPE_CONTINUE and an appropriate error code:

DERR(DETYPE_CONTINUE, code )

The error type tells the RIP that no change to the output call sequence is necessary, but that it should display the status message and/or icon indicated by the error code. The message and/or icon is dis‐ played in the Output Controller.

If the last error reported (d_lasterror ) had the error type DETYPE_CONTINUE too, but the new error has a different error code from the last one, the RIP calls the D_ERROR_TEXT and D_ERROR_ICON selectors to get text and icons for the error code. If the plugin does not supply anything it uses its own.

After displaying the message and/or icon, the RIP continues with the normal plugin call sequence.