This document is archived and information here might be outdated.  Recommended version.

RasterCursor Class (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > DataSourcesRaster > ESRI.ArcGIS.DataSourcesRaster > Classes > R > RasterCursor Class
ArcGIS Developer Help

RasterCursorClass Class

A raster cursor class.

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 | IPixelBlock3 Interface | IPixelBlockCursor Interface