diff options
| -rw-r--r-- | src/jogl/classes/com/jogamp/opengl/GLCapabilitiesFilter.java | 73 | ||||
| -rw-r--r-- | src/nativewindow/classes/com/jogamp/nativewindow/CapabilitiesFilter.java | 164 |
2 files changed, 237 insertions, 0 deletions
diff --git a/src/jogl/classes/com/jogamp/opengl/GLCapabilitiesFilter.java b/src/jogl/classes/com/jogamp/opengl/GLCapabilitiesFilter.java new file mode 100644 index 000000000..d2479f47d --- /dev/null +++ b/src/jogl/classes/com/jogamp/opengl/GLCapabilitiesFilter.java @@ -0,0 +1,73 @@ +/** + * 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.opengl; + +import java.util.ArrayList; + +import com.jogamp.nativewindow.CapabilitiesFilter; + +/** + * Diverse reusable {@link GLCapabilitiesImmutable} list filter + * @see {@link CapabilitiesFilter} + */ +public class GLCapabilitiesFilter extends CapabilitiesFilter { + protected GLCapabilitiesFilter() {} + + public static class RemoveLessDepthBits<C extends GLCapabilitiesImmutable> implements RemovalCriteria<C> { + final int minDepthBits; + public RemoveLessDepthBits(final int minDepthBits) { + this.minDepthBits = minDepthBits; + } + public final boolean match(final C cap) { + return cap.getDepthBits() < minDepthBits; + } + } + public static class RemoveMoreDepthBits<C extends GLCapabilitiesImmutable> implements RemovalCriteria<C> { + final int maxDepthBits; + public RemoveMoreDepthBits(final int maxDepthBits) { + this.maxDepthBits = maxDepthBits; + } + public final boolean match(final C cap) { + return cap.getDepthBits() > maxDepthBits; + } + } + + /** + * Filter removing all {@link GLCapabilitiesImmutable} derived elements having depth bits < {@code minDepthBits}. + * @param availableCaps list of {@link GLCapabilitiesImmutable} derived elements to be filtered + * @param minDepthBits minimum tolerated depth bits + * @return the list of removed {@link GLCapabilitiesImmutable} derived elements, might be of size 0 if none were removed. + */ + public static <C extends GLCapabilitiesImmutable> ArrayList<C> removeLessDepthBits(final ArrayList<C> availableCaps, + final int minDepthBits) { + final ArrayList<RemovalCriteria<C>> criteria = new ArrayList<RemovalCriteria<C>>(); + criteria.add(new RemoveLessDepthBits<C>(minDepthBits)); + return CapabilitiesFilter.removeMatching(availableCaps, criteria); + } +} 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<C extends CapabilitiesImmutable> { + public boolean match(final C cap); + } + + /** Filter {@link Criteria} for removal */ + public static interface RemovalCriteria<C extends CapabilitiesImmutable> extends Criteria<C> { + } + public static class RemoveLessColorCompBits<C extends CapabilitiesImmutable> implements RemovalCriteria<C> { + 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<C extends CapabilitiesImmutable> implements RemovalCriteria<C> { + 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<C extends CapabilitiesImmutable> implements RemovalCriteria<C> { + 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 <C extends CapabilitiesImmutable> ArrayList<C> removeMatching(final ArrayList<C> availableCaps, final List<RemovalCriteria<C>> criteria) { + final ArrayList<C> removedCaps = new ArrayList<C>(); + for(int i=0; i<availableCaps.size(); ) { + final C cap = availableCaps.get(i); + boolean removed = false; + for(int j=0; !removed && j<criteria.size(); j++) { + if( criteria.get(j).match(cap) ) { + removedCaps.add(availableCaps.remove(i)); + removed = true; + } + } + if( !removed ) { + i++; + } + } + return removedCaps; + } + + /** + * If {@code requiredNativeVisualID} is not {@link VisualIDHolder.VID_UNDEFINED} and hence specific, + * this filter removes all non-matching nativeVisualID {@link VIDType.NATIVE}. + * <p> + * Otherwise, if {@code requiredNativeVisualID} equals {@link VisualIDHolder.VID_UNDEFINED}, none is removed. + * </p> + * @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 <C extends CapabilitiesImmutable> ArrayList<C> removeUnmatchingNativeVisualID(final ArrayList<C> availableCaps, + final int requiredNativeVisualID) { + if( VisualIDHolder.VID_UNDEFINED == requiredNativeVisualID) { + return new ArrayList<C>(); + } + final ArrayList<RemovalCriteria<C>> criteria = new ArrayList<RemovalCriteria<C>>(); + criteria.add(new CapabilitiesFilter.RemoveUnmatchedNativeVisualID<C>(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 <C extends CapabilitiesImmutable> ArrayList<C> removeMoreColorComps(final ArrayList<C> availableCaps, + final int maxColorCompBits) { + final ArrayList<RemovalCriteria<C>> criteria = new ArrayList<RemovalCriteria<C>>(); + criteria.add(new CapabilitiesFilter.RemoveMoreColorCompBits<C>(maxColorCompBits)); + return removeMatching(availableCaps, criteria); + } + + /** + * Filter removing all {@link CapabilitiesImmutable} derived elements having color components > {@code maxColorCompBits} including alpha. + * <p> + * If {@code requiredNativeVisualID} is not {@link VisualIDHolder.VID_UNDEFINED} and hence specific, + * this filter also removes all non-matching nativeVisualID {@link VIDType.NATIVE}. + * </p> + * @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 <C extends CapabilitiesImmutable> ArrayList<C> removeMoreColorCompsAndUnmatchingNativeVisualID(final ArrayList<C> availableCaps, + final int maxColorCompBits, final int requiredNativeVisualID) { + final ArrayList<RemovalCriteria<C>> criteria = new ArrayList<RemovalCriteria<C>>(); + criteria.add(new CapabilitiesFilter.RemoveMoreColorCompBits<C>(maxColorCompBits)); + if( VisualIDHolder.VID_UNDEFINED != requiredNativeVisualID) { + criteria.add(new CapabilitiesFilter.RemoveUnmatchedNativeVisualID<C>(requiredNativeVisualID)); + } + return removeMatching(availableCaps, criteria); + } + +} |