MonitorDevice.java

Go to the documentation of this file.

/**
 * Copyright 2013 JogAmp Community. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are
 * permitted provided that the following conditions are met:
 *
 *    1. Redistributions of source code must retain the above copyright notice, this list of
 *       conditions and the following disclaimer.
 *
 *    2. Redistributions in binary form must reproduce the above copyright notice, this list
 *       of conditions and the following disclaimer in the documentation and/or other materials
 *       provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * The views and conclusions contained in the software and documentation are those of the
 * authors and should not be interpreted as representing official policies, either expressed
 * or implied, of JogAmp Community.
 */
 
package com.jogamp.newt;
 
import java.util.List;
 
import com.jogamp.nativewindow.ScalableSurface;
import com.jogamp.nativewindow.util.DimensionImmutable;
import com.jogamp.nativewindow.util.Dimension;
import com.jogamp.nativewindow.util.Rectangle;
import com.jogamp.nativewindow.util.RectangleImmutable;
import com.jogamp.nativewindow.util.SurfaceSize;
import com.jogamp.common.util.ArrayHashSet;
import com.jogamp.common.util.PropertyAccess;
 
/**
 * Visual output device, i.e. a CRT, LED ..consisting of it's components:<br>
 * <ui>
 *   <li>Immutable
 *   <ul>
 *     <li>nativeId</li>
 *     <li>{@link DimensionImmutable} size in [mm]</li>
 *     <li>{@link MonitorMode} original mode</li>
 *     <li><code>List&lt;MonitorMode&gt;</code> supportedModes</li>
 *   </ul></li>
 *   <li>Mutable
 *   <ul>
 *     <li>{@link MonitorMode} current mode</li>
 *     <li>{@link RectangleImmutable} viewport (rotated)</li>
 *     <li>pixel-scale (rotated)</li>
 *   </ul></li>
 * </ul>
 * <p>
 * All values of this interface are represented in pixel units, if not stated otherwise.
 * </p>
 *
 * Default monitor properties: 1920x1080 32bpp @ 60Hz, size 421x237 mm, dpi 93.60 x 93.62
 * - Pixel size of via property `newt.monitor.pxwidth` and `newt.monitor.pxheight`
 * - Refresh rate via property `newt.monitor.refresh`
 * - Bits per pixel via property `newt.monitor.bpp`
 * - Display size in millimeter via property `newt.monitor.mmwidth`
 *
 * The defaults are being used either if value could not be retrieved by the driver
 * or if they are overridden via properties.
 */
public abstract class MonitorDevice {
    protected final Screen screen; // backref
    protected final long nativeHandle; // unique monitor device long handle, implementation specific
    protected final int nativeId; // unique monitor device integer Id, implementation specific
    protected final String name; // optional monitor name, maybe an empty string
    protected final DimensionImmutable sizeMM; // in [mm]
    protected final MonitorMode originalMode;
    protected final ArrayHashSet<MonitorMode> supportedModes; // FIXME: May need to support mutable mode, i.e. adding modes on the fly!
    protected final float[] pixelScale;
    protected final Rectangle viewportPU; // in pixel units
    protected final Rectangle viewportWU; // in window units
    protected boolean isClone;
    protected boolean isPrimary;
    protected MonitorMode currentMode;
    protected boolean modeChanged;
 
    /** Pixel size of default Monitor 1920x1080 32bpp @ 60Hz, size 421x237 mm, dpi 93.60 x 93.62. Customizable via property `newt.monitor.pxwidth` and `newt.monitor.pxheight`. */
    public static final DimensionImmutable DEFAULT_MODE_PIXEL_SIZE;
    /** True if DEFAULT_MODE_PIXEL_SIZE is set by properties. */
    public static final boolean DEFAULT_MODE_PIXEL_SIZE_OVERRIDE;
 
    /** Refresh rate of default Monitor 1920x1080 32bpp @ 60Hz, size 421x237 mm, dpi 93.60 x 93.62. Customizable via property `newt.monitor.refresh`. */
    public static final int DEFAULT_MODE_REFRESH;
    /** True if DEFAULT_MODE_REFRESH is set by properties. */
    public static final boolean DEFAULT_MODE_REFRESH_OVERRIDE;
 
