my_startdocument()

a function called at the beginning of the document

Synopsis:

int my_startdocument( struct _doc_ctrl *c );

Description:

This function is called after the _doc_ctrl structure has been filled in with all the print-job information but before the graphics subsystem and ram_buffer are initialized. It can be used to initialize the fields in the _doc_ctrl structure, including:

• amount of space to allocate for ram_buffer
• page size
• margins
• color model
• dithering
• resolution
• scale.

As mentioned in the overview, the phs file might contain such information, but doesn't have to. Even if the information is there, it might be for a different printer. Therefore, the values should not be considered valid.

Returns:

0

Success.

Any other value

An error occurred.

Classification:

Photon