| synopsis || arguments || prev || next |
void get_block_size( kdu_coords & nominal_size, kdu_coords & first_size)
Java: void Get_block_size( Kdu_coords nominal_size, Kdu_coords first_size)
[Declared in "../coresys/common/kdu_compressed.h"]
Retrieves apparent dimensions for the code-block partition of the current subband, whose primary purpose is to facilitate the determination of buffer sizes for quantized subband samples prior to encoding, or after decoding. Although the open_block member function returns a kdu_block object which contains complete information regarding each block's dimensions and the region of interest within the block, this function has profound implications for resource consumption and should not be invoked until the caller is ready to decode or encode a block of sample values.
Used to return the dimensions of the code-block partition for the subband. Note that these are apparent dimensions and so they are affected by the transpose flag supplied in any call to kdu_codestream::change_appearance.
Used to return the dimensions of the first apparent code-block. This is the code-block which has the smallest indices (given by the pos field of the indices structure) retrieved via kdu_subband::get_valid_blocks. The actual code-block corresponding to these indices may be at the upper left, lower right, lower left or upper right corner of the subband, depending upon the prevailing geometric view. Moreover, the dimensions returned via first_size are also sensitive to the geometric view and the prevailing region of interest. When this first code-block is opened using the kdu_subband::open function, the returned kdu_block object should have its kdu_block::size member equal to the dimensions returned via first_size, transposed if necessary.