|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.geotools.referencing.wkt.Formattable
org.geotools.referencing.operation.transform.AbstractMathTransform
org.geotools.referencing.operation.transform.WarpTransform2D
public class WarpTransform2D
Wraps an arbitrary Warp
object as a two-dimensional transform.
Calls to transform methods are forwarded to
the warpPoint
method, or something equivalent. This
implies that source coordinates may be rounded to nearest integers before the transformation
is applied.
This transform is typically used with grid coverage "Resample" operation for reprojecting an image. Source and destination coordinates are usually pixel coordinates in source and target image, which is why this transform may use integer arithmetic.
This math transform can be created alone (by invoking its public constructors directly), or it
can be created by a factory like LocalizationGrid
.
For more information on image warp, see Geometric Image Manipulation in the Programming in Java Advanced Imaging guide.
LocalizationGrid.getPolynomialTransform(int)
,
Warp
,
WarpOpImage
,
WarpDescriptor
,
Serialized FormNested Class Summary | |
---|---|
static class |
WarpTransform2D.Provider
The provider for the WarpTransform2D . |
Nested classes/interfaces inherited from class org.geotools.referencing.operation.transform.AbstractMathTransform |
---|
AbstractMathTransform.Inverse |
Field Summary | |
---|---|
static int |
MAX_DEGREE
The maximal polynomial degree allowed. |
Fields inherited from class org.geotools.referencing.wkt.Formattable |
---|
SINGLE_LINE |
Constructor Summary | |
---|---|
|
WarpTransform2D(java.awt.geom.Point2D[] srcCoords,
java.awt.geom.Point2D[] dstCoords,
int degree)
Constructs a warp transform that approximatively maps the given source coordinates to the given destination coordinates. |
|
WarpTransform2D(java.awt.geom.Rectangle2D srcBounds,
float[] srcCoords,
int srcOffset,
java.awt.geom.Rectangle2D dstBounds,
float[] dstCoords,
int dstOffset,
int numCoords,
int degree)
Constructs a warp transform that approximatively maps the given source coordinates to the given destination coordinates. |
|
WarpTransform2D(java.awt.geom.Rectangle2D srcBounds,
java.awt.geom.Point2D[] srcCoords,
int srcOffset,
java.awt.geom.Rectangle2D dstBounds,
java.awt.geom.Point2D[] dstCoords,
int dstOffset,
int numCoords,
int degree)
Constructs a warp transform that approximatively maps the given source coordinates to the given destination coordinates. |
protected |
WarpTransform2D(javax.media.jai.Warp warp,
javax.media.jai.Warp inverse)
Constructs a transform using the specified warp object. |
Method Summary | |
---|---|
static org.opengis.referencing.operation.MathTransform2D |
create(javax.media.jai.Warp warp)
Returns a transform using the specified warp object. |
boolean |
equals(java.lang.Object object)
Compares this transform with the specified object for equality. |
org.opengis.parameter.ParameterDescriptorGroup |
getParameterDescriptors()
Returns the parameter descriptors for this math transform. |
org.opengis.parameter.ParameterValueGroup |
getParameterValues()
Returns the parameter values for this math transform. |
int |
getSourceDimensions()
Returns the dimension of input points. |
int |
getTargetDimensions()
Returns the dimension of output points. |
javax.media.jai.Warp |
getWarp()
Returns image warp wrapped by this transform. |
static javax.media.jai.Warp |
getWarp(java.lang.CharSequence name,
org.opengis.referencing.operation.MathTransform2D transform)
Returns a image warp for the specified transform. |
int |
hashCode()
Returns a hash value for this transform. |
org.opengis.referencing.operation.MathTransform2D |
inverse()
Returns the inverse transform. |
boolean |
isIdentity()
Tests if this transform is the identity transform. |
void |
transform(double[] srcPts,
int srcOff,
double[] dstPts,
int dstOff,
int numPts)
Transforms source coordinates (usually pixel indices) into destination coordinates (usually "real world" coordinates). |
void |
transform(float[] srcPts,
int srcOff,
float[] dstPts,
int dstOff,
int numPts)
Transforms source coordinates (usually pixel indices) into destination coordinates (usually "real world" coordinates). |
java.awt.geom.Point2D |
transform(java.awt.geom.Point2D ptSrc,
java.awt.geom.Point2D ptDst)
Transforms source coordinates (usually pixel indices) into destination coordinates (usually "real world" coordinates). |
Methods inherited from class org.geotools.referencing.operation.transform.AbstractMathTransform |
---|
createTransformedShape, derivative, derivative, ensureNonNull, formatWKT, getName, needCopy, rollLongitude, transform, transform, transform |
Methods inherited from class org.geotools.referencing.wkt.Formattable |
---|
cleanupThreadLocals, toString, toWKT, toWKT, toWKT |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.opengis.referencing.operation.MathTransform2D |
---|
createTransformedShape, derivative |
Methods inherited from interface org.opengis.referencing.operation.MathTransform |
---|
derivative, toWKT, transform, transform, transform |
Field Detail |
---|
public static final int MAX_DEGREE
Constructor Detail |
---|
public WarpTransform2D(java.awt.geom.Point2D[] srcCoords, java.awt.geom.Point2D[] dstCoords, int degree)
Degree of Warp | Number of Points |
---|---|
1 | 3 |
2 | 6 |
3 | 10 |
4 | 15 |
5 | 21 |
6 | 28 |
7 | 36 |
srcCoords
- Source coordinates.dstCoords
- Destination coordinates.degree
- The desired degree of the warp polynomials.public WarpTransform2D(java.awt.geom.Rectangle2D srcBounds, java.awt.geom.Point2D[] srcCoords, int srcOffset, java.awt.geom.Rectangle2D dstBounds, java.awt.geom.Point2D[] dstCoords, int dstOffset, int numCoords, int degree)
srcBounds
- Bounding box of source coordinates, or null
if unknow.srcCoords
- Source coordinates.srcOffset
- The inital entry of srcCoords
to be used.dstBounds
- Bounding box of destination coordinates, or null
if unknow.dstCoords
- Destination coordinates.dstOffset
- The inital entry of destCoords
to be used.numCoords
- The number of coordinates from srcCoords
and destCoords
to be used.degree
- The desired degree of the warp polynomials.public WarpTransform2D(java.awt.geom.Rectangle2D srcBounds, float[] srcCoords, int srcOffset, java.awt.geom.Rectangle2D dstBounds, float[] dstCoords, int dstOffset, int numCoords, int degree)
srcBounds
- Bounding box of source coordinates, or null
if unknow.srcCoords
- Source coordinates with x and y alternating.srcOffset
- The inital entry of srcCoords
to be used.dstBounds
- Bounding box of destination coordinates, or null
if unknow.dstCoords
- Destination coordinates with x and y alternating.dstOffset
- The inital entry of destCoords
to be used.numCoords
- The number of coordinates from srcCoords
and destCoords
to be used.degree
- The desired degree of the warp polynomials.protected WarpTransform2D(javax.media.jai.Warp warp, javax.media.jai.Warp inverse)
warpPoint
method or something equivalent.
warp
- The image warp to wrap into a math transform.inverse
- An image warp to uses for the inverse transform,
or null
in none.Method Detail |
---|
public static org.opengis.referencing.operation.MathTransform2D create(javax.media.jai.Warp warp)
warpPoint
method or something equivalent.
warp
- The image warp to wrap into a math transform.
public static javax.media.jai.Warp getWarp(java.lang.CharSequence name, org.opengis.referencing.operation.MathTransform2D transform)
Warp.warpPoint
method transforms coordinates from
source to target CRS. Note that JAI's warp operation needs a warp object with the opposite semantic (i.e. the image warp must
transforms coordinates from target to source CRS). Consequently, consider invoking
getWarp(transform.inverse())
if the warp object is going to be used in an
image reprojection.
name
- The image or coverage
name, or null
in unknow. Used only for formatting error message if some
TransformException
are thrown by the
supplied transform.transform
- The transform to returns as an image warp.
public javax.media.jai.Warp getWarp()
Warp.warpPoint
method transforms coordinates from
source to target CRS. Note that JAI's warp operation needs a warp object with the opposite semantic (i.e. the image warp must
transforms coordinates from target to source CRS). Consequently, consider invoking
inverse.getWarp()
if the warp object is going to be used in an
image reprojection.
public org.opengis.parameter.ParameterDescriptorGroup getParameterDescriptors()
getParameterDescriptors
in class AbstractMathTransform
null
.OperationMethod.getParameters()
public org.opengis.parameter.ParameterValueGroup getParameterValues()
getParameterValues
in class AbstractMathTransform
null
.Operation.getParameterValues()
public int getSourceDimensions()
getSourceDimensions
in interface org.opengis.referencing.operation.MathTransform
getSourceDimensions
in class AbstractMathTransform
public int getTargetDimensions()
getTargetDimensions
in interface org.opengis.referencing.operation.MathTransform
getTargetDimensions
in class AbstractMathTransform
public boolean isIdentity()
isIdentity
in interface org.opengis.referencing.operation.MathTransform
isIdentity
in class AbstractMathTransform
public java.awt.geom.Point2D transform(java.awt.geom.Point2D ptSrc, java.awt.geom.Point2D ptDst)
transform
in interface org.opengis.referencing.operation.MathTransform2D
transform
in class AbstractMathTransform
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
.MathTransform2D.transform(Point2D,Point2D)
public void transform(float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)
transform
in interface org.opengis.referencing.operation.MathTransform
transform
in class AbstractMathTransform
public void transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)
transform
in interface org.opengis.referencing.operation.MathTransform
public org.opengis.referencing.operation.MathTransform2D inverse() throws org.opengis.referencing.operation.NoninvertibleTransformException
inverse
in interface org.opengis.referencing.operation.MathTransform
inverse
in interface org.opengis.referencing.operation.MathTransform2D
inverse
in class AbstractMathTransform
org.opengis.referencing.operation.NoninvertibleTransformException
- if no inverse warp were specified at construction time.public int hashCode()
hashCode
in class AbstractMathTransform
public boolean equals(java.lang.Object object)
equals
in class AbstractMathTransform
object
- The object to compare with this transform.
true
if the given object is a transform of the same class
and if, given identical source position, the
transformed
position would be the equals.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |