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 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 of the underlying surface; unlike normalOnUV, they are not flipped for a reversed face.

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.

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.

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 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.

The border offsets trim the range at each end. Each rectangle sits centered in its cell, sized by the scale patterns as a fraction of it; the fillet pattern rounds corners, the inclusion pattern skips cells.

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

The holes follow the same cells and patterns as subdivideToRectangleWires; when no scale pattern is given each hole covers half its cell. With holesToFaces true the result also carries one face per hole, after the perforated face, which is handy for lids or fillers.

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

The border offsets trim a fraction of the range at each end; flatU turns a flat side toward U, the extend flags stretch the outer rows past the edges. Scale, fillet and inclusion patterns repeat per hexagon.

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

The holes follow the same layout and patterns as subdivideToHexagonWires; when no scale pattern is given each hole is half the size of its hexagon. With holesToFaces true the result also carries one face per hole, after 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.

Creates a flat L-shaped face: two rectangular legs joined at a corner.

The first leg has widthFirst and lengthFirst, the second widthSecond and lengthSecond; align puts the corner on the outside, inside or middle of the legs, and rotation turns the shape in its plane, in degrees. It lies flat on the ground unless direction says otherwise.

Creates a flat star-shaped face with numRays points.

The points reach outerRadius and the notches between them innerRadius; half keeps only the first half of the rays. offsetOuterEdges lifts the ray tips out of the plane and is meant for the wire; a flat face needs it at 0. It lies flat on the ground unless direction says otherwise.

Creates a flat face shaped like a stylized Christmas tree: nrSkirts layers of branches, narrowing from outerDist to innerDist off the trunk line, on a trunk of trunkHeight and trunkWidth.

Unlike the other flat shapes here it stands upright in the XY plane, tip along Y; direction is the trunk-to-tip direction, rotation spins it about that axis, in degrees.

Creates a flat parallelogram face: a rectangle of width and height whose sides lean over by angle degrees.

With aroundCenter true the shape is centered on center; otherwise it starts there and extends in the positive directions. direction is the normal of the plane; the default [0, 1, 0] lays it flat on the ground.

Creates a flat heart-shaped face that fits roughly into a square of sizeApprox.

rotation turns it in its plane, in degrees. direction is the normal of the plane; the default [0, 1, 0] lays it flat on the ground.

Creates a flat regular polygon face with nrCorners corners, all on a circle of radius.

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

Rebuilds the surface of a face as a B-spline of the given U and V degrees.

Lowering a degree smooths the surface into a simpler approximation within tolerance; raising it is exact. keepTrim keeps the original boundary wires, which is reliable when raising; otherwise the face covers the whole new surface. A rebuild that fails gives a null face.

Changes how the UV parameters run over a face: swap U and V, reverse U, reverse V, or any combination.

The geometry stays the same; only the parameter directions change, which matters for every method here that works in UV, such as subdivideToPoints or wireAlongParam. The face is rebuilt over the surface's natural bounds.

Reparametrizes a face so equal steps in U or V give roughly equal distances on the surface.

Many surfaces bunch their parameters up in places, so a UV grid over them looks uneven; this resamples the surface at samples points per direction and refits it, which evens out subdivideToPoints and its siblings. The face is rebuilt over the new bounds.