IRasterCursor Interface

Provides access to members that provide optimized raster access.

Members

Name 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.

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.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.