/* * Copyright (c) 2010, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package javafx.scene.effect; import javafx.beans.property.DoubleProperty; import javafx.beans.property.DoublePropertyBase; import javafx.beans.property.ObjectProperty; import javafx.scene.Node; import com.sun.javafx.util.Utils; import com.sun.javafx.effect.EffectDirtyBits; import com.sun.javafx.geom.BaseBounds; import com.sun.javafx.geom.transform.BaseTransform; import com.sun.javafx.scene.BoundsAccessor; /** * An effect that allows for per-pixel adjustments of hue, saturation, * brightness, and contrast. * *

* Example: *


 * ColorAdjust colorAdjust = new ColorAdjust();
 * colorAdjust.setContrast(0.1);
 * colorAdjust.setHue(-0.05);
 * colorAdjust.setBrightness(0.1);
 * colorAdjust.setSaturation(0.2);
 *
 * Image image = new Image("boat.jpg");
 * ImageView imageView = new ImageView(image);
 * imageView.setFitWidth(200);
 * imageView.setPreserveRatio(true);
 * imageView.setEffect(colorAdjust);
 * 
*

The code above applied on this image:

*

* *

*

produces the following:

*

* *

* @since JavaFX 2.0 */ public class ColorAdjust extends Effect { /** * Creates a new instance of ColorAdjust with default parameters. */ public ColorAdjust() {} /** * Creates a new instance of ColorAdjust with the specified hue, saturation, * brightness, and contrast. * @param hue the hue adjustment value * @param saturation the saturation adjustment value * @param brightness the brightness adjustment value * @param contrast the contrast adjustment value * @since JavaFX 2.1 */ public ColorAdjust(double hue, double saturation, double brightness, double contrast) { setBrightness(brightness); setContrast(contrast); setHue(hue); setSaturation(saturation); } @Override com.sun.scenario.effect.ColorAdjust impl_createImpl() { return new com.sun.scenario.effect.ColorAdjust(); }; /** * The input for this {@code Effect}. * If set to {@code null}, or left unspecified, a graphical image of * the {@code Node} to which the {@code Effect} is attached will be * used as the input. * @defaultValue null */ private ObjectProperty input; public final void setInput(Effect value) { inputProperty().set(value); } public final Effect getInput() { return input == null ? null : input.get(); } public final ObjectProperty inputProperty() { if (input == null) { input = new EffectInputProperty("input"); } return input; } @Override boolean impl_checkChainContains(Effect e) { Effect localInput = getInput(); if (localInput == null) return false; if (localInput == e) return true; return localInput.impl_checkChainContains(e); } /** * The hue adjustment value. *
     *       Min: -1.0
     *       Max: +1.0
     *   Default:  0.0
     *  Identity:  0.0
     * 
* @defaultValue 0.0 */ private DoubleProperty hue; public final void setHue(double value) { hueProperty().set(value); } public final double getHue() { return hue == null ? 0 : hue.get(); } public final DoubleProperty hueProperty() { if (hue == null) { hue = new DoublePropertyBase() { @Override public void invalidated() { markDirty(EffectDirtyBits.EFFECT_DIRTY); effectBoundsChanged(); } @Override public Object getBean() { return ColorAdjust.this; } @Override public String getName() { return "hue"; } }; } return hue; } /** * The saturation adjustment value. *
     *       Min: -1.0
     *       Max: +1.0
     *   Default:  0.0
     *  Identity:  0.0
     * 
* @defaultValue 0.0 */ private DoubleProperty saturation; public final void setSaturation(double value) { saturationProperty().set(value); } public final double getSaturation() { return saturation == null ? 0 : saturation.get(); } public final DoubleProperty saturationProperty() { if (saturation == null) { saturation = new DoublePropertyBase() { @Override public void invalidated() { markDirty(EffectDirtyBits.EFFECT_DIRTY); effectBoundsChanged(); } @Override public Object getBean() { return ColorAdjust.this; } @Override public String getName() { return "saturation"; } }; } return saturation; } /** * The brightness adjustment value. *
     *       Min: -1.0
     *       Max: +1.0
     *   Default:  0.0
     *  Identity:  0.0
     * 
* @defaultValue 0.0 */ private DoubleProperty brightness; public final void setBrightness(double value) { brightnessProperty().set(value); } public final double getBrightness() { return brightness == null ? 0 : brightness.get(); } public final DoubleProperty brightnessProperty() { if (brightness == null) { brightness = new DoublePropertyBase() { @Override public void invalidated() { markDirty(EffectDirtyBits.EFFECT_DIRTY); effectBoundsChanged(); } @Override public Object getBean() { return ColorAdjust.this; } @Override public String getName() { return "brightness"; } }; } return brightness; } /** * The contrast adjustment value. *
     *       Min: -1.0
     *       Max: +1.0
     *   Default:  0.0
     *  Identity:  0.0
     * 
* @defaultValue 0.0 */ private DoubleProperty contrast; public final void setContrast(double value) { contrastProperty().set(value); } public final double getContrast() { return contrast == null ? 0 : contrast.get(); } public final DoubleProperty contrastProperty() { if (contrast == null) { contrast = new DoublePropertyBase() { @Override public void invalidated() { markDirty(EffectDirtyBits.EFFECT_DIRTY); effectBoundsChanged(); } @Override public Object getBean() { return ColorAdjust.this; } @Override public String getName() { return "contrast"; } }; } return contrast; } @Override void impl_update() { Effect localInput = getInput(); if (localInput != null) { localInput.impl_sync(); } com.sun.scenario.effect.ColorAdjust peer = (com.sun.scenario.effect.ColorAdjust) impl_getImpl(); peer.setInput(localInput == null ? null : localInput.impl_getImpl()); peer.setHue((float)Utils.clamp(-1, getHue(), 1)); peer.setSaturation((float)Utils.clamp(-1, getSaturation(), 1)); peer.setBrightness((float)Utils.clamp(-1, getBrightness(), 1)); peer.setContrast((float)Utils.clamp(-1, getContrast(), 1)); } /** * @treatAsPrivate implementation detail * @deprecated This is an internal API that is not intended for use and will be removed in the next version */ @Deprecated @Override public BaseBounds impl_getBounds(BaseBounds bounds, BaseTransform tx, Node node, BoundsAccessor boundsAccessor) { return getInputBounds(bounds, tx, node, boundsAccessor, getInput()); } /** * @treatAsPrivate implementation detail * @deprecated This is an internal API that is not intended for use and will be removed in the next version */ @Deprecated @Override public Effect impl_copy() { ColorAdjust ca = new ColorAdjust(this.getHue(), this.getSaturation(), this.getBrightness(), this.getContrast()); ca.setInput(ca.getInput()); return ca; } }