SDO_GEOR.setNODATAMask

Format

SDO_GEOR.setNODATAMask(
     georaster     IN OUT SDO_GEORASTER,
     layerNumber   IN NUMBER,
     isNODATAMask  IN VARCHAR2);

Description

Specifies whether a bitmap mask of the specified GeoRaster layer is a NODATA mask, and updates the GeoRaster metadata accordingly.

Parameters

georaster

GeoRaster object.

layerNumber

Layer with the relevant bitmap mask. A value of 0 (zero) indicates the object layer.

mask

The bitmap mask to be attached to the GeoRaster object. If this parameter is null, any existing bitmap mask associated with the specified layer of the GeoRaster object is removed.

isNODATAMask

Specifies whether the bitmap mask of the layerNumber layer is to be interpreted as a NODATA mask. The string TRUE causes that bitmap mask to be interpreted as a NODATA mask; the string FALSE causes that bitmap mask not to be interpreted as a NODATA mask.

Usage Notes

For information about a bitmap mask being treated as a special type of NODATA, that is, a NODATA mask specifying one or more irregular areas as NODATA areas, see NODATA Values and Value Ranges.

Examples

The following example sets the bitmap mask of sublayer 1 to be a NODATA mask.

declare
    gr sdo_georaster;
begin
     select georaster into gr from georaster_table where georid=1 for update;
     sdo_geor.setNODATAMask(gr, 1, 'true');
      update georaster_table set georster=gr where georid=1;
      commit;
end;