Header menu logo Euclid

AutoOpenPPlane Module

When Euclid is opened this module will be auto-opened. It only contains extension members for type PPlane.

Type extensions

Type extension Description

this.Angle90ToLine

Full Usage: this.Angle90ToLine

Parameters:
Returns: float
Modifiers: inline

Returns the angle to a Line3D in Degree, ignoring the Zaxis's orientation. So 0.0 if the line is parallele to the Plane. And 90 degrees if the line is perpendicular to the plane.

Extended Type: PPlane

ln : Line3D
Returns: float

this.Angle90ToPlane

Full Usage: this.Angle90ToPlane

Parameters:
Returns: float
Modifiers: inline

Returns the angle to another Plane in Degree, ignoring the normal's orientation. So 0.0 if the planes are parallel. And 90 degrees if the planes are perpendicular to ech other.

Extended Type: PPlane

pl : PPlane
Returns: float

this.Angle90ToVec

Full Usage: this.Angle90ToVec

Parameters:
Returns: float
Modifiers: inline

Returns the angle to 3D vector in Degree, ignoring the plane's orientation. So 0.0 if the vector is parallele to the Plane. And 90 degrees if the vector is perpendicular to the plane.

Extended Type: PPlane

v : Vec
Returns: float

this.Angle90ToVec

Full Usage: this.Angle90ToVec

Parameters:
Returns: float
Modifiers: inline

Returns the angle to 3D unit-vector in Degree, ignoring the plane's orientation. So 0.0 if the vector is parallele to the Plane. And 90 degrees if the vector is perpendicular to the plane.

Extended Type: PPlane

v : UnitVec
Returns: float

this.ClosestPoint

Full Usage: this.ClosestPoint

Parameters:
Returns: Pnt
Modifiers: inline

Returns the closest point on the plane from a test point.

Extended Type: PPlane

pt : Pnt
Returns: Pnt

this.DistanceToPt

Full Usage: this.DistanceToPt

Parameters:
Returns: float
Modifiers: inline

Returns signed distance of point to plane, also indicating on which side it is.

Extended Type: PPlane

pt : Pnt
Returns: float

this.EvaluateAt

Full Usage: this.EvaluateAt

Parameters:
    px : float
    py : float
    pz : float

Returns: Pnt
Modifiers: inline

Evaluate at 3D parameter.

Extended Type: PPlane

px : float
py : float
pz : float
Returns: Pnt

this.EvaluateAtXY

Full Usage: this.EvaluateAtXY

Parameters:
    px : float
    py : float

Returns: Pnt
Modifiers: inline

Evaluate at 2D parameter (Z parameter = 0.0)

Extended Type: PPlane

px : float
py : float
Returns: Pnt

this.IsCoincidentTo

Full Usage: this.IsCoincidentTo

Parameters:
Returns: bool
Modifiers: inline

Checks if two PPlanes are coincident within the distance tolerance. 1e-6 by default. This means that their Z-axes are parallel within the angle tolerance and the distance of second origin to the first plane is less than the distance tolerance. The default angle tolerance is 0.25 degrees. This tolerance can be customized by an optional minium cosine value. See Euclid.Cosine module.

Extended Type: PPlane

other : PPlane
distanceTolerance : float
minCosine : float<MeasureProduct<cosine, MeasureOne>>
Returns: bool

this.PlaneAtClPt

Full Usage: this.PlaneAtClPt

Parameters:
Returns: PPlane
Modifiers: inline

First finds the closet point on plane from a test point. Then returns a new plane with Origin at this point and the same Axes vectors.

Extended Type: PPlane

pt : Pnt
Returns: PPlane

this.PointParameters

Full Usage: this.PointParameters

Parameters:
Returns: float * float * float
Modifiers: inline

Returns the X, Y and Z parameters of a point with regards to the plane.

Extended Type: PPlane

pt : Pnt
Returns: float * float * float

PPlane.WorldBack()

Full Usage: PPlane.WorldBack()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Back view. X-axis = minus World X-axis Y-axis = World Z-axis Z-axis = World Y-axis

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldBack

