|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
MathTransform
in the org.opengis.referencing.operation
package.
Transforms multi-dimensional coordinate points. This interface transforms coordinate value for a point given in the source coordinate system to coordinate value for the same point in the target coordinate system. In an ISO conversion, the transformation is accurate to within the limitations of the computer making the calculations. In an ISO transformation, where some of the operational parameters are derived from observations, the transformation is accurate to within the limitations of those observations.
CT_MathTransform
,
AffineTransform
,
PerspectiveTransform
,
javax.media.j3d.Transform3D
,
MathTransform2D
Method Summary | |
Matrix |
derivative(CoordinatePoint point)
Deprecated. Gets the derivative of this transform at a point. |
int |
getDimSource()
Deprecated. Gets the dimension of input points. |
int |
getDimTarget()
Deprecated. Gets the dimension of output points. |
MathTransform |
inverse()
Deprecated. Creates the inverse transform of this object. |
boolean |
isIdentity()
Deprecated. Tests whether this transform does not move any points. |
CoordinatePoint |
transform(CoordinatePoint ptSrc,
CoordinatePoint ptDst)
Deprecated. Transforms the specified ptSrc and stores the result in
ptDst . |
void |
transform(double[] srcPts,
int srcOff,
double[] dstPts,
int dstOff,
int numPts)
Deprecated. Transforms a list of coordinate point ordinal values. |
void |
transform(float[] srcPts,
int srcOff,
float[] dstPts,
int dstOff,
int numPts)
Deprecated. Transforms a list of coordinate point ordinal values. |
Method Detail |
public int getDimSource()
CT_MathTransform.getDimSource()
public int getDimTarget()
CT_MathTransform.getDimTarget()
public CoordinatePoint transform(CoordinatePoint ptSrc, CoordinatePoint ptDst) throws org.opengis.spatialschema.geometry.MismatchedDimensionException, org.opengis.referencing.operation.TransformException
ptSrc
and stores the result in
ptDst
. If ptDst
is null
, a new
CoordinatePoint
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 specified coordinate point to be transformed.ptDst
- the specified coordinate point that stores the
result of transforming ptSrc
, or
null
.
ptSrc
and storing the result in ptDst
, or a newly
created point if ptDst
was null.
org.opengis.spatialschema.geometry.MismatchedDimensionException
- if ptSrc
or
ptDst
doesn't have the expected dimension.
org.opengis.referencing.operation.TransformException
- if the point can't be transformed.CT_MathTransform.transform(org.opengis.pt.PT_CoordinatePoint)
public void transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws org.opengis.referencing.operation.TransformException
srcPts
- the array containing the source point coordinates.srcOff
- the offset to the first point to be transformed
in the source array.dstPts
- the array into which the transformed point
coordinates are returned. May be the same
than srcPts
.dstOff
- the offset to the location of the first
transformed point that is stored in the
destination array.numPts
- the number of point objects to be transformed.
org.opengis.referencing.operation.TransformException
- if a point can't be transformed.CT_MathTransform.transformList(double[])
public void transform(float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts) throws org.opengis.referencing.operation.TransformException
srcPts
- the array containing the source point coordinates.srcOff
- the offset to the first point to be transformed
in the source array.dstPts
- the array into which the transformed point
coordinates are returned. May be the same
than srcPts
.dstOff
- the offset to the location of the first
transformed point that is stored in the
destination array.numPts
- the number of point objects to be transformed.
org.opengis.referencing.operation.TransformException
- if a point can't be transformed.public Matrix derivative(CoordinatePoint point) throws org.opengis.spatialschema.geometry.MismatchedDimensionException, org.opengis.referencing.operation.TransformException
N×M
. The elements of the matrix
{en,m : n=0..(N-1)}
form a vector in the output space which is parallel to the displacement
caused by a small change in the m'th ordinate in the input space.
(x0, x1, x2, x3)
in the input space will result in a displacement
(y0, y1, y2)
in the output space computed as below (en,m
are the matrix's elements):
[ y0 ] [ e00 e01 e02 e03 ] [ x0 ] [ y1 ] = [ e10 e11 e12 e13 ] [ x1 ] [ y2 ] [ e20 e21 e22 e23 ] [ x2 ] [ x3 ]
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.
null
).
This method never returns an internal object: changing the matrix
will not change the state of this math transform.
java.lang.NullPointerException
- if the derivative dependents on coordinate
and point
is null
.
org.opengis.spatialschema.geometry.MismatchedDimensionException
- if point
doesn't have
the expected dimension.
org.opengis.referencing.operation.TransformException
- if the derivative can't be evaluated at the
specified point.CT_MathTransform.derivative(org.opengis.pt.PT_CoordinatePoint)
public MathTransform inverse() throws org.opengis.referencing.operation.NoninvertibleTransformException
org.opengis.referencing.operation.NoninvertibleTransformException
- if the transform can't be inversed.CT_MathTransform.inverse()
public boolean isIdentity()
true
if this MathTransform
is
an identity transform; false
otherwise.CT_MathTransform.isIdentity()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |