org.apache.sis.referencing.operation.transform

Class AbstractMathTransform2D.Inverse

Object

FormattableObject

AbstractMathTransform

AbstractMathTransform.Inverse

AbstractMathTransform2D.Inverse

All Implemented Interfaces:

Serializable, Parameterized, LenientComparable, MathTransform, MathTransform2D

Enclosing class:

AbstractMathTransform2D

protected abstract class AbstractMathTransform2D.Inverse
extends AbstractMathTransform.Inverse
implements MathTransform2D

Base class for implementation of inverse math transforms. This inner class is the inverse of the enclosing Abstract­Math­Transform2D.

Serialization

Instances of this class are serializable only if the enclosing math transform is also serializable. Serialized math transforms are not guaranteed to be compatible with future SIS versions. Serialization, if allowed, should be used only for short term storage or RMI between applications running the same SIS version.

Since:

0.5

See Also:

Serialized Form

Defined in the sis-referencing module

Nested Class Summary

Nested classes/interfaces inherited from class AbstractMathTransform

Abstract­Math­Transform.Inverse

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Inverse() Constructs an inverse math transform.

Method Summary

Modifier and Type	Method and Description
Shape	createTransformedShape(Shape shape) Transforms the specified shape.
Matrix	derivative(Point2D point) Gets the derivative of this transform at a point.
MathTransform2D	inverse() Returns the enclosing math transform.
Point2D	transform(Point2D ptSrc, Point2D ptDst) Transforms the specified pt­Src and stores the result in pt­Dst.

Methods inherited from class AbstractMathTransform.Inverse

compute­Hash­Code, derivative, equals, format­To, get­Source­Dimensions, get­Target­Dimensions, is­Identity

Methods inherited from class AbstractMathTransform

equals, get­Contextual­Parameters, get­Parameter­Descriptors, get­Parameter­Values, hash­Code, transform, transform, transform, transform, transform, transform, try­Concatenate

Methods inherited from class FormattableObject

print, to­String, to­String, to­WKT

Methods inherited from class Object

clone, finalize, get­Class, notify, notify­All, wait, wait, wait

Methods inherited from interface MathTransform

derivative, get­Source­Dimensions, get­Target­Dimensions, is­Identity, to­WKT, transform, transform, transform, transform, transform

Constructor Detail

Inverse

protected Inverse()

Constructs an inverse math transform.

Method Detail

inverse

public MathTransform2D inverse()

Returns the enclosing math transform.

Specified by:

inverse in interface Math­Transform

Specified by:

inverse in interface Math­Transform2D

Overrides:

inverse in class Abstract­Math­Transform.Inverse

Returns:

the enclosing math transform.

transform

public Point2D transform(Point2D ptSrc,
                         Point2D ptDst)
                  throws TransformException

Transforms the specified pt­Src and stores the result in pt­Dst. The default implementation invokes Abstract­Math­Transform.transform(double[], int, double[], int, boolean) using a temporary array of doubles.

Specified by:

transform in interface Math­Transform2D

Parameters:

pt­Src - the coordinate point to be transformed.

pt­Dst - the coordinate point that stores the result of transforming pt­Src, or null if a new point shall be created.

Returns:

the coordinate point after transforming pt­Src and storing the result in pt­Dst, or in a new point if pt­Dst was null.

Throws:

Transform­Exception - if the point can not be transformed.

See Also:

Math­Transform2D.transform(Point2D, Point2D)

createTransformedShape

public Shape createTransformedShape(Shape shape)
                             throws TransformException

Transforms the specified shape. The default implementation computes quadratic curves using three points for each line segment in the shape. The returned object is often a Path2D, but may also be a Line2D or a Quad­Curve2D if such simplification is possible.

Specified by:

create­Transformed­Shape in interface Math­Transform2D

Parameters:

shape - shape to transform.

Returns:

transformed shape, or shape if this transform is the identity transform.

Throws:

Transform­Exception - if a transform failed.

derivative

public Matrix derivative(Point2D point)
                  throws TransformException

Gets the derivative of this transform at a point. The default implementation performs the following steps:

• Copy the coordinate in a temporary array and pass that array to the Abstract­Math­Transform.transform(double[], int, double[], int, boolean) method, with the derivate boolean argument set to true.
• If the later method returned a non-null matrix, returns that matrix. Otherwise throws Transform­Exception.

Specified by:

derivative in interface Math­Transform2D

Parameters:

point - the coordinate point where to evaluate the derivative.

Returns:

the derivative at the specified point as a 2×2 matrix.

Throws:

Transform­Exception - if the derivative can not be evaluated at the specified point.