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


IRasterCursor Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabase)  

IRasterCursor Interface

Provides access to members that provide optimized raster access.

Product Availability

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

Members

Description
Method Next Iterates to the next PixelBlock.
Read-only property PixelBlock The current PixelBlock.
Method Reset Return to state when first created.
Read-only property TopLeft The offset of the current PixelBlock.

CoClasses that implement IRasterCursor

CoClasses and Classes Description
RasterCursor (esriDataSourcesRaster) A raster cursor class.

Remarks

The IRasterCursor interface controls enumeration through the PixelBlocks in a Raster. It is useful for rasters that are too large to be brought into memory at once.

The RasterCursor divides the Raster into blocks 128 pixels high that span the full width of the raster. Each successive PixelBlock is read 128 lines below the previous PixelBlock.

To create a RasterCursor, use the IRaster::CreateCursor or IRaster2::CreateCursorEx method.

See Also

IRaster Interface | IPixelBlock Interface | IPixelBlockCursor Interface

.NET Related Topics

How to access pixel data using a raster cursor