Hole

Status: Implemented — threads are symbolic only

Hole drills one cutter per sketch point and subtracts it from a target solid. Simple, countersunk, counterbored and threaded styles are available.

Walkthrough

Inputs

• id – a string, default null.
• face – a single (multiple: false) reference_selection filtered to SKETCH, default null; at least one selection is required.
• holeType – an options value: SIMPLE (default), COUNTERSINK, COUNTERBORE, or THREADED.
• diameter – a number, default 6.
• depth – a number, default 10; ignored when throughAll.
• throughAll – a boolean, default false.
• countersinkDiameter – a number, default 10.
• countersinkAngle – a number, default 82; the included angle in degrees, clamped to 1–179.
• counterboreDiameter – a number, default 10.
• counterboreDepth – a number, default 3.
• boolean – a boolean_operation, default { targets: [], operation: "SUBTRACT", mergeCoplanarFaces: true }.

Behaviour

• Placement centres are the sketch's model points in world space — every point that is not construction geometry, whatever its id. A new sketch starts with no points, so the first point you place is P0 and it is drilled like any other. Construction points (the sketcher's toggle, and the points a projected or linked model edge materializes) are references, not holes, and are skipped. Points are ordered by their numeric id, giving a deterministic subtract order, and coincident positions are de-duplicated at 1e-7.
• Axis: the sketch plane's normal, flipped so it points into the target, decided against the target's bounding box.
• Target: only the first entry of boolean.targets is the cut target. With no target selected the feature passes through unchanged; with a target name that does not resolve, the name is recorded as unresolved. A boolean.operation of NONE leaves the scene unchanged.
• Each cutter's base is pulled back slightly along −normal so the entry cut is a clean through-intersection rather than a tangent one.
• Cutter shapes: SIMPLE is a plain cylinder; COUNTERSINK and COUNTERBORE are exact revolved profiles.
• Face naming: each hole's faces are prefixed with its point's name, so a simple hole's walls land as {sketchId}:P{pid}_Hole_S, with _B the entry cap and _T the drill tip. The result reuses the target solid's name.

Limitations

• THREADED is symbolic only. No helical geometry is ever built: the cutter is a plain cylinder core at the crest diameter, geometrically identical to SIMPLE. holeType records the intent; nothing about the cut changes. NPT taper is not modelled either.
• Set diameter directly. Clearance-fit and thread-designation sizing tables are not implemented.
• A missing or unresolved placement sketch is a hard error — there is no silent air-drill.
• A sketch that holds only points is drawn in the model as its points (vertex markers on the sketch plane, no face, no edge); clicking one of them with the placement field active picks the sketch. A sketch with no model point at all (empty, or construction points only) is a hard error: no placement points.
• Also hard errors: a zero depth without throughAll; a COUNTERSINK whose countersinkDiameter does not exceed diameter; a COUNTERBORE with a zero counterboreDepth.

Where to find it

Offered in the Modeling and All workbenches. Type code H.