| Modifier and Type | Field and Description |
|---|---|
| private static final double | DEFAULT_TOLERANCE
Default value for tolerance. |
| private Vector3D | origin
Origin of the plane frame. |
| private double | originOffset
Offset of the origin with respect to the plane. |
| private final double | tolerance
Tolerance below which points are considered identical. |
| private Vector3D | u
First vector of the plane frame (in plane). |
| private Vector3D | v
Second vector of the plane frame (in plane). |
| private Vector3D | w
Third vector of the plane frame (plane normal). |
| Access | Constructor and Description |
|---|---|
| public | |
| public | |
| public | |
| public | Plane(final Vector3D
normal direction to the plane normal)
Deprecated
as of 3.3, replaced with
Plane(Vector3D, double)
Build a plane normal to a given direction and containing the origin. |
| public | Plane(final Vector3D
point belonging to the plane p, final Vector3D normal direction to the plane normal)
Deprecated
as of 3.3, replaced with
Plane(Vector3D, Vector3D, double)
Build a plane from a point and a normal. |
| public | Plane(final Vector3D
first point belonging to the plane p1, final Vector3D second point belonging to the plane p2, final Vector3D third point belonging to the plane p3)
Deprecated
as of 3.3, replaced with
Plane(Vector3D, Vector3D, Vector3D, double)
Build a plane from three points. |
| public |
| Modifier and Type | Method and Description |
|---|---|
| public boolean | |
| public Plane | Returns: a new hyperplane, copy of the instanceImplements org. Copy the instance. |
| public Vector3D | |
| public double | |
| public double | Returns: offset of the vectorvector to check vector)Get the offset (oriented distance) of a vector. |
| public double | Returns: offset of the pointpoint to check point)Implements org. Get the offset (oriented distance) of a point. |
| public Vector3D | Returns: the origin point of the plane frame (point closest to the 3D-space origin)Get the origin point of the plane frame. |
| public Vector3D | Returns: one point in the 3D-space, with given coordinates and offset relative to the planedesired in-plane coordinates for the point in the
plane inPlane, final double desired offset for the point offset)Get one point from the 3D-space. |
| public double | getTolerance()
Implements org. Get the tolerance below which points are considered to belong to the hyperplane. |
| public Vector3D | |
| public Vector3D | |
| public Vector3D | Returns: intersection point between between the line and the instance (null if the line is parallel to the instance)line intersecting the instance line)Get the intersection of a line with the instance. |
| public Line | Returns: line at the intersection of the instance and the other plane (really aLine instance)other plane other)Build the line shared by the instance and another plane. |
| public static Vector3D | Returns: intersection point of three planes, null if some planes are parallelfirst plane1 plane1, final Plane second plane2 plane2, final Plane third plane2 plane3)Get the intersection point of three planes. |
| public boolean | Returns: true if the planes are similarplane to which the instance is compared plane)Check if the instance is similar to another plane. |
| public Point | project(Point<Euclidean3D>
point to project point)Implements org. Project a point to the hyperplane. |
| public void | |
| public void | |
| public void | |
| public Plane | |
| public boolean | Returns: true if the instance and the other hyperplane have the same orientationother hyperplane to check against the instance other)Implements org. Check if the instance has the same orientation as another hyperplane. |
| private void | |
| private void | |
| public Vector3D | Returns: n-dimension point of the space corresponding to the specified sub-space point(n-1)-dimension point of the sub-space vector)Transform a sub-space point into a space point. |
| public Vector3D | Returns: 3D space point (really aVector3D instance)in-plane point (must be a point)Vector2D instance)Implements org. Transform an in-plane point into a 3D space point. |
| public Vector2D | Returns: (n-1)-dimension point of the sub-space corresponding to the specified space pointn-dimension point of the space vector)Transform a space point into a sub-space point. |
| public Vector2D | Returns: in-plane point (really aVector2D instance)point of the space (must be a point)Vector3D instance)Implements org. Transform a 3D space point into an in-plane point. |
| public Plane | |
| public SubPlane | Returns: a region covering the whole hyperplaneImplements org. Build a region covering the whole hyperplane. |
| public PolyhedronsSet | Returns: a region containing the instance (really aPolyhedronsSet instance)Implements org. Build a region covering the whole space. |
| DEFAULT_TOLERANCE | back to summary |
|---|---|
| private static final double DEFAULT_TOLERANCE Default value for tolerance. | |
| origin | back to summary |
|---|---|
| private Vector3D origin Origin of the plane frame. | |
| originOffset | back to summary |
|---|---|
| private double originOffset Offset of the origin with respect to the plane. | |
| tolerance | back to summary |
|---|---|
| private final double tolerance Tolerance below which points are considered identical. | |
| u | back to summary |
|---|---|
| private Vector3D u First vector of the plane frame (in plane). | |
| v | back to summary |
|---|---|
| private Vector3D v Second vector of the plane frame (in plane). | |
| w | back to summary |
|---|---|
| private Vector3D w Third vector of the plane frame (plane normal). | |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D normal, final double tolerance) throws MathArithmeticException Build a plane normal to a given direction and containing the origin.
| |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D p, final Vector3D normal, final double tolerance) throws MathArithmeticException Build a plane from a point and a normal.
| |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D p1, final Vector3D p2, final Vector3D p3, final double tolerance) throws MathArithmeticException Build a plane from three points. The plane is oriented in the direction of
| |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D normal) throws MathArithmeticException
Deprecated as of 3.3, replaced with Build a plane normal to a given direction and containing the origin.
| |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D p, final Vector3D normal) throws MathArithmeticException
Deprecated as of 3.3, replaced with Build a plane from a point and a normal.
| |
| Plane | back to summary |
|---|---|
| public Plane(final Vector3D p1, final Vector3D p2, final Vector3D p3) throws MathArithmeticException
Deprecated as of 3.3, replaced with Build a plane from three points. The plane is oriented in the direction of
| |
| Plane | back to summary |
|---|---|
| public Plane(final Plane plane) Copy constructor. The instance created is completely independant of the original one. A deep copy is used, none of the underlying object are shared.
| |
| contains | back to summary |
|---|---|
| public boolean contains(final Vector3D p) Check if the instance contains a point.
| |
| copySelf | back to summary |
|---|---|
| public Plane copySelf() Implements org. Copy the instance. The instance created is completely independant of the original one. A deep copy is used, none of the underlying objects are shared (except for immutable objects).
| |
| getNormal | back to summary |
|---|---|
| public Vector3D getNormal() Get the normalized normal vector. The frame defined by ( | |
| getOffset | back to summary |
|---|---|
| public double getOffset(final Plane plane) Get the offset (oriented distance) of a parallel plane. This method should be called only for parallel planes otherwise the result is not meaningful. The offset is 0 if both planes are the same, it is positive if the plane is on the plus side of the instance and negative if it is on the minus side, according to its natural orientation.
| |
| getOffset | back to summary |
|---|---|
| public double getOffset(Vector<Euclidean3D> vector) Get the offset (oriented distance) of a vector.
| |
| getOffset | back to summary |
|---|---|
| public double getOffset(final Point<Euclidean3D> point) Implements org. Get the offset (oriented distance) of a point. The offset is 0 if the point is on the underlying hyperplane, it is positive if the point is on one particular side of the hyperplane, and it is negative if the point is on the other side, according to the hyperplane natural orientation.
| |
| getOrigin | back to summary |
|---|---|
| public Vector3D getOrigin() Get the origin point of the plane frame. The point returned is the orthogonal projection of the 3D-space origin in the plane.
| |
| getPointAt | back to summary |
|---|---|
| public Vector3D getPointAt(final Vector2D inPlane, final double offset) Get one point from the 3D-space. | |
| getTolerance | back to summary |
|---|---|
| public double getTolerance() Implements org. Doc from org. Get the tolerance below which points are considered to belong to the hyperplane.
| |
| getU | back to summary |
|---|---|
| public Vector3D getU() Get the plane first canonical vector. The frame defined by ( | |
| getV | back to summary |
|---|---|
| public Vector3D getV() Get the plane second canonical vector. The frame defined by ( | |
| intersection | back to summary |
|---|---|
| public Vector3D intersection(final Line line) Get the intersection of a line with the instance. | |
| intersection | back to summary |
|---|---|
| public Line intersection(final Plane other) Build the line shared by the instance and another plane. | |
| intersection | back to summary |
|---|---|
| public static Vector3D intersection(final Plane plane1, final Plane plane2, final Plane plane3) Get the intersection point of three planes. | |
| isSimilarTo | back to summary |
|---|---|
| public boolean isSimilarTo(final Plane plane) Check if the instance is similar to another plane. Planes are considered similar if they contain the same points. This does not mean they are equal since they can have opposite normals.
| |
| project | back to summary |
|---|---|
| public Point Implements org. Doc from org. Project a point to the hyperplane.
| |
| reset | back to summary |
|---|---|
| public void reset(final Vector3D p, final Vector3D normal) throws MathArithmeticException Reset the instance as if built from a point and a normal.
| |
| reset | back to summary |
|---|---|
| public void reset(final Plane original) Reset the instance from another one. The updated instance is completely independant of the original one. A deep reset is used none of the underlying object is shared.
| |
| revertSelf | back to summary |
|---|---|
| public void revertSelf() Revert the plane. Replace the instance by a similar plane with opposite orientation. The new plane frame is chosen in such a way that a 3D point that had
| |
| rotate | back to summary |
|---|---|
| public Plane rotate(final Vector3D center, final Rotation rotation) Rotate the plane around the specified point. The instance is not modified, a new instance is created. | |
| sameOrientationAs | back to summary |
|---|---|
| public boolean sameOrientationAs(final Hyperplane<Euclidean3D> other) Implements org. Check if the instance has the same orientation as another hyperplane.
| |
| setFrame | back to summary |
|---|---|
| private void setFrame() Reset the plane frame. | |
| setNormal | back to summary |
|---|---|
| private void setNormal(final Vector3D normal) throws MathArithmeticException Set the normal vactor.
| |
| toSpace | back to summary |
|---|---|
| public Vector3D toSpace(Vector<Euclidean2D> vector) Transform a sub-space point into a space point.
| |
| toSpace | back to summary |
|---|---|
| public Vector3D toSpace(final Point<Euclidean2D> point) Implements org. Transform an in-plane point into a 3D space point.
| |
| toSubSpace | back to summary |
|---|---|
| public Vector2D toSubSpace(Vector<Euclidean3D> vector) Transform a space point into a sub-space point.
| |
| toSubSpace | back to summary |
|---|---|
| public Vector2D toSubSpace(final Point<Euclidean3D> point) Implements org. Transform a 3D space point into an in-plane point. | |
| translate | back to summary |
|---|---|
| public Plane translate(final Vector3D translation) Translate the plane by the specified amount. The instance is not modified, a new instance is created. | |
| wholeHyperplane | back to summary |
|---|---|
| public SubPlane wholeHyperplane() Implements org. Build a region covering the whole hyperplane.
| |
| wholeSpace | back to summary |
|---|---|
| public PolyhedronsSet wholeSpace() Implements org. Build a region covering the whole space.
| |