| SE_rasterattr_get_pyramid_info | |
Retrieves the pyramid information
LONG SE_rasterattr_get_pyramid_info (SE_RASTERATTR handle, LONG *max_level, BOOL *skip_level1, SE_INTERPOLATION_TYPE *interpolation);
| handle | The SE_RASTERATTR handle |
| max_level | The maximum level |
| skip_level1 | currently not implemented |
| interpolation | A pointer to the interpolation type |
SE_rasterattr_get_pyramid_info returns the pyramid information.
The interpolation types are
SE_INTERPOLATION_NONE—A pyramid is not constructed.
SE_INTERPOLATION_NEAREST—Nearest-neighbor interpolation; the closest
pixel is resampled into the resulting pixels.
SE_INTERPOLATION_BILINEAR—Bilinear interpolation; the values of four
adjacent pixels are resampled into the resulting pixel.
SE_INTERPOLATION_BICUBIC—Bicubic interpolation; the values of 16 adjacent
pixels are resampled into the resulting pixel.
To create an image without a pyramid, set the pyramid level to 0 and the interpolation type to SE_INTERPOLATION_NONE. If the pyramid level is set to any value other than 0 and the interpolation type is set to SE_INTERPOLATION_NONE, ArcSDE returns an SE_INVALID_PARAMETER error.
If you set the maximum pyramid level to SE_PYRAMID_AUTO, ArcSDE will create an image with an optimum number of pyramid levels.
Although the nearest neighbor interpolation method performs the fastest, the bilinear interpolation method is most often used since it provides an acceptable result at a savings of computation time. The bicubic interpolation method generally provides the best result but at a cost of extra computation time.
SE_SUCCESS
SE_INVALID_POINTER
SE_INVALID_RASTERATTR_OBJECT
SE_NET_FAILURE
SE_SDE_NOT_STARTED