gce
OCCT package gce: gce_ErrorType, gce_MakeCirc, gce_MakeCirc2d, gce_MakeCone, and 21 more bound classes.
gce_ErrorType
Properties(14)
gce_MakeCirc
This class implements construction algorithms for gp_Circ. Supported constructions include:
- circle from axis and radius;
- circle coaxial to another one, through point or at signed offset;
- circle through three points;
- circle from center and normal/plane;
- circle from center and axis-defining point;
- circle from axis and radius.
Constructors(8)
- constructor(A2: gp_Ax2, Radius: number): gce_MakeCirc
Creates a circle from axis placement and radius.
Parameters (2)A2—local coordinate systemRadius—radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(Circ: gp_Circ, Dist: number): gce_MakeCirc
Creates a circle coaxial to input circle at signed distance.
Parameters (2)Circ—source circleDist—signed distance
RemarksNote: If
Distis negative, the result is enclosed byCirc. - constructor(Circ: gp_Circ, Point: gp_Pnt): gce_MakeCirc
Creates a circle coaxial to input circle and passing through a point.
Parameters (2)Circ—source circlePoint—reference point
- constructor(Axis: gp_Ax1, Radius: number): gce_MakeCirc
Creates a circle from axis and radius.
Parameters (2)Axis—axis definitionRadius—radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(P1: gp_Pnt, P2: gp_Pnt, P3: gp_Pnt): gce_MakeCirc
Creates a circle passing through three points.
Parameters (3)P1—first pointP2—second pointP3—third point
- constructor(Center: gp_Pnt, Norm: gp_Dir, Radius: number): gce_MakeCirc
Creates a circle from center, plane normal and radius.
Parameters (3)Center—center pointNorm—input valueRadius—radius value
- constructor(Center: gp_Pnt, Plane: gp_Pln, Radius: number): gce_MakeCirc
Creates a circle from center, reference plane and radius.
Parameters (3)Center—center pointPlane—reference planeRadius—radius value
- constructor(Center: gp_Pnt, Ptaxis: gp_Pnt, Radius: number): gce_MakeCirc
Creates a circle from center, axis-defining point and radius.
Parameters (3)Center—center pointPtaxis—point defining axis directionRadius—radius value
Instance methods(2)
Returns the constructed circle. Exceptions StdFail_NotDone if no circle is constructed.
Returnsresulting circle
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeCirc2d
This class implements construction algorithms for gp_Circ2d. Supported constructions include:
- circle from axis and radius;
- circle concentric to another one, through point or at signed offset;
- circle through three points;
- circle from center and radius;
- circle from center and one point.
Constructors(7)
- constructor(Axis: gp_Ax22d, Radius: number): gce_MakeCirc2d
Creates a circle from local coordinate system and radius.
Parameters (2)Axis—axis definitionRadius—radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(Circ: gp_Circ2d, Dist: number): gce_MakeCirc2d
Creates a circle concentric to input circle with signed offset.
Parameters (2)Circ—source circleDist—signed distance
RemarksNote: Result radius is
Abs(Circ.Radius() + Dist). - constructor(Circ: gp_Circ2d, Point: gp_Pnt2d): gce_MakeCirc2d
Creates a circle concentric to input circle and passing through a point.
Parameters (2)Circ—source circlePoint—reference point
- constructor(XAxis: gp_Ax2d, Radius: number, Sense?: boolean): gce_MakeCirc2d
Creates a circle from axis and radius.
Parameters (3)XAxis—axis placementRadius—radius valueSense—orientation flag
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(P1: gp_Pnt2d, P2: gp_Pnt2d, P3: gp_Pnt2d): gce_MakeCirc2d
Creates a circle passing through three points.
Parameters (3)P1—first pointP2—second pointP3—third point
RemarksNote: The local coordinate system of the result is derived from input points.
- constructor(Center: gp_Pnt2d, Radius: number, Sense?: boolean): gce_MakeCirc2d
Creates a circle from center and radius.
Parameters (3)Center—center pointRadius—radius valueSense—orientation flag
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(Center: gp_Pnt2d, Point: gp_Pnt2d, Sense?: boolean): gce_MakeCirc2d
Creates a circle from center and one point on circle.
Parameters (3)Center—center pointPoint—reference pointSense—orientation flag
RemarksNote:
Sensecontrols result orientation.
Instance methods(2)
Returns the constructed circle. Exceptions StdFail_NotDone if no circle is constructed.
Returnsresulting circle
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeCone
This class implements construction algorithms for gp_Cone. Supported constructions include:
- from axis placement, semi-angle and reference radius;
- cone coaxial to another cone, through a point or at signed offset;
- cone from four points;
- cone from axis and two points;
- cone from two axis points and two section radii.
Constructors(7)
- constructor(Cone: gp_Cone, Point: gp_Pnt): gce_MakeCone
Creates a cone coaxial to input cone and passing through a point.
Parameters (2)Cone—source conePoint—reference point
RemarksNote: Construction fails with
gce_NegativeRadiuswhen no non-negative solution radius can be found. - constructor(Cone: gp_Cone, Dist: number): gce_MakeCone
Creates a cone coaxial to input cone at signed distance.
Parameters (2)Cone—source coneDist—signed distance
RemarksNote: Construction fails with
gce_NegativeRadiusif resulting radius is negative. - constructor(A2: gp_Ax2, Ang: number, Radius: number): gce_MakeCone
Creates a cone from axis placement, semi-angle and reference radius.
Parameters (3)A2—local coordinate systemAng—angle valueRadius—radius value
RemarksNote: Construction fails with
gce_BadAngleifAng <= gp::Resolution()orPI/2 - Ang <= gp::Resolution(). - constructor(Axis: gp_Ax1, P1: gp_Pnt, P2: gp_Pnt): gce_MakeCone
Creates a cone from line axis and two points.
Parameters (3)Axis—axis definitionP1—first pointP2—second point
RemarksNote: Error status is propagated from the 4-point construction.
- constructor(Axis: gp_Lin, P1: gp_Pnt, P2: gp_Pnt): gce_MakeCone
Creates a cone from line axis and two points.
Parameters (3)Axis—axis definitionP1—first pointP2—second point
RemarksNote: Error status is propagated from the 4-point construction.
- constructor(P1: gp_Pnt, P2: gp_Pnt, P3: gp_Pnt, P4: gp_Pnt): gce_MakeCone
Creates a cone from four points.
Parameters (4)P1—first pointP2—second pointP3—third pointP4—fourth point
RemarksNote: Construction fails with
gce_NullRadiusfor degenerate right-angle or zero-angle radius configuration. - constructor(P1: gp_Pnt, P2: gp_Pnt, R1: number, R2: number): gce_MakeCone
Creates a cone from two axis points and two section radii.
Parameters (4)P1—first pointP2—second pointR1—first radius valueR2—second radius value
RemarksNote: Construction fails with
gce_NullAnglefor degenerate zero-angle or right-angle configurations.
Instance methods(2)
Returns the constructed cone. Exceptions StdFail_NotDone if no cone is constructed.
Returnsresulting cone
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeCylinder
This class implements construction algorithms for gp_Cylinder. Supported constructions include:
- cylinder from axis placement and radius;
- cylinder coaxial to another, through point or at signed offset;
- cylinder from three points;
- cylinder from axis and radius;
- cylinder from circular base.
Constructors(6)
- constructor(Circ: gp_Circ): gce_MakeCylinder
Creates a cylinder from circular base.
Parameters (1)Circ—source circle
RemarksNote: This constructor succeeds for any valid
Circ. - constructor(A2: gp_Ax2, Radius: number): gce_MakeCylinder
Creates a cylinder from axis placement and radius.
Parameters (2)A2—local coordinate systemRadius—radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifRadiusis negative. - constructor(Cyl: gp_Cylinder, Point: gp_Pnt): gce_MakeCylinder
Creates a cylinder coaxial to input cylinder and passing through a point.
Parameters (2)Cyl—source cylinderPoint—reference point
- constructor(Cyl: gp_Cylinder, Dist: number): gce_MakeCylinder
Creates a cylinder coaxial to input cylinder at signed distance.
Parameters (2)Cyl—source cylinderDist—signed distance
RemarksNote: Construction fails with
gce_NegativeRadiusif resulting radius is negative. - constructor(Axis: gp_Ax1, Radius: number): gce_MakeCylinder
Makes a Cylinder by its axis <Axis> and radius <Radius>.
Parameters (2)Axis—axis definitionRadius—radius value
- constructor(P1: gp_Pnt, P2: gp_Pnt, P3: gp_Pnt): gce_MakeCylinder
Creates a cylinder from three points.
Parameters (3)P1—first pointP2—second pointP3—third point
RemarksNote: Radius is the distance from
P3to that axis.
Instance methods(2)
- Value(): gp_Cylinder
Returns the constructed cylinder. Exceptions StdFail_NotDone if no cylinder is constructed.
Returnsresulting cylinder
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeDir
This class implements construction algorithms for gp_Dir. Supported constructions include:
- direction from vector or coordinate components;
- direction from two points.
Constructors(4)
- constructor(V: gp_Vec): gce_MakeDir
Normalizes the vector V and creates a direction.
Parameters (1)V—direction vector
RemarksNote: Construction fails with
gce_NullVectorifV.Magnitude() <= gp::Resolution(). - constructor(Coord: gp_XYZ): gce_MakeDir
Creates a direction from a coordinate vector.
Parameters (1)Coord—coordinate vector
RemarksNote: Construction fails with
gce_NullVectorifCoord.Modulus() <= gp::Resolution(). - constructor(P1: gp_Pnt, P2: gp_Pnt): gce_MakeDir
Creates a direction from two points.
Parameters (2)P1—first pointP2—second point
RemarksNote: Construction fails with
gce_ConfusedPointsif points are coincident. - constructor(Xv: number, Yv: number, Zv: number): gce_MakeDir
Creates a direction with its 3 cartesian coordinates.
Parameters (3)Xv—X coordinate valueYv—Y coordinate valueZv—Z coordinate value
RemarksNote: Construction fails with
gce_NullVectorifXv*Xv + Yv*Yv + Zv*Zv <= gp::Resolution().
Instance methods(2)
Returns the constructed unit vector. Exceptions StdFail_NotDone if no unit vector is constructed.
Returnsresulting direction
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeDir2d
This class implements construction algorithms for gp_Dir2d. Supported constructions include:
- direction from vector or coordinate components;
- direction from two points.
Constructors(4)
Normalizes the vector V and creates a direction.
Parameters (1)V—direction vector
RemarksNote: Construction fails with
gce_NullVectorifV.Magnitude() <= gp::Resolution().- constructor(Coord: gp_XY): gce_MakeDir2d
Creates a direction from a coordinate vector.
Parameters (1)Coord—coordinate vector
RemarksNote: Construction fails with
gce_NullVectorifCoord.Modulus() <= gp::Resolution(). - constructor(Xv: number, Yv: number): gce_MakeDir2d
Creates a direction with its two cartesian coordinates.
Parameters (2)Xv—X coordinate valueYv—Y coordinate value
RemarksNote: Construction fails with
gce_NullVectorifXv*Xv + Yv*Yv <= gp::Resolution(). - constructor(P1: gp_Pnt2d, P2: gp_Pnt2d): gce_MakeDir2d
Creates a direction from two points.
Parameters (2)P1—first pointP2—second point
RemarksNote: Construction fails with
gce_ConfusedPointsif points are coincident.
Instance methods(2)
Returns the constructed unit vector. Exceptions StdFail_NotDone if no unit vector is constructed.
Returnsresulting direction
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeElips
This class implements construction algorithms for gp_Elips. Supported constructions include:
- ellipse from local coordinate system and radii;
- ellipse from center and two points.
Constructors(2)
- constructor(A2: gp_Ax2, MajorRadius: number, MinorRadius: number): gce_MakeElips
The major radius of the ellipse is on the "XAxis" and the minor radius is on the "YAxis" of the ellipse. The "XAxis" is defined with the "XDirection" of A2 and the "YAxis" is defined with the "YDirection" of A2.
Parameters (3)A2—local coordinate systemMajorRadius—major radius valueMinorRadius—minor radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifMinorRadius < 0.0. - constructor(S1: gp_Pnt, S2: gp_Pnt, Center: gp_Pnt): gce_MakeElips
Creates an ellipse from center and two points.
Parameters (3)S1—first pointS2—second pointCenter—center point
RemarksNote: Construction fails with
gce_InvertAxiswhen computed minor radius is null/greater than major radius, or when points are collinear.
Instance methods(2)
Returns the constructed ellipse. Exceptions StdFail_NotDone if no ellipse is constructed.
Returnsresulting ellipse
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeElips2d
This class implements construction algorithms for gp_Elips2d. Supported constructions include:
- ellipse from major axis (or local 2D coordinate system) and radii;
- ellipse from center and two points.
Constructors(3)
- constructor(A: gp_Ax22d, MajorRadius: number, MinorRadius: number): gce_MakeElips2d
Axis defines the Xaxis and Yaxis of the ellipse which defines the origin and the sense of parametrization. Creates an ellipse with the AxisPlacement the major and the minor radius. The location of Axis is the center of the ellipse. It is possible to create an ellipse with MajorRadius = MinorRadius.
Parameters (3)A—local coordinate systemMajorRadius—major radius valueMinorRadius—minor radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifMajorRadius < 0.0. - constructor(S1: gp_Pnt2d, S2: gp_Pnt2d, Center: gp_Pnt2d): gce_MakeElips2d
Creates an ellipse from center and two points.
Parameters (3)S1—first pointS2—second pointCenter—center point
RemarksNote: Construction fails with
gce_InvertAxiswhen computed minor radius exceeds major radius. - constructor(MajorAxis: gp_Ax2d, MajorRadius: number, MinorRadius: number, Sense?: boolean): gce_MakeElips2d
Creates an ellipse with the major axis, the major and the minor radius. The location of the MajorAxis is the center of the ellipse. The sense of parametrization is given by Sense. It is possible to create an ellipse with MajorRadius = MinorRadius.
Parameters (4)MajorAxis—major axis placementMajorRadius—major radius valueMinorRadius—minor radius valueSense—orientation flag
RemarksNote: Construction fails with
gce_NegativeRadiusifMajorRadius < 0.0.
Instance methods(2)
- Value(): gp_Elips2d
Returns the constructed ellipse. Exceptions StdFail_NotDone if no ellipse is constructed.
Returnsresulting ellipse
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeHypr
This class implements construction algorithms for gp_Hypr. Supported constructions include:
- hyperbola from center and two points (one on major axis);
- hyperbola from local coordinate system and radii.
^YAxis | FirstConjugateBranch | Other | Main -------------------- C ------------------------------>XAxis Branch | Branch | | SecondConjugateBranch |
The local Cartesian coordinate system of the hyperbola is an axis placement (two axes).
The "XDirection" and the "YDirection" of the axis placement define the plane of the hyperbola.
The "Direction" of the axis placement defines the normal axis to the hyperbola's plane.
The "XAxis" of the hyperbola ("Location", "XDirection") is the major axis and the "YAxis" of the hyperbola ("Location", "YDirection") is the minor axis.
Constructors(2)
- constructor(A2: gp_Ax2, MajorRadius: number, MinorRadius: number): gce_MakeHypr
Creates a hyperbola from a local coordinate system and radii.
Parameters (3)A2—local coordinate systemMajorRadius—major radius valueMinorRadius—minor radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifMajorRadius < 0.0orMinorRadius < 0.0. - constructor(S1: gp_Pnt, S2: gp_Pnt, Center: gp_Pnt): gce_MakeHypr
Creates a hyperbola from center and two points.
Parameters (3)S1—first pointS2—second pointCenter—center point
RemarksNote: Construction fails with
gce_ColinearPointsifS1,S2, andCenterare collinear.
Instance methods(2)
Returns the constructed hyperbola. Exceptions StdFail_NotDone if no hyperbola is constructed.
Returnsresulting hyperbola
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeHypr2d
This class implements construction algorithms for gp_Hypr2d. Supported constructions include:
- hyperbola from center and two points (one on major axis);
- hyperbola from major axis and radii;
- hyperbola from local coordinate system and radii.
^YAxis | FirstConjugateBranch | Other | Main -------------------- C ------------------------------>XAxis Branch | Branch | | SecondConjugateBranch |
An axis placement (one axis) is associated with the hyperbola. This axis is the "XAxis" or major axis of the hyperbola. It is the symmetry axis of the main branch. The "YAxis" is normal to this axis and passes through its location point. It is the minor axis.
The major radius is the distance between the Location point of the hyperbola C and the vertex of the Main Branch (or the Other branch). The minor radius is the distance between the Location point of the hyperbola C and the vertex of the First (or Second) Conjugate branch. The major radius can be lower than the minor radius.
Constructors(3)
- constructor(S1: gp_Pnt2d, S2: gp_Pnt2d, Center: gp_Pnt2d): gce_MakeHypr2d
Creates a hyperbola from center and two points.
Parameters (3)S1—first pointS2—second pointCenter—center point
RemarksNote: Construction fails with
gce_ColinearPointsifS1,S2, andCenterare collinear. - constructor(A: gp_Ax22d, MajorRadius: number, MinorRadius: number): gce_MakeHypr2d
Creates a hyperbola from local coordinate system and radii.
Parameters (3)A—local coordinate systemMajorRadius—major radius valueMinorRadius—minor radius value
RemarksNote: Construction fails with
gce_NegativeRadiusifMajorRadius < 0.0orMinorRadius < 0.0. - constructor(MajorAxis: gp_Ax2d, MajorRadius: number, MinorRadius: number, Sense: boolean): gce_MakeHypr2d
Creates a hyperbola from major axis and radii.
Parameters (4)MajorAxis—major axis placementMajorRadius—major radius valueMinorRadius—minor radius valueSense—orientation flag
RemarksNote: Construction fails with
gce_NegativeRadiusifMajorRadius < 0.0orMinorRadius < 0.0.
Instance methods(2)
Returns the constructed hyperbola. Exceptions StdFail_NotDone if no hyperbola is constructed.
Returnsresulting hyperbola
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeLin
This class implements construction algorithms for gp_Lin. Supported constructions include:
- line from axis placement;
- line from point and direction;
- parallel line through point;
- line through two points.
Constructors(4)
- constructor(A1: gp_Ax1): gce_MakeLin
Creates a line located along the axis A1.
Parameters (1)A1—axis placement
RemarksNote: The location of
A1is the line origin. - constructor(P: gp_Pnt, V: gp_Dir): gce_MakeLin
is the location point (origin) of the line and <V> is the direction of the line.
Parameters (2)P—pointV—direction vector
- constructor(Lin: gp_Lin, Point: gp_Pnt): gce_MakeLin
Creates a line parallel to input line and passing through a point.
Parameters (2)Lin—source linePoint—reference point
- constructor(P1: gp_Pnt, P2: gp_Pnt): gce_MakeLin
Creates a line passing through two points.
Parameters (2)P1—first pointP2—second point
RemarksNote: Construction fails with
gce_ConfusedPointsif points are coincident.
Instance methods(2)
Returns the constructed line. Exceptions StdFail_NotDone is raised if no line is constructed.
Returnsresulting line
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeLin2d
This class implements construction algorithms for gp_Lin2d. Supported constructions include:
- line from axis placement;
- line from point and direction;
- line from cartesian equation;
- parallel line through point or at signed distance;
- line through two points.
Constructors(6)
Creates a line located with A.
Parameters (1)A—local coordinate system
RemarksNote: The location of
Ais the line origin.- constructor(P: gp_Pnt2d, V: gp_Dir2d): gce_MakeLin2d
is the location point (origin) of the line and <V> is the direction of the line.
Parameters (2)P—pointV—direction vector
- constructor(Lin: gp_Lin2d, Dist: number): gce_MakeLin2d
Creates a line parallel to input line at signed distance.
Parameters (2)Lin—source lineDist—signed distance
RemarksNote: If
Distis positive, the result is on the right side ofLin(in line local orientation), otherwise on the left. - constructor(Lin: gp_Lin2d, Point: gp_Pnt2d): gce_MakeLin2d
Creates a line parallel to input line and passing through a point.
Parameters (2)Lin—source linePoint—reference point
- constructor(P1: gp_Pnt2d, P2: gp_Pnt2d): gce_MakeLin2d
Creates a line passing through two points.
Parameters (2)P1—first pointP2—second point
RemarksNote: Construction fails with
gce_ConfusedPointsifP1andP2are coincident. - constructor(A: number, B: number, C: number): gce_MakeLin2d
Creates the line from the equation AX + BY + C = 0.0.
Parameters (3)A—equation coefficient AB—equation coefficient BC—equation coefficient C
RemarksNote: Construction fails with
gce_NullAxisifA*A + B*B <= gp::Resolution().
Instance methods(2)
Returns the constructed line. Exceptions StdFail_NotDone if no line is constructed.
Returnsresulting line
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeMirror
This class implements elementary construction algorithms for a symmetrical transformation in 3D space about a point, axis or plane. The result is a gp_Trsf transformation. A MakeMirror object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(6)
- constructor(Point: gp_Pnt): gce_MakeMirror
Constructs a central symmetry about a point.
Parameters (1)Point—center point
- constructor(Axis: gp_Ax1): gce_MakeMirror
Constructs an axial symmetry about an axis.
Parameters (1)Axis—mirror axis
- constructor(Line: gp_Lin): gce_MakeMirror
Constructs an axial symmetry about a line.
Parameters (1)Line—mirror line
- constructor(Plane: gp_Pln): gce_MakeMirror
Constructs a planar symmetry about a plane.
Parameters (1)Plane—mirror plane
- constructor(Plane: gp_Ax2): gce_MakeMirror
Constructs a planar symmetry about a plane.
Parameters (1)Plane—mirror plane
- constructor(Point: gp_Pnt, Direc: gp_Dir): gce_MakeMirror
Constructs an axial symmetry about an axis defined by point and direction.
Parameters (2)Point—point on the axisDirec—axis direction
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeMirror2d
This class implements elementary construction algorithms for a symmetrical transformation in 2D space about a point or axis. The result is a gp_Trsf2d transformation. A MakeMirror2d object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and consulting the result.
Constructors(4)
- constructor(Point: gp_Pnt2d): gce_MakeMirror2d
Constructs a central symmetry about a point.
Parameters (1)Point—center point
- constructor(Axis: gp_Ax2d): gce_MakeMirror2d
Constructs an axial symmetry about an axis.
Parameters (1)Axis—mirror axis
- constructor(Line: gp_Lin2d): gce_MakeMirror2d
Constructs an axial symmetry about a line.
Parameters (1)Line—mirror line
- constructor(Point: gp_Pnt2d, Direc: gp_Dir2d): gce_MakeMirror2d
Constructs an axial symmetry about an axis defined by point and direction.
Parameters (2)Point—point on the axisDirec—axis direction
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeParab
Implements construction algorithms for gp_Parab. The parabola is infinite in the parameter range ]-infinite, +infinite[. The vertex is the Location point of the local coordinate system.
The XDirection and YDirection define the parabola plane.
The XAxis (Location, XDirection) is the symmetry axis and is oriented from the vertex to the focus.
The YAxis (Location, YDirection) is parallel to the directrix.
The equation in the local coordinate system is: Y**2 = (2*P) * X, where P is the parameter (distance between focus and directrix). The focal length F = P / 2 is the distance from vertex to focus.
Supported constructions:
- from local coordinate system and focal length;
- from directrix and focus.
Constructors(2)
- constructor(A2: gp_Ax2, Focal: number): gce_MakeParab
Creates a parabola from local coordinate system and focal length.
Parameters (2)A2—local coordinate system of the parabolaFocal—focal length
RemarksNote:
TheErroris set togce_NullFocusLengthifFocal < 0.0. - constructor(D: gp_Ax1, F: gp_Pnt): gce_MakeParab
Creates a parabola from directrix and focus.
Parameters (2)D—directrix of the parabolaF—focus point of the parabola
Instance methods(2)
Returns the constructed parabola.
Returnsresulting parabola
Alias for
Value()returning a copy.Returnsresulting parabola
gce_MakeParab2d
Implements construction algorithms for gp_Parab2d. The parabola is infinite and represented in a local 2D coordinate system. The XAxis is the symmetry axis directed from vertex to focus, and the YAxis is parallel to the directrix. The equation in local coordinates is: Y**2 = (2*P) * X, where P is the distance between focus and directrix. The focal length F = P / 2 is the distance from vertex to focus.
Supported constructions:
- from symmetry axis and focal length;
- from full axis system and focal length;
- from directrix and focus;
- from focus and vertex.
Constructors(4)
- constructor(A: gp_Ax22d, Focal: number): gce_MakeParab2d
Creates a parabola from full local coordinate system and focal length.
Parameters (2)A—local coordinate system of the parabolaFocal—focal length
RemarksNote:
TheErroris set togce_NullFocusLengthifFocal < 0.0. - constructor(MirrorAxis: gp_Ax2d, Focal: number, Sense?: boolean): gce_MakeParab2d
Creates a parabola from symmetry axis and focal length.
Parameters (3)MirrorAxis—symmetry axis of the parabolaFocal—focal lengthSense—orientation of parametrization
RemarksNote:
TheErroris set togce_NullFocusLengthifFocal < 0.0. - constructor(D: gp_Ax2d, F: gp_Pnt2d, Sense?: boolean): gce_MakeParab2d
Creates a parabola from directrix and focus.
Parameters (3)D—directrix of the parabolaF—focus point of the parabolaSense—orientation of parametrization
- constructor(S1: gp_Pnt2d, Center: gp_Pnt2d, Sense?: boolean): gce_MakeParab2d
Creates a parabola from focus and vertex.
Parameters (3)S1—focus pointCenter—vertex pointSense—orientation of parametrization
RemarksNote:
TheErroris set togce_NullAxisifS1andCenterare coincident.
Instance methods(2)
- Value(): gp_Parab2d
Returns the constructed parabola.
Returnsresulting parabola
Alias for
Value()returning a copy.Returnsresulting parabola
gce_MakePln
This class implements construction algorithms for gp_Pln. Supported constructions include:
- plane from axis placement or point+normal;
- plane from cartesian equation;
- plane parallel to another plane through point or at signed distance;
- plane through two or three points;
- plane through axis location normal to axis direction.
Constructors(8)
- constructor(A2: gp_Ax2): gce_MakePln
The coordinate system of the plane is defined with the axis placement A2. The "Direction" of A2 defines the normal to the plane. The "Location" of A2 defines the location (origin) of the plane. The "XDirection" and "YDirection" of A2 define the "XAxis" and the "YAxis" of the plane used to parametrize the plane.
Parameters (1)A2—local coordinate system
- constructor(Axis: gp_Ax1): gce_MakePln
Make a pln passing through the location of <Axis>and normal to the Direction of <Axis>.
Parameters (1)Axis—axis definition
RemarksNote: This constructor always succeeds for valid
Axis. - constructor(P: gp_Pnt, V: gp_Dir): gce_MakePln
Creates a plane with the "Location" point.
and the normal direction <V>.Parameters (2)P—pointV—direction vector
- constructor(Pln: gp_Pln, Point: gp_Pnt): gce_MakePln
Creates a plane parallel to input plane and passing through a point.
Parameters (2)Pln—source planePoint—reference point
- constructor(Pln: gp_Pln, Dist: number): gce_MakePln
Creates a plane parallel to input plane at signed distance.
Parameters (2)Pln—source planeDist—signed distance
RemarksNote: Positive
Distshifts along the plane normal, negative in opposite direction. - constructor(P1: gp_Pnt, P2: gp_Pnt): gce_MakePln
Creates a plane through
P1, normal to direction (P1,P2).Parameters (2)P1—first pointP2—second point
RemarksNote: Construction fails with
gce_ConfusedPointsifP1andP2coincide. - constructor(P1: gp_Pnt, P2: gp_Pnt, P3: gp_Pnt): gce_MakePln
Creates a plane through three points.
Parameters (3)P1—first pointP2—second pointP3—third point
RemarksNote: Construction fails with
gce_ColinearPointsif points are collinear. - constructor(A: number, B: number, C: number, D: number): gce_MakePln
Creates a plane from its cartesian equation : A * X + B * Y + C * Z + D = 0.0.
Parameters (4)A—equation coefficient AB—equation coefficient BC—equation coefficient CD—equation constant term
RemarksNote: Construction fails with
gce_BadEquationifA*A + B*B + C*C <= gp::Resolution().
Instance methods(2)
Returns the constructed plane. Exceptions StdFail_NotDone if no plane is constructed.
Returnsresulting plane
Alias for
Value()returning a copy.Returnsresulting object
gce_MakeRotation
This class implements elementary construction algorithms for a rotation in 3D space. The result is a gp_Trsf transformation. A MakeRotation object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(3)
- constructor(Line: gp_Lin, Angle: number): gce_MakeRotation
Constructs a rotation around the axis defined by a line.
Parameters (2)Line—rotation axisAngle—rotation angle in radians
- constructor(Axis: gp_Ax1, Angle: number): gce_MakeRotation
Constructs a rotation around an axis.
Parameters (2)Axis—rotation axisAngle—rotation angle in radians
- constructor(Point: gp_Pnt, Direc: gp_Dir, Angle: number): gce_MakeRotation
Constructs a rotation around an axis defined by point and direction.
Parameters (3)Point—point on the axisDirec—axis directionAngle—rotation angle in radians
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeRotation2d
Implements an elementary construction algorithm for a rotation in 2D space. The result is a gp_Trsf2d transformation. A MakeRotation2d object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(1)
- constructor(Point: gp_Pnt2d, Angle: number): gce_MakeRotation2d
Constructs a rotation around a point in 2D.
Parameters (2)Point—rotation centerAngle—rotation angle in radians
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeScale
Implements an elementary construction algorithm for a scaling transformation in 3D space. The result is a gp_Trsf transformation. A MakeScale object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(1)
- constructor(Point: gp_Pnt, Scale: number): gce_MakeScale
Constructs a scaling transformation.
Parameters (2)Point—center of scalingScale—scale factor
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeScale2d
This class implements an elementary construction algorithm for a scaling transformation in 2D space. The result is a gp_Trsf2d transformation. A MakeScale2d object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(1)
- constructor(Point: gp_Pnt2d, Scale: number): gce_MakeScale2d
Constructs a scaling transformation.
Parameters (2)Point—center of scalingScale—scale factor
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeTranslation
This class implements elementary construction algorithms for a translation in 3D space. The result is a gp_Trsf transformation. A MakeTranslation object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(2)
- constructor(Vect: gp_Vec): gce_MakeTranslation
Constructs a translation from a vector.
Parameters (1)Vect—translation vector
- constructor(Point1: gp_Pnt, Point2: gp_Pnt): gce_MakeTranslation
Constructs a translation from two points.
Parameters (2)Point1—start pointPoint2—end point
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_MakeTranslation2d
This class implements elementary construction algorithms for a translation in 2D space. The result is a gp_Trsf2d transformation. A MakeTranslation2d object provides a framework for:
- defining the construction of the transformation,
- implementing the construction algorithm, and
- consulting the result.
Constructors(2)
- constructor(Vect: gp_Vec2d): gce_MakeTranslation2d
Constructs a translation from a vector.
Parameters (1)Vect—translation vector
- constructor(Point1: gp_Pnt2d, Point2: gp_Pnt2d): gce_MakeTranslation2d
Constructs a translation from two points.
Parameters (2)Point1—start pointPoint2—end point
Instance methods(2)
Returns the constructed transformation.
Returnsresulting transformation
Alias for
Value()returning a copy.Returnsresulting transformation
gce_Root
Provides common status services for all gce construction classes.
Constructors(1)
Instance methods(3)
- IsDone(): boolean
Returns true if the construction is successful.
Returnstrue if status is
gce_Done - IsError(): boolean
Returns true if the construction has failed.
Returnstrue if status is not
gce_Done Returns the status of the construction:
- gce_Done, if the construction is successful, or
- another value of the
gce_ErrorTypeenumeration indicating why the construction failed.
Returnsconstruction status