Module org.apache.sis.referencing

Package org.apache.sis.referencing.operation.transform

Class AbstractMathTransform2D.Inverse

Object

FormattableObject

AbstractMathTransform

AbstractMathTransform.Inverse

Inverse

All Implemented Interfaces:

Parameterized, Lenient­Comparable, Math­Transform, Math­Transform2D

Enclosing class:

Abstract­Math­Transform2D

protected abstract static 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

This object may or may not be serializable, at implementation choices. Most Apache SIS implementations are serializable, but the serialized objects are not guaranteed to be compatible with future SIS versions. Serialization should be used only for short term storage or RMI between applications running the same SIS version.

Since:

0.5

Nested Class Summary

Nested classes/interfaces inherited from class AbstractMathTransform

Abstract­Math­Transform.Inverse

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
Shape	create­Transformed­Shape(Shape shape)	Transforms the specified shape.
Matrix	derivative(Point2D point)	Gets the derivative of this transform at a point.
abstract Math­Transform2D	inverse()	Returns the inverse of this math transform.
Point2D	transform(Point2D pt­Src, Point2D pt­Dst)	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­Domain, 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 Details

Inverse

protected Inverse()

Constructs an inverse math transform.

Method Details

inverse

public abstract MathTransform2D inverse()

Returns the inverse of this math transform. The returned transform should be the enclosing math transform.

Specified by:

inverse in interface Math­Transform

Specified by:

inverse in interface Math­Transform2D

Specified by:

inverse in class Abstract­Math­Transform.Inverse

Returns:

the inverse of this 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 tuple to be transformed.

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

Returns:

the coordinate tuple 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 cannot 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 coordinates 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 latter method returned a non-null matrix, returns that matrix. Otherwise throws Transform­Exception.

Specified by:

derivative in interface Math­Transform2D

Parameters:

point - the coordinate tuple where to evaluate the derivative.

Returns:

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

Throws:

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