| SbProj4Projection Class |
Cartographic (PROJ4) projection class.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ProjectionSbProjection
OIV.Inventor.ProjectionSbProj4Projection
Namespace: OIV.Inventor.Projection
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2023.1.3.0 (2023.1.3)
SyntaxThe SbProj4Projection type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SbProj4Projection | Constructor. |
| SbProj4Projection(SoProjection) | Constructor. |
Methods| Name | Description | |
|---|---|---|
| Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
| Exit | Exit method. |
| GetCoordinateSystem | Get current coordinate system. |
| GetEllipsoid | Get current ellipsoid. |
| GetEllipsoidIn | Get current input ellipsoid. |
 | GetEllipsoidString | Get PROJ.4 ellipsoid string. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetNumFloatParameters | Get number of used float parameters. |
| GetNumStringParameters | Get number of used string parameters. |
| GetParameter(Int32, Single) | Get float parameter at position pos. |
| GetParameter(Int32, String) | Get string parameter at position pos. |
| GetProjectedBoundingBox | Return projected bounding box if available. |
| GetProjection | Get current projection . |
| GetProjectionIn | Get current input projection . |
| GetProjectionName | Get projection name description. |
| GetProjectionNode | Return associated projection node. |
| GetProjectionString | Get internal PROJ.4 projection string. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetUTMZone | Get current UTM zone. |
| Init | Initialisation method. |
| Inverse | Apply the inverse coordinate to one point. |
| IsRevertCoordNeeded | Get revertCoordNeeded. |
| IsUTMSouth | Get m_south (UTM) |
| Project(SbVec3f) | Apply the complete computation (matrix, pre-projection, projection, post-projection) to one point. |
| Project(SbVec3f, SbVec3f) | Apply the complete computation to a set of coordinates. |
| SetCoordinateSystem | Set current coordinate system. |
| SetEllipsoid | Set current ellipsoid. |
| SetEllipsoidIn | Set current input ellipsoid. |
| SetNumFloatParameters | Set number of float parameters to use. |
| SetNumStringParameters | Set number of string parameters to use. |
| SetParameter(Int32, Single) | Set float parameter. |
| SetParameter(Int32, String) | Set string parameter. |
| SetProjection | Set current projection. |
| SetProjectionIn | Set current input projection. |
| SetRevertCoord | Set revertCoordNeeded. |
| SetUTMSouth | Set m_south (UTM) |
| SetUTMZone | Set current UTM zone. |
| ToGeocentric | Transform the given coordinates from Geodetic coordinate system to Geocentric coordinate system . |
| ToGeodetic | Transform the given coordinates from Geocentric coordinate system to Geodetic coordinate system . |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
RemarksThis class performs a cartographic projection using the PROJ.4 Cartographic Projections Library ( see http://proj.maptools.org/ )
To use this class as a projection, refer to the documentation of OIV.Inventor.Projection.SbProjection class.
By default, input points must be defined in the geodetic coordinate system :
x coordinate : longitudes degrees from -180 to 180
y coordinate : latitudes degrees from -90 to 90
z coordinate : meters
It is possible to define the input data in the geocentric coordinate system by calling setCoordinateSystem(GEOCENTRIC). The geocentric coordinate system is the earth coordinate system, where x, y and z coordinate are expressed in meters.
The PROJ.4 library parameters are stored as OIV.Inventor.Projection.SbProjection string parameters:
parameter 0 : projection name
parameter 1 : ellipsoid
parameter 2 : units
parameter 3 : longitude zero
The first OIV.Inventor.Projection.SbProjection float parameter is used to specify the z coordinate scaleRatio applied to the projected shapes.
The enumeration PredefinedEllipsoid defines the list of available ellipsoid. An ellispoid definition is a mathematical representation used to approximate the earth when computing projections. Calling OIV.Inventor.Projection.SbProj4Projection.SetEllipsoid(OIV.Inventor.Projection.SbProj4Projection.PredefinedEllipsoids) sets the current ellipsoid used to compute projections.
Only projections with an inverse function defined are available.
The available projections are defined with the Projection enumeration. When using an OIV.Inventor.Projection.SbProj4Projection object with an OIV.Inventor.Nodes.SoProjection node, those projections are automatically added in the order above, and you can choose the desired projection by using the corresponding id (refer to OIV.Inventor.Nodes.SoProjection node).
LIMITATIONS
It can happen that vertices of a projected shape cross other ones, depending on the chosen projection. Visually it results in a flipping effect.
OIV.Inventor.Projection.SbProjection, OIV.Inventor.Nodes.SoProjection, OIV.Inventor.Nodes.SoGeoProjectionSee Also