Class OCCTFace

Creates the flat cross-section of an I-beam: two horizontal flanges joined by a vertical web.

width is the flange width, height the total height, webThickness and flangeThickness the wall thicknesses; alignment says which point of the profile's box sits on center, rotation turns it in its plane, in degrees. It lies on the ground, ready to extrude along Y.

Creates the flat cross-section of an H-beam: two vertical flanges joined by a horizontal web, an I-beam on its side.

width is the total width, height the flange height, webThickness and flangeThickness the wall thicknesses; alignment says which point of the profile's box sits on center, rotation turns it in its plane, in degrees. It lies on the ground.

Creates the flat cross-section of a T-beam: a horizontal flange with a vertical web hanging from its middle.

width is the flange width, height the total height, webThickness and flangeThickness the wall thicknesses; alignment says which point of the profile's box sits on center, and rotation turns it in its plane, in degrees. It lies flat on the ground.

Creates the flat cross-section of a U-beam, a channel: a web with two flanges of flangeWidth standing up from its ends.

width and height are the total size, webThickness and flangeThickness the wall thicknesses; alignment says which point of the profile's box sits on center, rotation turns it in its plane, in degrees. It lies flat on the ground.

Collects diagnostic facts about a face: its surface type, U and V degrees, control point and knot counts, whether U or V are closed, periodic or rational, the UV bounds, area, planarity, orientation and the number of wires and edges.

An empty or null face gives a report marked invalid.

Lays a plane, cylinder or cone face out flat without stretching it, as the pattern a sheet is cut from.

Lengths and areas are kept, holes and notches included, and a closed face opens along its seam. The flat face lies on the ground plane facing +Y, as the other flat shapes do, ready for a DXF export.

Lays a grid of points over a face by stepping evenly through its U and V ranges.

nrDivisionsU by nrDivisionsV points cover the face edge to edge, listed row by row: all V values for the first U, then the next U. The removal flags drop the first or last row; the shift flags push every point half a step.

Draws evenly spaced wires across a face along one parameter direction, like the lines of a ruled sheet.

nrDivisions steps give one more wire than that, the boundary lines included; removeStart and removeEnd drop those, shiftHalfStep moves every wire half a step. With isU true each wire sits at a fixed U and runs across V; false swaps the roles.

Lays a grid of points over a face like subdivideToPoints, but shifts and removes points on every nth row or column, for brick-like and staggered patterns.

Each rule is a pair: shiftHalfStepNthU says every how-manyth V row moves half a step in U, shiftHalfStepUOffsetN where counting starts; the removal rules drop every nth point of an edge row.

Computes the surface normal at every point of the grid subdivideToPoints would lay over a face, with the same options and the same order.

The normals are unit vectors and follow the face's orientation, so a reversed face gives them flipped. Pair the list with subdivideToPoints to place things standing on the surface.

Lists the UV parameter pairs of the grid subdivideToPoints would lay over a face, with the same options and the same order.

The pairs are in the face's real UV values, not fractions.

Finds the point on a face at the given UV fractions.

paramU and paramV run from 0 to 1 over the face's U and V range, so 0.5, 0.5 is the middle of the range, which on a trimmed face is not always inside the face.

Finds the surface normal of a face at the given UV fractions.

paramU and paramV run from 0 to 1 over the face's U and V range. The normal is a unit vector and follows the face's orientation, so a reversed face gives it flipped.

Finds the points on a face at several UV fraction pairs at once.

Each pair holds U then V, both from 0 to 1 over the face's range.

Finds the surface normals of a face at several UV fraction pairs at once.

Each pair holds U then V, both from 0 to 1 over the face's range. The normals are unit vectors and follow the face's orientation, as normalOnUV does, so a reversed face gives them flipped.

Places evenly spaced points along one straight line across a face's UV range.

With isU true the line sits at param (a fraction from 0 to 1 of the U range) and nrPoints points spread over the whole V range; with false the roles swap. removeStartPoint and removeEndPoint drop the ends, and shiftHalfStep moves every point half a step.

Draws one wire across a face along a parameter line, following the surface.

With isU true the wire sits at param (a fraction from 0 to 1 of the U range) and runs over the whole V range; with false the roles swap.

