/*
* Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt;
import java.lang.annotation.Native;
The DisplayMode class encapsulates the bit depth, height, width, and refresh rate of a GraphicsDevice. The ability to change graphics device's display mode is platform- and configuration-dependent and may not always be available (see GraphicsDevice.isDisplayChangeSupported).
For more information on full-screen exclusive mode API, see the
Full-Screen Exclusive Mode API Tutorial.
Author: Michael Martak See Also: Since: 1.4
/**
* The {@code DisplayMode} class encapsulates the bit depth, height,
* width, and refresh rate of a {@code GraphicsDevice}. The ability to
* change graphics device's display mode is platform- and
* configuration-dependent and may not always be available
* (see {@link GraphicsDevice#isDisplayChangeSupported}).
* <p>
* For more information on full-screen exclusive mode API, see the
* <a href="http://docs.oracle.com/javase/tutorial/extra/fullscreen/index.html">
* Full-Screen Exclusive Mode API Tutorial</a>.
*
* @see GraphicsDevice
* @see GraphicsDevice#isDisplayChangeSupported
* @see GraphicsDevice#getDisplayModes
* @see GraphicsDevice#setDisplayMode
* @author Michael Martak
* @since 1.4
*/
public final class DisplayMode {
private Dimension size;
private int bitDepth;
private int refreshRate;
Create a new display mode object with the supplied parameters.
Params: - width – the width of the display, in pixels
- height – the height of the display, in pixels
- bitDepth – the bit depth of the display, in bits per pixel. This can be
BIT_DEPTH_MULTI if multiple bit depths are available. - refreshRate – the refresh rate of the display, in hertz. This can be
REFRESH_RATE_UNKNOWN if the information is not available.
See Also:
/**
* Create a new display mode object with the supplied parameters.
* @param width the width of the display, in pixels
* @param height the height of the display, in pixels
* @param bitDepth the bit depth of the display, in bits per
* pixel. This can be {@code BIT_DEPTH_MULTI} if multiple
* bit depths are available.
* @param refreshRate the refresh rate of the display, in hertz.
* This can be {@code REFRESH_RATE_UNKNOWN} if the
* information is not available.
* @see #BIT_DEPTH_MULTI
* @see #REFRESH_RATE_UNKNOWN
*/
public DisplayMode(int width, int height, int bitDepth, int refreshRate) {
this.size = new Dimension(width, height);
this.bitDepth = bitDepth;
this.refreshRate = refreshRate;
}
Returns the height of the display, in pixels.
Returns: the height of the display, in pixels
/**
* Returns the height of the display, in pixels.
* @return the height of the display, in pixels
*/
public int getHeight() {
return size.height;
}
Returns the width of the display, in pixels.
Returns: the width of the display, in pixels
/**
* Returns the width of the display, in pixels.
* @return the width of the display, in pixels
*/
public int getWidth() {
return size.width;
}
Value of the bit depth if multiple bit depths are supported in this
display mode.
See Also: - getBitDepth
/**
* Value of the bit depth if multiple bit depths are supported in this
* display mode.
* @see #getBitDepth
*/
@Native public static final int BIT_DEPTH_MULTI = -1;
Returns the bit depth of the display, in bits per pixel. This may be BIT_DEPTH_MULTI if multiple bit depths are supported in this display mode. See Also: Returns: the bit depth of the display, in bits per pixel.
/**
* Returns the bit depth of the display, in bits per pixel. This may be
* {@code BIT_DEPTH_MULTI} if multiple bit depths are supported in
* this display mode.
*
* @return the bit depth of the display, in bits per pixel.
* @see #BIT_DEPTH_MULTI
*/
public int getBitDepth() {
return bitDepth;
}
Value of the refresh rate if not known.
See Also: - getRefreshRate
/**
* Value of the refresh rate if not known.
* @see #getRefreshRate
*/
@Native public static final int REFRESH_RATE_UNKNOWN = 0;
Returns the refresh rate of the display, in hertz. This may be REFRESH_RATE_UNKNOWN if the information is not available. See Also: Returns: the refresh rate of the display, in hertz.
/**
* Returns the refresh rate of the display, in hertz. This may be
* {@code REFRESH_RATE_UNKNOWN} if the information is not available.
*
* @return the refresh rate of the display, in hertz.
* @see #REFRESH_RATE_UNKNOWN
*/
public int getRefreshRate() {
return refreshRate;
}
Returns whether the two display modes are equal.
Params: - dm – the display mode to compare to
Returns: whether the two display modes are equal
/**
* Returns whether the two display modes are equal.
*
* @param dm the display mode to compare to
* @return whether the two display modes are equal
*/
public boolean equals(DisplayMode dm) {
if (dm == null) {
return false;
}
return (getHeight() == dm.getHeight()
&& getWidth() == dm.getWidth()
&& getBitDepth() == dm.getBitDepth()
&& getRefreshRate() == dm.getRefreshRate());
}
{@inheritDoc}
/**
* {@inheritDoc}
*/
@Override
public boolean equals(Object dm) {
if (dm instanceof DisplayMode) {
return equals((DisplayMode)dm);
} else {
return false;
}
}
{@inheritDoc}
/**
* {@inheritDoc}
*/
@Override
public int hashCode() {
return getWidth() + getHeight() + getBitDepth() * 7
+ getRefreshRate() * 13;
}
{@inheritDoc}
/**
* {@inheritDoc}
*/
@Override
public String toString() {
return getWidth() + "x" + getHeight() + "x" +
(getBitDepth() > 0 ? getBitDepth() + "bpp": "[Multi depth]")
+ "@" + (getRefreshRate() > 0 ? getRefreshRate() + "Hz" :
"[Unknown refresh rate]");
}
}