de.javagl.geom

Class AffineTransforms

java.lang.Object

de.javagl.geom.AffineTransforms

public class AffineTransforms
extends Object

Utility methods related to affine transforms

Method Summary

Modifier and Type	Method and Description
static <T> Function<T,AffineTransform>	compose(Function<? super T,? extends AffineTransform> f0, Function<? super T,? extends AffineTransform> f1) Creates a function that returns an affine transform that is the concatenation of the affine transforms returned by the given functions.
static double	computeDistanceX(AffineTransform at, double distanceX) Computes the distance that two points have when they are transformed with the given affine transform, and initially had the given distance in x-direction
static double	computeDistanceY(AffineTransform at, double distanceY) Computes the distance that two points have when they are transformed with the given affine transform, and initially had the given distance in y-direction
static double	computeX(AffineTransform at, double x, double y) Computes the x-coordinate of the specified point when it is transformed with the given affine transform
static double	computeX(AffineTransform at, Point2D p) Computes the x-coordinate of the given point when it is transformed with the given affine transform
static double	computeY(AffineTransform at, double x, double y) Computes the y-coordinate of the specified point when it is transformed with the given affine transform
static double	computeY(AffineTransform at, Point2D p) Computes the y-coordinate of the given point when it is transformed with the given affine transform
static Shape	createTransformedShape(AffineTransform at, Shape shape) An implementation of the AffineTransform#createTransformedShape method that is optimized for certain simple shapes (like Rectangle2D and Line2D): If the given transform only consists of translation (or translation and scaling) then a new shape will be constructed directly, avoiding the general (but inefficient) method of creating a Path2D.
static AffineTransform	getScaleInstance(double minX, double minY, double maxX, double maxY, AffineTransform result) Sets the given result to be an affine transform that transforms the unit square into the given rectangle.
static AffineTransform	getScaleInstance(Rectangle2D rectangle, AffineTransform result) Sets the given result to be an affine transform that transforms the unit square into the given rectangle.
static AffineTransform	invert(AffineTransform atSrc, AffineTransform atDst) Invert the given affine transform, storing the result in the given destination.
static <T> Function<T,AffineTransform>	rotating(ToDoubleFunction<? super T> angleRadFunction) Creates a function that returns an affine transform that performs a rotation according to value returned by the given function.
static <T> Function<T,AffineTransform>	rotating(ToDoubleFunction<? super T> angleRadFunction, double anchorX, double anchorY) Creates a function that returns an affine transform that performs a rotation according to value returned by the given function.
static <T> Function<T,AffineTransform>	scaling(ToDoubleFunction<? super T> scalingFunction) Creates a function that returns an affine transform that performs a scaling according to value returned by the given function.
static <T> Function<T,AffineTransform>	scaling(ToDoubleFunction<? super T> xScalingFunction, ToDoubleFunction<? super T> yScalingFunction) Creates a function that returns an affine transform that performs a scaling according to values returned by the given functions.
static String	toString(AffineTransform at) Creates a formatted, multi-line string representation of the given affine transform
static String	toString(AffineTransform at, Locale locale, String format) Creates a formatted, multi-line string representation of the given affine transform, using the given format for each entry
static String	toString(AffineTransform at, String format) Creates a formatted, multi-line string representation of the given affine transform, using the given format for each entry
static <T> Function<T,AffineTransform>	translate(ToDoubleFunction<? super T> xTranslationFunction, ToDoubleFunction<? super T> yTranslationFunction) Creates a function that returns an affine transform that performs a translation according to values returned by the given functions.

Methods inherited from class java.lang.Object

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

Method Detail

invert

public static AffineTransform invert(AffineTransform atSrc,
                                     AffineTransform atDst)

Invert the given affine transform, storing the result in the given destination. If the given destination is null, then a new affine transform will be created and returned.

Parameters:

atSrc - The source

atDst - The destination

Returns:

The destination.

Throws:

IllegalArgumentException - If the given transform can not be inverted.

scaling

public static <T> Function<T,AffineTransform> scaling(ToDoubleFunction<? super T> xScalingFunction,
                                                      ToDoubleFunction<? super T> yScalingFunction)

Creates a function that returns an affine transform that performs a scaling according to values returned by the given functions.

Type Parameters:

T - The function argument type

Parameters:

xScalingFunction - The function that returns the x-scaling

yScalingFunction - The function that returns the y-scaling

Returns:

The function

scaling

public static <T> Function<T,AffineTransform> scaling(ToDoubleFunction<? super T> scalingFunction)

Creates a function that returns an affine transform that performs a scaling according to value returned by the given function.

Type Parameters:

T - The function argument type

Parameters:

scalingFunction - The function that returns the scaling

Returns:

The function

rotating

public static <T> Function<T,AffineTransform> rotating(ToDoubleFunction<? super T> angleRadFunction)

Creates a function that returns an affine transform that performs a rotation according to value returned by the given function.

Type Parameters:

T - The function argument type

Parameters:

angleRadFunction - The function that returns the rotation angle, in radians

