ArcGIS Developer Help

IPixelBlock Interface

Provides access to members that control a PixelBlock.

Product Availability

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

Members

	Name	Description
	BytesPerPixel	The number of bytes per pixel for the PixelBlock.
	GetVal	The value for a specified pixel.
	Height	The height of the PixelBlock in pixels.
	PixelType	The pixel type of the PixelBlock.
	Planes	The number of pixel arrays contained in the PixelBlock.
	SafeArray	A variant SafeArray of pixels for a specified plane.
	Width	The width of the PixelBlock in pixels.

Classes that implement IPixelBlock

Classes	Description
PixelBlock (esriDataSourcesRaster)	Esri PixelBlock, a container of pixel data.

Remarks

The Height and Width properties return the number of rows and columns in the PixelBlock.

The Planes argument returns the number of bands in the PixelBlock.

The PixelType property specifies the data type and bit depth of the pixels in the specified band.The SafeArray property specifies the variant SafeArray for the specified band. At ArcGIS 9.0 and later, this property returns SafeArray by value, not by reference like it does in ArcGIS 8.x. Your application, if only reads pixel values from SafeArray, will not be affected by this change. However, if your application involves modifying and writing pixel block to the band, you might experience a different behavior. The recommended fix is to use IPixelBlock3::PixelDataByRef method.

The GetVal method returns an individual value for the pixel specified by the band and pixel location input.

.NET Samples

Create a custom NoData pixel filter Create a custom raster function Create an NDVI custom raster function