Top Description Fields Constructors Methods
com.sun.scenario.effect

public Class BoxShadow

extends AbstractShadow
Class Inheritance
Imports
com.sun.javafx.geom.BaseBounds, .DirtyRegionContainer, .DirtyRegionPool, .RectBounds, .Rectangle, com.sun.javafx.geom.transform.BaseTransform, com.sun.scenario.effect.impl.Renderer, com.sun.scenario.effect.impl.state.BoxShadowState, .LinearConvolveKernel
A shadow effect using a box-shaped convolution kernel, with a configurable size for each dimension of the kernel and a number of passes to control the quality of the blur.

Field Summary

Modifier and TypeField and Description
private final BoxShadowState
state

Constructor Summary

AccessConstructor and Description
public
BoxShadow()

Constructs a new BoxShadow effect with the default blur sizes (1, 1) and the default number of passes (1), using the default input for source data.

public
BoxShadow(int
the horizontal size of the BoxShadow kernel
hsize, int
the vertical size of the BoxShadow kernel
vsize)

Constructs a new BoxShadow effect with the given blur sizes and the default number of passes (1), using the default input for source data.

public
BoxShadow(int
the horizontal size of the BoxShadow kernel
hsize, int
the vertical size of the BoxShadow kernel
vsize, int
the number of blur passes to execute
passes)

Constructs a new BoxShadow effect with the given blur sizes and number of passes, using the default input for source data.

public
BoxShadow(int
the horizontal size of the BoxShadow kernel
hsize, int
the vertical size of the BoxShadow kernel
vsize, int
the number of blur passes to execute
passes, Effect
the single input Effect
input)

Constructs a new BoxShadow effect with the given blur sizes and number of passes, using the output of the specified effect for source data.

Method Summary

Modifier and TypeMethod and Description
public Effect.AccelType
getAccelType(FilterContext fctx)

Overrides com.sun.scenario.effect.CoreEffect.getAccelType.

Returns one of the AccelType values, indicating whether this Effect is accelerated in hardware for the given FilterContext.

public BaseBounds
getBounds(BaseTransform
the transform the effect will be viewed under
transform, Effect
the default input Effect to be used in all cases where a filter has a null input
defaultInput)

Overrides com.sun.scenario.effect.FilterEffect.getBounds.

Returns the bounding box that will be affected by this filter operation when viewed under the specified transform, given its list of input Effects and the specified defaultInput effect.

public Color4f

Returns:

the shadow color
getColor()

Implements abstract com.sun.scenario.effect.AbstractShadow.getColor.

Returns the shadow color.

public DirtyRegionContainer
getDirtyRegions(Effect
the default input Effect to be used in all cases where a filter has a null input
defaultInput, DirtyRegionPool
the pool of dirty regions
regionPool)

Overrides com.sun.scenario.effect.Effect.getDirtyRegions.

Returns the dirty region container containing dirty regions affected by this filter operation.

public float
getGaussianHeight()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianHeight.

public float
getGaussianRadius()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianRadius.

public float
getGaussianWidth()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianWidth.

public int

Returns:

the horizontal size of the effect kernel
getHorizontalSize()

Returns the horizontal size of the effect kernel.

public final Effect

Returns:

the input for this Effect
getInput()

Implements abstract com.sun.scenario.effect.AbstractShadow.getInput.

Returns the input for this Effect.

public AbstractShadow.ShadowMode
getMode()

Implements abstract com.sun.scenario.effect.AbstractShadow.getMode.

public int

Returns:

the number of passes of the effect kernel
getPasses()

Returns the number of passes of the effect kernel to control the quality of the blur.

public Rectangle
getResultBounds(BaseTransform transform, Rectangle outputClip, ImageData... inputDatas)

Overrides com.sun.scenario.effect.Effect.getResultBounds.

public float

Returns:

the spread of the shadow effect
getSpread()

Implements abstract com.sun.scenario.effect.AbstractShadow.getSpread.

Gets the spread of the shadow effect.

pack-priv LinearConvolveKernel
getState()

Implements abstract com.sun.scenario.effect.LinearConvolveCoreEffect.getState.

Returns state object that is associated with this effect instance.

public int

Returns:

the vertical size of the effect kernel
getVerticalSize()

Returns the vertical size of the effect kernel.

public AbstractShadow
implFor(AbstractShadow.ShadowMode mode)

Implements abstract com.sun.scenario.effect.AbstractShadow.implFor.

public boolean
reducesOpaquePixels()

Implements abstract com.sun.scenario.effect.Effect.reducesOpaquePixels.

Whether an opacity for any pixel is different (lower) than the corresponding pixel in the default input.

public final void
setColor(Color4f
the shadow color
color)

Implements abstract com.sun.scenario.effect.AbstractShadow.setColor.

Sets the shadow color.

public void
setGaussianHeight(float h)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianHeight.

public void
setGaussianRadius(float r)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianRadius.

public void
setGaussianWidth(float w)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianWidth.

public final void
setHorizontalSize(int
the horizontal size of the effect kernel
hsize)

