| synopsis || arguments || prev |
void pull( kdu_line_buf & line, bool allow_exchange=false)
Java: void Pull( Kdu_line_buf line, boolean allow_exchange)
[Declared in "../coresys/common/kdu_sample_processing.h"]
Fills out the supplied line buffer's sample values before returning. If allow_exchange is true, the function is allowed to exchange the storage associated with the supplied line and an internal line buffer which may be managed by the implementation. However, the two lines must have been allocated using the same kdu_sample_allocator object, and they must have identical dimensions. This capability has the potential to fragment the memory and so both the caller and the implementor of this function should be careful to use it only when exchange is likely to be efficient.