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
directionesriTransformDirectionpPivotPointIPointdegreedouble
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
directionesriTransformDirectionscaleXdoublescaleYdouble
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
directionesriTransformDirectionshiftXdoubleshiftYdouble
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
srcIClone
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
CheckingsSurcePointsIPointCollectionCheckingsTargetPointsIPointCollectiondirectionesriTransformDirectionpResidualobjectrmsdouble
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
ConvertToSupportedObject(esriArcGISVersion)
Convert the object to another object that is supported.
virtual object ConvertToSupportedObject(esriArcGISVersion docVersion)
Parameters
docVersionesriArcGISVersion
Returns
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
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
pSrcPointsIPointCollectionpTarPointsIPointCollectionOrderint
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
dataIXMLSerializeData
Domains
virtual IGeometryCollection Domains { get; }
Returns
GetClassID(out Guid)
virtual void GetClassID(out Guid pClassID)
Parameters
pClassIDGuid
GetCoefficients(esriTransformDirection)
Gets the coefficients of the polynomial.
virtual object GetCoefficients(esriTransformDirection direction)
Parameters
directionesriTransformDirection
Returns
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
ppSrcPointsIPointCollectionppTarPointsIPointCollection
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
directionesriTransformDirection
Returns
GetSystemResidual(esriTransformDirection)
Gets the system residuals.
virtual object GetSystemResidual(esriTransformDirection direction)
Parameters
directionesriTransformDirection
Returns
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
otherIClone
Returns
IsIdentical(IClone)
Indicates if the receiver and other are the same object.
virtual bool IsIdentical(IClone other)
Parameters
otherIClone
Returns
IsIdentity
virtual bool IsIdentity { get; }
Returns
IsSupportedAtVersion(esriArcGISVersion)
Is this object valid at the given document version.
virtual bool IsSupportedAtVersion(esriArcGISVersion docVersion)
Parameters
docVersionesriArcGISVersion
Returns
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
pstmIStream
MinNamespaceSupported
The minimum namespace the class can serialize to (eg the 90 namespace).
virtual string MinNamespaceSupported { get; }
Returns
Order
The polynomial order (0-3).
virtual int Order { get; }
Returns
Save(IStream, int)
virtual void Save(IStream pstm, int fClearDirty)
Parameters
Serialize(IXMLSerializeData)
Serializes an object to XML.
virtual void Serialize(IXMLSerializeData data)
Parameters
dataIXMLSerializeData
SpatialReference
virtual ISpatialReference SpatialReference { get; set; }
Returns
Transform(esriTransformDirection, int, ref WKSPoint)
virtual void Transform(esriTransformDirection Direction, int npoints, ref WKSPoint points)
Parameters
DirectionesriTransformDirectionnpointsintpointsWKSPoint
TransformCellsize(esriTransformDirection, ref double, ref double, IEnvelope)
virtual void TransformCellsize(esriTransformDirection Direction, ref double dx, ref double dy, IEnvelope AreaOfInterest)
Parameters
DirectionesriTransformDirectiondxdoubledydoubleAreaOfInterestIEnvelope
TransformExtent(esriTransformDirection, IEnvelope)
virtual void TransformExtent(esriTransformDirection Direction, IEnvelope Extent)
Parameters
DirectionesriTransformDirectionExtentIEnvelope
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
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresdouble
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
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresint
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
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresdouble
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
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresint
TransformPoints(esriTransformDirection, IPointCollection)
virtual void TransformPoints(esriTransformDirection Direction, IPointCollection points)
Parameters
DirectionesriTransformDirectionpointsIPointCollection
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
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsdouble
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.
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
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsint
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
DirectionesriTransformDirectioncPointsintinPointsintoutPointsdouble
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
DirectionesriTransformDirectioncPointsintinPointsintoutPointsint
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.