JDK-5094347 : clarify GraphicsDevice.setDisplayMode() spec regarding BIT_DEPTH_MULTI
  • Type: Bug
  • Component: client-libs
  • Sub-Component: 2d
  • Affected Version: 6
  • Priority: P2
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2004-08-30
  • Updated: 2017-05-16
  • Resolved: 2006-08-10
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 6
6 b95Fixed
Related Reports
Relates :  
Relates :  
Relates :  
Description
The setDisplayMode() specification is not clear about the interpretation of the
BIT_DEPTH_MULTI constant.  This has become an issue now that DisplayMode
switching and fullscreen exclusive mode are available on Linux, where we have
historically used BIT_DEPTH_MULTI to describe the bit depth on those
configurations.

There are a couple questions to address here:

- Should we interpret BIT_DEPTH_MULTI as "any bit depth"?  For example, if an
application calls setDisplayMode() with BIT_DEPTH_MULTI, should we just select
any available DisplayMode that matches otherwise (width, height, refresh rate)?
(This is similar to the question posed in 5041225, where we now will pick some
DisplayMode if the user specifies REFRESH_RATE_UNKNOWN, as long as the mode
matches otherwise (the width, height, and bit depth all match.)

- Likewise, if the application tries to set a DisplayMode with a bit depth of,
say 32, should we treat that as a successful match to BIT_DEPTH_MULTI?  Many
fullscreen apps have been written already with Windows in mind, where 32-bit
DisplayModes are almost always available, so developers may be in for a surprise
when they try their app on Linux, where 32-bit mode may not be enabled for
their particular configuration.  (Many distros default to 16-bit mode, for
example...)

There are no clear cut answers here, but we should give these issues some
thought to help solidify the spec in this area.

Comments
SUGGESTED FIX http://javaweb.sfbay/jcg/1.6.0-mustang/2D/5094347/
31-07-2006

EVALUATION After some discussion, I think we've determined that the answer to both questions above should be "no", so we should clarify the spec to that extent. This will be addressed as part of the fix for 6430607. Transferring to the engineer responsible for that fix.
25-07-2006

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mustang
31-08-2004

EVALUATION Should be clarified in the Mustang timeframe, since display mode switching and fullscreen exclusive mode will be possible on Linux in that release. ###@###.### 2004-08-30
30-08-2004