Full Usage: PPlane.WorldBack

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Back view. X-axis = minus World X-axis Y-axis = World Z-axis Z-axis = World Y-axis

Extended Type: PPlane

Returns: PPlane

PPlane.WorldBottom()

Full Usage: PPlane.WorldBottom()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Bottom view. X-axis = World X-axis Y-axis = minus World Y-axis Z-axis = minus World Z-axis

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldBottom

Full Usage: PPlane.WorldBottom

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Bottom view. X-axis = World X-axis Y-axis = minus World Y-axis Z-axis = minus World Z-axis

Extended Type: PPlane

Returns: PPlane

PPlane.WorldFront()

Full Usage: PPlane.WorldFront()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Front view. X-axis = World X-axis Y-axis = World Z-axis Z-axis = minus World Y-axis

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldFront

Full Usage: PPlane.WorldFront

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Front view. X-axis = World X-axis Y-axis = World Z-axis Z-axis = minus World Y-axis

Extended Type: PPlane

Returns: PPlane

PPlane.WorldLeft()

Full Usage: PPlane.WorldLeft()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Left view. X-axis = minus World Y-axis Y-axis = World Z-axis Z-axis = minus World X-axis

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldLeft

Full Usage: PPlane.WorldLeft

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Left view. X-axis = minus World Y-axis Y-axis = World Z-axis Z-axis = minus World X-axis

Extended Type: PPlane

Returns: PPlane

PPlane.WorldMinusXMinusY()

Full Usage: PPlane.WorldMinusXMinusY()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

WorldXY rotated 180 degrees round Z-axis.

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldMinusXMinusY

Full Usage: PPlane.WorldMinusXMinusY

Returns: PPlane
Modifiers: inline

WorldXY rotated 180 degrees round Z-axis.

Extended Type: PPlane

Returns: PPlane

PPlane.WorldMinusYX()

Full Usage: PPlane.WorldMinusYX()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

WorldXY rotated 270 degrees round Z-axis Counter-Clockwise from top.

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldMinusYX

Full Usage: PPlane.WorldMinusYX

Returns: PPlane
Modifiers: inline

WorldXY rotated 270 degrees round Z-axis Counter-Clockwise from top.

Extended Type: PPlane

Returns: PPlane

PPlane.WorldRight()

Full Usage: PPlane.WorldRight()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Right view. X-axis = World Y-axis Y-axis = World Z-axis Z-axis = World X-axis

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldRight

Full Usage: PPlane.WorldRight

Returns: PPlane
Modifiers: inline

Returns the Coordinate System Plane of a Right view. X-axis = World Y-axis Y-axis = World Z-axis Z-axis = World X-axis

Extended Type: PPlane

Returns: PPlane

PPlane.WorldTop()

Full Usage: PPlane.WorldTop()

Parameters:
    () : unit

Returns: PPlane

Returns the World Coordinate System Plane at World Origin. X-axis = World X-axis Y-axis = World Y-axis Z-axis = World Z-axis same as PPlane.WorldXY

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldTop

Full Usage: PPlane.WorldTop

Returns: PPlane

Returns the World Coordinate System Plane at World Origin. X-axis = World X-axis Y-axis = World Y-axis Z-axis = World Z-axis same as PPlane.WorldXY

Extended Type: PPlane

Returns: PPlane

PPlane.WorldXMinusY()

Full Usage: PPlane.WorldXMinusY()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

WorldXY rotated 180 degrees round X-axis, Z points down now.

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldXMinusY

Full Usage: PPlane.WorldXMinusY

Returns: PPlane
Modifiers: inline

WorldXY rotated 180 degrees round X-axis, Z points down now.

Extended Type: PPlane

Returns: PPlane

PPlane.WorldXY()

Full Usage: PPlane.WorldXY()

Parameters:
    () : unit

Returns: PPlane

Returns the World Coordinate System Plane at World Origin. X-axis = World X-axis Y-axis = World Y-axis Z-axis = World Z-axis same as PPlane.WorldTop

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldXY

