ESRI.ArcGIS.ADF.IMS
Project(GeometryCollection,SpatialReference,Double,Double,Boolean,IMSServerConnection,Environment) Method
See Also 
ESRI.ArcGIS.ADF.IMS.Projection Namespace > Projection Class > Project Method : Project(GeometryCollection,SpatialReference,Double,Double,Boolean,IMSServerConnection,Environment) Method




geometries
The GeometryCollection to project.
toSpatialReference
SpatialReference to project the Geometries to.
densifyTolerance
Defines the distance (tolerance) between points and is applied on the Geometry before the projection takes place.
accuracy
Determines the amount of generalization for a feature based on a specified distance.
returnEnvelopes
True to return the projected Geometries as envelopes.
connection
IMSServerConnection for the projection request.
environment
The Environment for the request, which provides culture information.
Projects a collection of Geometries.

Syntax

Visual Basic (Declaration) 
Public Overloads Shared Function Project( _
   ByVal geometries As GeometryCollection, _
   ByVal toSpatialReference As SpatialReference, _
   ByVal densifyTolerance As Double, _
   ByVal accuracy As Double, _
   ByVal returnEnvelopes As Boolean, _
   ByVal connection As IMSServerConnection, _
   ByVal environment As Environment _
) As GeometryCollection
Visual Basic (Usage)Copy Code
Dim geometries As GeometryCollection
Dim toSpatialReference As SpatialReference
Dim densifyTolerance As Double
Dim accuracy As Double
Dim returnEnvelopes As Boolean
Dim connection As IMSServerConnection
Dim environment As Environment
Dim value As GeometryCollection
 
value = Projection.Project(geometries, toSpatialReference, densifyTolerance, accuracy, returnEnvelopes, connection, environment)
C# 
public static GeometryCollection Project( 
   GeometryCollection geometries,
   SpatialReference toSpatialReference,
   double densifyTolerance,
   double accuracy,
   bool returnEnvelopes,
   IMSServerConnection connection,
   Environment environment
)

Parameters

geometries
The GeometryCollection to project.
toSpatialReference
SpatialReference to project the Geometries to.
densifyTolerance
Defines the distance (tolerance) between points and is applied on the Geometry before the projection takes place.
accuracy
Determines the amount of generalization for a feature based on a specified distance.
returnEnvelopes
True to return the projected Geometries as envelopes.
connection
IMSServerConnection for the projection request.
environment
The Environment for the request, which provides culture information.

Return Value

The projected Geometries. Cast items to the appropriate geometry type to use.

Remarks

Accuracy

Points are generalized within a feature based on the distance specified and the resolution of the image. Units are the same as the service. A value of 0 for accuracy returns all points of a feature, whereas higher values return a feature with fewer points thus making the feature more generalized. Note that given a non-zero value used for accuracy, and depending on the geometry layout of features in a layer, polylines or polygons may become self-intersecting. When this happens, the geomtery is invalid, the feature is ignored, and no result is returned for the spatial query. Accuracy cannot be used on a point layer; only polygon and polyline layers are valid.



DensifyTolerance

Defines the distance (tolerance) between points and is applied on the geometry before projecting takes place. The units are the same as the units for the original coordinate system. For example, if the coordinate system is in feet, the densifyTolerance distance is in feet.

The process of data densification adds virtual points to a polygon before it is projected. When a polygon is projected, the line geometry changes. For example, a square in one projection may be trapezoidal in another projection. In some cases, the number of points defining the geometry in the original geometry is not enough to describe the geometry correctly in the new coordinate system.

If the tolerance value is too small, the ArcIMS Spatial Server can slow down considerably. It is better to start with a large value. A guideline is to start with a value about 20 to 30 percent of the distance between the minimum and maximum x-coordinates of the current map extent.

ReturnEnvelopes

When returnEnvelopes is set to true, geometry is returned as Envelope. When set to false, the input and output geometry are the same. The exception is when using Envelope as input geometry. In this case, when returnEnvelopes is false, then the geometry is returned as Polygon.

Environment

The Environment parameter is used to determine the culture information for writing out the geometry in the request. An Environment object may be constructed by reading the machine information, which loads the current culture information from the server.

Returned Geometry

The returned value will be a GeometryCollection. You may need to cast the members of the collection to the appropriate type to display or use them. See above on returnEnvelopes for whether the returned geometry will be the same as the input type or Envelope.

See Also

© 2010 All Rights Reserved.