import com.jogamp.newt.util.MonitorModeUtil;

* Immutable MonitorMode Class, consisting of it's read only components:<br>

* <ul>

* <li>nativeId</li>

// Pick the monitor:

// Either the one used by a window ..

MonitorDevice monitor = window.getMainMonitor();

// Or arbitrary from the list ..

List<MonitorDevice> allMonitor = getMonitorDevices();

MonitorDevice monitor = allMonitor.get(0);

// Current and original modes ..

MonitorMode mmCurrent = monitor.queryCurrentMode();

MonitorMode mmOrig = monitor.getOriginalMode();

// Target resolution

Dimension res = new Dimension(800, 600);

monitorModes = MonitorModeUtil.filterByFlags(monitorModes, 0); // no interlace, double-scan etc

monitorModes = MonitorModeUtil.filterByRotation(monitorModes, rot);

monitorModes = MonitorModeUtil.filterByResolution(monitorModes, res);

monitorModes = MonitorModeUtil.getHighestAvailableBpp(monitorModes);

// pick 1st one and set to current ..

* </pre>

*/

public class MonitorMode implements Comparable<MonitorMode> {

/** Comparator for 2 {@link MonitorMode}s, following comparison order as described in {@link MonitorMode#compareTo(MonitorMode)}, returning the ascending order. */

public static final Comparator<MonitorMode> monitorModeComparator = new Comparator<MonitorMode>() {

public int compare(MonitorMode mm1, MonitorMode mm2) {

return mm1.compareTo(mm2);

} };

/** Comparator for 2 {@link MonitorMode}s, following comparison order as described in {@link MonitorMode#compareTo(MonitorMode)}, returning the descending order. */

public static final Comparator<MonitorMode> monitorModeComparatorInv = new Comparator<MonitorMode>() {

public int compare(MonitorMode mm1, MonitorMode mm2) {

return mm2.compareTo(mm1);

} };

* Immutable <i>surfaceSize, flags and refreshRate</i> Class, consisting of it's read only components:<br>

* <ul>

* <li>nativeId</li>

/** Vertical refresh rate */

public final float refreshRate;

public final int hashCode;

public SizeAndRRate(SurfaceSize surfaceSize, float refreshRate, int flags) {

if(null==surfaceSize) {

throw new IllegalArgumentException("surfaceSize must be set ("+surfaceSize+")");

this.refreshRate=refreshRate;

this.hashCode = getHashCode();

}

private final static String STR_INTERLACE = "Interlace";

private final static String STR_DOUBLESCAN = "DoubleScan";

private final static String STR_SEP = ", ";

public static final StringBuilder flags2String(int flags) {

final StringBuilder sb = new StringBuilder();

boolean sp = false;

}

return sb;

}

public final String toString() {

return new String(surfaceSize+" @ "+refreshRate+" Hz, flags ["+flags2String(flags).toString()+"]");

}

/**

* <p>

* Compares {@link SurfaceSize#compareTo(SurfaceSize) surfaceSize} 1st, then {@link #flags}, then {@link #refreshRate}.

* <p>

* Flags are compared as follows:

* <pre>

final int rssz = surfaceSize.compareTo(sszr.surfaceSize);

if( 0 != rssz ) {

return rssz;

final int tflags = 0 == flags ? Integer.MAX_VALUE : flags; // normalize NONE

final int xflags = 0 == sszr.flags ? Integer.MAX_VALUE : sszr.flags; // normalize NONE

if( tflags == xflags ) {

return 0;

}

}

/**

* by evaluating equality of it's components:<br/>

* <ul>

* <li><code>surfaceSize</code></li>

* <li><code>flags</code></li>

* </ul>

*/

public final boolean equals(Object obj) {

if (this == obj) { return true; }

if (obj instanceof SizeAndRRate) {

}

return false;

}

/**

* Returns a combined hash code of it's elements:<br/>

* <ul>

* <li><code>refreshRate</code></li>

* </ul>

*/

public final int hashCode() {

return hashCode;

private final int getHashCode() {

// 31 * x == (x << 5) - x

int hash = 31 + surfaceSize.hashCode();

hash = ((hash << 5) - hash) + flags;

hash = ((hash << 5) - hash) + (int)(refreshRate*100.0f);

return hash;

}

/** zero rotation, compared to normal settings */

public static final int ROTATE_0 = 0;

/** 270 degrees CCW rotation */

public static final int ROTATE_270 = 270;

/** Frame is split into two fields. See {@link #getFlags()}. */

public static final int FLAG_INTERLACE = 1 << 0;

/** Lines are doubled. See {@link #getFlags()}. */

public static final int FLAG_DOUBLESCAN = 1 << 1;

/** The immutable native Id of this instance, which may not be unique. */

private final SizeAndRRate sizeAndRRate;

private final int rotation;

private final int hashCode;

this.rotation = rotation;

this.hashCode = getHashCode();

}

/**

* Creates a user instance w/o {@link #getId() identity} to filter our matching modes w/ identity.

* <p>

*/

public MonitorMode(SurfaceSize surfaceSize, float refreshRate, int flags, int rotation) {

this(0, new SizeAndRRate(surfaceSize, refreshRate, flags), rotation);

/** @return the immutable native Id of this mode, may not be unique, may be 0. */

public final int getId() { return nativeId; }

/** Returns the <i>surfaceSize and refreshRate</i> instance. */

return sizeAndRRate;

}

/** Returns the unrotated {@link SurfaceSize} */

public final SurfaceSize getSurfaceSize() {

return sizeAndRRate.surfaceSize;

public final int getFlags() {

return sizeAndRRate.flags;

}

/** Returns the CCW rotation of this mode */

public final int getRotation() {

return rotation;

}

* derived from <code>getMonitorMode().getSurfaceSize().getResolution()</code>

*/

public final int getRotatedWidth() {

return getRotatedWH(true);

}

* derived from <code>getMonitorMode().getSurfaceSize().getResolution()</code>

*/

public final int getRotatedHeight() {

return getRotatedWH(false);

}

public final String toString() {

return "[Id "+Display.toHexString(nativeId)+", " + sizeAndRRate + ", " + rotation + " degr]";

}

/**

* <p>

* Compares {@link SizeAndRRate#compareTo(SizeAndRRate) sizeAndRRate} 1st, then {@link #rotation}.

* <p>

* so the lowest rotation reflects a higher value.

* </p>

* <p>

* <li>flags</li>

* <li>refresh rate</li>

* <li>rotation</li>

* </p>

* {@inheritDoc}

*/

}

return 0;

}

/**

* by evaluating equality of it's components:<br/>

* <ul>

* <li><code>nativeId</code></li>

* <li><code>rotation</code></li>

* </ul>

*/

public final boolean equals(Object obj) {

if (this == obj) { return true; }

if (obj instanceof MonitorMode) {

* <li><code>rotation</code></li>

* </ul>

*/

public final int hashCode() {

return hashCode;

}

hash = ((hash << 5) - hash) + getRotation();

return hash;

}

private final int getRotatedWH(boolean width) {

final DimensionImmutable d = sizeAndRRate.surfaceSize.getResolution();

final boolean swap = MonitorMode.ROTATE_90 == rotation || MonitorMode.ROTATE_270 == rotation ;

return d.getHeight();

}

return d.getWidth();

}