Shear

java.lang.Object
- javafx.scene.transform.Transform
- - javafx.scene.transform.Shear

All Implemented Interfaces:: java.lang.Cloneable, EventTarget

public class Shear
extends Transform

This class represents an Affine object that shears coordinates by the specified multipliers. The matrix representing the shearing transformation is as follows:

      [   1   x   0   -x*pivotY ]
      [   y   1   0   -y*pivotX ]
      [   0   0   1   0   ]

For example:


 Text text = new Text("Using Shear for pseudo-italic font");
 text.setX(20);
 text.setY(50);
 text.setFont(new Font(20));

 text.getTransforms().add(new Shear(-0.35, 0));

Since:: JavaFX 2.0

Field Summary

Fields
Modifier and Type	Field and Description
`private DoubleProperty`	`pivotX` Defines the X coordinate of the shear pivot point.
`private DoubleProperty`	`pivotY` Defines the Y coordinate of the shear pivot point.
`private DoubleProperty`	`x` Defines the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate.
`private DoubleProperty`	`y` Defines the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate.

Constructor Summary

Constructors
Constructor and Description
`Shear()` Creates a default Shear (identity).
`Shear(double x, double y)` Creates a new instance of Shear.
`Shear(double x, double y, double pivotX, double pivotY)` Creates a new instance of Shear with pivot.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`(package private) void`	`appendTo(Affine a)` Visitor from `Affine` class which provides an efficient `append` operation for the subclasses.
`Shear`	`clone()` Returns a deep copy of this transform.
`(package private) boolean`	`computeIs2D()` Computes if this transform is currently a 2D transform (has no effect in the direction of Z axis).
`(package private) boolean`	`computeIsIdentity()` Computes if this transform is currently an identity (has no effect in any direction).
`Transform`	`createConcatenation(Transform transform)` Returns the concatenation of this transform and the specified transform.
`Transform`	`createInverse()` Returns the inverse transform of this transform.
`Point2D`	`deltaTransform(double x, double y)` Transforms the relative magnitude vector by this transform.
`Point3D`	`deltaTransform(double x, double y, double z)` Transforms the relative magnitude vector by this transform.
`(package private) void`	`fill2DArray(double[] array)` Core of the toArray implementation for the 2D case.
`(package private) void`	`fill3DArray(double[] array)` Core of the toArray implementation for the 3D case.
`double`	`getMxy()` Gets the XY coordinate element of the 3x4 matrix.
`double`	`getMyx()` Gets the YX coordinate element of the 3x4 matrix.
`double`	`getPivotX()`
`double`	`getPivotY()`
`double`	`getTx()` Gets the X coordinate translation element of the 3x4 matrix.
`double`	`getTy()` Gets the Y coordinate translation element of the 3x4 matrix.
`double`	`getX()`
`double`	`getY()`
`void`	`impl_apply(Affine3D trans)` Deprecated. This is an internal API that is not intended for use and will be removed in the next version
`BaseTransform`	`impl_derive(BaseTransform trans)` Deprecated. This is an internal API that is not intended for use and will be removed in the next version
`Point2D`	`inverseDeltaTransform(double x, double y)` Transforms the relative magnitude vector by the inverse of this transform.
`Point3D`	`inverseDeltaTransform(double x, double y, double z)` Transforms the relative magnitude vector by the inverse of this transform.
`Point2D`	`inverseTransform(double x, double y)` Transforms the specified point by the inverse of this transform.
`Point3D`	`inverseTransform(double x, double y, double z)` Transforms the specified point by the inverse of this transform.
`(package private) void`	`inverseTransform2DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the inverseTransform2DPoints method.
`(package private) void`	`inverseTransform3DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the inverseTransform3DPoints method.
`DoubleProperty`	`pivotXProperty()`
`DoubleProperty`	`pivotYProperty()`
`(package private) void`	`prependTo(Affine a)` Visitor from `Affine` class which provides an efficient `prepend` operation for the subclasses.
`void`	`setPivotX(double value)`
`void`	`setPivotY(double value)`
`void`	`setX(double value)`
`void`	`setY(double value)`
`java.lang.String`	`toString()` Returns a string representation of this `Shear` object.
`Point2D`	`transform(double x, double y)` Transforms the specified point by this transform.
`Point3D`	`transform(double x, double y, double z)` Transforms the specified point by this transform.
`(package private) void`	`transform2DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the transform2DPoints method.
`(package private) void`	`transform3DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the transform3DPoints method.
`(package private) void`	`validate()` Needed for the proper delivery of the TransformChangedEvent.
`DoubleProperty`	`xProperty()`
`DoubleProperty`	`yProperty()`