    /** Bits per pixel of default Monitor 1920x1080 32bpp @ 60Hz, size 421x237 mm, dpi 93.60 x 93.62. Customizable via property `newt.monitor.bpp`. */
    public static final int DEFAULT_MODE_BPP;
    /** True if DEFAULT_MODE_BPP is set by properties. */
    public static final boolean DEFAULT_MODE_BPP_OVERRIDE;
 
    /** Display size in millimeter of default Monitor 1920x1080 32bpp @ 60Hz, size 421x237 mm, dpi 93.60 x 93.62. Customizable via property `newt.monitor.mmwidth`. */
    public static final DimensionImmutable DEFAULT_SCREEN_MM_SIZE;
    /** True if DEFAULT_SCREEN_MM_SIZE_OVERRIDE is set by properties. */
    public static final boolean DEFAULT_SCREEN_MM_SIZE_OVERRIDE;
 
    static {
        final int mode_px_width = PropertyAccess.getIntProperty("newt.monitor.pxwidth", true, 0);
        final int mode_px_height = PropertyAccess.getIntProperty("newt.monitor.pxheight", true, 0);
        final int mode_refresh = PropertyAccess.getIntProperty("newt.monitor.refresh", true, 0);
        final int mode_bpp = PropertyAccess.getIntProperty("newt.monitor.bpp", true, 0);
        final int screen_mm_width = PropertyAccess.getIntProperty("newt.monitor.mmwidth", true, 0);
        final int screen_mm_height = PropertyAccess.getIntProperty("newt.monitor.mmheight", true, 0);
 
        if( mode_px_width > 0 && mode_px_height > 0 ) {
            DEFAULT_MODE_PIXEL_SIZE = new Dimension(mode_px_width, mode_px_height);
            DEFAULT_MODE_PIXEL_SIZE_OVERRIDE = true;
        } else {
            DEFAULT_MODE_PIXEL_SIZE = new Dimension(1920, 1080);
            DEFAULT_MODE_PIXEL_SIZE_OVERRIDE = false;
        }
        if( mode_refresh > 0 ) {
            DEFAULT_MODE_REFRESH = mode_refresh;
            DEFAULT_MODE_REFRESH_OVERRIDE = true;
        } else {
            DEFAULT_MODE_REFRESH = 60;
            DEFAULT_MODE_REFRESH_OVERRIDE = false;
        }
        if( mode_bpp > 0 ) {
            DEFAULT_MODE_BPP = mode_refresh;
            DEFAULT_MODE_BPP_OVERRIDE = true;
        } else {
            DEFAULT_MODE_BPP = 32;
            DEFAULT_MODE_BPP_OVERRIDE = false;
        }
        if( screen_mm_width > 0 && screen_mm_height > 0 ) {
            DEFAULT_SCREEN_MM_SIZE = new Dimension(screen_mm_width, screen_mm_height);
            DEFAULT_SCREEN_MM_SIZE_OVERRIDE = true;
        } else {
            DEFAULT_SCREEN_MM_SIZE = new Dimension(521, 293);
            DEFAULT_SCREEN_MM_SIZE_OVERRIDE = false;
        }
    }
 
    public static enum Orientation {
        clone(0),
        right_of(1),
        left_of(-1),
        below(2),
        above(-2);
 
        public final int value;
 
        private Orientation(final int v) {
            value = v;
        }
    }
 