Full Usage: PPlane.WorldXY

Returns: PPlane

Returns the World Coordinate System Plane at World Origin. X-axis = World X-axis Y-axis = World Y-axis Z-axis = World Z-axis same as PPlane.WorldTop

Extended Type: PPlane

Returns: PPlane

PPlane.WorldYMinusX()

Full Usage: PPlane.WorldYMinusX()

Parameters:
    () : unit

Returns: PPlane
Modifiers: inline

WorldXY rotated 90 degrees round Z-axis Counter-Clockwise from top.

Extended Type: PPlane

() : unit
Returns: PPlane

PPlane.WorldYMinusX

Full Usage: PPlane.WorldYMinusX

Returns: PPlane
Modifiers: inline

WorldXY rotated 90 degrees round Z-axis Counter-Clockwise from top.

Extended Type: PPlane

Returns: PPlane

PPlane.areCoincident tol a b

Full Usage: PPlane.areCoincident tol a b

Parameters:
Returns: bool
Modifiers: inline

Checks if two 3D Parametrized Planes are coincident within the distance tolerance.. This means that the Z-axes are parallel within 0.25 degrees and the distance of second origin to the first plane is less than the tolerance.

Extended Type: PPlane

tol : float
a : PPlane
b : PPlane
Returns: bool

PPlane.createOriginNormal (origin, normal)

Full Usage: PPlane.createOriginNormal (origin, normal)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and unit-vector representing the normal (or Z-axis). The X-axis will be found by taking the Cross Product of the World Z-axis and the given normal (or Z-axis). This will make the X-axis horizontal. If this fails because they are coincident, the Cross Product of the World Y-axis and the given normal (or Z-axis) will be used.

Extended Type: PPlane

origin : Pnt
normal : UnitVec
Returns: PPlane

PPlane.createOriginNormal (origin, normal)

Full Usage: PPlane.createOriginNormal (origin, normal)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and vector representing the normal (or Z-axis). The X-axis will be found by taking the Cross Product of the World Z-axis and the given normal (or Z-axis). This will make the X-axis horizontal. If this fails because they are coincident, the Cross Product of the World Y-axis and the given normal (or Z-axis) will be used. Fails if the vectors are shorter than 1e-6.

Extended Type: PPlane

origin : Pnt
normal : Vec
Returns: PPlane

PPlane.createOriginNormalXaxis (origin, normal, xAxis)

Full Usage: PPlane.createOriginNormalXaxis (origin, normal, xAxis)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and unit-vector representing the Z-axis. The given X vector does not need to be perpendicular to the normal vector, just not parallel. Fails if the vectors are shorter than 1e-6 or normal and xAxis are parallel within 1 degree.

Extended Type: PPlane

origin : Pnt
normal : UnitVec
xAxis : UnitVec
Returns: PPlane

PPlane.createOriginNormalXaxis (origin, normal, xAxis)

Full Usage: PPlane.createOriginNormalXaxis (origin, normal, xAxis)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and unit-vector representing the Z-axis. The given X vector does not need to be perpendicular to the normal vector, just not parallel. Fails if the vectors are shorter than 1e-6 or normal and X are parallel.

Extended Type: PPlane

origin : Pnt
normal : Vec
xAxis : Vec
Returns: PPlane

PPlane.createOriginXaxisYaxis (origin, xAxis, yAxis)

Full Usage: PPlane.createOriginXaxisYaxis (origin, xAxis, yAxis)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and a unit-vector representing the X-axis and a Y-axis hint. The resulting PPlane will have the X-Axis in direction of X vector. The X and Y vectors will define the plane and the side that Z will be on. The given Y vector does not need to be perpendicular to the X vector, just not parallel. Fails if the vectors are shorter than 1e-6.

Extended Type: PPlane

origin : Pnt
xAxis : UnitVec
yAxis : UnitVec
Returns: PPlane

PPlane.createOriginXaxisYaxis (origin, xAxis, yAxis)