Returns:

The function

rotating

public static <T> Function<T,AffineTransform> rotating(ToDoubleFunction<? super T> angleRadFunction,
                                                       double anchorX,
                                                       double anchorY)

Creates a function that returns an affine transform that performs a rotation according to value returned by the given function.

Type Parameters:

T - The function argument type

Parameters:

angleRadFunction - The function that returns the rotation angle, in radians

anchorX - The x-coordinate of the rotation center

anchorY - The y-coordinate of the rotation center

Returns:

The function

translate

public static <T> Function<T,AffineTransform> translate(ToDoubleFunction<? super T> xTranslationFunction,
                                                        ToDoubleFunction<? super T> yTranslationFunction)

Creates a function that returns an affine transform that performs a translation according to values returned by the given functions.

Type Parameters:

T - The function argument type

Parameters:

xTranslationFunction - The function that returns the x-translation

yTranslationFunction - The function that returns the y-translation

Returns:

The function

compose

public static <T> Function<T,AffineTransform> compose(Function<? super T,? extends AffineTransform> f0,
                                                      Function<? super T,? extends AffineTransform> f1)

Creates a function that returns an affine transform that is the concatenation of the affine transforms returned by the given functions. If either of the functions returns null, then the result will be equal to the affine transform of the other function. If both functions return null, then the function will also return null.

Type Parameters:

T - The function argument type

Parameters:

f0 - The first function

f1 - The second function

Returns:

The function

computeDistanceX

public static double computeDistanceX(AffineTransform at,
                                      double distanceX)

Computes the distance that two points have when they are transformed with the given affine transform, and initially had the given distance in x-direction

Parameters:

at - The affine transform

distanceX - The distance

Returns:

The distance after the transform

computeDistanceY

public static double computeDistanceY(AffineTransform at,
                                      double distanceY)

Computes the distance that two points have when they are transformed with the given affine transform, and initially had the given distance in y-direction

Parameters:

at - The affine transform

distanceY - The distance

Returns:

The distance after the transform

computeX

public static double computeX(AffineTransform at,
                              Point2D p)

Computes the x-coordinate of the given point when it is transformed with the given affine transform

Parameters:

at - The affine transform

p - The point

Returns:

The x-coordinate of the transformed point

computeX

public static double computeX(AffineTransform at,
                              double x,
                              double y)

Computes the x-coordinate of the specified point when it is transformed with the given affine transform

Parameters:

at - The affine transform

x - The x-coordinate of the point

y - The y-coordinate of the point

Returns:

The x-coordinate of the transformed point

computeY

public static double computeY(AffineTransform at,
                              Point2D p)

Computes the y-coordinate of the given point when it is transformed with the given affine transform

Parameters:

at - The affine transform

p - The point

Returns:

The y-coordinate of the transformed point

computeY

public static double computeY(AffineTransform at,
                              double x,
                              double y)

Computes the y-coordinate of the specified point when it is transformed with the given affine transform

Parameters:

at - The affine transform

x - The x-coordinate of the point

y - The y-coordinate of the point

Returns:

The y-coordinate of the transformed point

createTransformedShape

public static Shape createTransformedShape(AffineTransform at,
                                           Shape shape)

An implementation of the AffineTransform#createTransformedShape method that is optimized for certain simple shapes (like Rectangle2D and Line2D): If the given transform only consists of translation (or translation and scaling) then a new shape will be constructed directly, avoiding the general (but inefficient) method of creating a Path2D. Otherwise, AffineTransform#createTransformedShape will be called

Parameters:

at - The affine transform

shape - The shape

Returns:

The transformed shape

getScaleInstance

public static AffineTransform getScaleInstance(Rectangle2D rectangle,
                                               AffineTransform result)

Sets the given result to be an affine transform that transforms the unit square into the given rectangle. If the given result is null, then a new transform will be created and returned.

Parameters:

rectangle - The rectangle

result - The result

Returns:

The result

getScaleInstance

public static AffineTransform getScaleInstance(double minX,
                                               double minY,
                                               double maxX,
                                               double maxY,
                                               AffineTransform result)

Sets the given result to be an affine transform that transforms the unit square into the given rectangle. If the given result is null, then a new transform will be created and returned.

Parameters:

minX - The minimum x-coordinate

minY - The minimum y-coordinate

maxX - The maximum x-coordinate

maxY - The maximum y-coordinate

result - The result

Returns:

The result

toString

public static String toString(AffineTransform at)

Creates a formatted, multi-line string representation of the given affine transform

Parameters:

at - The affine transform

Returns:

The string

toString

public static String toString(AffineTransform at,
                              String format)

Creates a formatted, multi-line string representation of the given affine transform, using the given format for each entry

Parameters:

at - The affine transform

format - The format

Returns:

The string

toString

public static String toString(AffineTransform at,
                              Locale locale,
                              String format)

Creates a formatted, multi-line string representation of the given affine transform, using the given format for each entry

Parameters:

at - The affine transform

locale - The locale

format - The format

Returns:

The string