    /**
     * Returns the orientation of this monitor to the other
     * @param other the other monitor
     * @param move_diff int[2] to store the move delta for each axis from this-monitor to the other.
     * @return Orientation of this-monitor to the other
     */
    public final Orientation getOrientationTo(final MonitorDevice other, final int move_diff[/*2*/]) {
        Orientation orientation = Orientation.clone;
        // Move from other -> this
        if( null != other ) {
            // Move from vp0 -> vp1
            final RectangleImmutable vp0 = other.getViewport(); // pixel units
            final RectangleImmutable vp1 = this.getViewport(); // pixel units
            if( vp0.getY() == vp1.getY() || vp0.getY() + vp0.getHeight() - 1 == vp1.getY() + vp1.getHeight() - 1 ) {
                // vp0.y == vp1.y, i.e. horizontal move
                if( vp1.getX() > vp0.getX() + vp0.getWidth() - 1 ) {
                    // vp1 right-of vp0
                    move_diff[0] = vp1.getX() - ( vp0.getX() + vp0.getWidth() - 1 ); // > 0
                    orientation = Orientation.right_of;
                } else if( vp1.getX() + vp1.getWidth() - 1 < vp0.getX() ) {
                    // vp1 left-of vp0
                    move_diff[0] = ( vp1.getX() + vp1.getWidth() - 1 ) - vp0.getX(); // < 0
                    orientation = Orientation.left_of;
                } // else same .. i.e. clone
            } else if( vp0.getX() == vp1.getX() || vp0.getX() + vp0.getWidth() - 1 == vp1.getX() + vp1.getWidth() - 1 ) {
                // vp0.x == vp1.x, i.e. vertical move
                if( vp1.getY() + vp0.getHeight() - 1 < vp0.getY() ) {
                    // vp1 above vp0
                    move_diff[1] = ( vp1.getY() + vp1.getHeight() - 1 ) - vp0.getY() ; // < 0
                    orientation = Orientation.above;
                } else if( vp1.getY() > vp0.getY() + vp0.getHeight() - 1 ) {
                    // vp1 below vp0
                    move_diff[1] = vp1.getY() - ( vp0.getY() + vp0.getHeight() - 1 ); // > 0
                    orientation = Orientation.below;
                }
            }
        }
        return orientation;
    }
 
    /**
     * @param screen associated {@link Screen}
     * @param nativeHandle unique monitor device long handle, implementation specific
     * @param nativeId unique monitor device integer Id, implementation specific
     * @param name optional monitor name, maybe null
     * @param isClone flag
     * @param isPrimary flag
     * @param sizeMM size in millimeters
     * @param currentMode
     * @param pixelScale pre-fetched current pixel-scale, maybe {@code null} for {@link ScalableSurface#IDENTITY_PIXELSCALE}.
     * @param viewportPU viewport in pixel-units
     * @param viewportWU viewport in window-units
     * @param supportedModes all supported {@link MonitorMode}s
     */
    protected MonitorDevice(final Screen screen, final long nativeHandle, final int nativeId,
                            final String name, final boolean isClone,
                            final boolean isPrimary, final DimensionImmutable sizeMM, final MonitorMode currentMode,
                            final float[] pixelScale, final Rectangle viewportPU, final Rectangle viewportWU, final ArrayHashSet<MonitorMode> supportedModes) {
        this.screen = screen;
        this.nativeHandle = nativeHandle;
        this.nativeId = nativeId;
        this.name = null != name ? name : "";
        this.sizeMM = sizeMM;
        this.originalMode = currentMode;
        this.supportedModes = supportedModes;
        if( null != pixelScale ) {
            this.pixelScale = new float[] { pixelScale[0], pixelScale[1] };
        } else {
            this.pixelScale = new float[] { ScalableSurface.IDENTITY_PIXELSCALE, ScalableSurface.IDENTITY_PIXELSCALE };
        }
        this.viewportPU = viewportPU;
        this.viewportWU = viewportWU;
 
        this.isClone = isClone;
        this.isPrimary = isPrimary;
        this.currentMode = currentMode;
        this.modeChanged = false;
    }
 
    /** Returns the {@link Screen} owning this monitor. */
    public final Screen getScreen() {
        return screen;
    }
 
    /**
     * Tests equality of two <code>MonitorDevice</code> objects
     * by evaluating equality of it's components:<br>
     * <ul>
     *  <li><code>nativeID</code></li>
     * </ul>
     * <br>
     */
    @Override
    public final boolean equals(final Object obj) {
        if (this == obj) { return true; }
        if (obj instanceof MonitorDevice) {
            final MonitorDevice md = (MonitorDevice)obj;
            return md.nativeId == nativeId;
        }
        return false;
    }
 
    /**
     * Returns a combined hash code of it's elements:<br>
     * <ul>
     *  <li><code>nativeID</code></li>
     * </ul>
     */
    @Override
    public final int hashCode() {
        return nativeId;
    }
 
