@Extension public interface MathTransform2D extends MathTransform
CoordinateOperation.getMathTransform()
may
returns instance of this interface when source and destination coordinate systems are both two
dimensional. MathTransform2D
extends MathTransform
by adding some methods for
easier interoperability with Java2D.
If the transformation is affine, then MathTransform
shall be an immutable instance of
AffineTransform
.
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()
Creates the inverse transform of this object.
|
Point2D |
transform(Point2D ptSrc,
Point2D ptDst)
Transforms the specified
ptSrc and stores the result in ptDst . |
derivative, getSourceDimensions, getTargetDimensions, isIdentity, toWKT, transform, transform, transform, transform, transform
Point2D transform(Point2D ptSrc, Point2D ptDst) throws TransformException
ptSrc
and stores the result in ptDst
. If ptDst
is null
, a new Point2D
object is allocated and then the result of the
transformation is stored in this object. In either case, ptDst
, which contains the
transformed point, is returned for convenience. If ptSrc
and ptDst
are the
same object, the input point is correctly overwritten with the transformed point.ptSrc
- the coordinate point to be transformed.ptDst
- the coordinate point that stores the result of transforming ptSrc
, or
null
if a new point should be created.ptSrc
and stroring the result in
ptDst
or in a new point if ptDst
was null.TransformException
- if the point can't be transformed.@Extension Shape createTransformedShape(Shape shape) throws TransformException
shape
- The Shape to transform.shape
unmodified if
this transform is identity.TransformException
- if a transform failed.Matrix derivative(Point2D point) throws TransformException
point
- The coordinate point where to evaluate the derivative. Null value is accepted
only if the derivative is the same everywhere. For example affine transform accept null
value since they produces identical derivative no matter the coordinate value. But most
map projection will requires a non-null value.NullPointerException
- if the derivative dependents on coordinate and point
is
null
.TransformException
- if the derivative can't be evaluated at the specified point.MathTransform2D inverse() throws NoninvertibleTransformException
inverse
in interface MathTransform
NoninvertibleTransformException
- if the transform can't be inversed.Copyright © 1996–2019 Geotools. All rights reserved.