Class PolynomialXformClass

Namespace
ESRI.ArcGIS.DatasourcesRaster
Assembly
ESRI.Server.DatasourcesRaster.dll
[ClassInterface(ClassInterfaceType.None)]
[Guid("B3CAA849-5523-4490-AA2D-780ACA41E1DD")]
public class PolynomialXformClass : PolynomialXform, IPolynomialXform, IGeodataXform, ITransformation, IClone, IPersistStream, IPersist, IDocumentVersionSupportGEN, IXMLSerialize, IXMLVersionSupport
Inheritance
PolynomialXformClass
Implements
Inherited Members

Constructors

PolynomialXformClass()

public PolynomialXformClass()

Explicit Interface Implementations

ApplyRotation(esriTransformDirection, IPoint, double)

Applies a rotation to the polynomial.

virtual void ApplyRotation(esriTransformDirection direction, IPoint pPivotPoint, double degree)

Parameters

direction esriTransformDirection
pPivotPoint IPoint
degree double

Remarks

ApplyRotation method append an xform to the existing PolynomialXform. To define a rotation transformation for work with raster data using this method, you must define both forward and inverse transformation.

For example, to define a rotation of 45 degree unclockwise, you need to call

 

pPolynomialXform.ApplyRotate TransformationForward, 45

pPolynomialXform.ApplyRotate TransformationReverse, -45

 

ApplyScale(esriTransformDirection, double, double)

Applies a scale to the polynomial.

virtual void ApplyScale(esriTransformDirection direction, double scaleX, double scaleY)

Parameters

direction esriTransformDirection
scaleX double
scaleY double

Remarks

ApplyScale method appends an xform to the existing PolynomialXform. To define an scale transformation to work with raster data using this method, you must define both forward and inverse transformations.

For example, to define a scale transformation, you need to call

 

pPolynomialXform.ApplyScale TransformationForward, 10

pPolynomialXform.ApplyScale TransformationReverse, 1/10

ApplyShift(esriTransformDirection, double, double)

Applies a shift to the polynomial.

virtual void ApplyShift(esriTransformDirection direction, double shiftX, double shiftY)

Parameters

direction esriTransformDirection
shiftX double
shiftY double

Remarks

ApplyShift method append an xform to the existing PolynomialXform. To define a shift transformation to work with raster data using this method, you must define both forward and inverse transformations.

For example, to define a shift transformation, you need to call

 

pPolynomialXform.ApplyShift TransformationForward, 10

pPolynomialXform.ApplyShift TransformationReverse, -10

Assign(IClone)

Assigns the properties of src to the receiver.

virtual void Assign(IClone src)

Parameters

src IClone

CheckResidualRMS(IPointCollection, IPointCollection, esriTransformDirection, out object, out double)

Gets the residuals and RMS using checking points.

virtual void CheckResidualRMS(IPointCollection CheckingsSurcePoints, IPointCollection CheckingsTargetPoints, esriTransformDirection direction, out object pResidual, out double rms)

Parameters

CheckingsSurcePoints IPointCollection
CheckingsTargetPoints IPointCollection
direction esriTransformDirection
pResidual object
rms double

Remarks

Get residual on a set of user specified check points. The residual returned is a variant array of double type.

Clone()

Clones the receiver and assigns the result to *clone.

virtual IClone Clone()

Returns

IClone

ConvertToSupportedObject(esriArcGISVersion)

Convert the object to another object that is supported.

virtual object ConvertToSupportedObject(esriArcGISVersion docVersion)

Parameters

docVersion esriArcGISVersion

Returns

object

Remarks

This method should be used when IDocumentVersionSupportGEN::IsSupportedAtVersion returns FALSE.  Calling ConvertToSupportedObject will return an IUnknown pointer to a relevant object supported at the particular ArcGIS version.  Not all objects will return a supported object; in these cases a null pointer will be returned.

DefineFromCoefficients(ref object, ref object, int)

