Package com.jme3.water

Class WaterFilter

java.lang.Object
com.jme3.post.Filter
com.jme3.water.WaterFilter
All Implemented Interfaces:
Savable, JmeCloneable, Cloneable
public class WaterFilter extends Filter implements JmeCloneable, Cloneable
The WaterFilter is a 2-D post process that simulates water. It renders water from both above and below the surface. See the jMonkeyEngine wiki for more info https://jmonkeyengine.github.io/wiki/jme3/advanced/post-processor_water.html.

  • Field Details Link icon

  • Constructor Details Link icon

    • WaterFilter Link icon

      public WaterFilter()
      Create a Water Filter

    • WaterFilter Link icon

      public WaterFilter(Node reflectionScene, Vector3f lightDirection)

  • Method Details Link icon

    • isRequiresDepthTexture Link icon

      protected boolean isRequiresDepthTexture()
      Description copied from class: Filter
      Override this method and return true if your Filter needs the depth texture
      Overrides:
      isRequiresDepthTexture in class Filter
      Returns:
      true if your Filter need the depth texture

    • preFrame Link icon

      protected void preFrame(float tpf)
      Description copied from class: Filter
      Override this method if you want to modify parameters according to tpf before the rendering of the frame. This is useful for animated filters Also it can be the place to render pre passes
      Overrides:
      preFrame in class Filter
      Parameters:
      tpf - the time used to render the previous frame

    • getMaterial Link icon

      protected Material getMaterial()
      Description copied from class: Filter
      Must return the material used for this filter. this method is called every frame.
      Specified by:
      getMaterial in class Filter
      Returns:
      the material used for this filter.

    • useDirectionLightFromScene Link icon

      protected boolean useDirectionLightFromScene()
      Returns:
      true to try using directional light from a scene

    • initFilter Link icon

      protected void initFilter(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h)
      Description copied from class: Filter
      Initialization of filter subclasses. This method is called once when the filter is added to the FilterPostProcessor It should contain Material initializations and extra passes initialization
      Specified by:
      initFilter in class Filter
      Parameters:
      manager - the assetManager
      renderManager - the renderManager
      vp - the viewPort where this filter is rendered
      w - the width of the filter
      h - the height of the filter

    • cleanUpFilter Link icon

      protected void cleanUpFilter(Renderer r)
      Description copied from class: Filter
      override this method if you have some cleanup to do
      Overrides:
      cleanUpFilter in class Filter
      Parameters:
      r - the renderer

    • write Link icon

      public void write(JmeExporter ex) throws IOException
      Description copied from class: Filter
      Override this method if you want to save extra properties when the filter is saved else only basic properties of the filter will be saved This method should always begin by super.write(ex);
      Specified by:
      write in interface Savable
      Overrides:
      write in class Filter
      Parameters:
      ex - the exporter (not null)
      Throws:
      IOException - from the exporter

    • read Link icon

      public void read(JmeImporter im) throws IOException
      Description copied from class: Filter
      Override this method if you want to load extra properties when the filter is loaded else only basic properties of the filter will be loaded This method should always begin by super.read(im);
      Specified by:
      read in interface Savable
      Overrides:
      read in class Filter
      Throws:
      IOException

    • getWaterHeight Link icon

      public float getWaterHeight()
      gets the height of the water plane
      Returns:
      the height

    • setWaterHeight Link icon

      public void setWaterHeight(float waterHeight)
      Sets the height of the water plane default is 0.0
      Parameters:
      waterHeight - the desired height (default=0)

    • setReflectionScene Link icon

      public void setReflectionScene(Spatial reflectionScene)
      Sets the scene to render in the reflection map.
      Parameters:
      reflectionScene - the refraction scene.

    • getReflectionScene Link icon

      public Spatial getReflectionScene()
      Gets the scene which is used to render in the reflection map.
      Returns:
      the refraction scene.

    • getReflectionView Link icon

      public ViewPort getReflectionView()
      Gets the view port used to render reflection scene.
      Returns:
      the reflection view port.

    • getWaterTransparency Link icon

      public float getWaterTransparency()
      returns the waterTransparency value
      Returns:
      the transparency value

    • setWaterTransparency Link icon

      public void setWaterTransparency(float waterTransparency)
      Sets how fast colours fade out. You can also think about this as how clear water is. Therefore, use smaller values (e.g. 0.05) for crystal-clear water and bigger values for "muddy" water. default is 0.1f
      Parameters:
      waterTransparency - the desired muddiness (default=0.1)

    • getNormalScale Link icon

      public float getNormalScale()
      Returns the normal scales applied to the normal map
      Returns:
      the scale factor

    • setNormalScale Link icon

      public void setNormalScale(float normalScale)
      Sets the normal scaling factors to apply to the normal map. the higher the value the more small ripples will be visible on the waves. default is 3
      Parameters:
      normalScale - the scaling factor (default=3)

    • getRefractionConstant Link icon

      public float getRefractionConstant()
      returns the refraction constant
      Returns:
      the refraction constant

    • setRefractionConstant Link icon

      public void setRefractionConstant(float refractionConstant)
      This is a constant related to the index of refraction (IOR) used to compute the fresnel term. F = R0 + (1-R0)( 1 - N.V)^5 where F is the fresnel term, R0 the constant, N the normal vector and V the view vector. It depends on the substance you are looking through (here water). Default value is 0.5 In practice, the lowest the value and the less the reflection can be seen on water
      Parameters:
      refractionConstant - the desired R0 value (default=0.5)

    • getMaxAmplitude Link icon

      public float getMaxAmplitude()
      return the maximum wave amplitude
      Returns:
      the maximum amplitude

    • setMaxAmplitude Link icon

      public void setMaxAmplitude(float maxAmplitude)
      Sets the maximum waves amplitude default is 1.5
      Parameters:
      maxAmplitude - the desired maximum amplitude (default=1.5)

    • getLightDirection Link icon

      public Vector3f getLightDirection()
      gets the light direction
      Returns:
      the pre-existing vector

    • setLightDirection Link icon

      public void setLightDirection(Vector3f lightDirection)
      Sets the light direction
      Parameters:
      lightDirection - the direction vector to use (alias created, default=(0,-1,0))

    • getLightColor Link icon

      public ColorRGBA getLightColor()
      returns the light color
      Returns:
      the pre-existing instance

    • setLightColor Link icon

      public void setLightColor(ColorRGBA lightColor)
      Sets the light color to use default is white
      Parameters:
      lightColor - the color to use (alias created, default=(1,1,1,1))

    • getShoreHardness Link icon

      public float getShoreHardness()
      Return the shore hardness.
      Returns:
      the hardness value

    • setShoreHardness Link icon

      public void setShoreHardness(float shoreHardness)
      The smaller this value is, the softer the transition between shore and water. If you want hard edges use very big value. Default is 0.1f.
      Parameters:
      shoreHardness - the desired hardness (default=0.1)

    • getFoamHardness Link icon

      public float getFoamHardness()
      returns the foam hardness
      Returns:
      the hardness value

    • setFoamHardness Link icon

      public void setFoamHardness(float foamHardness)
      Sets the foam hardness : How much the foam will blend with the shore to avoid hard edged water plane. Default is 1.0
      Parameters:
      foamHardness - the desired hardness (default=1)

    • getRefractionStrength Link icon

      public float getRefractionStrength()
      returns the refractionStrength
      Returns:
      the strength value

    • setRefractionStrength Link icon

      public void setRefractionStrength(float refractionStrength)
      This value modifies current fresnel term. If you want to weaken reflections use bigger value. If you want to emphasize them use a value smaller than 0. Default is 0.
      Parameters:
      refractionStrength - the desired strength (default=0)

    • getWaveScale Link icon

      public float getWaveScale()
      Returns the scale factor of the waves' height map.
      Returns:
      the scale factor

    • setWaveScale Link icon

      public void setWaveScale(float waveScale)
      Sets the scale factor of the waves' height map. The smaller the value, the bigger the waves. Default is 0.005 .
      Parameters:
      waveScale - the desired scale factor (default=0.005)

    • getFoamExistence Link icon

      public Vector3f getFoamExistence()
      returns the foam existence vector
      Returns:
      the pre-existing vector

    • setFoamExistence Link icon

      public void setFoamExistence(Vector3f foamExistence)
      Describes at what depth foam starts to fade out and at what it is completely invisible. The third value is at what height foam for waves appear (+ waterHeight). default is (0.45, 4.35, 1.0);
      Parameters:
      foamExistence - the desired parameters (alias created)

    • getSunScale Link icon

      public float getSunScale()
      gets the scale of the sun
      Returns:
      the scale factor

    • setSunScale Link icon

      public void setSunScale(float sunScale)
      Sets the scale of the sun for specular effect
      Parameters:
      sunScale - the desired scale factor (default=3)

    • getColorExtinction Link icon

      public Vector3f getColorExtinction()
      Returns the color extinction vector of the water
      Returns:
      the pre-existing vector

    • setColorExtinction Link icon

      public void setColorExtinction(Vector3f colorExtinction)
      Return at what depth the refraction color extinct the first value is for red the second is for green the third is for blue Play with those parameters to "trouble" the water default is (5.0, 20.0, 30.0f);
      Parameters:
      colorExtinction - the desired depth for each color component (alias created, default=(5,20,30))

    • setFoamTexture Link icon

      public void setFoamTexture(Texture2D foamTexture)
      Sets the foam texture.
      Parameters:
      foamTexture - the foam texture.

    • getFoamTexture Link icon

      public Texture2D getFoamTexture()
      Gets the foam texture.
      Returns:
      the foam texture.

    • setHeightTexture Link icon

      public void setHeightTexture(Texture2D heightTexture)
      Sets the height texture
      Parameters:
      heightTexture - the texture to use (alias created)

    • getHeightTexture Link icon

      public Texture2D getHeightTexture()
      Gets the height texture.
      Returns:
      the height texture.

    • setNormalTexture Link icon

      public void setNormalTexture(Texture2D normalTexture)
      Sets the normal texture.
      Parameters:
      normalTexture - the normal texture.

    • getNormalTexture Link icon

      public Texture2D getNormalTexture()
      Gets the normal texture.
      Returns:
      the normal texture.

    • getShininess Link icon

      public float getShininess()
      return the shininess factor of the water
      Returns:
      the shininess factor

    • setShininess Link icon

      public void setShininess(float shininess)
      Sets the shininess factor of the water default is 0.7f
      Parameters:
      shininess - the desired factor (default=0.7)

    • getSpeed Link icon

      public float getSpeed()
      returns the speed of the waves
      Returns:
      the speed value

    • setSpeed Link icon

      public void setSpeed(float speed)
      Set the speed of the waves (0.0 is still) default is 1.0
      Parameters:
      speed - the desired speedup factor (default=1)

    • getWaterColor Link icon

      public ColorRGBA getWaterColor()
      returns the color of the water
      Returns:
      the pre-existing instance

    • setWaterColor Link icon

      public void setWaterColor(ColorRGBA waterColor)
      Sets the color of the water see setDeepWaterColor for deep water color default is (0.0078f, 0.3176f, 0.5f,1.0f) (greenish blue)
      Parameters:
      waterColor - the color to use (alias created, default=(0.0078,0.3176,0.5,1))

    • getDeepWaterColor Link icon

      public ColorRGBA getDeepWaterColor()
      returns the deep water color
      Returns:
      the pre-existing instance

    • setDeepWaterColor Link icon

      public void setDeepWaterColor(ColorRGBA deepWaterColor)
      sets the deep water color see setWaterColor for general color default is (0.0039f, 0.00196f, 0.145f,1.0f) (very dark blue)
      Parameters:
      deepWaterColor - the color to use (alias created, default=(0.0039,0.00196,0.145,1))

    • getWindDirection Link icon

      public Vector2f getWindDirection()
      returns the wind direction
      Returns:
      the pre-existing direction vector

    • setWindDirection Link icon

      public void setWindDirection(Vector2f windDirection)
      sets the wind direction the direction where the waves move default is (0.0f, -1.0f)
      Parameters:
      windDirection - the direction vector to use (alias created, default=(0,-1))

    • getReflectionMapSize Link icon

      public int getReflectionMapSize()
      returns the size of the reflection map
      Returns:
      the size (in pixels)

    • setReflectionMapSize Link icon

      public void setReflectionMapSize(int reflectionMapSize)
      Sets the size of the reflection map default is 512, the higher, the better quality, but the slower the effect.
      Parameters:
      reflectionMapSize - the desired size (in pixels per side, default=512)

    • isUseFoam Link icon

      public boolean isUseFoam()
      Whether or not the water uses foam
      Returns:
      true if the water uses foam

    • setUseFoam Link icon

      public void setUseFoam(boolean useFoam)
      set to true to use foam with water default true
      Parameters:
      useFoam - true for foam, false for no foam (default=true)

    • setCausticsTexture Link icon

      public void setCausticsTexture(Texture2D causticsTexture)
      Sets the texture to use to render caustics on the ground underwater.
      Parameters:
      causticsTexture - the caustics texture.

    • getCausticsTexture Link icon

      public Texture2D getCausticsTexture()
      Gets the texture which is used to render caustics on the ground underwater.
      Returns:
      the caustics texture.

    • isUseCaustics Link icon

      public boolean isUseCaustics()
      Whether or not caustics are rendered
      Returns:
      true if caustics are rendered

    • setUseCaustics Link icon

      public void setUseCaustics(boolean useCaustics)
      set to true if you want caustics to be rendered on the ground underwater, false otherwise
      Parameters:
      useCaustics - true to enable rendering fo caustics, false to disable it (default=true)

    • isUseHQShoreline Link icon

      public boolean isUseHQShoreline()
      Whether or not the shader is set to use high-quality shoreline.
      Returns:
      true if high-quality shoreline is enabled

    • setUseHQShoreline Link icon

      public void setUseHQShoreline(boolean useHQShoreline)

    • isUseRefraction Link icon

      public boolean isUseRefraction()
      Whether or not the water uses the refraction
      Returns:
      true if the water uses refraction

    • setUseRefraction Link icon

      public void setUseRefraction(boolean useRefraction)
      set to true to use refraction (default is true)
      Parameters:
      useRefraction - true to enable refraction, false to disable it (default=true)

    • isUseRipples Link icon

      public boolean isUseRipples()
      Whether or not the water uses ripples
      Returns:
      true if the water is set to use ripples

    • setUseRipples Link icon

      public void setUseRipples(boolean useRipples)
      Set to true to use ripples
      Parameters:
      useRipples - true to enable ripples, false to disable them (default=true)

    • isUseSpecular Link icon

      public boolean isUseSpecular()
      Whether or not the water is using specular
      Returns:
      true if the water is set to use specular

    • setUseSpecular Link icon

      public void setUseSpecular(boolean useSpecular)
      Set to true to use specular lighting on the water
      Parameters:
      useSpecular - true to enable the specular effect, false to disable it (default=true)

    • getFoamIntensity Link icon

      public float getFoamIntensity()
      returns the foam intensity
      Returns:
      the intensity value

    • setFoamIntensity Link icon

      public void setFoamIntensity(float foamIntensity)
      sets the foam intensity default is 0.5f
      Parameters:
      foamIntensity - the desired intensity (default=0.5)

    • getReflectionDisplace Link icon

      public float getReflectionDisplace()
      returns the reflection displace see setReflectionDisplace(float)
      Returns:
      the displacement value

    • setReflectionDisplace Link icon

      public void setReflectionDisplace(float reflectionDisplace)
      Sets the reflection displace. define how troubled will look the reflection in the water. default is 30
      Parameters:
      reflectionDisplace - the desired displacement (default=30)

    • isUnderWater Link icon

      public boolean isUnderWater()
      Whether or not the camera is under the water level
      Returns:
      true if the camera is under the water level

    • getUnderWaterFogDistance Link icon

      public float getUnderWaterFogDistance()
      returns the distance of the fog when underwater
      Returns:
      the distance

    • setUnderWaterFogDistance Link icon

      public void setUnderWaterFogDistance(float underWaterFogDistance)
      Sets the distance of the fog when underwater. Default is 120 (120 world units). Use a high value to raise the view range underwater.
      Parameters:
      underWaterFogDistance - the desired distance (in world units, default=120)

    • getCausticsIntensity Link icon

      public float getCausticsIntensity()
      Gets the intensity of caustics underwater
      Returns:
      the intensity value (≥0, ≤1)

    • setCausticsIntensity Link icon

      public void setCausticsIntensity(float causticsIntensity)
      Sets the intensity of caustics underwater. Goes from 0 to 1, default is 0.5.
      Parameters:
      causticsIntensity - the desired intensity (≥0, ≤1, default=0.5)

    • getCenter Link icon

      public Vector3f getCenter()
      returns the center of this effect
      Returns:
      the center of this effect

    • setCenter Link icon

      public void setCenter(Vector3f center)
      Set the center of the effect. By default, the water will extend across the entire scene. By setting a center and a radius you can restrain it to a portion of the scene.
      Parameters:
      center - the center of the effect

    • getRadius Link icon

      public float getRadius()
      returns the radius of this effect
      Returns:
      the radius of this effect

    • setRadius Link icon

      public void setRadius(float radius)
      Set the radius of the effect. By default, the water will extend across the entire scene. By setting a center and a radius you can restrain it to a portion of the scene.
      Parameters:
      radius - the radius of the effect

    • getShapeType Link icon

      public WaterFilter.AreaShape getShapeType()
      returns the shape of the water area
      Returns:
      the shape of the water area

    • setShapeType Link icon

      public void setShapeType(WaterFilter.AreaShape shapeType)
      Set the shape of the water area (Circular (default) or Square). if the shape is square the radius is considered as an extent.
      Parameters:
      shapeType - the shape type

    • jmeClone Link icon

      public Object jmeClone()
      Description copied from interface: JmeCloneable
      Performs a regular shallow clone of the object. Some fields may also be cloned but generally only if they will never be shared with other objects. (For example, local Vector3fs and so on.)

      This method is separate from the regular clone() method so that objects might still maintain their own regular java clone() semantics (perhaps even using Cloner for those methods). However, because Java's clone() has specific features in the sense of Object's clone() implementation, it's usually best to have some path for subclasses to bypass the public clone() method that might be cloning fields and instead get at the superclass protected clone() methods. For example, through super.jmeClone() or another protected clone method that some base class eventually calls super.clone() in.

      Specified by:
      jmeClone in interface JmeCloneable
      Returns:
      a new instance

    • cloneFields Link icon

      public void cloneFields(Cloner cloner, Object original)
      Description copied from interface: JmeCloneable
      Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner. The object can call cloner.clone(fieldValue) to deep clone any of its fields.

      Note: during normal clone operations the original object will not be needed as the clone has already had all of the fields shallow copied.

      Specified by:
      cloneFields in interface JmeCloneable
      Parameters:
      cloner - The cloner that is performing the cloning operation. The cloneFields method can call back into the cloner to make clones of its subordinate fields.
      original - The original object from which this object was cloned. This is provided for the very rare case that this object needs to refer to its original for some reason. In general, all of the relevant values should have been transferred during the shallow clone, and this object need only clone what it wants.

    • setNeedSaveReflectionScene Link icon

      public void setNeedSaveReflectionScene(boolean needSaveReflectionScene)
      Sets the flag.
      Parameters:
      needSaveReflectionScene - true if need to save reflection scene.

    • isNeedSaveReflectionScene Link icon

      public boolean isNeedSaveReflectionScene()
      Returns:
      true if need to save reflection scene.