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

IPixelBlock Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IP > IPixelBlock Interface
ArcGIS Developer Help

IPixelBlock Interface

Provides access to members that control a PixelBlock.

Product Availability

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


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

Classes that implement IPixelBlock

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


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.

See Also

IPixelBlock3 Interface

.NET Samples

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