ArcObjects Library Reference (DataSourcesRaster)  

RasterCursor Class

A raster cursor class.

RasterCursor is a non-creatable object. References to non-creatable objects must be obtained through other objects.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux


Interfaces Description
IRasterCursor (esriGeoDatabase) Provides access to members that provide optimized raster access.


The RasterCursor object is used for iterating through all of the pixel blocks in a raster. It is useful for rasters that are too large to be brought into memory at once.

IRaster::CreateCursor or IRaster2::CreateCursorEx can be used to create a RasterCursor .

The IRaster::CreateCursor divides the Raster into blocks of 128 pixels high (rows) that span the full width of the raster. Each successive pixel block is read 128 lines below the previous pixel block. IRaster2::CreateCursorEx divides the Raster with your specified block size.

See Also

PixelBlock Class