    /** @return the immutable unique native long handle of this monitor device, implementation specific. */
    public final long getHandle() { return nativeHandle; }
 
    /** @return the immutable unique native integer Id of this monitor device, implementation specific. */
    public final int getId() { return nativeId; }
 
    /** @return optional monitor name, maybe an empty string but never null. */
    public final String getName() { return name; }
 
    /** @return {@code true} if this device represents a <i>clone</i>, otherwise return {@code false}. */
    public final boolean isClone() { return isClone; }
 
    /**
     * Returns {@code true} if this device represents the <i>primary device</i>, otherwise return {@code false}.
     * @see Screen#getPrimaryMonitor()
     */
    public final boolean isPrimary() { return isPrimary; }
 
    /**
     * @return the immutable monitor size in millimeters.
     */
    public final DimensionImmutable getSizeMM() {
        return sizeMM;
    }
 
    /**
     * Returns the <i>pixels per millimeter</i> value according to the <i>current</i> {@link MonitorMode mode}'s
     * {@link SurfaceSize#getResolution() surface resolution}.
     * <p>
     * To convert the result to <i>dpi</i>, i.e. dots-per-inch, multiply both components with <code>25.4f</code>,
     * see {@link #mmToInch(float[])}.
     * </p>
     * @param ppmmStore float[2] storage for the ppmm result
     * @return the passed storage containing the ppmm for chaining
     * @see #mmToInch(float[])
     */
    public final float[] getPixelsPerMM(final float[] ppmmStore) {
        return getPixelsPerMM(getCurrentMode(), ppmmStore);
    }
 
    /**
     * Returns the <i>pixels per millimeter</i> value according to the given {@link MonitorMode mode}'s
     * {@link SurfaceSize#getResolution() surface resolution}.
     * <p>
     * To convert the result to <i>dpi</i>, i.e. dots-per-inch, multiply both components with <code>25.4f</code>.
     * </p>
     * @param mode
     * @param ppmmStore float[2] storage for the ppmm result
     * @return the passed storage containing the ppmm for chaining
     */
    public final float[] getPixelsPerMM(final MonitorMode mode, final float[] ppmmStore) {
        final DimensionImmutable sdim = getSizeMM();
        final DimensionImmutable spix = mode.getSurfaceSize().getResolution();
        ppmmStore[0] = (float)spix.getWidth() / (float)sdim.getWidth();
        ppmmStore[1] = (float)spix.getHeight() / (float)sdim.getHeight();
        return ppmmStore;
    }
 
    /**
     * Converts [1/mm] to [1/inch] from ppmm into result.
     * @param ppmm float[2] [1/mm] value, unmodified
     * @return return result w/ [1/inch] value
     */
    public static float[/*2*/] mmToInch(final float[/*2*/] result, final float[/*2*/] ppmm) {
        result[0] = ppmm[0] * 25.4f;
        result[1] = ppmm[1] * 25.4f;
        return result;
    }
    /**
     * Converts [1/mm] to [1/inch] in place
     * @param ppmm float[2] [1/mm] value, modified
     * @return return [1/inch] value
     */
    public static float[/*2*/] mmToInch(final float[/*2*/] ppmm) {
        ppmm[0] *= 25.4f;
        ppmm[1] *= 25.4f;
        return ppmm;
    }
    /**
     * Converts [1/mm] to [1/inch]
     * @param ppmm [1/mm] value
     * @return return [1/inch] value
     */
    public static float mmToInch(final float ppmm) {
        return ppmm * 25.4f;
    }
 
    /**
     * Converts [1/inch] to [1/mm] in place
     * @param ppinch float[2] [1/inch] value, unmodified
     * @return return [1/mm] value
     */
    public static float[/*2*/] inchToMM(final float[/*2*/] result, final float[/*2*/] ppinch) {
        result[0] = ppinch[0] / 25.4f;
        result[1] = ppinch[1] / 25.4f;
        return result;
    }
    /**
     * Converts [1/inch] to [1/mm] in place
     * @param ppinch float[2] [1/inch] value, modified
     * @return return [1/mm] value
     */
    public static float[/*2*/] inchToMM(final float[/*2*/] ppinch) {
        ppinch[0] /= 25.4f;
        ppinch[1] /= 25.4f;
        return ppinch;
    }
    /**
     * Converts [1/inch] to [1/mm]
     * @param ppinch [1/inch] value
     * @return return [1/mm] value
     */
    public static float inchToMM(final float ppinch) {
        return ppinch / 25.4f;
    }
 