Methods inherited from class javafx.scene.transform.Transform
addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, checkRequestedMAT, clearInverseCache, column, column, deltaTransform, deltaTransform, determinant, ensureCanTransform2DPoint, getElement, getMxx, getMxz, getMyy, getMyz, getMzx, getMzy, getMzz, getOnTransformChanged, getTz, identityProperty, impl_add, impl_remove, inverseDeltaTransform, inverseDeltaTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform2DPoints, inverseTransform3DPoints, isIdentity, isType2D, onTransformChangedProperty, removeEventFilter, removeEventHandler, rotate, row, row, scale, scale, setOnTransformChanged, shear, shear, similarTo, toArray, toArray, transform, transform, transform, transform2DPoints, transform3DPoints, transformChanged, translate, type2DProperty

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - x
```
private DoubleProperty x
```
    Defines the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate. Typical values are in the range -1 to 1, exclusive.
  - y
```
private DoubleProperty y
```
    Defines the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate. Typical values are in the range -1 to 1, exclusive.
  - pivotX
```
private DoubleProperty pivotX
```
    Defines the X coordinate of the shear pivot point.
  - pivotY
```
private DoubleProperty pivotY
```
    Defines the Y coordinate of the shear pivot point.
- Constructor Detail
  - Shear
```
public Shear()
```
    Creates a default Shear (identity).
  - Shear
```
public Shear(double x,
             double y)
```
    Creates a new instance of Shear. The pivot point is set to (0,0)
    
    Parameters:
    
    x - the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate
    
    y - the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate
  - Shear
```
public Shear(double x,
             double y,
             double pivotX,
             double pivotY)
```
    Creates a new instance of Shear with pivot.
    
    Parameters:
    
    x - the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate
    
    y - the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate
    
    pivotX - the X coordinate of the shear pivot point
    
    pivotY - the Y coordinate of the shear pivot point
- Method Detail
  - setX
```
public final void setX(double value)
```
  - getX
```
public final double getX()
```
  - xProperty
```
public final DoubleProperty xProperty()
```
  - setY
```
public final void setY(double value)
```
  - getY
```
public final double getY()
```
  - yProperty
```
public final DoubleProperty yProperty()
```
  - setPivotX
```
public final void setPivotX(double value)
```
  - getPivotX
```
public final double getPivotX()
```
  - pivotXProperty
```
public final DoubleProperty pivotXProperty()
```
  - setPivotY
```
public final void setPivotY(double value)
```
  - getPivotY
```
public final double getPivotY()
```
  - pivotYProperty
```
public final DoubleProperty pivotYProperty()
```
  - getMxy
```
public double getMxy()
```
    Description copied from class: Transform
    
    Gets the XY coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMxy in class Transform
  - getMyx
```
public double getMyx()
```
    Description copied from class: Transform
    
    Gets the YX coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMyx in class Transform
  - getTx
```
public double getTx()
```
    Description copied from class: Transform
    
    Gets the X coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTx in class Transform
  - getTy
```
public double getTy()
```
    Description copied from class: Transform
    
    Gets the Y coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTy in class Transform
  - computeIs2D
```
boolean computeIs2D()
```
    Description copied from class: Transform
    
    Computes if this transform is currently a 2D transform (has no effect in the direction of Z axis). Used by the subclasses to effectively provide value of the type2D property.
    
    Overrides:
    
    computeIs2D in class Transform
    
    Returns:
    
    true if this transform is currently 2D-only
  - computeIsIdentity
