Name
convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCart — Convert spherical coordinates of a 3D point to Cartesian
coordinates.
Herror convert_point_3d_spher_to_cart(double Longitude, double Latitude, double Radius, const char* EquatPlaneNormal, const char* ZeroMeridian, double* X, double* Y, double* Z)
Herror T_convert_point_3d_spher_to_cart(const Htuple Longitude, const Htuple Latitude, const Htuple Radius, const Htuple EquatPlaneNormal, const Htuple ZeroMeridian, Htuple* X, Htuple* Y, Htuple* Z)
Herror convert_point_3d_spher_to_cart(const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HTuple& EquatPlaneNormal, const HTuple& ZeroMeridian, double* X, double* Y, double* Z)
Herror convert_point_3d_spher_to_cart(const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HTuple& EquatPlaneNormal, const HTuple& ZeroMeridian, HTuple* X, HTuple* Y, HTuple* Z)
void ConvertPoint3dSpherToCart(const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HTuple& EquatPlaneNormal, const HTuple& ZeroMeridian, HTuple* X, HTuple* Y, HTuple* Z)
static void HMisc::ConvertPoint3dSpherToCart(const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HString& EquatPlaneNormal, const HString& ZeroMeridian, HTuple* X, HTuple* Y, HTuple* Z)
static void HMisc::ConvertPoint3dSpherToCart(double Longitude, double Latitude, double Radius, const HString& EquatPlaneNormal, const HString& ZeroMeridian, double* X, double* Y, double* Z)
static void HMisc::ConvertPoint3dSpherToCart(double Longitude, double Latitude, double Radius, const char* EquatPlaneNormal, const char* ZeroMeridian, double* X, double* Y, double* Z)
void HOperatorSetX.ConvertPoint3dSpherToCart(
[in] VARIANT Longitude, [in] VARIANT Latitude, [in] VARIANT Radius, [in] VARIANT EquatPlaneNormal, [in] VARIANT ZeroMeridian, [out] VARIANT* X, [out] VARIANT* Y, [out] VARIANT* Z)
VARIANT HMiscX.ConvertPoint3dSpherToCart(
[in] VARIANT Longitude, [in] VARIANT Latitude, [in] VARIANT Radius, [in] BSTR EquatPlaneNormal, [in] BSTR ZeroMeridian, [out] VARIANT* Y, [out] VARIANT* Z)
static void HOperatorSet.ConvertPoint3dSpherToCart(HTuple longitude, HTuple latitude, HTuple radius, HTuple equatPlaneNormal, HTuple zeroMeridian, out HTuple x, out HTuple y, out HTuple z)
static void HMisc.ConvertPoint3dSpherToCart(HTuple longitude, HTuple latitude, HTuple radius, string equatPlaneNormal, string zeroMeridian, out HTuple x, out HTuple y, out HTuple z)
static void HMisc.ConvertPoint3dSpherToCart(double longitude, double latitude, double radius, string equatPlaneNormal, string zeroMeridian, out double x, out double y, out double z)
The operator convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCart converts the
spherical coordinates of a 3D point, which are given in
LongitudeLongitudeLongitudeLongitudeLongitudelongitude, LatitudeLatitudeLatitudeLatitudeLatitudelatitude, and RadiusRadiusRadiusRadiusRadiusradius, into the
Cartesian coordinates XXXXXx, YYYYYy, and ZZZZZz. The
spherical coordinates LongitudeLongitudeLongitudeLongitudeLongitudelongitude and LatitudeLatitudeLatitudeLatitudeLatitudelatitude must
be specified in radians. Furthermore, the LatitudeLatitudeLatitudeLatitudeLatitudelatitude must be
within the range [-PI/2,+PI/2], where the
latitude of the north pole is PI/2, and hence, the
latitude of the south pole is -PI/2.
The orientation of the spherical coordinate system with respect to
the Cartesian coordinate system can be specified with the parameters
EquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalequatPlaneNormal and ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian.
EquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalequatPlaneNormal determines the normal of the equatorial
plane (longitude == 0) pointing to the north pole (positive
latitude) and may take the following values:
- 'x'"x""x""x""x""x":
-
The equatorial plane is the yz plane. The
positive x axis points to the north pole.
- '-x'"-x""-x""-x""-x""-x":
-
The equatorial plane is the yz plane. The
positive x axis points to the south pole.
- 'y'"y""y""y""y""y":
-
The equatorial plane is the xz plane. The
positive y axis points to the north pole.
- '-y'"-y""-y""-y""-y""-y":
-
The equatorial plane is the xz plane. The
positive y axis points to the south pole.
- 'z'"z""z""z""z""z":
-
The equatorial plane is the xy plane. The
positive z axis points to the north pole.
- '-z'"-z""-z""-z""-z""-z":
-
The equatorial plane is the xy plane. The
positive z axis points to the south pole.
The position of the zero meridian can be specified with the
parameter ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian. For this, the coordinate axis
(lying in the equatorial plane) that points to the zero meridian
must be passed. The following values for ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian are
valid:
- 'x'"x""x""x""x""x":
-
The positive x axis points in the direction of the zero
meridian.
- '-x'"-x""-x""-x""-x""-x":
-
The negative x axis points in the direction of the zero
meridian.
- 'y'"y""y""y""y""y":
-
The positive y axis points in the direction of the zero
meridian.
- '-y'"-y""-y""-y""-y""-y":
-
The negative y axis points in the direction of the zero
meridian.
- 'z'"z""z""z""z""z":
-
The positive z axis points in the direction of the zero
meridian.
- '-z'"-z""-z""-z""-z""-z":
-
The negative z axis points in the direction of the zero
meridian.
Only reasonable combinations of EquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalequatPlaneNormal and
ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian are permitted, i.e., the normal of the
equatorial plane must not be parallel to the direction of the zero
meridian. For example, the combination
EquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalequatPlaneNormal='y'"y""y""y""y""y" and
ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian='-y'"-y""-y""-y""-y""-y" is not permitted.
Note that in order to guarantee a consistent conversion back from
Cartesian to spherical coordinates by using
convert_point_3d_cart_to_spherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherConvertPoint3dCartToSpher, the same values must be
passed for EquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalEquatPlaneNormalequatPlaneNormal and ZeroMeridianZeroMeridianZeroMeridianZeroMeridianZeroMeridianzeroMeridian as
were passed to convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCart.
The operator convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCart can be used,
for example, to convert a camera position that is given in spherical
coordinates into Cartesian coordinates. The result can then be
utilized to create a complete camera pose by passing the
Cartesian coordinates to create_cam_pose_look_at_pointcreate_cam_pose_look_at_pointCreateCamPoseLookAtPointcreate_cam_pose_look_at_pointCreateCamPoseLookAtPointCreateCamPoseLookAtPoint.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Longitude of the 3D point.
Latitude of the 3D point.
Restriction: - pi / 2 <= Latitude && Latitude <= pi / 2
Normal vector of the equatorial plane (points to the
north pole).
Default value:
'-y'
"-y"
"-y"
"-y"
"-y"
"-y"
List of values: '-x'"-x""-x""-x""-x""-x", '-y'"-y""-y""-y""-y""-y", '-z'"-z""-z""-z""-z""-z", 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'z'"z""z""z""z""z"
Coordinate axis in the equatorial plane that points
to the zero meridian.
Default value:
'-z'
"-z"
"-z"
"-z"
"-z"
"-z"
List of values: '-x'"-x""-x""-x""-x""-x", '-y'"-y""-y""-y""-y""-y", '-z'"-z""-z""-z""-z""-z", 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'z'"z""z""z""z""z"
XXXXXx (output_control) real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)
X coordinate of the 3D point.
YYYYYy (output_control) real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)
Y coordinate of the 3D point.
ZZZZZz (output_control) real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)
Z coordinate of the 3D point.
If the parameters are valid, the operator
convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCart returns the value 2 (H_MSG_TRUE). If
necessary an exception is raised.
get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParams
convert_point_3d_cart_to_spherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherConvertPoint3dCartToSpher
3D Metrology