Defines a polynomial XForm from polynomial (order: 0-3) coefficients .

virtual void DefineFromCoefficients(ref object pForwardPolyCoef, ref object pReversePolyCoef, int Order)

Parameters

pForwardPolyCoef object
pReversePolyCoef object
Order int

Remarks

The polynomial coefficients are a variant array of nx2 elements of double type, where n=3 for the first order, 6 for the second order and 10 for the third order.

To define a PolynomialXform to work with raster dataset, coefficients for both forward case and reverse case must be set.

You can define a PolynomialXform that performs one direction transformation, for transforming other type of data, such as forward transformation, pass Null to reverse coefficient argument.

DefineFromControlPoints(IPointCollection, IPointCollection, int)

Defines a polynomial (order: 0-3) XForm from control points.

virtual void DefineFromControlPoints(IPointCollection pSrcPoints, IPointCollection pTarPoints, int Order)

Parameters

pSrcPoints IPointCollection
pTarPoints IPointCollection
Order int

Remarks

The polynomial order can be 1,2,3 and the number of the non-correlated control points required must be at least 3, 6, and 10 respectively.

Deserialize(IXMLSerializeData)

Deserializes an object from XML.

virtual void Deserialize(IXMLSerializeData data)

Parameters

data IXMLSerializeData

Domains

virtual IGeometryCollection Domains { get; }

Returns

IGeometryCollection

GetClassID(out Guid)

virtual void GetClassID(out Guid pClassID)

Parameters

pClassID Guid

GetCoefficients(esriTransformDirection)

Gets the coefficients of the polynomial.

virtual object GetCoefficients(esriTransformDirection direction)

Parameters

direction esriTransformDirection

Returns

object

Remarks

The polynomial coefficients are in a variant array of nx2 elements of double type, where n=3 for the first order, 6 for the second order and 10 for the third order.

GetControlPoints(out IPointCollection, out IPointCollection)

Gets control points used in defining the polynomial.

virtual void GetControlPoints(out IPointCollection ppSrcPoints, out IPointCollection ppTarPoints)

Parameters

ppSrcPoints IPointCollection
ppTarPoints IPointCollection

GetSizeMax(out _ULARGE_INTEGER)

virtual void GetSizeMax(out _ULARGE_INTEGER pcbSize)

Parameters

pcbSize _ULARGE_INTEGER

GetSystemRMS(esriTransformDirection)

Gets the system RMS.

virtual double GetSystemRMS(esriTransformDirection direction)

Parameters

direction esriTransformDirection

Returns

double

GetSystemResidual(esriTransformDirection)

Gets the system residuals.

virtual object GetSystemResidual(esriTransformDirection direction)

Parameters

direction esriTransformDirection

Returns

object

Remarks

The residual returned is variant array of double type, the size of the array is the number of control points used in creating the PolynomialXform.

IsDirty()

virtual void IsDirty()

IsEqual(IClone)

Indicates if the receiver and other have the same properties.

virtual bool IsEqual(IClone other)

Parameters

other IClone

Returns

bool

IsIdentical(IClone)

Indicates if the receiver and other are the same object.

virtual bool IsIdentical(IClone other)

Parameters

other IClone

Returns

bool

IsIdentity

virtual bool IsIdentity { get; }

Returns

bool

IsSupportedAtVersion(esriArcGISVersion)

Is this object valid at the given document version.

virtual bool IsSupportedAtVersion(esriArcGISVersion docVersion)

Parameters

docVersion esriArcGISVersion

Returns

bool

Remarks

Use IsSupportedAtVersion to identify if a particular object should be saved to the ObjectStream.  This result is based on the esriArcGISVersion enumeration.  In some instances, if the object is not supported at a particular ArcGIS version, the object may support conversion to another similar object; use IDocumentVersionSupportGEN::ConvertToSupportedObject to accomplish this.

Load(IStream)

virtual void Load(IStream pstm)

Parameters

pstm IStream

MinNamespaceSupported

