# Metadata
Platforms: desktop, server OS: mac, windows, linux Introduced: 1.0 Security:
# Syntax
the screenDepth
# Examples
the screenDepth
if the screenDepth > 8 then show image "Photograph"
# Description
Use the screenDepth function to determine the color capacity of the screen. For example, you might display different images depending on the number of colors available.
If the system has more than one monitor, the screenDepth function returns the bit depth of the main screen.
The expression
2 ^ (the screenDepth)
is equal to
the screenColors
The value returned by the screenDepth function is updated only when you start up the application. If you change the screen settings after starting up the application, you must quit and restart to update the screenDepth.
When the environment is "command line", the screenDepth is 0.
# Tags
# See
- **property:** colorWorld, dontDither - **glossary:** bit depth, return, application - **command:** unlock colorMap - **object:** image - **function:** environment, screenType - **control structure:** function