Class MonitorMode

Immutable MonitorMode Class, consisting of it's read only components:

• nativeId
• MonitorMode.SizeAndRRate, consist out of non rotated surface size, refresh rate and flags.
• rotation, measured counter clockwise (CCW)

Aquire and filter MonitorMode

• MonitorDevice Selection:
  • A List of all MonitorDevices is accessible via Screen.getMonitorDevices().
  • The main monitor used by a windows is accessible via Window.getMainMonitor().
  • The main monitor covering an arbitrary rectangle is accessible via Screen.getMainMonitor(RectangleImmutable).
• The current MonitorMode can be obtained via MonitorDevice.getCurrentMode().
• The original MonitorMode can be obtained via MonitorDevice.getOriginalMode().
• MonitorMode Filtering:
  • A MonitorDevice's MonitorModes is accessible via MonitorDevice.getSupportedModes().
  • You may utilize MonitorModeUtil to filter and select a desired MonitorMode.

Changing MonitorMode

• Use MonitorDevice.setCurrentMode(MonitorMode) to change the current MonitorMode for all Screens referenced via the full qualified name (FQN).
• The original mode is restored when
  • the last FQN referenced Screen closes.
  • the JVM shuts down.

Example for changing the MonitorMode:

        // Pick the monitor:
        // Either the one used by a window ..
        MonitorDevice monitor = window.getMainMonitor();

        // Or arbitrary from the list ..
        List allMonitor = getMonitorDevices();
        MonitorDevice monitor = allMonitor.get(0);

        // Current and original modes ..
        MonitorMode mmCurrent = monitor.queryCurrentMode();
        MonitorMode mmOrig = monitor.getOriginalMode();

        // Target resolution in pixel units
        DimensionImmutable res = new Dimension(800, 600);

        // Target refresh rate shall be similar to current one ..
        float freq = mmCurrent.getRefreshRate();

        // Target rotation shall be similar to current one
        int rot = mmCurrent.getRotation();

        // Filter criterias sequential out of all available MonitorMode of the chosen MonitorDevice
        List monitorModes = monitor.getSupportedModes();
        monitorModes = MonitorModeUtil.filterByFlags(monitorModes, 0); // no interlace, double-scan etc
        monitorModes = MonitorModeUtil.filterByRotation(monitorModes, rot);
        monitorModes = MonitorModeUtil.filterByResolution(monitorModes, res);
        monitorModes = MonitorModeUtil.filterByRate(monitorModes, freq);
        monitorModes = MonitorModeUtil.getHighestAvailableBpp(monitorModes);

        // pick 1st one and set to current ..
        MonitorMode mm = monitorModes.get(0);
        monitor.setCurrentMode(mm);