The minimum namespace the class can serialize to (eg the 90 namespace).

virtual string MinNamespaceSupported { get; }

Returns

string

Order

The polynomial order (0-3).

virtual int Order { get; }

Returns

int

Save(IStream, int)

virtual void Save(IStream pstm, int fClearDirty)

Parameters

pstm IStream
fClearDirty int

Serialize(IXMLSerializeData)

Serializes an object to XML.

virtual void Serialize(IXMLSerializeData data)

Parameters

data IXMLSerializeData

SpatialReference

virtual ISpatialReference SpatialReference { get; set; }

Returns

ISpatialReference

Transform(esriTransformDirection, int, ref WKSPoint)

virtual void Transform(esriTransformDirection Direction, int npoints, ref WKSPoint points)

Parameters

Direction esriTransformDirection
npoints int
points WKSPoint

TransformCellsize(esriTransformDirection, ref double, ref double, IEnvelope)

virtual void TransformCellsize(esriTransformDirection Direction, ref double dx, ref double dy, IEnvelope AreaOfInterest)

Parameters

Direction esriTransformDirection
dx double
dy double
AreaOfInterest IEnvelope

TransformExtent(esriTransformDirection, IEnvelope)

virtual void TransformExtent(esriTransformDirection Direction, IEnvelope Extent)

Parameters

Direction esriTransformDirection
Extent IEnvelope

TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)

Transforms floating point measures to floating point measures (or do the inverse).

virtual void TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures double
outMeasures double

TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)

Transforms floating point measures to integer measures (or do the inverse).

virtual void TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures double
outMeasures int

TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)

Transforms integer measures to floating point measures (or do the inverse).

virtual void TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures int
outMeasures double

TransformMeasuresII(esriTransformDirection, int, ref int, ref int)

Transforms integer measures to integer measures (or do the inverse).

virtual void TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures int
outMeasures int

TransformPoints(esriTransformDirection, IPointCollection)

virtual void TransformPoints(esriTransformDirection Direction, IPointCollection points)

Parameters

Direction esriTransformDirection
points IPointCollection

TransformPointsFF(esriTransformDirection, int, ref double, ref double)

Transforms floating point points to floating point points (or do the inverse).

virtual void TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints double
outPoints double

Remarks

The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.

[C#]

The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.  This code is a shift of the points to the east and north.

 

            IAffineTransformation2D transform = new AffineTransformation2D() as IAffineTransformation2D;
            //Sets the type of transformation moving the values 10 degrees East and 20 degrees North
            transform.Move(10, 20);
            //Create two single dimensioned arrays for the inPoints and OutPoints
            double[] inPoints = new double[4];
            double[] outPoints = new double[4];




            //Interleave the Longitude and Latitude value for two points 1.1E 5.2N, 2.3E 6.4N
            inPoints[0]=1.1; //Longitude point 1
            inPoints[1]=5.2; //Latitude point 1
            inPoints[2]=2.3; //Longitude point 2
            inPoints[3] = 6.4; //Latitude point 2



            transform.TransformPointsFF(0,2,ref inPoints[0],ref outPoints[0]);
            Debug.Print(outPoints[0].ToString()); //11.1
            Debug.Print(outPoints[1].ToString()); //25.2
            Debug.Print(outPoints[2].ToString()); //12.3
            Debug.Print(outPoints[3].ToString()); //26.4



TransformPointsFI(esriTransformDirection, int, ref double, ref int)

Transforms floating point points to integer points (or do the inverse).

virtual void TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints double
outPoints int

Remarks

The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.

TransformPointsIF(esriTransformDirection, int, ref int, ref double)

Transforms integer points to floating point points (or do the inverse).

virtual void TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints int
outPoints double

Remarks

The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.

TransformPointsII(esriTransformDirection, int, ref int, ref int)

Transforms integer points to integer points (or do the inverse).

virtual void TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints int
outPoints int

Remarks

The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.