```
boolean computeIsIdentity()
```
    Description copied from class: Transform
    
    Computes if this transform is currently an identity (has no effect in any direction). Used by the subclasses to effectively provide value of the identity property.
    
    Overrides:
    
    computeIsIdentity in class Transform
    
    Returns:
    
    true if this transform is currently an identity transform
  - fill2DArray
```
void fill2DArray(double[] array)
```
    Description copied from class: Transform
    
    Core of the toArray implementation for the 2D case. All of the checks has been made by the enclosing method as well as the constant elements filled, this method only fills the varying elements to the array. Used by subclasses to fill the elements efficiently.
    
    Overrides:
    
    fill2DArray in class Transform
    
    Parameters:
    
    array - array to be filled with the 6 2D elements
  - fill3DArray
```
void fill3DArray(double[] array)
```
    Description copied from class: Transform
    
    Core of the toArray implementation for the 3D case. All of the checks has been made by the enclosing method as well as the constant elements filled, this method only fills the varying elements to the array. Used by subclasses to fill the elements efficiently.
    
    Overrides:
    
    fill3DArray in class Transform
    
    Parameters:
    
    array - array to be filled with the 12 3D elements
  - createConcatenation
```
public Transform createConcatenation(Transform transform)
```
    Description copied from class: Transform
    
    Returns the concatenation of this transform and the specified transform. Applying the resulting transform to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.
    
    Overrides:
    
    createConcatenation in class Transform
    
    Parameters:
    
    transform - transform to be concatenated with this transform
    
    Returns:
    
    The concatenated transform
  - createInverse
```
public Transform createInverse()
```
    Description copied from class: Transform
    
    Returns the inverse transform of this transform.
    
    Overrides:
    
    createInverse in class Transform
    
    Returns:
    
    the inverse transform
  - clone
```
public Shear clone()
```
    Description copied from class: Transform
    
    Returns a deep copy of this transform.
    
    Overrides:
    
    clone in class Transform
    
    Returns:
    
    a copy of this transform
  - transform
```
public Point2D transform(double x,
                         double y)
```
    Description copied from class: Transform
    
    Transforms the specified point by this transform. This method can be used only for 2D transforms.
    
    Overrides:
    
    transform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    Returns:
    
    the transformed point
  - transform
```
public Point3D transform(double x,
                         double y,
                         double z)
```
    Description copied from class: Transform
    
    Transforms the specified point by this transform.
    
    Overrides:
    
    transform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    z - the Z coordinate of the point
    
    Returns:
    
    the transformed point
  - transform2DPointsImpl
```
void transform2DPointsImpl(double[] srcPts,
                           int srcOff,
                           double[] dstPts,
                           int dstOff,
                           int numPts)
```
    Description copied from class: Transform
    
    Core of the transform2DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    transform2DPointsImpl in class Transform
  - transform3DPointsImpl
```
void transform3DPointsImpl(double[] srcPts,
                           int srcOff,
                           double[] dstPts,
                           int dstOff,
                           int numPts)
```
    Description copied from class: Transform
    
    Core of the transform3DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    transform3DPointsImpl in class Transform
  - deltaTransform
```
public Point2D deltaTransform(double x,
                              double y)
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by this transform. The vector is transformed without applying the translation components of the affine transformation matrix. This method can be used only for a 2D transform.
    
    Overrides:
    
    deltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the transformed relative magnitude vector represented by a Point2D instance
  - deltaTransform
```
public Point3D deltaTransform(double x,
                              double y,
                              double z)
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by this transform. The vector is transformed without applying the translation components of the affine transformation matrix.
    
    Overrides:
    
    deltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the transformed relative magnitude vector represented by a Point3D instance
  - inverseTransform