Sets the horizontal size of the effect kernel.

public void
setInput(Effect
the input for this Effect
input)

Implements abstract com.sun.scenario.effect.AbstractShadow.setInput.

Sets the input for this Effect.

public final void
setPasses(int passes)

Sets the number of passes of the effect kernel to control the quality of the blur.

public final void
setSpread(float
the spread of the shadow effect
spread)

Implements abstract com.sun.scenario.effect.AbstractShadow.setSpread.

Sets the spread of the shadow effect.

public final void
setVerticalSize(int
the vertical size of the effect kernel
vsize)

Sets the vertical size of the effect kernel.

Field Detail

stateback to summary
private final BoxShadowState state

Constructor Detail

BoxShadowback to summary
public BoxShadow()

Constructs a new BoxShadow effect with the default blur sizes (1, 1) and the default number of passes (1), using the default input for source data. This is a shorthand equivalent to: 

    new BoxShadow(1, 1, 1, DefaultInput)
BoxShadowback to summary
public BoxShadow(int hsize, int vsize)

Constructs a new BoxShadow effect with the given blur sizes and the default number of passes (1), using the default input for source data. This is a shorthand equivalent to: 

    new BoxShadow(hsize, vsize, 1, DefaultInput)
Parameters
hsize:int

the horizontal size of the BoxShadow kernel

vsize:int

the vertical size of the BoxShadow kernel

Exceptions
IllegalArgumentException:
if either hsize or vsize is outside the allowable range
BoxShadowback to summary
public BoxShadow(int hsize, int vsize, int passes)

Constructs a new BoxShadow effect with the given blur sizes and number of passes, using the default input for source data. This is a shorthand equivalent to: 

    new BoxShadow(hsize, vsize, passes, DefaultInput)
Parameters
hsize:int

the horizontal size of the BoxShadow kernel

vsize:int

the vertical size of the BoxShadow kernel

passes:int

the number of blur passes to execute

Exceptions
IllegalArgumentException:
if either hsize or vsize or passes is outside the allowable range
BoxShadowback to summary
public BoxShadow(int hsize, int vsize, int passes, Effect input)

Constructs a new BoxShadow effect with the given blur sizes and number of passes, using the output of the specified effect for source data.

Parameters
hsize:int

the horizontal size of the BoxShadow kernel

vsize:int

the vertical size of the BoxShadow kernel

passes:int

the number of blur passes to execute

input:Effect

the single input Effect

Exceptions
IllegalArgumentException:
if either hsize or vsize or passes is outside the allowable range

Method Detail

getAccelTypeback to summary
public Effect.AccelType getAccelType(FilterContext fctx)

Overrides com.sun.scenario.effect.CoreEffect.getAccelType.

Doc from com.sun.scenario.effect.Effect.getAccelType.

Returns one of the AccelType values, indicating whether this Effect is accelerated in hardware for the given FilterContext.

Returns:Effect.AccelType

one of the AccelType values

Annotations
@Override
getBoundsback to summary
public BaseBounds getBounds(BaseTransform transform, Effect defaultInput)

Overrides com.sun.scenario.effect.FilterEffect.getBounds.

Doc from com.sun.scenario.effect.Effect.getBounds.

Returns the bounding box that will be affected by this filter operation when viewed under the specified transform, given its list of input Effects and the specified defaultInput effect. Note that the returned bounds can be smaller or larger than one or more of the inputs.

Parameters
transform:BaseTransform

the transform the effect will be viewed under

defaultInput:Effect

the default input Effect to be used in all cases where a filter has a null input

Returns:BaseBounds

the bounding box of this filter

Annotations
@Override
getColorback to summary
public Color4f getColor()

Implements abstract com.sun.scenario.effect.AbstractShadow.getColor.

Returns the shadow color.

Returns:Color4f

the shadow color

Annotations
@Override
getDirtyRegionsback to summary
public DirtyRegionContainer getDirtyRegions(Effect defaultInput, DirtyRegionPool regionPool)

Overrides com.sun.scenario.effect.Effect.getDirtyRegions.

Doc from com.sun.scenario.effect.Effect.getDirtyRegions.

Returns the dirty region container containing dirty regions affected by this filter operation.

Parameters
defaultInput:Effect

the default input Effect to be used in all cases where a filter has a null input

regionPool:DirtyRegionPool

the pool of dirty regions

Returns:DirtyRegionContainer

the dirty region container

Annotations
@Override
getGaussianHeightback to summary
public float getGaussianHeight()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianHeight.

Annotations
@Override
getGaussianRadiusback to summary
public float getGaussianRadius()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianRadius.

Annotations
@Override
getGaussianWidthback to summary
public float getGaussianWidth()

Implements abstract com.sun.scenario.effect.AbstractShadow.getGaussianWidth.

Annotations
@Override
getHorizontalSizeback to summary
public int getHorizontalSize()

Returns the horizontal size of the effect kernel.

Returns:int

the horizontal size of the effect kernel

getInputback to summary
public final Effect getInput()

Implements abstract com.sun.scenario.effect.AbstractShadow.getInput.

