IPixelBlockCursor Interface

Provides access to members that control pixel block cursor.

Product Availability

Members

	All Properties Methods	Description
	GetBlockSize	Gets the cursor block size.
	InitByRaster	Initializes the cursor by the raster interface.
	InitByRawPixels	Initializes the cursor by the raw pixel interface.
	NextBlock	Obtains the next pixel block from the cursor.
	ScanMode	The cursor scan mode: Line = 0, LineSerpent = 1, Serpent2 = 3, alaGIF = 4.
	UpdateBlockSize	Updates the cursor block size.

CoClasses that implement IPixelBlockCursor

Remarks

A legacy interface in ArcGIS 9.2

The IPixelBlockCursor interface controls iteration through the pixel blocks of a Raster and a RasterBand.

The InitByRawPixels method initializes a PixelBlock from a RasterBand by specifying the pixel block size.

The InitByRaster method initializes the PixelBlock from a Raster. The size of the PixelBlock is determined automatically when creating from a Raster.

GetBlockSize returns the size of the current pixel block.

NextBlock retrieves the next pixel block, the location of upper-left corner of the pixel block in pixel space, and size of the pixel block.

The ScanMode, a write-only property, specifies the pixel block scan mode. The default is line mode. If you wish to change the scan mode, this property must be set immediately after initializing pixel block (calling InitByRawPixels or InitByRaster). The supported 4 scan modes are Line, LineSerpent, Serpent, and alaGIF, with values 0, 1, 3, and 4 respectively.

The UpdateBlockSize method changes the pixel block size for retrieving the next pixel block. This should be used only when reading pixel block from a Raster.

When iterating through the pixel blocks in a RasterBand, you must specify the size of the pixel block at the time of initiating it. After initiation, the size of the pixel block is fixed. When iterating through the pixel blocks in a Raster, the size of the pixel block is determined automatically at the time of initiation. You can modify it later on.