    /**
     * Returns the immutable original {@link com.jogamp.newt.MonitorMode}, as used at NEWT initialization.
     * <p>
     * The returned {@link MonitorMode} is element of the lists {@link #getSupportedModes()} and {@link Screen#getMonitorModes()}.
     * </p>
     */
    public final MonitorMode getOriginalMode() {
        return originalMode;
    }
 
    /**
     * Returns a list of immutable {@link MonitorMode}s supported by this monitor.
     * <p>
     * The list is ordered in descending order,
     * see {@link MonitorMode#compareTo(MonitorMode)}.
     * </p>
     * <p>
     * Use w/ care, it's not a copy!
     * </p>
     */
    public final List<MonitorMode> getSupportedModes() {
        return supportedModes.getData();
    }
 
    /**
     * Returns the current {@link RectangleImmutable rectangular} portion
     * of the <b>rotated</b> virtual {@link Screen} size in pixel units
     * represented by this monitor, i.e. top-left origin and size.
     * @see #getPixelScale()
     * @see Screen#getViewport()
     */
    public final RectangleImmutable getViewport() {
        return viewportPU;
    }
 
    /**
     * Returns the current {@link RectangleImmutable rectangular} portion
     * of the <b>rotated</b> virtual {@link Screen} size in window units
     * represented by this monitor, i.e. top-left origin and size.
     * @see #getPixelScale()
     * @see Screen#getViewportInWindowUnits()
     */
    public final RectangleImmutable getViewportInWindowUnits() {
        return viewportWU;
    }
 
    /**
     * Returns the current <b>rotated</b> pixel-scale
     * of this monitor, i.e. horizontal and vertical.
     * @see #getViewportInWindowUnits()
     * @see #getViewport()
     * @see ScalableSurface#getMaximumSurfaceScale(float[])
     */
    public float[] getPixelScale(final float[] result) {
        System.arraycopy(pixelScale, 0, result, 0, 2);
        return result;
    }
 
    /**
     * Returns <code>true</code> if given screen coordinates in pixel units
     * are contained by this {@link #getViewport() viewport}, otherwise <code>false</code>.
     * @param x x-coord in pixel units
     * @param y y-coord in pixel units
     */
    public final boolean contains(final int x, final int y) {
        return x >= viewportPU.getX() &&
               x <  viewportPU.getX() + viewportPU.getWidth() &&
               y >= viewportPU.getY() &&
               y <  viewportPU.getY() + viewportPU.getHeight() ;
    }
 
    /**
     * Calculates the union of the given monitor's {@link #getViewport() viewport} in pixel- and window units.
     * @param viewport storage for result in pixel units, maybe null
     * @param viewportInWindowUnits storage for result in window units, maybe null
     * @param monitors given list of monitors
     */
    public static void unionOfViewports(final Rectangle viewport, final Rectangle viewportInWindowUnits, final List<MonitorDevice> monitors) {
        int x1PU=Integer.MAX_VALUE, y1PU=Integer.MAX_VALUE;
        int x2PU=Integer.MIN_VALUE, y2PU=Integer.MIN_VALUE;
        int x1WU=Integer.MAX_VALUE, y1WU=Integer.MAX_VALUE;
        int x2WU=Integer.MIN_VALUE, y2WU=Integer.MIN_VALUE;
        for(int i=monitors.size()-1; i>=0; i--) {
            if( null != viewport ) {
                final RectangleImmutable viewPU = monitors.get(i).getViewport();
                x1PU = Math.min(x1PU, viewPU.getX());
                x2PU = Math.max(x2PU, viewPU.getX() + viewPU.getWidth());
                y1PU = Math.min(y1PU, viewPU.getY());
                y2PU = Math.max(y2PU, viewPU.getY() + viewPU.getHeight());
            }
            if( null != viewportInWindowUnits ) {
                final RectangleImmutable viewWU = monitors.get(i).getViewportInWindowUnits();
                x1WU = Math.min(x1WU, viewWU.getX());
                x2WU = Math.max(x2WU, viewWU.getX() + viewWU.getWidth());
                y1WU = Math.min(y1WU, viewWU.getY());
                y2WU = Math.max(y2WU, viewWU.getY() + viewWU.getHeight());
            }
        }
        if( null != viewport ) {
            viewport.set(x1PU, y1PU, x2PU - x1PU, y2PU - y1PU);
        }
        if( null != viewportInWindowUnits ) {
            viewportInWindowUnits.set(x1WU, y1WU, x2WU - x1WU, y2WU - y1WU);
        }
    }
 