Draws several wires across a face, one per parameter value, following the surface.

With isU true each wire sits at its fraction of the U range and runs over the whole V range; with false the roles swap. The wires ignore the face's trims; isoCurves gives the exact curves trimmed to the face.

Finds a face's exact iso curves at fractions of its UV range, trimmed to the face.

With isU true each curve holds u at its fraction and runs along v; false swaps them. A curve stops at a hole and goes on past it; 0 and 1 give the boundary, and values outside give none.

Sorts points as inside a face, on its boundary or outside it, and keeps the chosen groups.

keepIn, keepOn, keepOut and keepUnknown choose the groups; tolerance decides how close to the boundary counts as on it. With useBndBox, a point outside the bounding box grown by gapTolerance is outside.

Runs filterFacePoints against several faces with the same points and options.

By default the result holds one list per face; with flatPointsArray true the lists are joined into one, so a point on two faces appears twice.

Finds the frame of a face at a UV fraction pair, where a profile or a copy would sit: at the surface point, normal as normalOnUV gives it, direction along U.

U and V run from 0 to 1 over the face's range. Where the surface has no normal, as at a cone's point, it is read inside the face.

Finds the frames of a face at several UV fraction pairs at once, each as frameOnUV finds it.

Places frames on a face in a grid, one at each point subdivideToPoints gives for the same inputs, each turned as frameOnUV turns it.

The frames come in the order of the points, their normals match subdivideToNormals and their X axes run along the face's U direction.

Finds the frame of a face at the place nearest a point, as frameOnUV finds it there; a point beyond the face's edge comes to the edge.

Finds the frames of a face at the places nearest several points at once, each as frameNearestPoint finds it.

Creates one face per wire, each cut from the surface of a guiding face so it takes that surface's curvature.

The wires must lie on the surface. With inside true each wire is turned so its face is the region it encloses; with false the wire's own direction decides, and a wire running the other way gives the outside region.

Creates a face from a wire that lies on the surface of a guiding face, so the new face takes the curvature of that surface.

With inside true the wire is turned so the face is the region it encloses; with false the wire's own direction decides, and a wire running the other way gives the region outside it.

Creates a face bounded by a closed wire.

With planar true the wire must lie in one plane and the face is flat; with false a smooth surface is fitted through the wire's edges, which fills a wire that is not flat. A shape that is not a wire throws an error.

Creates one face from several wires: the first wire is the outer boundary and every further wire cuts a hole in it.

With planar true the wires must lie in one plane. The hole wires must sit inside the outer one without crossing it or each other.

Creates one face from several wires on the surface of a guiding face: the first wire is the outer boundary and every further wire cuts a hole.

The face takes the curvature of the guiding surface. inside applies to the first wire: true turns it so the face is the region it encloses; false lets its own direction decide.

Creates one face per closed wire, each as createFaceFromWire would.

With planar true every wire must lie in a plane; with false a smooth surface is fitted through each.

Joins circles with tangent belts: for each pair it draws the two outer tangent lines and the outer arcs between them and fills that outline with a flat face.

combination picks the pairs: allWithAll every circle with every other, inOrder neighbors in the list, inOrderClosed also the last with the first. unify fuses the faces; otherwise they form a compound.

Joins circles from consecutive lists with tangent belts, the way createFaceFromMultipleCircleTanWires joins single circles.

allWithAll joins every circle of a list with every circle of the next; inOrder joins circles at the same position in neighboring lists, which need equal lengths; inOrderClosed also closes each list into a ring. unify fuses the faces; otherwise they form a compound.

Creates a face that covers a whole surface, out to the surface's natural bounds.

tolerance is used to detect degenerate edges, such as the pole of a sphere. Surfaces come from geom.surfaces.

Creates a face by cutting a surface with a wire that lies on it.

With inside true the wire is turned so the face is the region it encloses; with false the wire's own direction decides, and a wire running the other way gives the region outside it. Surfaces come from geom.surfaces.

Creates a B-spline face through a grid of points, or near them.

