Compress the data in the stream using Flate compression.
Flate compression is a standard, fast and efficient lossless
compression method. It is used as the basis of file formats like
ZIP and image formats like PNG. In most situations this is the
method you should prefer.
PDF streams allow a set of compression filters to be applied to
a stream of data. For example one might want to apply Flate
compression and then ASCII85 encode the result. This is represented
as two compression filters in sequence.
This function does not decompress the stream. So if compression
is already present, then this method will compress the
already-encoded data and append a compression specification to the
ABCpdf tries to avoid creating certain compression sequences.
Some compression types on some objects are illegal. Some sequences
are legal but not supported within Acrobat (though they are in most
other viewers). However these are unusual situations and you are
unlikely to ever see them.
You can override this behavior by forcing the compression to
take place. However if you do this you may end up creating a
document which is invalid or unviewable in Acrobat.