Class ColorAdjust

java.lang.Object

javafx.scene.effect.Effect

javafx.scene.effect.ColorAdjust

public class ColorAdjust extends Effect

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:

A photo

produces the following:

The visual effect of ColorAdjust on
photo

Since:: JavaFX 2.0

Property Summary

Type	Property	Description
`final DoubleProperty`	`brightness`	The brightness adjustment value.
`final DoubleProperty`	`contrast`	The contrast adjustment value.
`final DoubleProperty`	`hue`	The hue adjustment value.
`final ObjectProperty<Effect>`	`input`	The input for this `Effect`.
`final DoubleProperty`	`saturation`	The saturation adjustment value.

Constructor Summary

Constructor	Description
`ColorAdjust()`	Creates a new instance of ColorAdjust with default parameters.
`ColorAdjust(double hue, double saturation, double brightness, double contrast)`	Creates a new instance of ColorAdjust with the specified hue, saturation, brightness, and contrast.

Method Summary

Modifier and Type	Method	Description
`final DoubleProperty`	`brightnessProperty()`	The brightness adjustment value.
`final DoubleProperty`	`contrastProperty()`	The contrast adjustment value.
`final double`	`getBrightness()`	Gets the value of the `brightness` property.
`final double`	`getContrast()`	Gets the value of the `contrast` property.
`final double`	`getHue()`	Gets the value of the `hue` property.
`final Effect`	`getInput()`	Gets the value of the `input` property.
`final double`	`getSaturation()`	Gets the value of the `saturation` property.
`final DoubleProperty`	`hueProperty()`	The hue adjustment value.
`final ObjectProperty<Effect>`	`inputProperty()`	The input for this `Effect`.
`final DoubleProperty`	`saturationProperty()`	The saturation adjustment value.
`final void`	`setBrightness(double value)`	Sets the value of the `brightness` property.
`final void`	`setContrast(double value)`	Sets the value of the `contrast` property.
`final void`	`setHue(double value)`	Sets the value of the `hue` property.
`final void`	`setInput(Effect value)`	Sets the value of the `input` property.
`final void`	`setSaturation(double value)`	Sets the value of the `saturation` property.

Methods declared in class java.lang.Object

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

Property Details

input

public final ObjectProperty<Effect> inputProperty

The input for this Effect. If set to null, or left unspecified, a graphical image of the Node to which the Effect is attached will be used as the input.

Default value:

null

See Also:

hue

public final DoubleProperty hueProperty

The hue adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

See Also:

saturation

public final DoubleProperty saturationProperty

The saturation adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

See Also:

brightness

public final DoubleProperty brightnessProperty

The brightness adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

See Also:

contrast

public final DoubleProperty contrastProperty

The contrast adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

See Also:

Constructor Details

ColorAdjust

public ColorAdjust()

Creates a new instance of ColorAdjust with default parameters.

ColorAdjust

public ColorAdjust(double hue, double saturation, double brightness, double contrast)

Creates a new instance of ColorAdjust with the specified hue, saturation, brightness, and contrast.

Parameters:: hue - the hue adjustment value; saturation - the saturation adjustment value; brightness - the brightness adjustment value; contrast - the contrast adjustment value
Since:: JavaFX 2.1

Method Details

setInput

public final void setInput(Effect value)

Sets the value of the input property.

Property description:

The input for this Effect. If set to null, or left unspecified, a graphical image of the Node to which the Effect is attached will be used as the input.

Default value:

null

Parameters:

value - the value for the input property

See Also:

getInput

public final Effect getInput()

Gets the value of the input property.

Property description:

The input for this Effect. If set to null, or left unspecified, a graphical image of the Node to which the Effect is attached will be used as the input.

Default value:

null

Returns:

the value of the input property

See Also:

inputProperty

public final ObjectProperty<Effect> inputProperty()

The input for this Effect. If set to null, or left unspecified, a graphical image of the Node to which the Effect is attached will be used as the input.

Default value:

null

Returns:

the input property

See Also:

setHue

public final void setHue(double value)

Sets the value of the hue property.

Property description:

The hue adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Parameters:

value - the value for the hue property

See Also:

getHue

public final double getHue()

Gets the value of the hue property.

Property description:

The hue adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the value of the hue property

See Also:

hueProperty

public final DoubleProperty hueProperty()

The hue adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the hue property

See Also:

setSaturation

public final void setSaturation(double value)

Sets the value of the saturation property.

Property description:

The saturation adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Parameters:

value - the value for the saturation property

See Also:

getSaturation

public final double getSaturation()

Gets the value of the saturation property.

Property description:

The saturation adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the value of the saturation property

See Also:

saturationProperty

public final DoubleProperty saturationProperty()

The saturation adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the saturation property

See Also:

setBrightness

public final void setBrightness(double value)

Sets the value of the brightness property.

Property description:

The brightness adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Parameters:

value - the value for the brightness property

See Also:

getBrightness

public final double getBrightness()

Gets the value of the brightness property.

Property description:

The brightness adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the value of the brightness property

See Also:

brightnessProperty

public final DoubleProperty brightnessProperty()

The brightness adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the brightness property

See Also:

setContrast

public final void setContrast(double value)

Sets the value of the contrast property.

Property description:

The contrast adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Parameters:

value - the value for the contrast property

See Also:

getContrast

public final double getContrast()

Gets the value of the contrast property.

Property description:

The contrast adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the value of the contrast property

See Also:

contrastProperty

public final DoubleProperty contrastProperty()

The contrast adjustment value.

       Min: -1.0
       Max: +1.0
   Default:  0.0
  Identity:  0.0

Default value:

0.0

Returns:

the contrast property

See Also:

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.