```
public Point2D inverseTransform(double x,
                                double y)
                         throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the specified point by the inverse of this transform. This method can be used only for 2D transforms.
    
    Overrides:
    
    inverseTransform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    Returns:
    
    the inversely transformed point
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseTransform
```
public Point3D inverseTransform(double x,
                                double y,
                                double z)
                         throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the specified point by the inverse of this transform.
    
    Overrides:
    
    inverseTransform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    z - the Z coordinate of the point
    
    Returns:
    
    the inversely transformed point
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseTransform2DPointsImpl
```
void inverseTransform2DPointsImpl(double[] srcPts,
                                  int srcOff,
                                  double[] dstPts,
                                  int dstOff,
                                  int numPts)
                           throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Core of the inverseTransform2DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    inverseTransform2DPointsImpl in class Transform
    
    Throws:
    
    NonInvertibleTransformException
  - inverseTransform3DPointsImpl
```
void inverseTransform3DPointsImpl(double[] srcPts,
                                  int srcOff,
                                  double[] dstPts,
                                  int dstOff,
                                  int numPts)
                           throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Core of the inverseTransform3DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    inverseTransform3DPointsImpl in class Transform
    
    Throws:
    
    NonInvertibleTransformException
  - inverseDeltaTransform
```
public Point2D inverseDeltaTransform(double x,
                                     double y)
                              throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by the inverse of this transform. The vector is transformed without applying the translation components of the affine transformation matrix. This method can be used only for a 2D transform.
    
    Overrides:
    
    inverseDeltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the inversely transformed relative magnitude vector represented by a Point2D instance
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseDeltaTransform
```
public Point3D inverseDeltaTransform(double x,
                                     double y,
                                     double z)
                              throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by the inverse of this transform. The vector is transformed without applying the translation components of the affine transformation matrix.
    
    Overrides:
    
    inverseDeltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the inversely transformed relative magnitude vector represented by a Point3D instance
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this Shear object.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    a string representation of this Shear object.
  - impl_apply
```
@Deprecated
public void impl_apply(Affine3D trans)
```
    Deprecated. This is an internal API that is not intended for use and will be removed in the next version
    
    Specified by:
    
    impl_apply in class Transform
  - impl_derive
```
@Deprecated
public BaseTransform impl_derive(BaseTransform trans)
```
    Deprecated. This is an internal API that is not intended for use and will be removed in the next version
    
    Specified by:
    
    impl_derive in class Transform
  - validate
```
void validate()
```
    Description copied from class: Transform
    
    Needed for the proper delivery of the TransformChangedEvent. If the members are invalid, the transformChanged() notification is not called and the event is not delivered. To avoid that we need to manually validate all properties. Subclasses validate their specific properties.
    
    Overrides:
    
    validate in class Transform
  - appendTo
```
void appendTo(Affine a)
```
    Description copied from class: Transform
    
    Visitor from Affine class which provides an efficient append operation for the subclasses.
    
    Overrides:
    
    appendTo in class Transform
    
    Parameters:
    
    a - Affine instance to append to
  - prependTo
```
void prependTo(Affine a)
```
    Description copied from class: Transform
    
    Visitor from Affine class which provides an efficient prepend operation for the subclasses.
    
    Overrides:
    
    prependTo in class Transform
    
    Parameters:
    
    a - Affine instance to prepend to

Class Shear

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.transform.Transform

Methods inherited from class java.lang.Object

Field Detail

x

y

pivotX

pivotY

Constructor Detail

Shear

Shear

Shear

Method Detail

setX

getX

xProperty

setY

getY

yProperty

setPivotX

getPivotX

pivotXProperty

setPivotY

getPivotY

pivotYProperty

getMxy

getMyx

getTx

getTy

computeIs2D

computeIsIdentity

fill2DArray

fill3DArray

createConcatenation

createInverse

clone

transform

transform

transform2DPointsImpl

transform3DPointsImpl

deltaTransform

deltaTransform

inverseTransform

inverseTransform

inverseTransform2DPointsImpl

inverseTransform3DPointsImpl

inverseDeltaTransform

inverseDeltaTransform

toString

impl_apply

impl_derive

validate

appendTo

prependTo