Full Usage: PPlane.createOriginXaxisYaxis (origin, xAxis, yAxis)

Parameters:
Returns: PPlane

Creates a Parametrized Plane from a point and vector representing the X-axis and a Y-axis hint. The resulting PPlane will have the X-Axis in direction of X vector. The X and Y vectors will define the plane and the side that Z will be on. The given Y vector does not need to be perpendicular to the X vector, just not parallel. Fails if the vectors are shorter than 1e-6.

Extended Type: PPlane

origin : Pnt
xAxis : Vec
yAxis : Vec
Returns: PPlane

PPlane.createThreePoints origin xPt yPt

Full Usage: PPlane.createThreePoints origin xPt yPt

Parameters:
Returns: PPlane

Builds Plane at first point, X-axis to second point, Y-axis to third point or at lest in plane with third point. Fails if points are closer than 1e-6.

Extended Type: PPlane

origin : Pnt
xPt : Pnt
yPt : Pnt
Returns: PPlane

PPlane.doLinePlaneIntersect ln pl

Full Usage: PPlane.doLinePlaneIntersect ln pl

Parameters:
Returns: bool
Modifiers: inline

Checks if a finite Line3D intersects with Plane in one point. Returns false for NaN values or (almost) parallel or coincident lines.

Extended Type: PPlane

ln : Line3D
pl : PPlane
Returns: bool

PPlane.equals tol a b

Full Usage: PPlane.equals tol a b

Parameters:
Returns: bool
Modifiers: inline

Checks if two Parametrized Planes are equal within tolerance distance For the tips of its units vectors and its origin. Use a tolerance of 0.0 to check for an exact match.

Extended Type: PPlane

tol : float
a : PPlane
b : PPlane
Returns: bool

PPlane.flipOnX pl

Full Usage: PPlane.flipOnX pl

Parameters:
Returns: PPlane
Modifiers: inline

Rotate the Plane 180 degrees on its X-axis. Called flip because Z-axis points in the opposite direction.

Extended Type: PPlane

pl : PPlane
Returns: PPlane

PPlane.flipOnY pl

Full Usage: PPlane.flipOnY pl

Parameters:
Returns: PPlane
Modifiers: inline

Rotate the Plane 180 degrees on its Y-axis. Called flip because Z-axis points in the opposite direction.

Extended Type: PPlane

pl : PPlane
Returns: PPlane

PPlane.intersect a b

Full Usage: PPlane.intersect a b

Parameters:
Returns: Line3D option

Returns the line of intersection between two planes. Returns None if they are parallel or coincident.

Extended Type: PPlane

a : PPlane
b : PPlane
Returns: Line3D option

PPlane.intersectLine ln pl

Full Usage: PPlane.intersectLine ln pl

Parameters:
Returns: Pnt option

Returns intersection point of infinite Line3D with Plane. Returns None if they are parallel.

Extended Type: PPlane

ln : Line3D
pl : PPlane
Returns: Pnt option

PPlane.intersectLineParameter ln pl

Full Usage: PPlane.intersectLineParameter ln pl

Parameters:
Returns: float option

Returns the parameter on the line. The parameter is the intersection point of the infinite Line3D with the PPlane. Returns None if they are parallel or coincident.

Extended Type: PPlane

ln : Line3D
pl : PPlane
Returns: float option

PPlane.intersectLineParameters ln pl

Full Usage: PPlane.intersectLineParameters ln pl

Parameters:
Returns: (float * float * float) option

Returns the line parameter and the X and Y parameters on the Plane. as tuple (pLn, pPlX, pPlY). The parameters is the intersection point of the infinite Line3D with the PPlane. Returns None if they are parallel or coincident.

Extended Type: PPlane

ln : Line3D
pl : PPlane
Returns: (float * float * float) option

PPlane.offset d pl

Full Usage: PPlane.offset d pl

Parameters:
Returns: PPlane
Modifiers: inline

Move Plane along the local Z-axis by the given distance. Same as PPlane.translateZ.

Extended Type: PPlane