The rows step along u and each row runs along v. Interpolating passes through every point at degree 3, closed in u when periodic; approximating keeps within tolerance at a degree from degreeMin to degreeMax. Neighbouring rows or columns holding the same points are refused.

Creates the ruled surface between two edges, or two wires edge by edge: straight lines from one to the other.

Each line joins the points at the same share of the two curves, so reversing one twists the surface. Wires need as many edges each, paired as each wire runs. The shapes given are left unchanged.

Creates a B-spline face bounded by two, three or four edges.

Four edges, in any order and direction, must close up. Of three, one must meet the other two, and a straight side closes their free ends. Two are opposite sides joined start to start; the curved style instead sweeps one along the other from a shared corner.

Creates a face that fills a closed loop of edges and passes near given points.

The edges may come in any order and direction. Each continuity says whether the patch passes through its edge, meets the face beside it at a tangent, or also bends as it does; an edge that stores no face takes that face in supports.

Creates a flat triangular face from three points.

Creates one flat triangular face per triangle of a mesh.

A triangle that cannot form a face, for instance one with repeated points, is skipped with a warning in the console.

Picks one face out of a shape by its position, counting from 0, in the order the kernel walks the shape.

The shape must be a face or something built from faces; an index beyond the last face throws an error.

Lists every face of a shape in the order the kernel walks it.

Flips a face so its normal points the other way.

The geometry stays the same; only the orientation changes, which decides the outside of a shell and the direction normalOnUV reports.

Reads the smallest U parameter value of a face, in the surface's own units.

Together with getUMaxBound, getVMinBound and getVMaxBound it gives the range that the UV fractions used elsewhere in this class map onto.

Reads the largest U parameter value of a face, in the surface's own units.

Reads the smallest V parameter value of a face, in the surface's own units.

Reads the largest V parameter value of a face, in the surface's own units.

Measures the surface area of a face, in square model units.

Measures the surface area of each face in a list, in square model units.

Finds the center of mass of a face, the point its area balances on.

On a curved or ring-shaped face this point can lie off the surface.

Finds the center of mass of each face in a list.

Lays rectangular wires over a face, one per cell of an nrRectanglesU by nrRectanglesV division of its UV range, following the surface.

Border offsets trim the range; each rectangle is centered in its cell, sized by the scale patterns, rounded by the fillet pattern, skipped by the inclusion pattern. One crossing a trim or hole is left out.

Cuts a grid of rectangular holes into a face and returns the perforated face.

The holes follow the cells and patterns of subdivideToRectangleWires; with no scale pattern each covers half its cell, and existing holes stay. With holesToFaces true one face per hole follows the perforated face.

Lays a honeycomb of hexagonal wires over a face, nrHexagonsU by nrHexagonsV of them fitted into its UV range, each following the surface.

Border offsets trim the range; flatU turns a flat side toward U, the extend flags stretch the outer rows past the edges, and patterns repeat per hexagon. One crossing a trim or hole is left out.

Cuts a honeycomb of hexagonal holes into a face and returns the perforated face.

The holes follow the layout and patterns of subdivideToHexagonWires; with no scale pattern each is half its hexagon, and existing holes stay. With holesToFaces true one face per hole follows the perforated face.

Creates a flat face from a list of corner points, closing the outline from the last point back to the first.

The points must lie in one plane.

Creates a flat circular face, a disc.

direction is the normal of its plane: the default [0, 1, 0] lays it flat on the ground.

Fills a rectangle on the ground plane with a grid of flat hexagonal faces, centered on the origin.

The hexagons are scaled so nrHexagonsInWidth fit across width and nrHexagonsInHeight across height. The scale, fillet and inclusion patterns are read hexagon by hexagon and repeat; the extend flags stretch the outer rows past the edges to cover the rectangle.

Creates a flat elliptical face.

direction is the normal of its plane: the default [0, 1, 0] lays it flat on the ground. radiusMajor must be at least radiusMinor.

Creates a flat square face centered on center.

direction is the normal of its plane: the default [0, 1, 0] lays it flat on the ground.

Creates a flat rectangular face centered on center.

On the ground plane width runs along X and length along Z; direction is the normal of the plane, and the default [0, 1, 0] keeps the face flat on the ground.