MIL_ID Geometry3dgeoId, | //in |
MIL_INT64 CreationMode, | //in |
MIL_DOUBLE XPos1, | //in |
MIL_DOUBLE YPos1, | //in |
MIL_DOUBLE ZPos1, | //in |
MIL_DOUBLE XPos2OrVector, | //in |
MIL_DOUBLE YPos2OrVector, | //in |
MIL_DOUBLE ZPos2OrVector, | //in |
MIL_DOUBLE Length, | //in |
MIL_INT64 ControlFlag | //in |
This function defines an arbitrary 3D line geometry object. You can translate, rotate, scale, or transform the resulting line, using the 3D image processing module.
You can use the resulting line to, for example, 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 line 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 line, you can leave some of its attributes unchanged, even if that attribute was set using a different creation mode or was modified using the 3D image processing module. To do so, set the corresponding parameter to M_UNCHANGED.
Specifies the identifier of the 3D geometry object, previously allocated on the required system using M3dgeoAlloc() with M_GEOMETRY.
Specifies how the line is defined.
See the Parameter associations section for possible values that can be specified.
Specifies the X-coordinate of the first point used to define the line.
See the Parameter associations section for possible values that can be specified.
Specifies the Y-coordinate of the first point used to define the line.
See the Parameter associations section for possible values that can be specified.
Specifies the Z-coordinate of the first point used to define the line.
See the Parameter associations section for possible values that can be specified.
Specifies the X-coordinate of the second point used to define the line, or the X-component of the vector defining the line's direction and length (if Length is M_DEFAULT).
See the Parameter associations section for possible values that can be specified.
Specifies the Y-coordinate of the second point used to define the line, or the Y-component of the vector defining the line's direction and length (if Length is M_DEFAULT).
See the Parameter associations section for possible values that can be specified.
Specifies the Z-coordinate of the second point used to define the line, or the Z-component of the vector defining the line's direction and length (if Length is M_DEFAULT).
See the Parameter associations section for possible values that can be specified.
Specifies to override the default line length.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default length defined by the creation mode. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies an infinite line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to override the line's length with a specific value. |
The table below lists possible values for the CreationMode, XPos1, YPos1, ZPos1, XPos2OrVector, YPos2OrVector, and ZPos2OrVector parameters.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
XPos1 | |||||||||||||||||||||||||||||||||||||||
YPos1 | |||||||||||||||||||||||||||||||||||||||
ZPos1 | |||||||||||||||||||||||||||||||||||||||
XPos2OrVector | |||||||||||||||||||||||||||||||||||||||
YPos2OrVector | |||||||||||||||||||||||||||||||||||||||
ZPos2OrVector | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Defines the line using a point on the line and a nonzero vector defining the line's direction. By default, the length of the line is finite and is set to the vector's magnitude. The point is at the start of the line. You can determine the coordinates of the line's end point by adding the given vector's X-, Y-, and Z-components to the first point's respective coordinates. You can also use M3dgeoInquire() with M_END_POINT_.... Note that if you set one of the vector's components to M_UNCHANGED, you must also set the other two components to M_UNCHANGED. (summarize)Defines the line using a point on the line and a nonzero vector defining the line's direction. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the point on the line. (summarize)Specifies the X-coordinate of the point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the point on the line. (summarize)Specifies the Y-coordinate of the point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-coordinate of the point on the line. (summarize)Specifies the Z-coordinate of the point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-component of the vector defining the line's direction. (summarize)Specifies the X-component of the vector defining the line's direction. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-component of the vector defining the line's direction. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-component of the vector defining the line's direction. (summarize)Specifies the Y-component of the vector defining the line's direction. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-component of the vector defining the line's direction. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-component of the vector defining the line's direction. (summarize)Specifies the Z-component of the vector defining the line's direction. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-component of the vector defining the line's direction. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Defines the line using any two non-identical points. By default, the length of the line is finite and is set to the distance between the two specified points. The line starts at the first point, and ends at the second point. (summarize)Defines the line using any two non-identical points. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the first point on the line. (summarize)Specifies the X-coordinate of the first point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the first point on the line. (summarize)Specifies the Y-coordinate of the first point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-coordinate of the first point on the line. (summarize)Specifies the Z-coordinate of the first point on the line. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the previously-defined value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-coordinate of the first point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the second point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the second point on the line. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Z-coordinate of the second point on the line. |
Header | Include mil.h. |
Library | Use mil.lib; mil3d.lib. |
DLL | Requires mil.dll; mil3d.dll. |