From 2ab629205c88978891271dd51cfa2a1669a6eec2 Mon Sep 17 00:00:00 2001 From: Sven Gothel Date: Sat, 7 Sep 2019 02:15:00 +0200 Subject: Bug 1392: Add CapabilitiesFilter and GLCapabilitiesFilter supporting diverse reusable [GL]CapabilitiesImmutable list filter To implement fix for Bug 1392, we have to remove certain GLCapabilitiesImmutable from the availability list. These filter provide a a clean reusable utility for the fix. --- .../jogamp/nativewindow/CapabilitiesFilter.java | 164 +++++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 src/nativewindow/classes/com/jogamp/nativewindow/CapabilitiesFilter.java (limited to 'src/nativewindow/classes/com') diff --git a/src/nativewindow/classes/com/jogamp/nativewindow/CapabilitiesFilter.java b/src/nativewindow/classes/com/jogamp/nativewindow/CapabilitiesFilter.java new file mode 100644 index 000000000..d7785bc48 --- /dev/null +++ b/src/nativewindow/classes/com/jogamp/nativewindow/CapabilitiesFilter.java @@ -0,0 +1,164 @@ +/** + * Copyright 2019 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.nativewindow; + +import java.util.ArrayList; +import java.util.List; + +import com.jogamp.nativewindow.VisualIDHolder.VIDType; + +/** + * Diverse reusable {@link CapabilitiesImmutable} list filter + */ +public class CapabilitiesFilter { + protected CapabilitiesFilter() {} + + /** Generic filter criteria */ + public static interface Criteria { + public boolean match(final C cap); + } + + /** Filter {@link Criteria} for removal */ + public static interface RemovalCriteria extends Criteria { + } + public static class RemoveLessColorCompBits implements RemovalCriteria { + final int minColorCompBits; + public RemoveLessColorCompBits(final int minColorCompBits) { + this.minColorCompBits = minColorCompBits; + } + public final boolean match(final C cap) { + return cap.getRedBits() < minColorCompBits || + cap.getGreenBits() < minColorCompBits || + cap.getBlueBits() < minColorCompBits || + cap.getAlphaBits() < minColorCompBits; + } + } + public static class RemoveMoreColorCompBits implements RemovalCriteria { + final int maxColorCompBits; + public RemoveMoreColorCompBits(final int maxColorCompBits) { + this.maxColorCompBits = maxColorCompBits; + } + public final boolean match(final C cap) { + return cap.getRedBits() > maxColorCompBits || + cap.getGreenBits() > maxColorCompBits || + cap.getBlueBits() > maxColorCompBits || + cap.getAlphaBits() > maxColorCompBits; + } + } + public static class RemoveUnmatchedNativeVisualID implements RemovalCriteria { + final int requiredNativeVisualID; + public RemoveUnmatchedNativeVisualID(final int requiredNativeVisualID) { + this.requiredNativeVisualID = requiredNativeVisualID; + } + public final boolean match(final C cap) { + return cap.getVisualID(VIDType.NATIVE) != requiredNativeVisualID; + } + } + + /** + * Removing all {@link CapabilitiesImmutable} derived elements matching the given {@code criteria} {@link RemovalCriteria} list. + * @param availableCaps {@link CapabilitiesImmutable} derived list to be filtered + * @param criteria {@link RemovalCriteria} list run on all non-removed {@link CapabilitiesImmutable} derived elements + * @return the list of removed {@link CapabilitiesImmutable} derived elements, might be of size 0 if none were removed. + */ + public static ArrayList removeMatching(final ArrayList availableCaps, final List> criteria) { + final ArrayList removedCaps = new ArrayList(); + for(int i=0; i + * Otherwise, if {@code requiredNativeVisualID} equals {@link VisualIDHolder.VID_UNDEFINED}, none is removed. + *

+ * @param availableCaps list of {@link CapabilitiesImmutable} derived elements to be filtered + * @param requiredNativeVisualID if not {@link VisualIDHolder.VID_UNDEFINED}, remove all non-matching nativeVisualID's + * @return the list of removed {@link CapabilitiesImmutable} derived elements, might be of size 0 if none were removed. + */ + public static ArrayList removeUnmatchingNativeVisualID(final ArrayList availableCaps, + final int requiredNativeVisualID) { + if( VisualIDHolder.VID_UNDEFINED == requiredNativeVisualID) { + return new ArrayList(); + } + final ArrayList> criteria = new ArrayList>(); + criteria.add(new CapabilitiesFilter.RemoveUnmatchedNativeVisualID(requiredNativeVisualID)); + return removeMatching(availableCaps, criteria); + } + + /** + * Filter removing all {@link CapabilitiesImmutable} derived elements having color components > {@code maxColorCompBits} including alpha. + * @param availableCaps list of {@link CapabilitiesImmutable} derived elements to be filtered + * @param maxColorCompBits maximum tolerated color component bits + * @return the list of removed {@link CapabilitiesImmutable} derived elements, might be of size 0 if none were removed. + */ + public static ArrayList removeMoreColorComps(final ArrayList availableCaps, + final int maxColorCompBits) { + final ArrayList> criteria = new ArrayList>(); + criteria.add(new CapabilitiesFilter.RemoveMoreColorCompBits(maxColorCompBits)); + return removeMatching(availableCaps, criteria); + } + + /** + * Filter removing all {@link CapabilitiesImmutable} derived elements having color components > {@code maxColorCompBits} including alpha. + *

+ * If {@code requiredNativeVisualID} is not {@link VisualIDHolder.VID_UNDEFINED} and hence specific, + * this filter also removes all non-matching nativeVisualID {@link VIDType.NATIVE}. + *

+ * @param availableCaps list of {@link CapabilitiesImmutable} derived elements to be filtered + * @param maxColorCompBits maximum tolerated color component bits + * @param requiredNativeVisualID if not {@link VisualIDHolder.VID_UNDEFINED}, also remove all non-matching nativeVisualID's + * @return the list of removed {@link CapabilitiesImmutable} derived elements, might be of size 0 if none were removed. + * @see #removeUnmatchingNativeVisualID(ArrayList, int) + * @see #removeMoreColorComps(ArrayList, int) + */ + public static ArrayList removeMoreColorCompsAndUnmatchingNativeVisualID(final ArrayList availableCaps, + final int maxColorCompBits, final int requiredNativeVisualID) { + final ArrayList> criteria = new ArrayList>(); + criteria.add(new CapabilitiesFilter.RemoveMoreColorCompBits(maxColorCompBits)); + if( VisualIDHolder.VID_UNDEFINED != requiredNativeVisualID) { + criteria.add(new CapabilitiesFilter.RemoveUnmatchedNativeVisualID(requiredNativeVisualID)); + } + return removeMatching(availableCaps, criteria); + } + +} -- cgit v1.2.3