FDO API Reference Feature Data Objects

virtual FDO_API void FdoIRaster::SetImageXSize FdoInt32  size  )  [pure virtual]
 

Sets the size of image file in the horizontal direction in pixels (number of columns). By setting the X and Y image size properties prior to getting a reader for the data, the client application can control the density of pixels fetched by the provider, which may reduce the amount of data shipped by the reader and reduce processing time significantly. For example, a certain query in the coordinate system of the raster object class returns a FdoIRaster object with image size 12091 by 8043. But the image only needs to be displayed in an area 1167 by 776 on the users monitor.

Note:
The aspect ratios are the same because the query is constructed based on the display area).
Remarks:
By setting the image size to these lower values the FDO raster subsystem may be able to use a previously subsampled image where the resolution has been reduced by a factor of 4. So instead of transferring 97MB, it can transfer 6MB (a reduction by 4 in both dimensions reduces the amount of data by a factor of 16) and subsample the image again to the desired resolution in a more timely manner (less data to process means less total time), with no appreciable difference in display quality to the user.
Parameters:
size The desired horizontal image size in pixels (number of columns).

Comments or suggestions? Send us feedback.