IRasterCursor Interface

Provides access to members that provide optimized raster access.

Members

	Name	Description
	Next	Iterates to the next PixelBlock.
	PixelBlock	The current PixelBlock.
	Reset	Return to state when first created.
	TopLeft	The offset of the current PixelBlock.

IRasterCursor.Next Method

Iterates to the next PixelBlock.

Public Function Next ( _
) As Boolean

public bool Next (
);

IRasterCursor.PixelBlock Property

The current PixelBlock.

Public ReadOnly Property PixelBlock As IPixelBlock

public IPixelBlock PixelBlock {get;}

IRasterCursor.Reset Method

Return to state when first created.

Public Sub Reset ( _
)

public void Reset (
);

IRasterCursor.TopLeft Property

The offset of the current PixelBlock.

Public ReadOnly Property TopLeft As IPnt

public IPnt TopLeft {get;}

Classes that implement IRasterCursor

Classes	Description
RasterCursor (esriDataSourcesRaster)	A raster cursor class.

Remarks

The IRasterCursorinterface 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.