Miscellaneous Extraction Features and Functions
Extracting <Image> data:
- The API has a specialized function to extract <Image> data.
- Organization and word order of returned data is determined by the <Image> object’s field values.
- Only one mip level can be extracted at a time.
- The start and stop texel parameters must correspond to the start and stop texels for the Image.
- Stores are used to manage the memory for the <Image> data.
- Level 1 functions exist to convert <Images> between differing representations (color model, scan direction, pixel depth, etc.).
SE_Return_Code SE_GetImageData(
SE_Integer_Unsigned start_texel_horizontal,
SE_Integer_Unsigned start_texel_vertical,
SE_Integer_Unsigned start_texel_z,
SE_Integer_Unsigned stop_texel_horizontal,
SE_Integer_Unsigned stop_texel_vertical,
SE_Integer_Unsigned stop_texel_z,
SE_Short_Integer_Unsigned mip_level,
unsigned char **data_out_ptr);