d : float
pl : PPlane
Returns: PPlane

PPlane.rotateOnZ180 pl

Full Usage: PPlane.rotateOnZ180 pl

Parameters:
Returns: PPlane
Modifiers: inline

Rotate the Plane 180 degrees on its Z-axis.

Extended Type: PPlane

pl : PPlane
Returns: PPlane

PPlane.rotateZ angDegree pl

Full Usage: PPlane.rotateZ angDegree pl

Parameters:
    angDegree : float
    pl : PPlane

Returns: PPlane
Modifiers: inline

Rotate about Z-axis of the Plane by angle in degree. Counter-Clockwise in top view (for WorldXY Plane).

Extended Type: PPlane

angDegree : float
pl : PPlane
Returns: PPlane

PPlane.rotateZ180IfYNegative pl

Full Usage: PPlane.rotateZ180IfYNegative pl

Parameters:
Returns: PPlane
Modifiers: inline

Rotate Plane 180 Degrees around Z-axis if the Y-axis orientation does not match World Y (pl.Yax.Y < 0.0) To ensure that Y is always positive. For example for showing Text.

Extended Type: PPlane

pl : PPlane
Returns: PPlane

PPlane.setOrigin pt pl

Full Usage: PPlane.setOrigin pt pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with given Origin.

Extended Type: PPlane

pt : Pnt
pl : PPlane
Returns: PPlane

PPlane.setOriginX x pl

Full Usage: PPlane.setOriginX x pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with given Origin X value changed.

Extended Type: PPlane

x : float
pl : PPlane
Returns: PPlane

PPlane.setOriginY y pl

Full Usage: PPlane.setOriginY y pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with given Origin Y value changed.

Extended Type: PPlane

y : float
pl : PPlane
Returns: PPlane

PPlane.setOriginZ z pl

Full Usage: PPlane.setOriginZ z pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with given Origin Z value changed.

Extended Type: PPlane

z : float
pl : PPlane
Returns: PPlane

PPlane.transform m pl

Full Usage: PPlane.transform m pl

Parameters:
Returns: PPlane

Transforms the plane by the given RigidMatrix. The returned PPlane has orthogonal unit-vectors.

Extended Type: PPlane

m : RigidMatrix
pl : PPlane
Returns: PPlane

PPlane.translateBy v pl

Full Usage: PPlane.translateBy v pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with Origin translated by Vec.

Extended Type: PPlane

v : Vec
pl : PPlane
Returns: PPlane

PPlane.translateByWorldX x pl

Full Usage: PPlane.translateByWorldX x pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with Origin translated in World X direction.

Extended Type: PPlane

x : float
pl : PPlane
Returns: PPlane

PPlane.translateByWorldY y pl

Full Usage: PPlane.translateByWorldY y pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with Origin translated in World Y direction.

Extended Type: PPlane

y : float
pl : PPlane
Returns: PPlane

PPlane.translateByWorldZ z pl

Full Usage: PPlane.translateByWorldZ z pl

Parameters:
Returns: PPlane
Modifiers: inline

Returns a new plane with Origin translated in World Z direction.

Extended Type: PPlane

z : float
pl : PPlane
Returns: PPlane

PPlane.translateX d pl

Full Usage: PPlane.translateX d pl

Parameters:
Returns: PPlane
Modifiers: inline

Move Plane along the local X-axis by the given distance.

Extended Type: PPlane

d : float
pl : PPlane
Returns: PPlane

PPlane.translateY d pl

Full Usage: PPlane.translateY d pl

Parameters:
Returns: PPlane
Modifiers: inline

Move Plane along the local Y-axis by the given distance.

Extended Type: PPlane

d : float
pl : PPlane
Returns: PPlane

PPlane.translateZ d pl

Full Usage: PPlane.translateZ d pl

Parameters:
Returns: PPlane
Modifiers: inline

Move Plane along the local Z-axis by the given distance. Same as PPlane.offset.

Extended Type: PPlane

d : float
pl : PPlane
Returns: PPlane

Type something to start searching.