com.jme3.post.filters

Class DepthOfFieldFilter

java.lang.Object

com.jme3.post.Filter

com.jme3.post.filters.DepthOfFieldFilter

All Implemented Interfaces:

com.jme3.export.Savable

public class DepthOfFieldFilter
extends com.jme3.post.Filter

A post-processing filter that performs a depth range blur using a scaled convolution filter.

Author:

Paul Speed

Nested Class Summary

Nested classes/interfaces inherited from class com.jme3.post.Filter

com.jme3.post.Filter.Pass

Field Summary

Fields inherited from class com.jme3.post.Filter

defaultPass, enabled, material, postRenderPasses, processor

Constructor Summary

Constructors

Constructor and Description
DepthOfFieldFilter() Creates a DepthOfField filter

Method Summary

Modifier and Type	Method and Description
float	getBlurScale() returns the blur scale
float	getFocusDistance() returns the focus distance
float	getFocusRange() returns the focus range
protected com.jme3.material.Material	getMaterial()
protected void	initFilter(com.jme3.asset.AssetManager assets, com.jme3.renderer.RenderManager renderManager, com.jme3.renderer.ViewPort vp, int w, int h)
protected boolean	isRequiresDepthTexture()
void	read(com.jme3.export.JmeImporter im)
void	setBlurScale(float f) Sets the blur amount by scaling the convolution filter up or down.
void	setFocusDistance(float f) Sets the distance at which objects are purely in focus.
void	setFocusRange(float f) Sets the range to either side of focusDistance where the objects go gradually out of focus.
void	write(com.jme3.export.JmeExporter ex)

Methods inherited from class com.jme3.post.Filter

cleanup, cleanUpFilter, getDefaultPassDepthFormat, getDefaultPassTextureFormat, getName, getPostRenderPasses, getRenderedTexture, getRenderFrameBuffer, init, isEnabled, isRequiresBilinear, isRequiresSceneTexture, postFilter, postFrame, postQueue, preFrame, setDepthTexture, setEnabled, setName, setProcessor, setRenderedTexture, setRenderFrameBuffer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DepthOfFieldFilter

public DepthOfFieldFilter()

Creates a DepthOfField filter

Method Detail

isRequiresDepthTexture

protected boolean isRequiresDepthTexture()

Overrides:

isRequiresDepthTexture in class com.jme3.post.Filter

getMaterial

protected com.jme3.material.Material getMaterial()

Specified by:

getMaterial in class com.jme3.post.Filter

initFilter

protected void initFilter(com.jme3.asset.AssetManager assets,
                          com.jme3.renderer.RenderManager renderManager,
                          com.jme3.renderer.ViewPort vp,
                          int w,
                          int h)

Specified by:

initFilter in class com.jme3.post.Filter

setFocusDistance

public void setFocusDistance(float f)

Sets the distance at which objects are purely in focus.

getFocusDistance

public float getFocusDistance()

returns the focus distance

Returns:

setFocusRange

public void setFocusRange(float f)

Sets the range to either side of focusDistance where the objects go gradually out of focus. Less than focusDistance - focusRange and greater than focusDistance + focusRange, objects are maximally "blurred".

getFocusRange

public float getFocusRange()

returns the focus range

Returns:

setBlurScale

public void setBlurScale(float f)

Sets the blur amount by scaling the convolution filter up or down. A value of 1 (the default) performs a sparse 5x5 evenly distributed convolution at pixel level accuracy. Higher values skip more pixels, and so on until you are no longer blurring the image but simply hashing it. The sparse convolution is as follows: %MINIFYHTMLc3d0cd9fab65de6875a381fd3f83e1b338%* Where 'x' is the texel being modified. Setting blur scale higher than 1 spaces the samples out.

getBlurScale

public float getBlurScale()

returns the blur scale

Returns:

write

public void write(com.jme3.export.JmeExporter ex)
           throws java.io.IOException

Specified by:

write in interface com.jme3.export.Savable

Overrides:

write in class com.jme3.post.Filter

Throws:

java.io.IOException

read

public void read(com.jme3.export.JmeImporter im)
          throws java.io.IOException

Specified by:

read in interface com.jme3.export.Savable

Overrides:

read in class com.jme3.post.Filter

Throws:

java.io.IOException