159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/* 259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Copyright (c) 2009-2010 jMonkeyEngine 359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * All rights reserved. 459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Redistribution and use in source and binary forms, with or without 659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * modification, are permitted provided that the following conditions are 759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * met: 859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions of source code must retain the above copyright 1059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer. 1159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions in binary form must reproduce the above copyright 1359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer in the 1459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * documentation and/or other materials provided with the distribution. 1559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Neither the name of 'jMonkeyEngine' nor the names of its contributors 1759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * may be used to endorse or promote products derived from this software 1859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * without specific prior written permission. 1959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 2059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 2259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 2359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 2459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 2559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 2759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 2859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 2959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 3059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 3259b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapackage com.jme3.post.filters; 3359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3459b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.asset.AssetManager; 3559b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.material.Material; 3659b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.post.Filter; 3759b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.renderer.RenderManager; 3859b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.renderer.ViewPort; 3959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/** 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * A Post Processing filter to change colors appear with sharp edges as if the 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * available amount of colors available was not enough to draw the true image. 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Possibly useful in cartoon styled games. Use the strength variable to lessen 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * influence of this filter on the total result. Values from 0.2 to 0.7 appear 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to give nice results. 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Based on an article from Geeks3D: 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <a href="http://www.geeks3d.com/20091027/shader-library-posterization-post-processing-effect-glsl/" rel="nofollow">http://www.geeks3d.com/20091027/shader-library-posterization-post-processing-effect-glsl/</a> 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author: Roy Straver a.k.a. Baal Garnaal 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic class PosterizationFilter extends Filter { 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private int numColors = 8; 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private float gamma = 0.6f; 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private float strength = 1.0f; 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Creates a posterization Filter 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public PosterizationFilter() { 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta super("PosterizationFilter"); 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Creates a posterization Filter with the given number of colors 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param numColors 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public PosterizationFilter(int numColors) { 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this(); 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.numColors = numColors; 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Creates a posterization Filter with the given number of colors and gamma 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param numColors 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param gamma 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public PosterizationFilter(int numColors, float gamma) { 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this(numColors); 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.gamma = gamma; 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta protected void initFilter(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h) { 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material = new Material(manager, "Common/MatDefs/Post/Posterization.j3md"); 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setInt("NumColors", numColors); 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setFloat("Gamma", gamma); 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setFloat("Strength", strength); 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta protected Material getMaterial() { 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return material; 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets number of color levels used to draw the screen 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 10059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setNumColors(int numColors) { 10159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.numColors = numColors; 10259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (material != null) { 10359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setInt("NumColors", numColors); 10459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 10559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 10659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 10759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 10859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets gamma level used to enhange visual quality 10959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 11059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setGamma(float gamma) { 11159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.gamma = gamma; 11259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (material != null) { 11359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setFloat("Gamma", gamma); 11459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 11559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 11659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets urrent strength value, i.e. influence on final image 11959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 12059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setStrength(float strength) { 12159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.strength = strength; 12259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (material != null) { 12359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta material.setFloat("Strength", strength); 12459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 12759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 12859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns number of color levels used 12959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public int getNumColors() { 13159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return numColors; 13259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 13359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 13459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 13559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns current gamma value 13659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getGamma() { 13859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return gamma; 13959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 14159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 14259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns current strength value, i.e. influence on final image 14359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 14459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getStrength() { 14559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return strength; 14659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta}