com.sun.scenario.effect.GaussianShadow Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of openjfx-78-backport Show documentation
Show all versions of openjfx-78-backport Show documentation
This is a backport of OpenJFX 8 to run on Java 7.
The newest version!
/*
* Copyright (c) 2008, 2013, 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 com.sun.scenario.effect;
import com.sun.javafx.geom.BaseBounds;
import com.sun.javafx.geom.DirtyRegionContainer;
import com.sun.javafx.geom.DirtyRegionPool;
import com.sun.javafx.geom.RectBounds;
import com.sun.javafx.geom.Rectangle;
import com.sun.javafx.geom.transform.BaseTransform;
import com.sun.scenario.effect.impl.Renderer;
import com.sun.scenario.effect.impl.state.GaussianShadowState;
/**
* A blurred shadow effect using a Gaussian convolution kernel, with a
* configurable radius and shadow color. Only the alpha channel of the
* input is used to create the shadow effect. The alpha value of each
* pixel from the result of the blur operation is modulated with the
* specified shadow color to produce the resulting image.
*/
public class GaussianShadow extends AbstractShadow {
private GaussianShadowState state = new GaussianShadowState();
/**
* Constructs a new {@code GaussianShadow} effect with the default radius
* (10.0) and the default color ({@code Color4f.BLACK}), using the
* default input for source data.
* This is a shorthand equivalent to:
*
* new GaussianShadow(10f, Color4f.BLACK, DefaultInput)
*
*/
public GaussianShadow() {
this(10f);
}
/**
* Constructs a new {@code GaussianShadow} effect with the given radius
* and the default color ({@code Color4f.BLACK}), using the
* default input for source data.
* This is a shorthand equivalent to:
*
* new GaussianShadow(radius, Color4f.BLACK, DefaultInput)
*
*
* @param radius the radius of the Gaussian kernel
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range
*/
public GaussianShadow(float radius) {
this(radius, Color4f.BLACK);
}
/**
* Constructs a new {@code GaussianShadow} effect with the given radius
* and color, using the default input for source data.
* This is a shorthand equivalent to:
*
* new GaussianShadow(radius, color, DefaultInput)
*
*
* @param radius the radius of the Gaussian kernel
* @param color the shadow {@code Color4f}
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range
*/
public GaussianShadow(float radius, Color4f color) {
this(radius, color, DefaultInput);
}
/**
* Constructs a new {@code GaussianShadow} effect with the given
* radius and color.
*
* @param radius the radius of the Gaussian kernel
* @param color the shadow {@code Color4f}
* @param input the single input {@code Effect}
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range, or if {@code color} is null
*/
public GaussianShadow(float radius, Color4f color, Effect input) {
super(input);
state.setRadius(radius);
state.setShadowColor(color);
}
@Override
Object getState() {
return state;
}
@Override
public AccelType getAccelType(FilterContext fctx) {
return Renderer.getRenderer(fctx).getAccelType();
}
/**
* Returns the input for this {@code Effect}.
*
* @return the input for this {@code Effect}
*/
public final Effect getInput() {
return getInputs().get(0);
}
/**
* Sets the input for this {@code Effect} to a specific {@code Effect}
* or to the default input if {@code input} is {@code null}.
*
* @param input the input for this {@code Effect}
*/
public void setInput(Effect input) {
setInput(0, input);
}
/**
* Returns the radius of the Gaussian kernel.
*
* @return the radius of the Gaussian kernel
*/
public float getRadius() {
return state.getRadius();
}
/**
* Sets the radius of the Gaussian kernel.
*
* Min: 0.0
* Max: 127.0
* Default: 10.0
* Identity: 0.0
*
*
* @param radius the radius of the Gaussian kernel
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range
*/
public void setRadius(float radius) {
float old = state.getRadius();
state.setRadius(radius);
}
/**
* Returns the horizontal radius of the Gaussian kernel.
*
* @return the horizontal radius of the Gaussian kernel
*/
public float getHRadius() {
return state.getHRadius();
}
/**
* Sets the horizontal radius of the Gaussian kernel.
*
* Min: 0.0
* Max: 127.0
* Default: 10.0
* Identity: 0.0
*
*
* @param hradius the horizontal radius of the Gaussian kernel
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range
*/
public void setHRadius(float hradius) {
float old = state.getHRadius();
state.setHRadius(hradius);
}
/**
* Returns the vertical radius of the Gaussian kernel.
*
* @return the vertical radius of the Gaussian kernel
*/
public float getVRadius() {
return state.getVRadius();
}
/**
* Sets the vertical radius of the Gaussian kernel.
*
* Min: 0.0
* Max: 127.0
* Default: 10.0
* Identity: 0.0
*
*
* @param vradius the vertical radius of the Gaussian kernel
* @throws IllegalArgumentException if {@code radius} is outside the
* allowable range
*/
public void setVRadius(float vradius) {
float old = state.getVRadius();
state.setVRadius(vradius);
}
/**
* Gets the spread of the shadow effect.
*
* @return the spread of the shadow effect
*/
public float getSpread() {
return state.getSpread();
}
/**
* Sets the spread of the shadow effect.
* The spread is the portion of the radius where the contribution of
* the source material will be 100%.
* The remaining portion of the radius will have a contribution
* controlled by the Gaussian kernel.
* A spread of {@code 0.0} will result in a pure Gaussian distribution
* of the shadow.
* A spread of {@code 1.0} will result in a solid growth outward of the
* source material opacity to the limit of the radius with a very sharp
* cutoff to transparency at the radius.
*
* Min: 0.0
* Max: 1.0
* Default: 0.0
* Identity: 0.0
*
*
* @param spread the spread of the shadow effect
* @throws IllegalArgumentException if {@code spread} is outside the
* allowable range
*/
public void setSpread(float spread) {
float old = state.getSpread();
state.setSpread(spread);
}
/**
* Returns the shadow color.
*
* @return the shadow color
*/
public Color4f getColor() {
return state.getShadowColor();
}
/**
* Sets the shadow color.
*
* Min: n/a
* Max: n/a
* Default: Color4f.BLACK
* Identity: n/a
*
*
* @param color the shadow color
* @throws IllegalArgumentException if {@code color} is null
*/
public void setColor(Color4f color) {
Color4f old = state.getShadowColor();
state.setShadowColor(color);
}
public float getGaussianRadius() {
return getRadius();
}
public float getGaussianWidth() {
return getHRadius() * 2.0f + 1.0f;
}
public float getGaussianHeight() {
return getVRadius() * 2.0f + 1.0f;
}
public void setGaussianRadius(float r) {
setRadius(r);
}
public void setGaussianWidth(float w) {
setHRadius(w < 1.0f ? 0.0f : ((w - 1.0f) / 2.0f));
}
public void setGaussianHeight(float h) {
setVRadius(h < 1.0f ? 0.0f : ((h - 1.0f) / 2.0f));
}
public ShadowMode getMode() {
return ShadowMode.GAUSSIAN;
}
public AbstractShadow implFor(ShadowMode mode) {
int passes = 0;
switch (mode) {
case GAUSSIAN:
return this;
case ONE_PASS_BOX:
passes = 1;
break;
case TWO_PASS_BOX:
passes = 2;
break;
case THREE_PASS_BOX:
passes = 3;
break;
}
BoxShadow box = new BoxShadow();
box.setInput(getInput());
box.setGaussianWidth(getGaussianWidth());
box.setGaussianHeight(getGaussianHeight());
box.setColor(getColor());
box.setPasses(passes);
box.setSpread(getSpread());
return box;
}
@Override
public BaseBounds getBounds(BaseTransform transform, Effect defaultInput) {
BaseBounds r = super.getBounds(null, defaultInput);
int hpad = state.getPad(0);
int vpad = state.getPad(1);
RectBounds ret = new RectBounds(r.getMinX(), r.getMinY(), r.getMaxX(), r.getMaxY());
ret.grow(hpad, vpad);
return transformBounds(transform, ret);
}
@Override
public Rectangle getResultBounds(BaseTransform transform,
Rectangle outputClip,
ImageData... inputDatas)
{
Rectangle r = super.getResultBounds(transform, outputClip, inputDatas);
int hpad = state.getPad(0);
int vpad = state.getPad(1);
Rectangle ret = new Rectangle(r);
ret.grow(hpad, vpad);
return ret;
}
@Override
public ImageData filterImageDatas(FilterContext fctx,
BaseTransform transform,
Rectangle outputClip,
ImageData... inputs)
{
return state.filterImageDatas(this, fctx, transform, outputClip, inputs);
}
@Override
public boolean operatesInUserSpace() {
return true;
}
@Override
protected Rectangle getInputClip(int inputIndex,
BaseTransform transform,
Rectangle outputClip)
{
// A blur needs as much "fringe" data from its input as it creates
// around its output so we use the same expansion as is used in the
// result bounds.
if (outputClip != null) {
int hpad = state.getPad(0);
int vpad = state.getPad(1);
if ((hpad | vpad) != 0) {
outputClip = new Rectangle(outputClip);
outputClip.grow(hpad, vpad);
}
}
return outputClip;
}
@Override
public boolean reducesOpaquePixels() {
return true;
}
@Override
public DirtyRegionContainer getDirtyRegions(Effect defaultInput, DirtyRegionPool regionPool) {
Effect di = getDefaultedInput(0, defaultInput);
DirtyRegionContainer drc = di.getDirtyRegions(defaultInput, regionPool);
drc.grow(state.getPad(0), state.getPad(1));
return drc;
}
}