kdu_stripe_decompressor::pull_stripe

Same as the first form of the overloaded pull_stripe function, except in the following respects:

• The stripe samples for each image component are written with a 16-bit representation; as with other forms of the pull_stripe function, the actual number of bits of this representation which are used is given by the precisions argument, but all 16 bits may be used (this is the default).
• The default representation for each recovered sample value is signed, but the application may explicitly identify whether or not each component is to have a signed or unsigned representation. Note that there is no required connection between the Ssigned attribute managed by siz_params and the application's decision to request signed or unsigned data from the present function. If the original data for component c was unsigned, the application may choose to request signed sample values here, or vice-versa.

Although Kakadu can decompress image sample values with more than 16 bits of precision, we do not currently provide any higher precision versions of the pull_stripe function to accurately represent high bit-depth sample data (you can still decompress high precision data, representing the results either as bytes or 16-bit words). Higher precision variants of the pull_stripe function could very easily be added if required, although there are very few applications which are able to meaningfully utilize image sample data with more than 16 bits of real precision.

True until all samples of all image components have been decompressed and returned, at which point the function returns false.

stripe_bufs[] [kdu_int16 *]

stripe_heights[] [int]

sample_gaps [int *]

row_gaps [int *]

precisions [int *]

is_signed [bool *]