Class AbstractMathTransform2D.Inverse

Object

FormattableObject

AbstractMathTransform

AbstractMathTransform.Inverse

Inverse

All Implemented Interfaces:

Parameterized, Lenient­Comparable, Printable, 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

Modifier and Type	Class	Description
protected static class	Abstract­Math­Transform.Inverse	Base class for implementations of inverse math transforms.

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

Modifier and Type	Method	Description
protected int	compute­Hash­Code()	Computes a hash value for this transform.
Matrix	derivative(Direct­Position point)	Gets the derivative of this transform at a point.
boolean	equals(Object object, Comparison­Mode mode)	Compares the specified object with this inverse math transform for equality.
protected String	format­To(Formatter formatter)	Formats the inner part of a Well Known Text version 1 (WKT 1) element.
Optional<Envelope>	get­Domain(Domain­Definition criteria)	Returns the ranges of coordinate values which can be used as inputs.
int	get­Source­Dimensions()	Gets the dimension of input points.
int	get­Target­Dimensions()	Gets the dimension of output points.
boolean	is­Identity()	Tests whether this transform does not move any points.

Methods inherited from class AbstractMathTransform

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

Modifier and Type	Method	Description
final boolean	equals(Object object)	Compares the specified object with this math transform for strict equality.
protected Contextual­Parameters	get­Contextual­Parameters()	Returns the parameters for a sequence of normalize → this → denormalize transforms (optional operation).
Parameter­Descriptor­Group	get­Parameter­Descriptors()	Returns the parameter descriptors for this math transform, or null if unknown.
Parameter­Value­Group	get­Parameter­Values()	Returns the parameter values for this math transform, or null if unknown.
final Type	get­Standard­Type()	Returns the class that defines the public properties of this instance.
final int	hash­Code()	Returns a hash value for this transform.
abstract Matrix	transform(double[] src­Pts, int src­Off, double[] dst­Pts, int dst­Off, boolean derivate)	Transforms a single coordinate tuple in an array, and optionally computes the transform derivative at that location.
void	transform(double[] src­Pts, int src­Off, double[] dst­Pts, int dst­Off, int num­Pts)	Transforms a list of coordinate tuples.
void	transform(double[] src­Pts, int src­Off, float[] dst­Pts, int dst­Off, int num­Pts)	Transforms a list of coordinate tuples.
void	transform(float[] src­Pts, int src­Off, double[] dst­Pts, int dst­Off, int num­Pts)	Transforms a list of coordinate tuples.
void	transform(float[] src­Pts, int src­Off, float[] dst­Pts, int dst­Off, int num­Pts)	Transforms a list of coordinate tuples.
Direct­Position	transform(Direct­Position pt­Src, Direct­Position pt­Dst)	Transforms the specified pt­Src and stores the result in pt­Dst.
protected void	try­Concatenate(Transform­Joiner context)	Concatenates in an optimized way this math transform with its neighbor, if possible.

Methods inherited from class FormattableObject

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

Modifier and Type	Method	Description
void	print()	Prints a string representation of this object to the standard output stream.
String	to­String()	Returns a Well Known Text (WKT) or an alternative text representation for this object.
String	to­String(Convention convention)	Returns a Well Known Text (WKT) for this object using the specified convention.
String	to­WKT()	Returns a strictly compliant Well Known Text (WKT) using the default convention, symbols and indentation.

Methods inherited from class Object

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

Methods inherited from interface MathTransform

to­WKT

Modifier and Type	Method	Description
String	to­WKT()	Returns a Well Known Text (WKT) for this object.

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.