Sets or retrieves the number of bits per pixel used for colors in the off-screen bitmap buffer.

Syntax

screen.bufferDepth(v) [ = iBitsPerPixel ]

Possible Values

iBitsPerPixel

Integer that specifies or receives one of the following values. 0 Default. No explicit buffering occurs. The colorDepth property is set to the screen depth. -1 Buffering occurs at screen depth. The colorDepth property is set to the screen depth. 1, 4, 8, 15, 16, 24, 32 Number of bits per pixel to use for the off-screen buffer. The colorDepth property is also set to this value. The value 15 specifies 16 bits per pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

The property is read/write. The property has a default value of 0.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

Nonsupported values cause bufferDepth to be set to -1.

When bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth is automatically updated to the new depth. This is not the case if bufferDepth is set to a specific value.

Standards Information

There is no public standard that applies to this property.

Applies To

	screen