colorDepth property

Gets the number of bits per pixel used for colors on the destination device or buffer.



p = object.colorDepth


Property values

Type: Integer

1, 4, 8, 15, 16, 24, 32

Number of bits per pixel, expressed as an integer, to use for the off-screen buffer. The value 15 specifies 16 bits per pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

Standards information


Retrieving the value of the property through script enables you to select an appropriate color to return to the client.

If bufferDepth is 0 or -1, colorDepth is equal to the bits-per-pixel value for the screen or printer. If bufferDepth is nonzero, colorDepth is equal to bufferDepth.

See also