Up | ObjectPosition3D - 105 | CreatePointCloud3D - 109 | ReferenceOnPlane3D - 143 | SphereFit3D - 141 | ModifyReference - 131 | ReferenceDiff3D - 126 | MapTo3D - 125 | ExtractMap3D - 122 | PlaneFit3D - 121 | CylinderFit3D - 112 | ChangeReference3D - 96 | Locate3D - 97 | MoveReference3D - 107 | ExternalReference3D - 95 | Calibrator3D - 155 | LineFromPoints3D - 98 | ReferenceFromPoints3D - 99 | Angle3D - 100 | NearestPointOnLine3D - 101 | ExternalPoint3D - 103 | ExternalLine3D - 104 | Point2Dfrom3D - 106 | GlobalPosition3D - 108 | Point3Dfrom2D - 115 | PointFromLines3D - 116 | ReferenceFromLines3D - 117 | LaserProfiler3D - 166 | NearestPointOnPlane3D - 118 | ChangePointReference3D - 119 | ChangeLineReference3D - 120 | PointOnLine3D - 130 | MoveLine3D - 138 | MovePoint3D - 137 | PlanePlaneIntersect3D - 139 | PlaneLineIntersect3D - 142 | Combine3D- 161

 

  

 
ReferenceOnPlane3D - 143

This tool establishes a 3D reference with its X and Y axes on a given plane. The Z axis will then be perpendicular to the plane. The origin and X/Y direction of the resulting reference system can be set in a number of different ways, ax explained below.


Setup

3D coordinate system

  • Reference - a 3D reference tool

Plane to project onto

  • Tool - tool delivering a plane
  • Result - tool result to use
    • Note - most 3D tools will deliver an XYplane result - this can be convenient to project onto.

Item to project onto plane

A tool reference, a line or a line defined by two points can be projected onto the given plane. The projection can be done using one of several options:

Tool reference - project a reference system onto the plane

  • Tool - a tool with a reference system
  • Child refsys origin - where to place the resulting origin
    • Origin nearest point on plane - at the refsys origin's nearest point on the plane
    • X axis/plane intersection - where the refsys' X axis intersects the plane
    • Y axis/plane intersection - where the refsys' Y axis intersects the plane
    • Z axis/plane intersection - where the refsys' Z axis intersects the plane
  • Child refsys direction - direction of the resulting refsys' X axis
    • Projection of X axis - along the projection of the refsys' X axis
    • Projection of Y axis - along the projection of the refsys' Y axis
    • Projection of Z axis - along the projection of the refsys' Z axis

Line - project a line onto the plane

  • Line tool - a tool with a line result
  • Line result - tool result to use
  • Child refsys origin - where to place the resulting origin
    • Line start nearest point on plane - at the line start's nearest point on the plane
    • Line end nearest point on plane - at the line end's nearest point on the plane
    • Line/plane intersection - where the line intersects the plane

    Note - the refsys' direction will be with the X axis along the line projection

Points - project to points onto the plane

  • Point 1 tool - a tool with a point result
  • Point 1 result - tool result to use
  • Point 2 tool - a tool with a point result
  • Point 2 result - tool result to use
  • Child refsys origin - where to place the resulting origin
    • Point 1 nearest point on plane - at point 1's nearest point on the plane
    • Point 2 nearest point on plane - at point 2's nearest point on the plane

Note - the refsys' direction will be with the X axis along the projection of the line from point 1 to point 2

Visualisation
   


Results

   


ExecuteCmd support
(see also executeCmd)

Command

Parameters

Return values

Comments

       

 

 
 

Scorpion Vision Version XII : Build 646 - Date: 20170225
Scorpion Vision Software® is a registered trademark of Tordivel AS.
Copyright © 2000 - 2017 Tordivel AS.