Class PerspectiveTransform

java.lang.Object
javafx.scene.effect.Effect
javafx.scene.effect.PerspectiveTransform

public class PerspectiveTransform extends Effect
An effect that provides non-affine transformation of the input content. Most typically PerspectiveTransform is used to provide a "faux" three-dimensional effect for otherwise two-dimensional content.

A perspective transformation is capable of mapping an arbitrary quadrilateral into another arbitrary quadrilateral, while preserving the straightness of lines. Unlike an affine transformation, the parallelism of lines in the source is not necessarily preserved in the output.

Note that this effect does not adjust the coordinates of input events or any methods that measure containment on a Node. The results of mouse picking and the containment methods are undefined when a Node has a PerspectiveTransform effect in place.

Example:


 PerspectiveTransform perspectiveTrasform = new PerspectiveTransform();
 perspectiveTrasform.setUlx(10.0);
 perspectiveTrasform.setUly(10.0);
 perspectiveTrasform.setUrx(310.0);
 perspectiveTrasform.setUry(40.0);
 perspectiveTrasform.setLrx(310.0);
 perspectiveTrasform.setLry(60.0);
 perspectiveTrasform.setLlx(10.0);
 perspectiveTrasform.setLly(90.0);

 Group g = new Group();
 g.setEffect(perspectiveTrasform);
 g.setCache(true);

 Rectangle rect = new Rectangle();
 rect.setX(10.0);
 rect.setY(10.0);
 rect.setWidth(280.0);
 rect.setHeight(80.0);
 rect.setFill(Color.web("0x3b596d"));

 Text text = new Text();
 text.setX(20.0);
 text.setY(65.0);
 text.setText("Perspective");
 text.setFill(Color.ALICEBLUE);
 text.setFont(Font.font(null, FontWeight.BOLD, 36));

 g.getChildren().addAll(rect, text);
 

The code above produces the following:

The visual effect of
 PerspectiveTransform on text

