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


IPixelBlock3 Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (DataSourcesRaster)  

IPixelBlock3 Interface

Provides access to members that control a PixelBlock.

Product Availability

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

Description

The IPixelBlock3 interface provides all the functionality of IPixelBlock interface, plus more properties on mask based NoData and SafeArray handling.

Basically, there are two ways to work with NoData mask and pixel values. They are by value (PixelData and NoDataMask properties) and by reference (PixelDataByRef and NoDataMaskByRef). Normally passing pixel values by reference is recommented since it saves memory. However for Java and .Net, passing by value (PixelData) should be used.

Members

Description
Read-only property BytesPerPixel The number of bytes per pixel for the PixelBlock.
Method Clear Clears a given plane (sets to NoData).
Method GetNoDataMaskVal Gets the NoData mask value for a specified pixel.
Method GetVal The value for a specified pixel.
Method HasNoData Checks if this PixelBlock contains NoData.
Read-only property Height The height of the PixelBlock in pixels.
Method Mask Generates NoData Mask using a given NoData value.
Read/write property NoDataMask The NoData mask for a specified plane.
Read-only property NoDataMaskByRef The NoData mask for a specified plane.
Read/write property PixelData An array of pixels for a specified plane.
Read-only property PixelDataByRef A pointer to an array of pixels for a specified plane.
Read/write property PixelType The pixel type of the PixelBlock.
Read-only property Planes The number of pixel arrays contained in the PixelBlock.
Read-only property Width The width of the PixelBlock in pixels.

CoClasses that implement IPixelBlock3

CoClasses and Classes Description
PixelBlock Esri PixelBlock, a container of pixel data.

.NET Samples

Create a custom NoData pixel filter (Code Files: NodataFilter) | Create an NDVI custom raster function (Code Files: NDVICustomFunction) | Create a custom raster function (Code Files: WatermarkFunction)

.NET Related Topics

DataSourcesRaster | How to access pixel data using a raster cursor | How to create a raster dataset