CAPS Universe documentation  1.0.4
All you need to know to be successful
Feature: printing data buffer_size
Section Variable
interface buffer_size

Values:

  • A number, unit is kiB, e.g. 1024 means 1024 kiB

If defined, the printer data buffer is extended to this value. E.g. the printer gets the printing data in one turn of this size instead of many small pieces.

Note
Some printers are in trouble if you send the printing data in many small pieces and thus, sometimes time out.

The time out especially can happen if the printer starts printing immediately when the first printing data arrives. Some printers cannot stop a printing activity once it has started. The printer then needs a continuous stream of data to continue and to finish the printing activity. Increase the buffer size if you face this kind of trouble.

The default value is 128 kiB if this setting isn't made in any INI file. It it also limited to max. 8 MiB (refer PRINTER_STREAM_BUFFER_DEFAULT_SIZE and PRINTER_STREAM_BUFFER_MAX_SIZE for the settings).

The printer driver is free when to flush the printing data buffer. It can flush the printing data buffer at the end of each processed page (for simplex print and on demand even for duplex print) or after two processed pages for duplex print. This is printer device dependend and should already be handled by the printer driver.

Note
If the printer driver already sets the buffer_size value, there is no reason to change its value.
Attention
The special value of '0' sets up a fully unbuffered mode. In this case the printer receives the printing data in many small pieces. This could make sense in some rare and special use cases.