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


IPixelBlock3.NoDataMask Property (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (DataSourcesRaster)  

IPixelBlock3.NoDataMask Property

The NoData mask for a specified plane.

[Visual Basic .NET]
Public Function get_NoDataMask ( _
    ByVal plane As Integer _
) As Object
[Visual Basic .NET]
Public Sub set_NoDataMask ( _
    ByVal plane As Integer, _
    ByVal pVal As Object _
)
[C#]
public object get_NoDataMask (
    int plane
);
[C#]
public void set_NoDataMask (
    int plane,
    object pVal
);
[C++]
HRESULT get_NoDataMask(
  long plane,
  VARIANT* pVal
);
[C++]
HRESULT put_NoDataMask(
  long plane,
  VARIANT pVal
);
[C++]

Parameters plane [in] plane is a parameter of type long pVal [out, retval] pVal is a parameter of type VARIANT plane [in] plane is a parameter of type long pVal [in] pVal is a parameter of type VARIANT

Product Availability

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

Description

Conceptually, a NoData mask is a two-dimensional array with values 0 and 1. Each element in the two-dimensional array is correspondent to a pixel in a raster; 1 indicates the pixel is a value pixel and 0 means the pixel is NoData.

In order to save space, the NoData mask is actually stored as a one-dimensional array of byte. Each byte is used to represent NoData value flags for 8 correspondent pixels.

If the image (or SafeArray) has an dimension of nxn, the length of the array returned from NoDataMask will be (n*n+7)/7

 

 

See Also

IPixelBlock3 Interface

.NET Samples

Create a custom NoData pixel filter (Code Files: NodataFilter)