    public final boolean isOriginalMode() {
        return currentMode.hashCode() == originalMode.hashCode();
    }
 
    /**
     * Returns <code>true</true> if the {@link MonitorMode}
     * has been changed programmatic via this API <i>only</i>, otherwise <code>false</code>.
     * <p>
     * Note: We cannot guarantee that we won't interfere w/ another running
     * application's screen mode change or vice versa.
     * </p>
     */
    public final boolean isModeChangedByUs() {
        return modeChanged && !isOriginalMode();
    }
 
    /**
     * Returns the cached current {@link MonitorMode} w/o native query.
     * <p>
     * The returned {@link MonitorMode} is element of the lists {@link #getSupportedModes()} and {@link Screen#getMonitorModes()}.
     * </p>
     * @see #queryCurrentMode()
     */
    public final MonitorMode getCurrentMode() {
        return currentMode;
    }
 
    /**
     * Returns the current {@link MonitorMode} resulting from a native query.
     * <p>
     * The returned {@link MonitorMode} is element of the lists {@link #getSupportedModes()} and {@link Screen#getMonitorModes()}.
     * </p>
     * @throws IllegalStateException if the {@link #getScreen() associated screen} is not {@link Screen#isNativeValid() valid natively}.
     * @see #getCurrentMode()
     */
    public abstract MonitorMode queryCurrentMode() throws IllegalStateException;
 
    /**
     * Set the current {@link com.jogamp.newt.MonitorMode}.
     * <p>This method is <a href="Window.html#lifecycleHeavy">lifecycle heavy</a>.</p>
     * @param mode to be made current, must be element of the list {@link #getSupportedModes()} and {@link Screen#getMonitorModes()}.
     * @return true if successful, otherwise false
     * @throws IllegalStateException if the {@link #getScreen() associated screen} is not {@link Screen#isNativeValid() valid natively}.
     */
    public abstract boolean setCurrentMode(MonitorMode mode) throws IllegalStateException;
 
    @Override
    public String toString() {
        boolean preComma = false;
        final StringBuilder sb = new StringBuilder();
        sb.append("Monitor[Id ").append(Display.toHexString(nativeId)).append(" [");
        {
            if( !name.isEmpty() ) {
                if( preComma ) {
                    sb.append(", ");
                }
                sb.append("name ").append("'").append(name).append("'");
                preComma = true;
            }
            if( nativeHandle != nativeId ) {
                if( preComma ) {
                    sb.append(", ");
                }
                sb.append("handle ").append(Display.toHexString(nativeHandle));
                preComma = true;
            }
            if( isClone() ) {
                if( preComma ) {
                    sb.append(", ");
                }
                sb.append("clone");
                preComma = true;
            }
            if( isPrimary() ) {
                if( preComma ) {
                    sb.append(", ");
                }
                sb.append("primary");
            }
        }
        preComma = false;
        sb.append("], ").append(sizeMM).append(" mm, pixelScale [").append(pixelScale[0]).append(", ")
        .append(pixelScale[1]).append("], viewport[pixel ").append(viewportPU).append(", window ").append(viewportWU)
        .append("], orig ").append(originalMode).append(", curr ")
        .append(currentMode).append(", modeChanged ").append(modeChanged).append(", modeCount ")
        .append(supportedModes.size()).append("]");
        return sb.toString();
    }
}