ST_CellDepth

Updated at:
Copy as MD

Returns the pixel depth, in bits, of a raster object.

Syntax

integer ST_CellDepth(raster raster_obj);

Parameters

ParameterDescription
raster_objThe raster object.

Return values

An integer representing the pixel depth in bits. Valid values:

Return valueDescription
0Unknown pixel depth.
11-bit pixel depth.
22-bit pixel depth.
44-bit pixel depth.
88-bit pixel depth.
1616-bit pixel depth.
3232-bit pixel depth.
6464-bit pixel depth.

Examples

Query the pixel depth of a raster object:

SELECT ST_CellDepth(raster_obj) FROM raster_table;

Expected output:

8

The output 8 indicates an 8-bit pixel depth.