Returns the input for this Effect.

Returns:Effect

the input for this Effect

Annotations
@Override
getModeback to summary
public AbstractShadow.ShadowMode getMode()

Implements abstract com.sun.scenario.effect.AbstractShadow.getMode.

Annotations
@Override
getPassesback to summary
public int getPasses()

Returns the number of passes of the effect kernel to control the quality of the blur.

Returns:int

the number of passes of the effect kernel

getResultBoundsback to summary
public Rectangle getResultBounds(BaseTransform transform, Rectangle outputClip, ImageData... inputDatas)

Overrides com.sun.scenario.effect.Effect.getResultBounds.

Annotations
@Override
getSpreadback to summary
public float getSpread()

Implements abstract com.sun.scenario.effect.AbstractShadow.getSpread.

Gets the spread of the shadow effect.

Returns:float

the spread of the shadow effect

Annotations
@Override
getStateback to summary
pack-priv LinearConvolveKernel getState()

Implements abstract com.sun.scenario.effect.LinearConvolveCoreEffect.getState.

Doc from com.sun.scenario.effect.Effect.getState.

Returns state object that is associated with this effect instance. Subclasses may override this method to return some sort of state object that contains implementation details that are hidden from the public API. Classes outside this package can use the AccessHelper class to get access to this package-private method.

Annotations
@Override
getVerticalSizeback to summary
public int getVerticalSize()

Returns the vertical size of the effect kernel.

Returns:int

the vertical size of the effect kernel

implForback to summary
public AbstractShadow implFor(AbstractShadow.ShadowMode mode)

Implements abstract com.sun.scenario.effect.AbstractShadow.implFor.

Annotations
@Override
reducesOpaquePixelsback to summary
public boolean reducesOpaquePixels()

Implements abstract com.sun.scenario.effect.Effect.reducesOpaquePixels.

Doc from com.sun.scenario.effect.Effect.reducesOpaquePixels.

Whether an opacity for any pixel is different (lower) than the corresponding pixel in the default input. It is always safe to return true from this method, though the consequences may be that the caller chooses to not utilize a planned optimization.

Returns:boolean

true if this effect may reduce opacity of some pixels of one of it's input (and thus the default input) or it's relevant input(s) might have reduced opaque pixels of the default input already.

Annotations
@Override
setColorback to summary
public final void setColor(Color4f color)

Implements abstract com.sun.scenario.effect.AbstractShadow.setColor.

Sets the shadow color. 

      Min: n/a
      Max: n/a
  Default: Color4f.BLACK
 Identity: n/a
Parameters
color:Color4f

the shadow color

Annotations
@Override
Exceptions
IllegalArgumentException:
if color is null
setGaussianHeightback to summary
public void setGaussianHeight(float h)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianHeight.

Annotations
@Override
setGaussianRadiusback to summary
public void setGaussianRadius(float r)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianRadius.

Annotations
@Override
setGaussianWidthback to summary
public void setGaussianWidth(float w)

Implements abstract com.sun.scenario.effect.AbstractShadow.setGaussianWidth.

Annotations
@Override
setHorizontalSizeback to summary
public final void setHorizontalSize(int hsize)

Sets the horizontal size of the effect kernel. 

      Min:   0
      Max: 255
  Default:   1
 Identity:   0
Parameters
hsize:int

the horizontal size of the effect kernel

Exceptions
IllegalArgumentException:
if hsize is outside the allowable range
setInputback to summary
public void setInput(Effect input)

Implements abstract com.sun.scenario.effect.AbstractShadow.setInput.

Sets the input for this Effect. Sets the input for this Effect to a specific Effect or to the default input if input is null.

Parameters
input:Effect

the input for this Effect

Annotations
@Override
setPassesback to summary
public final void setPasses(int passes)

Sets the number of passes of the effect kernel to control the quality of the blur. 

      Min:   0
      Max:   3
  Default:   1
 Identity:   0
A setting of 1 creates a low quality blur. A setting of 3 creates a blur that is very close to a Gaussian blur.
Exceptions
IllegalArgumentException:
if passes is outside the allowable range
setSpreadback to summary
public final void setSpread(float spread)

Implements abstract com.sun.scenario.effect.AbstractShadow.setSpread.

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 Blur kernel. A spread of 0.0 will result in a pure box-blur distribution of the shadow. A spread of 1.0 will result in a solid growth outward of the source material opacity to the limit of the kernel sizes with a very sharp cutoff to transparency at the edge of the kernel. 

      Min: 0.0
      Max: 1.0
  Default: 0.0
 Identity: 0.0
Parameters
spread:float

the spread of the shadow effect

Annotations
@Override
Exceptions
IllegalArgumentException:
if spread is outside the allowable range
setVerticalSizeback to summary
public final void setVerticalSize(int vsize)

Sets the vertical size of the effect kernel. 

      Min:   0
      Max: 255
  Default:   1
 Identity:   0
Parameters
vsize:int

the vertical size of the effect kernel

Exceptions
IllegalArgumentException:
if vsize is outside the allowable range