long setBrightness(int intensity)

This method changes the brightness of all views to intensity, a value between 1 and 255, where 255 implies normal brightness and 1 implies complete blackness. Thus, an intensity of 128 would result in 50% of normal brightness.

The method does not effect transient layers, nor does it effect the background color of the views.  Therefore, applications that require effective dimming should use black as the background color (See CARIS Color Map File).

This method returns 0 upon success, and returns an error code if intensity is out of range.