Information collection for printing progression report. More...

Data Fields
unsigned	flags

unsigned	copy

unsigned	cpage

unsigned	dmedia

unsigned	fmedia

Detailed Description

fmedia defines the full amount of to be printed media. The amount depends on the print mode (duplex versus simplex) and the page-ranges the user has given in the printing parameters.

An easy use case is to print a full document with 10 pages in simplex mode and one copy only. The amount of to be printed media in this case is 10. The same job in duplex print mode would have only 5 media.

If the full document has only 9 pages, in simplex mode and one copy only, the amount of to be printed media is 9, but in duplex mode it is still 5 media.

Things change if page-ranges come into play:

10 pages document, ranges "1-6, 8", simplex print mode, results into 7 printed media (e.g. fmedia = 7)
10 pages document, ranges "1-6, 8", duplex print mode, results into 4 printed media (e.g. fmedia = 4)

And again it changes, if more than one copy is to be printed:

2 copies, 10 pages document, ranges "1-6, 8", simplex print mode, results into 14 printed media (e.g. fmedia = 14)
2 copies, 10 pages document, ranges "1-6, 8", duplex print mode, results into 8 printed media (e.g. fmedia = 8)

dmedia is related to the fmedia value. It starts with '1' and increases up to the value of dmedia.

Precondition: At the printing vendor's side: the first report is to be sent after the first page/medium was printed (to avoid any '0' value)!

Todo:: Add timestamp

Field Documentation

◆ flags

unsigned flags

report about

bit 0 is 0 = non-collating job
bit 0 is 1 = collating job

More bits may follow.

◆ copy

unsigned copy

Current copy of medium (non-collating) or copy of document (collating)

Attention: A 0 is invalid

◆ cpage

unsigned cpage

Current page number, corresponding to the document's page number (not medium number)

Attention: A 0 is invalid

◆ dmedia

unsigned dmedia

Media count already done

Attention: A 0 is invalid

◆ fmedia

unsigned fmedia

Predicted full media count to print

Attention: A 0 is invalid

The documentation for this struct was generated from the following file:

caps-printing-coordinator/src/libcapsppcommon.h