Sets the gamma, brightness, and contrast of the display associated with the given
surface
.
This functionality is not available on all platforms and
graphics hardware. Returns true if the settings were successfully
changed, false if not. This method may return false for some
values of the incoming arguments even on hardware which does
support the underlying functionality.
If this method returns true, the display settings will
automatically be reset to their original values upon JVM exit
(assuming the JVM does not crash); if the user wishes to change
the display settings back to normal ahead of time,
use
#resetDisplayGamma(NativeSurface) or
#resetAllDisplayGamma().
It is recommended to call
#resetDisplayGamma(NativeSurface) or
#resetAllDisplayGamma()before calling e.g. System.exit()
from the application rather than
rely on the shutdown hook functionality due to inevitable race
conditions and unspecified behavior during JVM teardown.
This method may be called multiple times during the application's
execution, but calling
#resetDisplayGamma(NativeSurface)will only reset the settings to the values
before the first call to this method.