Since:
JavaFX 2.0
  • Property Summary Link icon

    Properties
    Type
    Property
    Description
    The input for this Effect.
    The x coordinate of the output location onto which the lower left corner of the source is mapped.
    The y coordinate of the output location onto which the lower left corner of the source is mapped.
    The x coordinate of the output location onto which the lower right corner of the source is mapped.
    The y coordinate of the output location onto which the lower right corner of the source is mapped.
    The x coordinate of the output location onto which the upper left corner of the source is mapped.
    The y coordinate of the output location onto which the upper left corner of the source is mapped.
    The x coordinate of the output location onto which the upper right corner of the source is mapped.
    The y coordinate of the output location onto which the upper right corner of the source is mapped.
  • Constructor Summary Link icon

    Constructors
    Constructor
    Description
    Creates a new instance of PerspectiveTransform with default parameters.
    PerspectiveTransform(double ulx, double uly, double urx, double ury, double lrx, double lry, double llx, double lly)
    Creates a new instance of PerspectiveTransform with the specified ulx, uly, urx, ury, lrx, lry, llx, and lly.
  • Method Summary Link icon

    Modifier and Type
    Method
    Description
    final Effect
    Gets the value of the input property.
    final double
    Gets the value of the llx property.
    final double
    Gets the value of the lly property.
    final double
    Gets the value of the lrx property.
    final double
    Gets the value of the lry property.
    final double
    Gets the value of the ulx property.
    final double
    Gets the value of the uly property.
    final double
    Gets the value of the urx property.
    final double
    Gets the value of the ury property.
    The input for this Effect.
    The x coordinate of the output location onto which the lower left corner of the source is mapped.
    The y coordinate of the output location onto which the lower left corner of the source is mapped.
    The x coordinate of the output location onto which the lower right corner of the source is mapped.
    The y coordinate of the output location onto which the lower right corner of the source is mapped.
    final void
    Sets the value of the input property.
    final void
    setLlx(double value)
    Sets the value of the llx property.
    final void
    setLly(double value)
    Sets the value of the lly property.
    final void
    setLrx(double value)
    Sets the value of the lrx property.
    final void
    setLry(double value)
    Sets the value of the lry property.
    final void
    setUlx(double value)
    Sets the value of the ulx property.
    final void
    setUly(double value)
    Sets the value of the uly property.
    final void
    setUrx(double value)
    Sets the value of the urx property.
    final void
    setUry(double value)
    Sets the value of the ury property.
    The x coordinate of the output location onto which the upper left corner of the source is mapped.
    The y coordinate of the output location onto which the upper left corner of the source is mapped.
    The x coordinate of the output location onto which the upper right corner of the source is mapped.
    The y coordinate of the output location onto which the upper right corner of the source is mapped.

    Methods declared in class java.lang.Object Link icon

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Property Details Link icon

  • Constructor Details Link icon

    • PerspectiveTransform Link icon

      public PerspectiveTransform()
      Creates a new instance of PerspectiveTransform with default parameters.
    • PerspectiveTransform Link icon

      public PerspectiveTransform(double ulx, double uly, double urx, double ury, double lrx, double lry, double llx, double lly)
      Creates a new instance of PerspectiveTransform with the specified ulx, uly, urx, ury, lrx, lry, llx, and lly.
      Parameters:
      ulx - the x coordinate of upper left corner
      uly - the y coordinate of upper left corner
      urx - the x coordinate of upper right corner
      ury - the y coordinate of upper right corner
      lrx - the x coordinate of lower right corner
      lry - the y coordinate of lower right corner
      llx - the x coordinate of lower left corner
      lly - the y coordinate of lower left corner
      Since:
      JavaFX 2.1
  • Method Details Link icon

    • setInput Link icon

      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 Link icon

      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 Link icon

      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:
    • setUlx Link icon

      public final void setUlx(double value)
      Sets the value of the ulx property.
      Property description:
      The x coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the ulx property
      See Also:
    • getUlx Link icon

      public final double getUlx()
      Gets the value of the ulx property.
      Property description:
      The x coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the ulx property
      See Also:
    • ulxProperty Link icon

      public final DoubleProperty ulxProperty()
      The x coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the ulx property
      See Also:
    • setUly Link icon

      public final void setUly(double value)
      Sets the value of the uly property.
      Property description:
      The y coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the uly property
      See Also:
    • getUly Link icon

      public final double getUly()
      Gets the value of the uly property.
      Property description:
      The y coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the uly property
      See Also:
    • ulyProperty Link icon

      public final DoubleProperty ulyProperty()
      The y coordinate of the output location onto which the upper left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the uly property
      See Also:
    • setUrx Link icon

      public final void setUrx(double value)
      Sets the value of the urx property.
      Property description:
      The x coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the urx property
      See Also:
    • getUrx Link icon

      public final double getUrx()
      Gets the value of the urx property.
      Property description:
      The x coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the urx property
      See Also:
    • urxProperty Link icon

      public final DoubleProperty urxProperty()
      The x coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the urx property
      See Also:
    • setUry Link icon

      public final void setUry(double value)
      Sets the value of the ury property.
      Property description:
      The y coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the ury property
      See Also:
    • getUry Link icon

      public final double getUry()
      Gets the value of the ury property.
      Property description:
      The y coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the ury property
      See Also:
    • uryProperty Link icon

      public final DoubleProperty uryProperty()
      The y coordinate of the output location onto which the upper right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the ury property
      See Also:
    • setLrx Link icon

      public final void setLrx(double value)
      Sets the value of the lrx property.
      Property description:
      The x coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the lrx property
      See Also:
    • getLrx Link icon

      public final double getLrx()
      Gets the value of the lrx property.
      Property description:
      The x coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the lrx property
      See Also:
    • lrxProperty Link icon

      public final DoubleProperty lrxProperty()
      The x coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the lrx property
      See Also:
    • setLry Link icon

      public final void setLry(double value)
      Sets the value of the lry property.
      Property description:
      The y coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the lry property
      See Also:
    • getLry Link icon

      public final double getLry()
      Gets the value of the lry property.
      Property description:
      The y coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the lry property
      See Also:
    • lryProperty Link icon

      public final DoubleProperty lryProperty()
      The y coordinate of the output location onto which the lower right corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the lry property
      See Also:
    • setLlx Link icon

      public final void setLlx(double value)
      Sets the value of the llx property.
      Property description:
      The x coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the llx property
      See Also:
    • getLlx Link icon

      public final double getLlx()
      Gets the value of the llx property.
      Property description:
      The x coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the llx property
      See Also:
    • llxProperty Link icon

      public final DoubleProperty llxProperty()
      The x coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the llx property
      See Also:
    • setLly Link icon

      public final void setLly(double value)
      Sets the value of the lly property.
      Property description:
      The y coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Parameters:
      value - the value for the lly property
      See Also:
    • getLly Link icon

      public final double getLly()
      Gets the value of the lly property.
      Property description:
      The y coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the value of the lly property
      See Also:
    • llyProperty Link icon

      public final DoubleProperty llyProperty()
      The y coordinate of the output location onto which the lower left corner of the source is mapped.
      Default value:
      0.0
      Returns:
      the lly property
      See Also: