| Customize Help
| Save Settings

M3dgeoSphere


Function Map
Syntax
Description
Parameters
- Geometry3dgeoId
- CenterX
Table: For specifying the X-coordinate of the sphere's center
- CenterY
Table: For specifying the Y-coordinate of the sphere's center
- CenterZ
Table: For specifying the Z-coordinate of the sphere's center
- Radius
Table: For specifying the sphere's radius
- ControlFlag
Compilation information
Synopsis
Define a 3D sphere geometry object.
Syntax
void M3dgeoSphere(
MIL_ID Geometry3dgeoId, //in
MIL_DOUBLE CenterX, //in
MIL_DOUBLE CenterY, //in
MIL_DOUBLE CenterZ, //in
MIL_DOUBLE Radius, //in
MIL_INT64 ControlFlag //in
)
Description

This function defines a 3D sphere geometry object, using its center coordinates and radius. You can translate, scale, or transform the resulting sphere, using the 3D image processing module.

You can use the resulting sphere to, for example, crop a point cloud or perform an arithmetic operation on a depth map using the 3D image processing module, or calculate its distance from each point in a point cloud using the 3D metrology module.

If you want to define a sphere geometry object from results obtained in a different module, you can use the copy function of that module.

All coordinates are expressed in world units in the working coordinate system.

Note that if Geometry3dgeoId specifies a previously-defined sphere, you can leave some of its attributes unchanged, even if that attribute was modified using the 3D image processing module. To do so, set the corresponding parameter to M_UNCHANGED.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
Geometry3dgeoId

Specifies the identifier of the 3D geometry object, previously allocated on the required system using M3dgeoAlloc() with M_GEOMETRY.

CenterX INQ

Specifies the X-coordinate of the sphere's center.

function map For specifying the X-coordinate of the sphere's center
Click to summarizeValue Description
Click to summarize M_UNCHANGED

Specifies to use the previously-defined value.
Click to summarize Value

Specifies the X-coordinate of the sphere's center.
CenterY INQ

Specifies the Y-coordinate of the sphere's center.

function map For specifying the Y-coordinate of the sphere's center
Click to summarizeValue Description
Click to summarize M_UNCHANGED

Specifies to use the previously-defined value.
Click to summarize Value

Specifies the Y-coordinate of the sphere's center.
CenterZ INQ

Specifies the Z-coordinate of the sphere's center.

function map For specifying the Z-coordinate of the sphere's center
Click to summarizeValue Description
Click to summarize M_UNCHANGED

Specifies to use the previously-defined value.
Click to summarize Value

Specifies the Z-coordinate of the sphere's center.
Radius INQ

Specifies the sphere's radius. This parameter cannot be set to a negative value.

function map For specifying the sphere's radius
Click to summarizeValue Description
Click to summarize M_UNCHANGED

Specifies to use the previously-defined value.
Click to summarize Value > 0.0

Specifies the sphere's radius.
ControlFlag

Reserved for future expansion. This parameter must be set to M_DEFAULT.

Compilation information
Header Include mil.h.
Library Use mil.lib; mil3d.lib.
DLL Requires mil.dll; mil3d.dll.
UNCHANGED UNCHANGED UNCHANGED UNCHANGED SPHERE