ArcFM Solution Developer Guide
ConvertGisPoint3DToWallCoordinateXY(Coordinate3D,LineSegment,Double) Method


Miner.Desktop Assembly > Miner.Desktop.Diagrams.Underground Namespace > ConduitLayoutGeometry Class > ConvertGisPoint3DToWallCoordinateXY Method : ConvertGisPoint3DToWallCoordinateXY(Coordinate3D,LineSegment,Double) Method
The 3D GIS coordinate of an object (e.g. a DuctEnd feature) that lies on the wall (a vertical plane in the GIS 3D coordinate system) of a vault or a manhole etc. The GIS Z value is understood to be referred to the ceiling of the vault as the Z=0 reference; Z values are therefore expected to be negative, and with magnitude less than the wall height of the vault, in map units. If the vault elevation is such that its ceiling is NOT at the actual Z=0 plane in the GIS coordinate system, then the caller should pass in a gisCoordinate3D value that has an elevation-adjusted Z value to account for that difference.
A 2-dimensional line segment that represents the projection of the vertical wall plane upon the ground. The order of the line segment's 2 coordinates P1 and P2 is important; P1 is understood to lie at the "left end" of the wall relative to an observer who is standing inside the vault or manhole facing that wall. P2 corresponds to the right end of the wall.
Used to verify that the given point actually lies in the plane of the wall defined by gisWallFootprintOnGround2D. An exception is thrown if the distance of the given point to the wall line is greater than wallSnappingTolerance.
Converts the given gisCoordinate3D into a corresponding coordinate in the 2-dimensional coordinate system defined by the wall of a vault or a manhole, etc. The upper left corner of the wall is taken to be the origin of that 2D coordinate system, and we expect all of the stuff on that wall to lie in quadrant IV of that 2D coordinate system (i.e. the Y values will all be negative and the X values all positive).
Syntax
'Declaration
 
Public Overloads Shared Function ConvertGisPoint3DToWallCoordinateXY( _
   ByVal gisCoordinate3D As SE.Geospatial.Spatial.Coordinate3D, _
   ByVal gisWallFootprintOnGround2D As SE.Geospatial.Spatial.LineSegment, _
   ByVal wallSnappingTolerance As System.Double _
) As SE.Geospatial.Spatial.Coordinate
'Usage
 
Dim gisCoordinate3D As SE.Geospatial.Spatial.Coordinate3D
Dim gisWallFootprintOnGround2D As SE.Geospatial.Spatial.LineSegment
Dim wallSnappingTolerance As System.Double
Dim value As SE.Geospatial.Spatial.Coordinate
 
value = ConduitLayoutGeometry.ConvertGisPoint3DToWallCoordinateXY(gisCoordinate3D, gisWallFootprintOnGround2D, wallSnappingTolerance)
public static SE.Geospatial.Spatial.Coordinate ConvertGisPoint3DToWallCoordinateXY( 
   SE.Geospatial.Spatial.Coordinate3D gisCoordinate3D,
   SE.Geospatial.Spatial.LineSegment gisWallFootprintOnGround2D,
   System.double wallSnappingTolerance
)

Parameters

gisCoordinate3D
The 3D GIS coordinate of an object (e.g. a DuctEnd feature) that lies on the wall (a vertical plane in the GIS 3D coordinate system) of a vault or a manhole etc. The GIS Z value is understood to be referred to the ceiling of the vault as the Z=0 reference; Z values are therefore expected to be negative, and with magnitude less than the wall height of the vault, in map units. If the vault elevation is such that its ceiling is NOT at the actual Z=0 plane in the GIS coordinate system, then the caller should pass in a gisCoordinate3D value that has an elevation-adjusted Z value to account for that difference.
gisWallFootprintOnGround2D
A 2-dimensional line segment that represents the projection of the vertical wall plane upon the ground. The order of the line segment's 2 coordinates P1 and P2 is important; P1 is understood to lie at the "left end" of the wall relative to an observer who is standing inside the vault or manhole facing that wall. P2 corresponds to the right end of the wall.
wallSnappingTolerance
Used to verify that the given point actually lies in the plane of the wall defined by gisWallFootprintOnGround2D. An exception is thrown if the distance of the given point to the wall line is greater than wallSnappingTolerance.
Requirements

Target Platforms: Windows XP SP3 (32-bit and 64-bit), Windows 7 (32-bit and 64-bit)

Not all Operating Systems are supported on all products. Visit the ArcFM Solution Supported Versions page for full details.

See Also

Reference

ConduitLayoutGeometry Class
ConduitLayoutGeometry Members
Overload List

 

 

Send Comment