dymokomi/luced-3d
Source of release 0.11.6
0.11.6 / docs / research / SURFACING-ALIAS-PLASTICITY.md
# Surfacing for luced-3d: Alias, Plasticity, xNURBS, Parasolid and Rhino
Research and design, 2026-10-12. No product code was changed for this document. It answers the
owner's request:
> "For CAD work let's also look at Plasticity and Alias Automotive Studio for different tools,
> especially for doing blends and alignments and projections and trims and CV manipulations. I
> think Alias, XNurbs, Parasolid are good things to pay attention to."
It follows [FUSION-CAD-UX.md](FUSION-CAD-UX.md) (cited as **FUSION §n**). That document made the
CAD context a Fusion 360 workflow of sketches, solid features and direct modeling. This one covers
the tools that work on freeform surfaces and the curves that drive them, where Fusion is thin:
blends between surfaces, matching continuity across edges, projecting and trimming, building
surfaces from curves, filling holes, and editing control vertices (CVs).
The owner's rules apply throughout:
- full parity with the reference tools;
- degree 5 by default for freeform curves and patches, and G3 as multi-span quintic B-splines;
- hot geometry in Luce Base;
- learn from the references, never copy their code.
Sources:
- **Alias.** The current Alias help is built in JavaScript and could not be fetched. The static
reference pages of the 2014–2016 help sets could, and they are the main source:
- `help.autodesk.com/cloudhelp/2014/ENU/Alias/files/<Tool>.htm`;
- `help.autodesk.com/cloudhelp/2015/ENU/Alias-Reference/files/...`.
The 2023 reference, the 2025 and 2026 What's New pages, Autodesk tutorials and forums fill in
the rest. Option names have been stable since then, and later additions are marked (2025+).
- **Plasticity.** Its manual at doc.plasticity.xyz and the release notes there.
- **xNURBS.** xnurbs.com, its Rhino and SolidWorks release notes, McNeel's forum and blog.
- **Parasolid.** The V35.0 Functional Description (July 2022), read through an unofficial mirror
(`q-solid.com/Parasolid_Docs_V35/chapters/fd_chap.NNN.html`, where file NNN holds chapter NNN−1),
and Siemens' release-note blog posts.
- **Rhino 8.** Its help, `docs.mcneel.com/rhino/8/help/en-us/commands/<cmd>.htm`.
- **Our code.** luced-3d and luce-cad at `origin/main` on 2026-10-12 (luced-3d 3b09240), read.
Claims carry FUSION's tags:
- **[doc]**: the vendor's help or reference;
- **[comm]**: a forum, blog, tutorial or third party;
- **[unverified]**: not confirmed in a source.
URLs are given once, where a tool is first described.
## 1. Decision in one page
**These tools are a second modeling style.** Fusion's tools work on solids, through sketches and
features. Alias works on surfaces, through curves and their CVs, and it is built out of a small
number of ideas:
- **Curves come first.** Most surfaces are built from curves: free 3D curves, blend curves, curves
on surfaces, isoparms and edges. luced-3d has curves only inside planar sketches. There are no 3D
CAD curves, and no curves lying on a surface.
- **Every surface tool sets continuity per edge.** The choices are G0, G1, G2 or G3, with a
continuity check drawn on the model.
- **Continuity is matched by moving CV rows.** G1 is set by the row next to the edge, G2 by the
next row and G3 by the one after that. Align, Alias's central tool, does this to an existing
surface. Its sliders (Tangent Scale, Curvature Scale, G3 Scale) are the free parameters of the
match (§6.1).
- **Structure is explicit.** "Explicit Control" in every tool sets the degree and span count. CV
tools edit the net in world space, along the hull, or along the surface's normal and its U and V
directions.
- **Trims are curves on surfaces.** Projections and intersections make curves on surfaces. Trim
keeps or discards the regions they bound, or divides them into separate surfaces. Stitch joins
surfaces into shells.
**Plasticity and xNURBS add filling and a modern UX.** Plasticity runs on Parasolid (it began on
C3D). Its surfacing commands that need more than Parasolid offers (xNURBS, Square, Align) come from
the xNURBS library. xNURBS is an energy-minimizing ("variational") surface solver: it makes the
smoothest NURBS surface that meets the boundary at G0, G1 or G2. Its algorithm is not published,
but the method family is (Welch & Witkin 1992, Greiner 1994). Rhino 9's rewritten Patch follows
the same approach.
**Parasolid sets the bar for blends on solids.** Edge blends, face-face blends between surface sets
and three-face blends; conic, G2 and chamfer sections; four overflow behaviors; limits and caps;
setbacks and Y-blends. luce-cad already does Fusion's fillets. Parasolid's model is wider, and
Alias's Surface Fillet, Freeform Blend and Round are its surface-side counterparts.
**What we have.** luce-cad's blends, local operations and sketch Blend Curve; Edit CAD's CVs and
Patch levels; and zebra, isophote and curvature shading. These cover a few of the tools here
(§3). The rest is missing: 3D curves, curves on surfaces, every curve-built surface, Align, the
trims, stitching, N-sided fill, a NURBS structure toolkit, curvature combs and continuity checks.
**The plan** (§8) builds the measuring tools first, then the NURBS toolkit and CV editing, then
curves and trims. Align follows, then the surface builders, then blends and fill. Parasolid's
remaining blend options on solids come last.
| Stage | What it delivers |
|---|---|
| 0 | Measuring: exact curvature combs, continuity checks, deviation (Base: third derivatives). **Done** (§8) |
| 1 | The NURBS toolkit in luce-cad, and CV editing at Edit CAD's CVs level. **Done** (§8) |
| 2 | 3D CAD curves and curves on surfaces; Blend Curve in 3D, G0–G4. **Done** (§8) |
| 3 | Project, Intersect, Trim, Untrim, Divide, Trim Convert, Stitch; open surface bodies throughout. **Done** (§8) |
| 4 | Align (match) G0–G3, with every Alias option. **Done** (§8) |
| 5 | Surfaces from curves: Square, Skin, Rail, Profile, Set Planar, Extend. **Done** (§8) |
| 6 | Blends between surfaces: Freeform Blend, Profile Blend, Surface Fillet between face sets. **Done** (§8) |
| 7 | Fill: N-sided and four-sided variational patches (xNURBS parity). **Done** (§8) |
| 8 | Parasolid's blend options on solids: conic, overflow, limits, caps, Y-blends, corners. **Done** in part (§8) |
## 2. Shared ideas across the references
### 2.1 Continuity
- **Names.** Alias's menus read G0 Position, G1 Tangent, G2 Curvature, G3 Curvature. G3 is
defined as continuity of "the rate of change of curvature" [doc]
([Surface Fillet](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesMultiSurfacefilletSurfacefillet.htm)).
Older dialogs and the check locators say Position, Tangent, Curvature, with locators lettered P,
T and C. Align's Diagnostic Feedback also reports torsion [doc].
- **How high each tool goes.** Blend curves go up to G4 in Alias
([Constraint Continuity](https://download.autodesk.com/us/alias/2013help/files/BlendConstraintContinuity.htm))
and in Rhino (BlendCrv, BlendSrf) [doc]. Rhino's MatchSrf and MatchCrv stop at G2 [doc].
Plasticity's Bridge Curve goes to G3; its Align, Patch, Loft and xNURBS to G2 [doc].
- **Implied continuity.** Alias's Square and Rail also offer Implied Tangent and Implied Curvature,
which give continuity with the mirrored half across a symmetry plane. They also offer Tangent
Angle, a fixed angle to the neighbor [doc].
- **Degree needed.** Alias states the degree a continuity needs across a single span [doc]
(Freeform Blend, Profile Blend):
- G2 needs degree 4 on one side or 5 on both;
- G3 needs degree 6 on one side or 7 on both.
So Alias's G3 fillet sections are fixed at degree 7. We reach G3 at degree 5 with three spans
(eight control points: four rows from each side), as luce-cad's G3 fillets already do (its
MODELING.md, "G2 and G3 fillets"). Where a reference tool offers a single-span (Bézier) result, our
default is the multi-span quintic. Explicit Control lets a user ask for a single span of higher
degree (§10, question 2).
### 2.2 Explicit Control and Bézier patches
- **Explicit Control.** Alias tools carry an "Explicit Control" switch with the same meaning
everywhere [doc]:
- Off: the tool picks degree and spans. It raises the degree to the master's and inserts spans,
up to **Max. New Spans**. With **Insert at Midpoint** on, a span is split at its middle rather
than at the worst deviation.
- On: the user sets U and V degree and spans.
- In Align, Explicit Control is on by default and starts at the input's own structure.
Plasticity's Studio commands (Square, Align, Rebuild Face Explicit) expose the same as Degree and
Spans [doc].
- **Surface Type.** Alias's multi-surface builders (Surface Fillet, Freeform Blend, Profile Blend,
Skin, Profile, Tubular Offset, Draft) choose **Single surface** or **Multiple surfaces** (one patch
per input boundary pair) [doc].
- With Multiple, **Bézier Surfaces** makes each patch one span, U degree 5 by default.
- **Short Edge Tolerance** is the shortest span allowed when cross knots are inserted.
- **Surface Edit › NURBS to Bezier** splits any surface into single spans
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/GUID-CA27685F-1EC8-44B7-9088-92704B6FCE82.htm)).
- **Class A practice.** That class-A surfacers prefer single-span patches of degree 5 to 7 is
practitioner lore, not an Autodesk statement [comm]. An Autodesk tutorial does say that "many
A-class surfacers prefer the Align tool's direct control" over blend curves
([Blend curve tips](https://help.autodesk.com/cloudhelp/2019/ENU/Alias-Tutorials/files/GUID-0461C378-446B-4166-85FB-9D0DA0F6F9E8.htm)).
### 2.3 The tool window, history and checks
**Alias** [doc]:
- **Control window.** Each tool's options are in a "<Tool> Control" window. **Auto Update**
recomputes live; with it off, Update (or the space bar) recomputes.
- **Buttons.** Reset, Undo All or Revert, and **Next** (finish this one and start another).
- **History.** **Create History** keeps construction history: edit an input and the result is
rebuilt. Query Edit reopens a tool on an object that has history.
- **Continuity Check.** Draws P, T and C locators along the boundaries, green when met and
yellow or red when not.
- **Chain Select.** Takes every tangent-continuous edge or curve.
- **Flow Control.** Says how the cross edges at Start, Interior and End meet the boundaries: Edge
align, Extend, Connect ends, or Default/Free (square to the boundary). Clicking the label on the
model cycles the choices.
- **Modify Range.** Start and End sliders, 0 to 1, with arrows on the model.
- **Variable values** (radius, offset, angle). A slider ball runs on a rail, with a value handle
beside it. A modifier click on the rail adds one; a modifier right click deletes one.
- **Vector Options** (Project, Trim, Align's Project, Draft): X, Y, Z, View (the view's normal,
refreshed on request), Picked (a vector object), or Normal (each point's surface normal).
**Retain Vector** keeps a reusable vector object.
**Plasticity** [doc] (doc.plasticity.xyz: selection-mode, command-palette, radial-menu, command-bar):
- **Selection modes.** 1 control point, 2 edge or curve, 3 face, 4 solid or sheet. Shift adds a mode.
- **Starting a command.** Selecting often starts the likely command: edges start Fillet, a face starts
Offset Face, outer sheet edges start Extend.
- **Handles and keys.** A yellow dot drags the main value, and a floating dialog holds the rest.
Letter keys set a value by moving the mouse (D distance, A angle, Tab cycles a mode or
continuity). A right click is OK. Ctrl shows the original.
- **Per-edge continuity.** Set by clicking black circles drawn on each boundary (Patch, Loft,
Align).
- **Other ways in.** Shift+F offers commands for the selection, F searches commands, and radial
menus are user-defined.
**Rhino** [doc]: history per command (where "Delete input" is off); BlendSrf's Edit reopens a blend;
Shift makes edits symmetric; Alt changes a shape curve's angle.
**Our equivalents.**
| Their idea | Ours |
|---|---|
| Create History, Query Edit | A node in a CAD network: its inputs re-cook it, and selecting it edits it (FUSION §4) |
| A one-off result | An Edit CAD step |
| Control window, Auto Update | The parameter panel and the tool bar; every cook is live, on the worker |
| Next | Repeat, which leads the A and S menus (FUSION §6.5) |
| Continuity Check locators | Stage 0's check, drawn by the tool and as its own display |
| Black circles per edge | Per-edge continuity labels on the model, clicked to cycle (§7.3) |
| Variable value manipulators | The variable fillet's handles, generalized (§7.3) |
## 3. What we have, and the gaps
Checked in the code on 2026-10-12.
### 3.1 What exists
**luce-cad geometry** (`src/geometry/`):
- **Evaluation.** Rational B-spline curves and surfaces, degree 1 to 8 (`nurbs.lucb`; the basis
buffer is nine wide). Basis derivatives go to the second order only, so the third derivatives
that a G3 check needs are missing.
- **Point inversion** on B-spline surfaces (`inversion.lucb`): Newton from a seed, then a lattice
and Greville starts.
- **Surface-surface intersection by marching** (`modeling/march.lucb`), each curve fitted as a
cubic.
- **Knot insertion and degree elevation exist, but privately.** They live inside `spline_rays`,
`setback` and `strip_join`. There is no public knot removal, degree reduction, splitting, fitting
or rebuild.
**The B-rep:**
- **Edges** are 3D curves: lines, arcs, ellipses, and trimmed B-spline intervals. They carry no
parameter-space curves (pcurves).
- **Faces** are planes, cylinders, cones, spheres, tori and rational B-splines.
- **Tolerance.** One tolerance per model.
- **Open surface bodies.** They exist (Copy faces, the quilts Replace Face takes), but no tool
makes surfaces from curves.
**Blends** (luce-cad MODELING.md):
- **Fillets.** Edge fillets at G1, G2 and G3 (G2 one quintic span, G3 three); variable radius along
tangent chains; chord length; Full Round; setback corners for three edges (thin-plate least
squares, `patch_fit.lucb`).
- **Chamfers.** Equal, two distances, distance and angle; corner types.
- **Loops.** Loops between two curved faces.
**Local operations.** Offset, move, rotate, replace, delete with healing, split face, shell (FUSION
§9).
**Sketch** (planar):
- **Splines.** Fit-point and control-point splines (degree 5), and conics.
- **Blend Curve** joins two sketch curves' ends with a quintic at G1, G2 or G3.
- **Project** casts edges, faces and silhouettes onto the sketch plane only.
**Edit CAD**:
- **Levels.** Object, CVs, Edges, Faces, Smart, Patch. Patch is a whole surface, picked by its
`cad_surface`.
- **CV tools.** At the CVs level, CVs move with the gizmo, Rotate and Scale, and with Noise
(Mountain), Flatten and Snap. Soft radius and falloff are by 3D distance. Symmetry works. A
moved boundary CV takes its trims along (luce-cad `with_cvs_moved`, `with_cvs_at`).
**Viewport shading** (luce-3d `set_shading`). Zebra (stripes, duty, axis, planar, stripes only),
Isophotes, and Curvature (mean, Gaussian, k1, k2, largest |k|). All three read the tessellation.
### 3.2 Gaps
| # | Gap | Where it is needed |
|---|---|---|
| S1 | **Closed by Stage 0** (§8). Was: no third derivatives; no exact continuity measure along an edge (G0 gap, G1 angle, G2 and G3 differences); no curvature combs on curves, edges or isoparms; no deviation map. | Every tool's check; Stage 0 |
| S2 | No public NURBS toolkit: insert and remove knots, raise and lower degree, split, extract a span, make knot vectors compatible, reparameterize, fit within tolerance, rebuild, reduce spans, remove multiple knots, convert analytic faces to B-splines. Degree is capped at 8: Alias builds to degree 9, Rhino rebuilds to 11. | Every stage |
| S3 | CV editing has only world-space moves. Missing: moves along the normal and U and V (NUV); sliding along the hull; picking a whole hull row; falloff counted in CV rows rather than 3D distance; a proxy of the original hull; step size and drag strength; locked rows that keep continuity. | Stage 1 |
| S4 | No 3D CAD curves outside sketches, and no curves on surfaces. No isoparms as objects, and no duplicating an edge or isoparm as a curve. | Stages 2–7 |
| S5 | No Project or Intersect onto surfaces. The sketch's Project casts onto its own plane only. | Stage 3 |
| S6 | No trimming by curves: Trim, Untrim, Divide, Trim Convert. Split Face takes only a face or a plane. | Stage 3 |
| S7 | No stitching or unstitching of surfaces into shells, and no tolerant edges. | Stage 3 |
| S8 | No Align or match of a surface or curve to another, at any continuity. | Stage 4 |
| S9 | No surfaces from curves: Square, Skin (loft), Rail (sweep), Profile, Set Planar, Revolve or Extrude of a free curve to a sheet. Sweep and loft are luce-cad's limit 5. | Stage 5 |
| S10 | No Extend of a surface or curve (linear, natural, soft, reflective). | Stage 5 |
| S11 | No blends between surfaces: Freeform Blend, Profile Blend, a fillet between two face sets that need not share an edge (Parasolid's face-face blend), 3D Blend Curve, Tubular Offset. | Stages 2, 6 |
| S12 | No N-sided or four-sided fill with continuity (xNURBS, Alias N-sided, Rhino Patch). | Stage 7 |
| S13 | Blends on solids lack conic (rho) and Bias, Lead and Form Factor sections; one-sided curvature; Parasolid's overflow choices (smooth, cliff, notch); limits and caps; Y-blends; vertex blends; corners of more than three edges; delete and identify blends beyond healing. | Stage 8 |
| S14 | No corner tools between existing surfaces: Ball Corner, Corner Blend, Bridge Fillet. | Stage 8 |
## 4. Alias AutoStudio
### 4.1 Blends
**Surface Fillet** (Surfaces › Multi-Surface Fillet) [doc]
([reference](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesMultiSurfacefilletSurfacefillet.htm),
[workflow](https://help.autodesk.com/cloudhelp/2015/ENU/Alias-Modeling/files/Create_a_fillet_surface.htm)).
- **What it joins.** A fillet between two **sets of surfaces**. They need not share an edge, and a
tangent break splits a set by itself.
- **Picking.** An arrow on each set shows the side; a click flips it. Build makes the fillet, and
history lets surfaces be added to or taken from either set.
- **Construction.** Radius (rolling ball) or Chord. Chord's Chordal Type is the distance between the
contact lines, or the tangent length.
- **Section Type:**
- G0 Chamfer;
- G1 Circular;
- G2 Curvature;
- G3 Curvature;
- Bias (peak radius pushed toward one set by a Bias Factor, negative toward set 1);
- Lead (peak radius plus a tangent offset, tangent both sides).
- **Curvature** (None, Side 1, Side 2, Both). G2 or G3 on one side only; for Bias, G2 and G3.
- **Radius sizing.** **Specify** is Center Radius (the radius at the section's middle), Tangent
Offset (the ball touching both inputs) or both. For Bias and Lead it is Peak Radius or Knee Ratio
(peak over tangent offset).
- **Form Factor**, 0.1–2: the ratio of inner to outer CV arm lengths. Smaller is sharper.
- **Variable Fillets.** Radius or chord set at points along the fillet with handles.
- **Explicit Control.** U degree 2–9. V degree 3–6 for G1, 5–7 for G2, 7 for G3. Max. Spans, or
Uniform Spans.
- **Flow Control.** Edge align, Extend or Free at Start, Interior and End. **Modify Range** sets
the ends. A forum fix for many failures is to set Flow Control to Default
([forum](https://forums.autodesk.com/t5/alias-forum/problems-with-round-tool/m-p/6848254)) [comm].
- **Surface Type and Trim.** Surface Type and Bézier (as §2.2). Trim Type is Automatic (the inputs
trimmed back to the contact lines), Curves-on-surface (the contact curves only) or Off.
- **Checks.** Curvature Comb on the result: drags change its density and slide it along (2025.1).
Continuity Check.
**Symmetric Fillet** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/GUID-3D7BE61C-2D8F-4A4B-883B-B54560A1D778.htm)):
the fillet across a symmetry plane, with the same section types and Flip Fillet.
**Freeform Blend** (Surfaces › Multi-Surface Blend) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesMultiSurfaceblendFreeformblend.htm)).
- **What it joins.** A blend between two picked contact lines rather than a radius. Each side is a
chain of surface edges, isoparms, curves on surfaces or free curves.
- **Continuity.** Side 1 and Side 2 each G0–G3. A side of free curves only is G0.
- **Shape.** **Side 1 / Side 2 Shape**: above 1 is tighter toward the corner, below 1 rounder.
**Lock Shape Controls** keeps the two alike.
- **Proportional Crown** with a Crown Value (−0.25 to 0.25 of the rail distance), when both sides
are G0.
- **Structure.** Explicit Control (U degree 2–9, Max. Spans). Flow Control (Edge align, Connect
ends, Free). Modify Range for both sides. Surface Type and Bézier. There is no trim option.
**Profile Blend** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesMultiSurfaceblendProfileblend.htm)).
- **What it adds.** Freeform Blend shaped by any number of **profile curves** placed between the
sides: blend curves, free curves or surface boundaries.
- **Options.** Side 1 / Side 2 continuity G0–G3. **Interior Edge Align** (off: the cross edges meet
at 90°).
- **A stated limit.** Between several blend patches only G1 is guaranteed, even when the sides are
G2.
**Round** (Surfaces › Round) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesRound.htm)).
- **What it does.** Rounds many edges at once and builds the corner pieces.
- **Workflow.** Pick or box edges. Set radii on handles; clicking the green line adds a radius
point, so radius can vary. Build. Revert keeps the handles.
- **Corner options:**
- **Equal Radius Corner**: Three surfaces, Triangular surface (one degenerate side) or With
setbacks (six surfaces);
- **Unequal Radius Corner**: Single Surface or With Setbacks;
- **Mitred Corner** (one edge of radius 0): Blended or Sharp;
- **Four Sided**: Single Surface or With Setbacks (eight surfaces).
- **Trim Type.** As Surface Fillet's.
- **How it differs from Surface Fillet.** An Autodesk course says Round needs exactly
coincident edges, is meant for many small detail fillets, and builds the three-fillet corner that
Surface Fillet does not
([course](https://www-pt.autodesk.com/learn/ondemand/course/alias-essentials/unit/4bvhzMxB6PmFmvqfTWNV9h))
[comm]. Round is G1 only.
**Ball Corner** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesBallCorner.htm)).
- **What it makes.** A corner patch between three fillets and a primary surface.
- **Shape.** Pivot Curve Length Ratio. Start and End Length Ratios. Center Adjust with Center
Height.
- **Continuity.** Position (the default), Tangent or Curvature.
- **Structure and trim.** Explicit Control (Side and Pivot degree 3, one span each, by default).
Trim Primary.
**Corner Blend** (2025+): where three or four surfaces meet, with Edge Shape sliders. Its Base
Curve Type is Fillet (Base Radius and Form Factor) or Freeform (contact points movable)
([2025](https://help.autodesk.com/cloudhelp/2025/ENU/Alias-WhatsNew/files/wn-whatsnewinalias2025/wn-alias-corner-blend-2025.html),
[2025.1](https://help.autodesk.com/cloudhelp/2025/ENU/Alias-WhatsNew/files/wn-whatsnewinalias2025/wn-alias-corner-blend-2025-1.html))
[doc]. The full option list could not be fetched.
**Bridge Fillet** (2025+): circular fillets joining three surfaces or sets, tangent to all three,
with an optional trim. In 2025.1 it gained Bézier in V and a Bridge Treatment option
([page](https://help.autodesk.com/cloudhelp/2025/ENU/Alias-WhatsNew/files/wn-whatsnewinalias2025/wn-alias-bridge-fillet-2025.html))
[doc].
**Tubular Offset** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesRollededgeTubularoffset.htm)):
- **What it makes.** A tube, groove or bump along a curve on a surface.
- **Options.** Variable radius on handles; Flip (groove to bump); Tangent and Normal offsets;
Bézier; trim of curves on the surface, or of the inside of the tube.
- **Its neighbors.** **Fillet Flange** builds a wall, a fillet (G1 or G2, Form Factor) and a flange
together. **Panel Gap** and **Tube Flange** are the other "rolled edge" tools.
**Blend Curve toolbox** [doc]
([Create](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/BlendCurvecreate.htm),
[Edit](https://download.autodesk.com/us/alias/2013help/files/Blendcurveedit.htm)).
- **What a blend curve is.** A free curve defined by constraints at **blend points**: a position,
and continuity to a curve or surface. It stays associated with what it touches.
- **Create:**
- Knot Spacing: Uniform (the default) or Chord;
- **Curve Degree**: 1, 2, 3, 5 (the default) or 7;
- Auto Align at Surface Corners;
- Curve to Curve Continuity: G2 or G0;
- Pivot Position;
- (2025.1) **Curve Shape**: Relax (long, loose) or Tight (shorter, fixes inflection kinks).
- **Constraints**, set per blend point:
- Continuity G0–G4;
- Interpolation Direction: location only, a fixed direction, or relative to the object;
- Direction Type: one sense, or parallel either way;
- **Curvature Type**: Parametric (along the surface's isoparm, for G2 to an edge) or Geometric (in
the plane of the normal and the direction).
- **Blend Curve Edit.** A handle on each blend point for position, tangent length and tangent
direction, with separate Tangent and Curvature handles. Picking both points edits them
symmetrically.
### 4.2 Align
Object Edit › Align › Align, since 2009 [doc]
([reference](https://help.autodesk.com/cloudhelp/2015/ENU/Alias-Reference/files/ObjectEditAlignAlign.htm),
[workflows](https://help.autodesk.com/cloudhelp/2015/ENU/Alias-Modeling/files/Workflows_for_the_Align_tool.htm)).
**Picking:**
- Click the **input** edge (the one that changes), then the **master**. The master may be a surface
edge, an isoparm, a curve on a surface, a trim edge or a free curve.
- On a curve, click near the end to align.
- Two masters, at both ends or on opposite edges, live in one history item, and a label on the
model switches between them.
**Options:**
- **Continuity**: G0, G1, G2, G3.
- **Alignment Type:**
- **Edge** (the default);
- **Project**: the input edge is projected onto the master along a vector, and a curve on the
surface is made so the master is trimmed. Shrink to Fit; NoCOS skips the curve.
- **U/V**: a curve to a surface;
- **Vector**: only along a chosen vector.
- **Vector** (Edge type, G1 and G2): G0 first, then the tangent and curvature rows move only along
the vector.
- **Position Influence**, 0–1. At 0 the input keeps its own parameterization and its CVs move least
(nothing moves if the fit is already within tolerance). At 1 the input takes the master's
parameterization: a better fit, but CVs may slide sideways. This is the nearest Align comes to
"proportional or fixed".
- **Tangent Balance.** Sets the tangent and curvature row lengths so their start and end ratios
match the master's, mimicking the master's inner hull. The scale sliders then work in proportion.
- **Blending.** **Extra CV Rows** carry the change further into the surface; the continuity rows
are left alone. **Blend Factor**: positive decays the change exponentially, 0 linearly, negative
grows it.
- **Partial** (off by default for surfaces). The input aligns to the nearest part of the master.
Start and End sliders have arrows that snap to the master's ends.
- **Explicit Control** (on): the input's degree and spans, shown and editable. Off: the degree is
raised to the master's and spans are inserted until continuity holds.
- **Outer Edge** (G1 and up): Start Align and End Align are Edge Align (the side edges follow the
neighbor's edge) or **Skew**, with an angle and a rotation handle. **Align Start/End Together**.
- **Tangent and curvature rows:**
- Starting and Ending **Tangent Scale**, **Curvature Scale** and **G3 Scale**;
- **AutoScale G2** or **AutoScale G3** keeps the rows' relative lengths as one is scaled;
- on the model, outer arrows scale each end and a middle arrow slides the whole row.
- **Curves only.** **Attach Point**, 0–1, on the master.
- **Display and checks:**
- **Continuity Check** with its type;
- **Enable Proxy Display**: a green ghost of the original hull;
- **Diagnostic Feedback**: the smallest and largest Position, Tangent, Curvature and Torsion
deviations, and the start and end angles;
- dashed edges where the current constraints cannot be met.
- **Buttons.** Reset, Update. **Revert** removes the history and restores the original.
**Accept / Restore** checkpoint a series of aligns.
**Align 2008** (legacy) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/ObjectEditAlignAlign2008.htm)) keeps
options the 2009 tool dropped:
- **Modify**: First, Second or Both (meeting in the middle).
- **Intersection**: Fixed (the end points stay, tangent CVs move) or Free (the reverse).
- **Alignment types**: proportional, by project, colinear (hulls parallel to the target's),
directional, perpendicular to edge.
- **Lock Position CV Row** and **Lock Tangent CV Row**.
- **Partial Joins**: T-Join, or General with Attach Hardness. Hard inserts multiple knots.
**Symmetry Plane Align** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/ObjectEditAlignSymmetryPlaneAlign.htm)):
makes a surface G0 and G1 (or G2) with its mirror half. Project For Position is on by default.
There is no separate curve Align or "Multi-align" in the help: curves go through Align itself, and
Accept chains aligns.
### 4.3 Project, Intersect, Trim, Stitch, Extend
- **Project** (Surface Edit › Create CurvesOnSurface) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditCreateCurvesOnSurfaceProject.htm)):
- Create curves on the surface, or free curves;
- Curve fit with degree and spans;
- Match original: projects the original edit points, so the span count stays similar;
- Vector Options (§2.3);
- history.
- **Intersect** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditCreateCurvesOnSurfaceIntersec.htm)):
surface with surface or with a plane, making curves on the first surface or on both, with
history.
- **Trim Surface** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditTrimTrimsurface.htm)):
- Picking: pick the surface and the curves (or with **3D Trimming**, curves off the surface,
by Project or Intersect).
- Regions: click region markers, then **Keep** or **Discard**, or **Divide**. Divide cuts each
picked region into its own trimmed surface.
- **Show Intersections** marks where curves meet (green) or dangle (yellow, red).
- In 2026 trim stages became editable, and a Curve Trim tool with history arrived.
- **Untrim** [doc]: Untrim Stages Last or All. Trims are kept as a stack of stages.
- **Trim Convert** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditTrimTromconvert.htm)):
a four-sided trimmed region becomes an untrimmed surface. Options: U and V degree and spans,
Switch U/V, Show Surface and Edge Deviations, Keep Originals.
- **Shell Stitch / Unstitch** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditStitchShellstitch.htm)):
- Stitch joins surfaces into a shell within a gap tolerance (0.0001–1, or the preferences'
Maximum Gap Distance).
- Detach periodic surfaces; detach single-curve boundaries (for CAD export).
- Keep originals is on by default, because unstitching may not give back the originals exactly.
- Shell booleans follow.
- **Extend** (Object Edit) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/ObjectEditExtend.htm)):
- **Linear** (straight on; a curvature break) or **Extrapolate** (keeps the rate of change of
curvature, adds no edit points);
- Merge (on);
- a distance or a percentage;
- Chain Select.
### 4.4 CVs and structure
**Transform CV** (Control Panel) [doc]
([page](https://help.autodesk.com/cloudhelp/2016/ENU/Alias-Reference/files/GUID-521240C9-D869-44CB-8E81-17FC8992FE20.htm)):
- **Operations:** Move, Rotate, Scale, Non-proportional scale, Pivot and Prop mod.
- **Modes:**
- **XYZ**: world;
- **SLIDE**: along the CV's own hull;
- **NUV**: the left button moves along the normal, the middle along U, the right along V;
- **PROJ**: along a hull line or vector, or held to a reference plane;
- **PARA**: parallel to a vector or hull line;
- **VIEW**: the screen plane;
- **ROT** and **NPSCL**: Prop mod only.
- **CV or HULL picking.** A hull pick takes the whole row.
- **Locks and sensitivity.** Lock X, Y, Z. Mouse sensitivity 1–100. Step size, and Lock step size
(arrow keys).
- **Proxy Display**: the original hull as a ghost.
**Proportional Mod** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/TransformModifyProportionalmod.htm)):
- **Falloff.** In U and V, −5 to 5. 0 is uniform, positive values damp distant CVs, and negative
values push them the other way.
- **Reach.** **Preceding # / Succeeding #** count CVs along U and V. Falloff is counted in rows,
not 3D distance.
- **Later versions.** 2026 replaced it with Soft Proportional Modification, which colors the
falloff and has a volumetric mode.
**Move CV Normal**: CVs along the normal or tangentially [doc].
**Insert** (Object Edit) [doc]
([page](https://help.autodesk.com/cloudhelp/2015/ENU/Alias-Reference/files/ObjectEditInsert.htm)):
one more span at a picked parameter, with a green preview of the new hull.
**Rebuild Curve / Rebuild Surface** [doc]
([curve](https://help.autodesk.com/cloudhelp/2015/ENU/Alias-Reference/files/CurveEditRebuildcurve.htm),
[surface](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfaceEditReuildsurface.htm)).
Types:
- **Curvature**: spans added where curvature is high, with Max Spans;
- **Reduce Spans**: within a tolerance;
- **Del Multi Knots**;
- **Uniform Knots**, with a CV count and a degree;
- **Match Knots**: to another object;
- **Non-rational**: surfaces only.
Rebuild Surface works in U, V or both, at degree 1–9. **MixMax Display** shows the deviation, and
the largest deviation is reported. The Modeling Control Panel's Rebuild fields change the degree
and spans of several objects at once, with the deviation to accept or cancel
([page](https://help.autodesk.com/cloudhelp/2016/ENU/Alias-Reference/files/GUID-F5A5E4DB-683E-4FAE-8869-3A3718FF57A9.htm)).
**Curve tools:**
- **Stretch** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/CurveEditModifyStretch.htm)):
reshapes a curve with handles on it while keeping its CV layout. Up to degree + 1 handles.
Parameter Locked or Floating.
- **Attach** [doc]: Blend (both ends move to meet, Blend Bias) or Connect (a straight span with
multiple knots).
- **Detach** and **Close** (Preserve Shape) [doc].
- **Duplicate Curve** [doc]: a free curve from an isoparm, an edge, a trim edge or a curve on a
surface.
### 4.5 Diagnostics
- **Diagnostic Shading** [doc]
([2023 index](https://help.autodesk.com/cloudhelp/2023/ENU/Alias-Reference/files/Menus/Object-Display-menu/GUID-9827166C-1FEC-4C74-A41D-DA808D5EA511.html)).
Modes:
- **Curvature Evaluation**: U, V, X, Y, Z, Mean, Gaussian, Principal Min, Principal Max, with a
radius ramp and min/max radius limits;
- **Zebra**: horizontal or vertical, Lock Texture or camera-projected, repeats, thickness, light
linked to the camera or set by azimuth and elevation;
- **Isophote**: count, thickness, sharpness, camera vector or fixed light;
- **Light Tunnel**;
- **Iso Angle**;
- **Draft Angle**;
- **Deviation Map**.
**Layer** overlays curvature or zebra on another shader.
- **Evaluate › Surface Continuity** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/EvaluateContinuitySurfacecontinuity.htm)):
- Find Positional, Tangent or Curvature breaks, checked by arc length or a number per span.
- The locator stays live. Check Interior looks at multiple-knot isoparms inside the surface.
- Labels: the largest in red, the smallest in blue.
- Show Comb draws the gap, tangent and curvature breaks as combs.
- Curvature is checked relative to the boundary, square to it.
- **Curve Continuity** [doc]: Simple (a green or red circle) or full P/T/C display.
- **Locators › Curve Curvature** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/LocatorsCurvecurvature.htm)):
- a live comb plotting curvature, radius or unit normal;
- Surface Relative (along the surface normal for curves on a surface);
- auto or log scale; samples with a drag handle;
- Comb, Outline or both; torsion quills;
- **inflection points** as red arrows;
- a radius limit: green quills inside the range, rose outside;
- min and max radius (2025.1: computed apart from the comb's density).
- **Evaluate › Highlights** [doc]: highlight lines as real curves on the surface, from parallel
lights.
- **Dynamic Section** [doc]: live section planes with curvature combs.
- **Deviation Map** [doc]: ramp distance, acceptable distance, bands.
- **Gap Check** (2025): gaps along a guide curve, with a min/max comb.
### 4.6 Surfaces from curves
- **Square** (four boundaries) [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesBoundarySurfacesSquare.htm)):
- **Continuity per edge**: Free, G0, G1, G2, Implied Tangent, Implied Curvature, or Tangent Angle
with a handle.
- **Rebuild per edge.**
- **Blend Type**: Linear or Cubic. 1-3 and 2-4 Boundary Blend (the middle of each pair's
influence) and Influence.
- **Colinear Options**: isoparms line up with the neighbors'.
- Explicit Control; Max. New Spans, Insert at Midpoint.
- Boundary Labels and Continuity Check.
- **Rail Surface** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesSweptsurfacesRailSurface.htm)):
- **Generation curves**: 1, 2 (Gen. Blend Value) or more. **Rail curves**: 1 or 2.
- **Continuity per edge** as Square's. Rebuild per curve.
- **Sweep Mode**: Proportional, Spine, View, Parallel, Natural.
- **Sweep Pivot** (one rail).
- **Transform Control** (two rails): Rotate No Trim, Rotate & Trim, Non-Prop Scale, Scale.
- Fixed Curve. Curve Segments (start and end picked on the curves). Colinear Options.
- Explicit Control.
- **Skin** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/GUID-3CC0C09F-BABF-4463-B7DD-ADBD27C617E8.htm)):
- a loft through curve sets, open or closed;
- Proportional Crown;
- U and V degree 1–7;
- Flow Control (Connect Ends by default), Modify Range;
- Surface Type, Bézier.
- **Profile** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/GUID-F7BB3BC4-43A9-4141-8E66-5821C2453BF2.htm)):
- rails with profiles placed on them;
- Orientation: Parallel, Radial or Surface Normal;
- Transition: Linear, Local, Global or Limited (no overshoot);
- Match Parameterization.
- **N-sided** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesBoundarysurfacesNsided.htm)):
- a trimmed patch over N boundaries;
- per edge Free, Position (the default), Tangent or Curvature;
- trim curves Linear or Cubic;
- surface degree 1–7, 3 by default;
- **Center Adjust** (height and weight); Smoothing Weight; Max. New Spans;
- per-edge continuity feedback.
- **Set Planar** [doc]: a trimmed planar fill of closed curves.
- **Multi-Surface Draft** [doc]
([page](https://help.autodesk.com/cloudhelp/2014/ENU/Alias/files/SurfacesDraftsurfacesMultisurfacedraft.htm)):
- draft or normal walls from edges or curves, at an angle and length;
- Double Sided; Intersect Flanges;
- V degree 1.
## 5. Plasticity, xNURBS, Parasolid and Rhino
### 5.1 Plasticity
**Kernel.** Plasticity began on C3D, as the open-source repository's `lib/c3d` shows. It moved to
Parasolid. Wikipedia and Digital Production (October 2023) both say it runs on Parasolid
([Wikipedia](https://en.wikipedia.org/wiki/Plasticity_(software)),
[Digital Production](https://digitalproduction.com/2023/10/04/plasticity-3d-cad-for-artists/)), and
Nick Kallen wrote in March 2022 that he was considering the switch
([post](https://x.com/nk/status/1507667984357203971)) [comm]. luce-cad's CAD-MODELING-STUDY dates
the move "around 2024–2025". The sources above put it in 2022–23 [unverified, exact date].
**xNURBS.** It is a separate surfacing library on top of Parasolid. Since 2024.1 it is in the Studio
tier only (xNURBS, Square, Align, Rebuild Face Explicit)
([licenses](https://doc.plasticity.xyz/getting-started/license-types-and-features)) [doc].
**The surfacing commands** (doc.plasticity.xyz, the page named after each) [doc]:
- **Fillet** (`solid/fillet-shell`):
- Drag the yellow dot one way for a fillet, the other way for a chamfer.
- **Shape**: Conic, Chordal (constant chord), G2, Full (full round).
- **Tension** (2025.2), for every shape but Full.
- **V** adds a variable-radius point. **L** adds up to two limit points that stop the fillet,
clicked again to flip.
- Y-Blend "Attempt" for three fillets at a corner. Add tangent edges.
- Chamfer shapes: Offset or Apex.
- **Remove Fillets From Shell**: by maximum radius and convexity, a Parasolid-style defeature.
- **Bridge Curve** (`sketch/bridge-curve`):
- Ends picked on curves, edges or faces, each with a parameter and a sense.
- Per end G0–G3, and three **tension tiers** per end: tension 1 moves CVs 1–3, tension 2 CVs 2–3,
tension 3 CV 3.
- 2025.2: the tensions are set by dragging the visible CVs, and a comb shows.
- Trim.
- **Bridge Surface**: between two sheets, or two crossing surfaces. Width, Tension, Shape (G2 or
Chamfer), Trim walls (Both, Short, Long, None).
- **Loft**:
- Profiles, then guides.
- Per end G0–G2 by Tab or the black circles. Per edge tension.
- Limit points; Loop.
- **Simplify** (on: planar trimmed patches; off: a consistent CV layout).
- Guides that miss a profile show a red dot.
- **Sweep**: twist, scale at the end; alignment Parallel or Normal; guides by Point, Chord or Curve;
corner Mitre or Round.
- **Patch** (Parasolid's fill, not xNURBS):
- Inputs: closed curves, edge holes, guide curves (each needs an isoparm where it touches), or
every hole at once to close a solid.
- **Per-edge** Planar, G0, G1 or G2.
- Faces: Single, Minimal or Quality.
- Method: Trim to hole or Trim to sheet.
- **xNURBS** (`solid/xnurbs`):
- Inputs: boundary edges, and open guide curves that need not touch the boundary.
- Continuity G0, G1 or G2. The page shows one setting; whether the per-edge circles apply here is
[unverified].
- **Quad sided**: an untrimmed four-sided result.
- **Flatness** (0.95–1 for quads). **Tension** 0.1–1 (quads).
- **Boundary** flow: Natural, Normal (isocurves square to the boundary), Next, Adjacent (V
isocurves follow neighboring trimmed edges).
- Quality Auto, High or Max. Satisfy tolerances.
- An N-sided result is one trimmed surface.
- **Square** (xNURBS, Studio):
- Continuity Free, G0, G1 or G2. Flatness. **Per-edge tension** (2025.2).
- Degree and Spans in U and V. Boundary flow as xNURBS's.
- **Weight**: lower relaxes the boundary for better reflections; higher enforces it.
- Analysis.
- It also serves as Loft, Sweep, Patch and **Refit Surfaces**: a trimmed four-sided face rebuilt
with spans that follow its flow.
- **Align** (xNURBS, Studio, 2025.2; `solid/align-surface`). Plasticity's match surface:
- Per edge G0–G2. Tension.
- **Blend extra rows**, and **Input shape influence**.
- **Partial start / end**.
- Degree and Spans; Boundary flow.
- Analysis with per-level comb scales.
- Several neighboring surfaces at once.
- B-spline surfaces only: analytic ones need Rebuild or Raise Degree first.
- 2026.1 added curve-to-curve and vertex-to-vertex G0–G3.
- **Match Face**: not continuity. It replaces faces with a target surface (Parasolid's replace),
with Grow Moving, Fixed or None.
- **Project Curve** (I): Normal or Vector, bidirectional, hide occluded, screen space.
- **Imprint Curve** (Shift+I): the same, plus **Completion**: None, Edge (extend until it meets
edges) or Boundary.
- **Cut** (by a curve or a face), **Untrim** (Keep edges imprints the old trims), and **Extend
Sheet**:
- Shape: Natural, Linear, Soft (G2), Reflective;
- limit to a target;
- the result stays one sheet.
- **Offset Face** (Push Face):
- **Angle Adjacent** tilts the neighbors.
- Grow Moving, Fixed or None.
- **Dependent Offset** runs until the face meets a picked one.
- **Thicken, Hollow, Draft Face.** Draft Face has methods Isocline, Curve, Surface, Offset and
Normal: Parasolid's taper methods.
- **Join Sheets** and **Unjoin**.
- **Control points:**
- Mode 1 shows the CVs of curves and faces, trimmed or not. A trimmed face is edited through its
hidden "nominal surface".
- **Move Control Point**: falloff None, All or Selected, measured in **UV hull distance**;
mirror across the C-plane.
- **Slide** (Shift+G) along the hull: U, V, or N for the normal.
- Alt-hover selects a hull row (2025.2).
- **Isoparam** (Ctrl+R): knot insertion, U or V, a count, and Subdivide to split the face.
- **Raise Surface Degree** (also turns analytic surfaces into splines).
- **Rebuild Face**: Explicit (degree, spans, extend, Shrink) or by tolerance. Rebuild Edge.
- **Rebuild Curve**: Refit, Points, or Explicit (degree, spans, Weight). Insert Knot. Raise Curve
Degree.
- **Analysis.** Measure Continuity (live G0–G2 between edge pairs, comb scales, maxima), curvature
combs, isophote and draft shaders.
### 5.2 xNURBS
**Who and what** [comm]:
- **The team.** Its people "previously held senior R&D positions at PTC" and spent over a decade
on "variational surfacing" ([about](https://www.xnurbs.com/about-us/)).
- **The kernel.** `xnkernel.dll` is licensed only to software vendors
([product](https://www.xnurbs.com/product/)). End users get it as a Rhino plug-in, a SolidWorks
add-in, or inside Plasticity Studio.
- **No Fusion use found.** A 2020 forum thread proposed an Alias module, with no visible outcome.
**The method** [comm]:
- **The claim.** "An energy-minimization method to generate the smoothest NURBS surface among all
possible solutions", explained with a bending batten
([home](https://www.xnurbs.com/), [Rhino blog](https://blog.rhino3d.com/2022/01/xnurbs-rhino-plugin-v52-released.html)).
- **The constraints.** Curves or points anywhere, each with contact, tangent or curvature
continuity ([forum, 2017](https://discourse.mcneel.com/t/xnurbs-releases-a-ground-breaking-nurbs-software/49049)).
- **Nothing published.** No paper or patent was found, under PTC or otherwise.
- **Our reading** [unverified]. A quadratic bending energy over a fixed NURBS net, with G0, G1 and
G2 conditions as constraints, refined where they fail, then trimmed to the boundary for N sides.
This is the published family below.
**Features by version** [comm] ([what's new](https://www.xnurbs.com/whats-new/)):
- **Per-edge continuity.** A demo sets one edge G1 and the others G0.
- **Rhino plug-in 5.2.** Boundary curves trimmed automatically.
- **7.0 (2025):**
- XNurbsSquare, with a user's degree and spans;
- interior points and curves on four-sided surfaces;
- two-, three- and four-sided and L-shaped domains;
- Tension; Align to Next;
- conflicting constraints shown on the model.
**How others answered** [comm]:
- **Rhino 9 WIP Patch, reimplemented** (February 2025,
[forum](https://discourse.mcneel.com/t/rhino-wip-feature-patch-re-implemented/198660)):
- "a thin membrane with elasticity and internal strain under bending";
- per-edge constraints I, G0, G1 or G2;
- Stiffness; degree 3–5; U and V spans; a starting surface;
- position, normal and internal tolerances, with **Refine** adding CV lines where a constraint
fails;
- domains Untrimmed, MultiBlend (several quads), Projected or Molded.
- **Rhino 9 MultiSidedPatch**
([forum](https://discourse.mcneel.com/t/rhino-9-feature-multi-sided-surface-patches/194768)):
- a transfinite patch: ribbons per side blended by generalized barycentric coordinates;
- Fullness; G1 to edges, no G2 yet.
- **Benchmark.** A 2025 paper (Li and Li, "An Improved N-Sided Filling Algorithm Based on GNURBS
Surface", J. CAD & CG) reports about 70% fewer control points than xNURBS for the same error.
**Background.**
- **Coons** (1967) and **Gordon** (1971): transfinite interpolation of four curves, and of a curve
network.
- **Gregory** (1974), **Chiyokura & Kimura** (SIGGRAPH 1983), **Charrot & Gregory** (CAGD 1984):
G1 patches over three, four and five sides.
- **Variational surfaces.** Celniker & Gossard (SIGGRAPH 1991), Welch & Witkin "Variational surface
modeling" (SIGGRAPH 1992), Moreton & Séquin (SIGGRAPH 1992), Greiner "Variational design and
fairing of spline surfaces" (Eurographics 1994): minimize ∫|S_uu|² + 2|S_uv|² + |S_vv|² under
linear constraints.
- **Transfinite N-sided patches.** Várady, Salvi and Rockwood (CAD 2011, CAGD 2014); the
Generalized Bézier patch (CGF 2016); Midpoint patches (2020); the survey "Genuine multi-sided
parametric surface patches" (CAGD 2024).
### 5.3 Parasolid
From the V35.0 Functional Description, chapters 46, 48, 62–78 and 16–17 [doc].
**Three blend families** (overview chapter 11):
- edge blends, which replace edges;
- face-face blends between two wall sets, which need not touch or be in one body;
- three-face blends, full rounds whose middle wall is consumed.
**Edge blends** (chapters 74–76):
- **Set, then fix.** Blends are first set on edges as attributes, then **fixed** together in one
call. Parasolid resolves how they interact, so the caller never chooses an order.
- **Three types:**
- constant rolling ball: circular or curvature-continuous section;
- chamfer: face-offset, or apex-range (measured from where the walls' tangents meet);
- **variable rolling ball**: radii at two or more positions, circular, conic or G2 section.
- **The blend surface is procedural**:
R(u,v) = C(u) + r X(u) cos(v a(u)) + r Y(u) sin(v a(u)), C being the ball's center (the spine).
It is simplified to a cylinder or torus where it can be.
- **Section shape:**
- **conic** by default: a circle when both sizes are equal, else a least-tension ellipse; with
**rho**, any conic;
- **G2**: matches each wall's curvature at the contact;
- **chamfer**.
- **Rho can be given three ways:**
- absolute: 0.5 parabolic, below elliptic, above hyperbolic;
- relative to the angle subtended;
- as the radius of curvature at the section's middle.
Clamp indices hold the rate of change at given positions.
- **Fix-time options:**
- **Cliff edges**: the blend is tangent to one wall and runs along an edge of the other.
- **Y-blends**: two blends of different convexity meeting at a vertex of three or more edges.
- **Setbacks**: per edge distances from a vertex, the gap patched, with or without collar faces.
- **Vertex blends**: roll past sharp edges of the other convexity.
- **Round order** at mixed-convexity corners: concave first, convex first, minority or majority
convexity.
- **Limits**: at a vertex, at a point on an edge (the plane through it caps the blend), or where
blends start to overlap.
- **Caps**: faces, planes or sheets.
- **Limit topologies**: trim along the blend's isoparameter where it crosses faces, with a
blend-like patch between limits.
- **Transfer**: topology a blend covers, such as a hole, is moved into the blend face.
- **inside_tight**: walls tighter than the radius.
- **Previews**: output the blend as a separate sheet, always or on failure. `suggest_limit`
returns where to stop a failing blend.
- **Tracking** of which walls each blend face came from.
- **Overflow** (chapter 76), where a blend runs off a face next to its edge:
- **smooth**: the blend continues on the next face; all bounding edges must be smooth;
- **cliff**: cliff-edge blends round the overflow region;
- **cliff end**: a cliff-edge blend at the chain's end;
- **notch**: the blend is unchanged and the neighbors are extended or trimmed.
The default order is smooth, then cliff, then notch. A table of defaults by convexity and edge
smoothness is given in the chapter. SolidWorks' "Keep edge / Keep surface" overflow choice
probably maps onto these [unverified].
**Face-face blends** (chapter 77) are built from three independent choices:
- **Section plane:**
- rolling ball (square to the walls);
- **disc** (square to a given spine);
- **isoparameter** (along the left wall's isocurves, for turbine blades).
- **Size or boundary:**
- radius, or two ranges;
- range laws along a spine;
- **constant width** (the chord between the contacts, with a ratio);
- variable width;
- apex-range chamfers;
- or **holdlines**: a tangent holdline gives one boundary and the blend's radius varies to meet
it; a conic holdline sets one side's range; cliff edges; inverted holdlines.
- **Section shape:**
- conic with rho;
- chamfer;
- **G2**, with depth (0 at the chord, 1 at the walls' tangent intersection) and skew (0 at the
left wall, 1 at the right), or a **softness** (higher is flatter and deeper, lower is "like a
chamfer with rounded edges").
Further options:
- **Trim** to the walls, none, long or short.
- **Walls**: untrimmed, both trimmed, attached (two bodies united) or made a solid.
- **Limit planes**, **caps**, and a **run-out angle** that stops the blend where the walls become
too shallow.
- **Help points** choose among several solutions.
- **Ribs**: section curves, output for an outside surfacer when the blend fails.
- **prevent_sharp** smooths kinks from G2 breaks in the walls.
- **user_surface**: you supply the blend's surface.
**Three-face blends** (chapter 78): walls up to 260° apart, against 180° for face-face blends.
**Recognition and editing** (chapters 62–64):
- **Finding blends.** `PK_FACE_identify_blends` finds constant rolling-ball blends and blend-like
B-surfaces.
- **Removing blends.** `PK_FACE_delete_blends` removes them and heals, knowing what blending
changed. Delete with **heal** caps, shrinks or grows the neighbors.
- **Editing blends.** A blend's radius is changed through `PK_FACE_change`, which rebuilds blends
when their walls move ("reblend"). v38 extends this to constant-width blends with overflows
([v38](https://blogs.sw.siemens.com/plm-components/whats-new-in-parasolid-v-38-0/)).
**Local operations** (chapters 58–72):
- **One growth rule.** Offset, taper, transform, hollow, thicken and face change share it:
moving faces grow, fixed faces grow, caps, automatic, or fail.
- **Offset**: G1 and exact, simplified to analytic surfaces where possible. Optional rolling-ball
blends on convex offset edges.
- **Taper**: Isocline (molds), Curve, Surface, Offset, Normal; step tapers; parting edges.
- **Replace surfaces**, **replace with sheet**.
- **PK_FACE_cover**: one fitted B-surface over a smooth face set.
- **Fill hole** (`PK_BODY_fill_hole`):
- methods: create patch, trim a supplied sheet to the hole, trim to sheet, extend the neighbors;
- G1 or **G2** (G2 needs the quality setting);
- per-edge relaxation (non-smooth edges, non-G2 edges);
- supporting wires, or a point the patch passes through;
- single, multiple or minimal patch topology;
- prefer planes or analytic surfaces.
- **PK_FACE_change**: offset (or dependent offset, tracking a reference face), taper, transform,
replace, reblend, bend, patch, deform and radiate, in one call.
- **Extension** (`PK_BODY_extend`): linear (the default; may break G2), **soft** (C2 at the
boundary, tending to linear) or **reflective** (C2, mirroring the shape).
**Sheets and tolerance:**
- **Sewing** (`PK_BODY_sew_bodies`): sheets joined within a gap bound, run incrementally with
growing bounds. Knitting is separate.
- **Tolerant modeling** (chapter 16): a precision per edge (a tube) and per vertex (a sphere).
Tolerant edges carry curves in each face's parameter space (SP-curves). `PK_EDGE_repair` sets
them.
- **B-geometry tools**: raise and lower degree, add and remove knots, clamp, reparameterize,
extend; a constrained B-surface through points and normals; lofting; isoclines.
- **Rules for a valid B-surface face**: no zero first partials except at legal degeneracies, no
self-intersection, no cusps except at knot lines.
### 5.4 Rhino 8
`docs.mcneel.com/rhino/8/help/en-us/commands/<command>.htm` [doc].
- **MatchSrf:**
- Continuity: Position, Tangency or Curvature (the default).
- **Preserve other end**: None, Position (the default), Tangency or Curvature. The structure
changes so the opposite edge does not move.
- **Average surfaces**: both move to meet.
- **Match edges by closest points.**
- **Refine match**: adds knots until within a distance, an angle and a curvature percentage.
- **Isocurve direction**: Automatic, Preserve, Match target, or Perpendicular to the target edge.
- Multiple matches. Match to a curve pulled onto a surface.
- **Match** (curves): Position, Tangency or Curvature; Preserve other end; perpendicular to an edge;
average; join; merge.
- **BlendSrf:**
- Per end Position to G4.
- Two bulge sliders with a lock.
- **Add Shapes** (section lines) and Remove Shapes; Straighten with an angle threshold.
- Interior shapes, or Refine.
- Planar sections parallel to a direction. **Same height** for a varying gap.
- Alt turns a shape; Shift edits both sides symmetrically. Edit reopens a blend.
- **BlendCrv**: per end Position to G4; picked points or curve ends; perpendicular to edges; Edit;
Show curvature.
- **NetworkSrf**: tolerances for edge curves, interior curves and angle; per edge Loose, Position,
Tangency or Curvature.
- **Patch** (before Rhino 9):
- a surface fitted to sampled boundary and interior points, with a spring stiffness, over a
starting plane or surface;
- U and V spans;
- Adjust tangency (G1 to surface edges);
- automatic trim; Preserve edges.
- **Sweep1, Sweep2:**
- frames Freeform, Roadlike or Align with surface;
- Rebuild or Refit;
- Preserve first and last sections; **Maintain height**;
- rail edge continuity Position, Tangency or Curvature (when the rails are surface edges).
- **EdgeSrf**: from two to four curves or edges.
- **Fillets and chamfers:**
- **FilletEdge**: rail type DistFromEdge, RollingBall or DistBetweenRails; handles add radius
points.
- **FilletSrf**: Arc, Deformable (degree 3–5, tangent and bulge) or G2; trim and extend.
- **VariableFilletSrf**, **ChamferSrf**.
- **Project**: along CPlane Z, the view or a custom direction; Loose. **Pull**: along the normal
(closest point).
- **Trimming:**
- **Trim**, **Split** (at an isocurve, with Shrink), **Untrim**.
- **ShrinkTrimmedSrf**: drops CVs beyond the trims; the shape is unchanged.
- **ExtendSrf**: Smooth or Line; Merge.
- **Structure:**
- **Rebuild**: point counts and degree up to 11. Retrim. **Calculate** colors the deviation
green, yellow or red.
- **RebuildUV**: one direction.
- **RebuildCrvNonUniform**.
- **ChangeDegree**: Deformable. The exact wording of what changes the shape was not confirmed
[unverified].
- **InsertKnot**, **RemoveKnot**, **RemoveMultiKnot**; **InsertControlPoint** (changes the shape);
**FitCrv**.
- **Point editing:**
- **MoveUVN**: U, V and N sliders with a scale; moves along the isocurves' tangents, along the
control polygon, or along extensions; symmetry and smoothing in U and V.
- **SoftEditSrf**: falloff distances in U and V, Fix edges, direction constraints.
- Gumball **Drag Strength** for fine moves.
- **Analysis:**
- **CurvatureAnalysis**: Gaussian, Mean, Min radius, Max radius, with auto or max range.
- **CurvatureGraph**: combs on curves and on surfaces' isocurves in U and V, scale, density.
- **Zebra**; **EMap**.
## 6. Algorithms we would need
Each is a luce-cad kernel in Base (`.lucb`): luced-3d calls it and draws what it returns.
### 6.1 Matching continuity across an edge by CV rows (Align, MatchSrf)
Let the input surface S meet the master M along S's edge u = 0. S's CVs in rows P₀, P₁, P₂, P₃ …
(row 0 on the edge). At a clamped end of degree p with knots t, the derivatives across the edge are
fixed by the first rows alone:
- S_u = p / (t_{p+1} − t₁) · (P₁ − P₀) (as B-spline curves along the edge);
- S_uu takes P₀ to P₂;
- S_uuu takes P₀ to P₃.
So G0 sets row 0, G1 row 1, G2 row 2 and G3 row 3. Each needs the rows below it.
**Geometric continuity.** Continuity of order k means that S's derivatives across the edge equal
M's after some reparameterization s = φ(u) with φ' = α > 0, φ'' = β, φ''' = γ. By the chain rule
(Faà di Bruno), with D the cross-boundary derivatives of M:
- G1: S_u = α D₁ + τ T;
- G2: S_uu = α² D₂ + β D₁ + (terms along T);
- G3: S_uuu = α³ D₃ + 3αβ D₂ + γ D₁ + (terms along T).
Here T is the edge's tangent and τ the skew.
- **The free parameters are Alias's sliders.** α, β and γ are Align's Tangent Scale, Curvature
Scale and G3 Scale. The skew τ is its Skew option. AutoScale keeps β and γ in proportion to α.
Fixing α to the master's own spacing is Tangent Balance.
- **Each row in turn.** Given them, each row is solved in turn, a linear back-substitution: P₁ from
S_u and P₀, P₂ from S_uu, P₀ and P₁, and so on.
- **Rhino's MatchSrf** is the same at G0–G2.
- **Vector mode** restricts each row's motion to a direction. Each row is then a least-squares
solve, still linear.
**When it is exact.**
- **The conditions.** The match is exact when M's cross-boundary derivative fields along the edge
lie in the space of S's B-splines along the edge, and α, β and γ are constants.
- **Making the spaces match.** For a natural (untrimmed) master edge, this holds after S is raised
to M's degree along the edge and M's knots are inserted into S. That is Alias's Explicit Control
off.
- **Position Influence.** At 0, S's own parameterization is kept, and the master's fields are
fitted in S's space by least squares. At 1, S takes the master's knots.
- **Approximate cases.** A trimmed master edge, a curve on a surface, or α varying along the edge
(Alias's Starting and Ending scales) cannot be exact. The rows are then fitted by least squares to
sampled targets. Refine (Rhino) inserts knots where a check fails, until the G0 distance, G1
angle, G2 curvature difference and G3 difference are within tolerance. Max. New Spans caps it.
**The rest of Align's options:**
- **Extra CV Rows / Blend Factor.** The change to the last constrained row is carried to the next k
rows with weights w(i/k): exponential, linear or growing, by the factor. The constrained rows
themselves are untouched.
- **Partial.** Knots are inserted (to full multiplicity) at the partial range's ends on S's edge.
The match applies inside the range and is tapered to zero over the extra rows outside it.
- **Two masters** (both ends, or opposite edges). Solve both when the row sets do not overlap; the
surface needs at least 2(k+1) rows across, eight for G3 at both ends. With degree 5 that is three
spans. Fewer rows are refused with the number needed, or spans are inserted when Explicit Control
is off.
- **Modify Both** (Align 2008, Rhino's Average). Both surfaces move toward a shared middle: P₀ is
averaged, then each side's rows are solved against the averaged field.
- **Curves.** The same with one row per end. Curve-to-surface matching uses the surface's derivative
in the chosen cross direction: along the isoparm (U/V) or square to the edge (Rhino's
"perpendicular").
- **Symmetry Plane Align.** The master is the mirror image of S: G1 sets row 1 square to the plane,
and G2 sets row 2 so the mirror's curvature matches.
### 6.2 Blend curves in 3D, G0–G4
A blend curve between two ends, each on a curve, an edge or a surface:
- **CVs fixed by each end.** An end at G_k fixes k+1 CVs from the end's derivatives, as in §6.1.
The shape parameters per end are tangent length α, curvature β, G3 γ, G4 δ.
- **Degree 5 and its spans.** The curve has 6 + (spans − 1) CVs, which must be at least the sum of
both ends' k+1:
| Both ends | CVs needed | Spans at degree 5 |
|---|---|---|
| G1 | 4 | 1 |
| G2 | 6 | 1 |
| G3 | 8 | 3 |
| G4 | 10 | 5 |
| G3 and G1 | 6 | 1 |
Alias builds degree 5 by default (§4.1), and so does our sketch Blend Curve. G4 needs five
spans at degree 5. Alias and Rhino reach it at degree 7 or 9 [comm].
- **CVs left free.** Free interior CVs minimize ∫|C'''|² with the ends fixed: one linear solve.
- **Default shape parameters.** Chosen from the chord length: Alias's Relax and Tight, and
Plasticity's tensions, are presets of α and β. Plasticity's three tension tiers per end move CV
groups 1–3, 2–3 and 3.
- **Ends on a surface.** The derivatives come from the cross direction chosen (Alias's Parametric
or Geometric curvature type). Geometric uses the normal section's curvature in the plane of the
normal and the direction.
- **Associativity.** Kept by the node: a moved end re-cooks.
The sketch's planar Blend Curve (`sketch_freeform.luc`) is the same algorithm restricted to a plane.
It should call the 3D kernel.
### 6.3 Projection and intersection onto faces
- **Along a vector d.** For samples t of a curve C, solve S(u,v) = C(t) + λd for (u, v, λ) by
Newton. The first seed is the face's lattice (`inversion.lucb`); later seeds are the previous
sample's solution.
- **Several hits.** Keep the nearest along d, or both ways (Plasticity's Bidirectional), or every
sheet (all hits).
- **Misses.** A ray that misses the face ends a piece. A piece reaching the face's boundary ends
on it, at the boundary curve's crossing.
- **Sampling.** Samples are adaptive by chord error in 3D.
- **Along the normal (Pull).** The closest point (`nearest_parameters`), with the same continuation.
- **The output is a curve on the surface.** It has two forms: a uv curve in the face's parameter
space, and a 3D curve. Both are fitted at degree 5 within tolerance (or the input's degree and
spans, Alias's Match original), and kept consistent: the 3D curve is the surface evaluated along
the uv curve, refitted.
- **Intersect.** `march.lucb`'s traced curves, kept with their uv parameters on both surfaces.
- **The missing link.** Today the B-rep has no pcurves. Curves on surfaces bring them, first as
data on the new trim edges, which is what Parasolid's SP-curves are (§5.3).
### 6.4 Trim, Divide, Untrim, Trim Convert
- **Trim:**
- The face's existing loops and the curves on it are laid out in the face's uv domain. Seams of
periodic surfaces are cut.
- luce-cad's sketch arrangement (`arrangement.lucb`: crossing curves split each other, smallest
regions) is the same problem in a plane, so it is reused on uv curves.
- Regions picked by a click (a point inverted onto the face) are kept or discarded.
- **Divide** makes each region its own face, with the dividing curves as shared edges.
- **Untrim.** The face's trim history is a stack of stages; Last or All pops them. Without history,
Untrim gives the natural surface (the untrimmed B-spline, or the analytic surface bounded by its
natural range).
- **Trim Convert.** A four-sided region's boundary curves are made compatible in pairs. A Coons
surface is fitted through them, then the interior is refined by least squares to the original
surface (deviation reported). The result is an untrimmed B-spline face.
- **Shrink.** A surface is cut down to the trim's uv box by knot insertion at the box (Rhino's
ShrinkTrimmedSrf); the shape does not change.
### 6.5 Stitch and tolerant edges
- **Stitching.** Boundary edges of sheet faces are matched within a gap bound: boxes in a grid,
then the distance between edges sampled both ways. A pair within the bound becomes one edge.
Each edge keeps a precision (a tube radius) and each vertex one (a sphere), as Parasolid's
tolerant edges do.
- **Orientation.** Shells are oriented consistently. A closed shell becomes a solid.
- **Unstitch** splits the shared edges again.
- **Growing bounds.** Sewing in steps (Parasolid's advice) avoids matching short overlaps first.
- **What changes.** Today a model has one tolerance (§3.1). Per-edge precision is a B-rep change,
and the booleans and the tessellator must read it.
### 6.6 Surfaces from curves
- **Compatibility first.** Curves that a surface interpolates are raised to a common degree and
given a common knot vector by inserting each other's knots. Where the knots are too many,
Rebuild with a tolerance comes first.
- **Square.**
- G0: a bilinearly blended Coons patch.
- G1 and G2: Hermite terms from each edge's neighbor, with twist compatibility at the corners
(Gregory's correction where the corners disagree).
- The result is then faired: §6.8's energy with the boundary rows fixed. Alias's Linear or
Cubic blend and its Influence are the weights of the Coons terms.
- **Skin (loft).** Interpolate compatible sections in the cross direction (degree 5 when there are
enough sections, else lower), or approximate.
- **Rail.** Sections swept along one or two rails:
- Frames: rotation-minimizing (Proportional, Natural), along a spine, parallel, or from a view.
- Two rails: each section moved, turned and scaled (non-proportionally under Non-Prop Scale) to
touch both.
- The surface: sections sampled along the rails, then fitted. With continuity to the rails'
surfaces, the first rows are set as in §6.1.
- **Profile.** Rail plus profiles placed by parameters, with transition laws (linear, local,
global, limited).
- **Set Planar.** The existing planar profile (`profile.lucb`), on a fitted plane, as a sheet face.
- **Extrude and Revolve of free curves** to sheets: the existing sweeps without caps.
### 6.7 Blends between surfaces
- **Freeform Blend and Bridge Surface.** The two sides are chains of curves on surfaces.
- **Matching the sides.** Both are reparameterized to a common knot vector along the blend.
Flow Control sets where the ends go: Edge align follows the neighbors' edges, Connect ends joins
the ends, Free stays square.
- **Sections.** At each station, a §6.2 section runs between the two sides' cross derivatives.
- **Rows.** The section CVs at matching stations form rows, each fitted as a curve along the blend.
With G3 on both sides that is eight rows: degree 5, three spans across.
- **Shape.** Shape factors scale α; Crown pushes the middle rows along the average normal.
- **Profile Blend.** The same with interior sections forced through the profile curves: those rows
are interpolated, not free.
- **Surface Fillet between face sets** (Parasolid's face-face blend):
- **Spine.** The rolling ball's center is where the two offset surfaces meet. `march.lucb`
already traces a B-spline's signed distance as a field, and offsetting it by r is that field
minus r. Contacts come by projection.
- **Sections.** The circular section is today's. G2 and G3 sections use the existing quintic
shapes. Conic sections are a rational quadratic with weight ρ/(1−ρ), raised to degree 5. Bias,
Lead and Form Factor are CV arm ratios on the quintic.
- **Sizes.** Chord or constant width solves r along the spine for the chord.
- **Trims.** The result is trimmed to the contact curves on both sets (§6.4), or left untrimmed.
- **Reuse.** luce-cad's edge blends are the special case where the walls share an edge. Their
section and row code (`blend_tools`, `row_fit`) is reused.
- **Tubular Offset.** A circular (or G2) section swept along a curve on a surface, its contacts at
±r along the surface, trimmed out or added.
### 6.8 Filling: variational patches (xNURBS, Rhino 9 Patch, Alias N-sided)
The unknowns are the CVs of a degree 5 B-spline net over a parameter domain.
- **The domain:**
- four-sided (Quad or Square): the unit square, the boundaries on its sides;
- N-sided: the boundary projected onto a best-fit plane (Projected), or a smoother map onto a
disk (Molded); the result is trimmed by the boundary's uv image (§6.4).
- **The energy:** E = w_b ∫(|S_uu|² + 2|S_uv|² + |S_vv|²) + w_s ∫(|S_u|² + |S_v|²).
- The first term is bending, the second membrane.
- Plasticity's Tension and Rhino's Stiffness set w_s : w_b. Flatness adds a pull toward the
best-fit plane.
- The Gram matrices of B-spline derivatives are exact by Gauss quadrature per span. They are
banded and sparse, a Base hot path.
- **Constraints**, sampled along each boundary at stations:
- **G0**: S(uv_k) = B_k, linear.
- **G1**: n_k · S_u = 0 and n_k · S_v = 0 at uv_k, with n_k the neighbor's normal. This is linear,
because n_k is fixed.
- **G2**: the normal curvature across the boundary equals the neighbor's,
n_k · S_dd = κ_k |S_d|², with d square to the boundary. It is linearized about the current
surface and iterated (a Gauss–Newton step).
- **Interior curves and points** (guides, Rhino's points, Parasolid's supporting wires): G0
constraints at their projected uv, or G1 when they carry a normal.
- **Boundary flow** (Natural, Normal, Next, Adjacent) adds conditions on S_v's direction along
the boundary: square to it, or along the neighboring edge.
- **The solve.** Constraints as heavily weighted least squares (Plasticity's Weight, Rhino's
tolerances), or exact through Lagrange multipliers.
- **Refinement.** Each pass checks the four measures of Stage 0 at the stations. Where one fails,
knots are inserted in that span (Rhino's Refine, xNURBS's Quality), up to a span limit.
- **Conflicts.** Constraints that conflict (G2 asked at a corner whose neighbors disagree) are
reported where they are, as xNURBS 7 draws them.
- **Reuse.** luce-cad's corner patches (`patch_fit.lucb`) already solve a thin-plate least-squares
problem with fixed boundary rows. That code is the start.
- **A cross-check.** A transfinite patch (a Midpoint or Generalized Bézier patch) is cheaper and
gives a starting surface; Rhino's MultiSidedPatch is one. We use it as the first guess and as an
independent check, not as the result.
### 6.9 Structure: the NURBS toolkit
As The NURBS Book's algorithms (Piegl and Tiller), for curves and for surfaces in U or V:
- **Knots and degree:**
- knot insertion and refinement;
- knot removal within a tolerance;
- degree elevation;
- degree reduction within a tolerance;
- Bézier extraction (Alias's NURBS to Bezier).
- **Pieces:** split at a parameter; extract a range; join with continuity (Alias's Attach Blend);
close (Preserve Shape).
- **Fitting and rebuilding:**
- compatible knot vectors for a set;
- reparameterization (uniform, chord);
- least-squares fitting at a given degree and span count, with end rows held, so a rebuild keeps
the continuity Align made;
- fitting within a tolerance, adding spans where needed;
- non-rational approximation of rational surfaces;
- conversion of analytic faces to B-splines (Plasticity's Raise Degree).
- **Extension:**
- natural: extrapolate the last span's polynomial (unclamp, extend, clamp again);
- linear;
- soft: C2, tending to linear;
- reflective.
- **Evaluation to the third derivative.** The basis derivatives (`nurbs.lucb`) need a fourth row,
so a G3 check needs no finite differences.
- **The degree cap.** Raised from 8 to at least 9, Alias's maximum, so STEP and IGES surfaces from
Alias load. Rhino's 11 is the safer bound.
### 6.10 CV editing with constraints
- **NUV.** Each CV moves along the surface's normal and its U and V tangents at the CV's Greville
point (Alias's NUV, Rhino's MoveUVN).
- **Slide.** Along the hull: the line through the CV's neighbors in U or V.
- **Hull.** A pick takes a whole row.
- **Falloff in rows.** Proportional modification counts CVs in U and V, with Alias's exponent
(−5 to 5) and preceding and succeeding counts. Plasticity measures distance along the hull. Both
are offered beside today's 3D soft radius.
- **Kept continuity.** A face aligned by a node keeps its continuity because the Align node
re-cooks after any change upstream. In Edit CAD, a CV move on a row an earlier Align step
constrained re-runs that step's row solve afterward (the owner's answer, §10).
- **Proxy.** The hull before the drag, drawn as a ghost.
- **Steps.** Step size, Drag strength (Rhino's), arrow-key nudges.
### 6.11 Measuring
At stations along an edge between faces F₁ and F₂ (or a curve's join):
- **G0**: the distance.
- **G1**: the angle between normals.
- **G2**: the normal curvatures in the direction square to the edge, compared relative to the
larger, in percent (Alias since v13, Rhino's Refine).
- **G3**: the derivative of that curvature along the same direction, relative.
Their outputs:
- **Combs:** per measure, auto or log scaled, with min and max labels.
- **Curvature combs** on curves, edges and isoparms: curvature or radius quills, torsion,
inflections marked, a radius band.
- **Deviation** between two surfaces or a surface and a mesh: a color map with ramp and acceptable
distance.
- **Draft angle** shading from a pull direction.
All of it is evaluated on the exact geometry in Base, then drawn as overlay lines.
## 7. Tools in luced-3d
### 7.1 Nodes, Edit CAD steps, menus
Our split follows FUSION §4 and §7. A node is Alias's construction history: its inputs re-cook it.
An Edit CAD step is a one-off result. Every builder is both, running the same luce-cad call.
| Reference tools | Node (CAD network) | Edit CAD step, at the level | Reached by |
|---|---|---|---|
| Free curves (CV, EP), Duplicate Curve (edge, isoparm) | **Curve** (CV / fit / from edge / from isoparm) | Curves are objects of the model; Create Curve | Create menu; right-click on an edge: Duplicate as curve |
| Blend Curve (Alias), Bridge Curve, BlendCrv | **Blend Curve** | Blend Curve, at Edges and Curves | Right-click on two curve ends or edges; S menu |
| Project, Pull, Imprint | **Project** (vector, view, normal; bidirectional; Completion) | Project, at Faces (then curves) | Right-click on a face with curves selected |
| Intersect | **Intersect** | Intersect, at Faces or Object | Right-click on two faces |
| Trim, Divide, Cut | **Trim** (Keep, Discard, Divide) | Trim, at Faces: regions clicked | Right-click on a face with curves on it |
| Untrim, Trim Convert, Shrink | **Untrim**, **Trim Convert** | Untrim, Trim Convert, Shrink, at Faces | Right-click on a trimmed face |
| Shell Stitch / Unstitch, Join / Unjoin Sheets | **Stitch**, **Unstitch** | Stitch, Unstitch, at Object | Right-click on sheets |
| Align, MatchSrf, Match Crv, Symmetry Plane Align | **Align** | Align, at Edges: the input edge, then the master | Right-click on an edge: Align to…; S menu at Edges |
| Square, EdgeSrf, xNURBS Square | **Square** | Square, at Edges or curves | S menu with four boundaries picked |
| Skin, Loft | **Skin** | Skin | S menu |
| Rail, Sweep1/2, Profile | **Rail**, **Profile** | Rail, Profile | S menu |
| Set Planar | **Set Planar** | Set Planar | Right-click on closed curves |
| Extend (surfaces, curves) | **Extend** | Extend, at Edges (sheet edges) | Right-click on a sheet edge; selecting one offers it first, as in Plasticity |
| Freeform Blend, Bridge Surface, BlendSrf, Profile Blend | **Blend Surface** (profiles optional) | Blend Surface, at Edges | Right-click on two edges or curve chains |
| Surface Fillet, FilletSrf, face-face blend | **Surface Fillet** (two face sets) | Surface Fillet, at Faces: set 1, then set 2 | Right-click on faces: Fillet between… |
| Tubular Offset | **Tube** | Tube | Right-click on a curve on a surface |
| N-sided, Patch, xNURBS, fill hole | **Fill** (N-sided or Quad) | Fill, at Edges (a loop) | Right-click on a boundary loop; S menu |
| Ball Corner, Corner Blend, Bridge Fillet | **Corner** | Corner, at Faces | Right-click on three or four faces |
| Insert, Isoparam, InsertKnot | none: structure is direct | **Insert** at CVs and Patch: click a parameter, the new isoparm previewed | S menu at CVs; right-click on a face |
| Rebuild, Reduce, Del multi-knots, Uniform, Match knots, Non-rational, Raise Degree, NURBS to Bezier | **Rebuild** (for history after an import) | **Rebuild** and its types, at Patch and curves | Right-click on a face or curve |
| Transform CV (XYZ, NUV, SLIDE, PROJ, PARA, VIEW), Prop mod, Move CV Normal | none | The CVs level's move modes (§7.2) | The tool bar's mode row; the A menu at CVs |
| Stretch, Attach, Detach, Close, Reverse | none | Curve steps at Curves | Right-click on a curve |
| Continuity checks, combs, deviation | **Check** (a display node, no change to geometry) | Always on while a step's tool is active; a viewport toggle otherwise | The shading menu; the viewport's Display menu |
### 7.2 The CVs level
The owner asked for this level especially.
- **Picking:**
- **CV or Hull.** A toggle, or Alt-hover as Plasticity's: a click takes a CV or its whole row.
- **A second click** on a CV takes its row; on a row, the whole net.
- **The move modes**, Alias's Transform CV, are a row in the tool bar:
- **World**: the gizmo, as now;
- **NUV**: the gizmo's axes become the normal, U and V at each CV; each CV moves in its own frame;
- **Slide**: along the hull;
- **Project**: onto a picked plane or along a vector;
- **Parallel**: parallel to a hull line;
- **View**: the screen plane.
Rotate and Scale keep their pivot setting. Non-proportional scale is the gizmo's axis scales.
- **Falloff:** today's Soft radius (3D), plus **Rows** (Alias's U and V counts and exponent) and
**Hull distance** (Plasticity's).
- **Structure steps:**
- **Insert** (a knot at a clicked parameter, the new isoparm shown in green before the click);
- **Remove knot**;
- **Raise degree**;
- **Rebuild** (its types);
- **Convert to B-spline** (an analytic face);
- **Untrim**.
Each is one step, one undo.
- **Continuity.** **Align** runs from here too: pick a row's edge, then the master. Its rows are
marked: position, tangent, curvature and G3 rows drawn in four tints. A drag on a marked row
follows §6.10.
- **Display:**
- the **proxy** hull while dragging;
- **Diagnostic feedback**: a comb on the edges of the faces being edited, live, with the G0–G3
readout (§6.11);
- the **curvature comb** on picked curves.
### 7.3 Handles and per-edge labels
- **Per-edge continuity.**
- **Labels.** A label at each boundary's middle (G0, G1, G2, G3, Free) cycles on a click, as
Plasticity's black circles and Alias's on-model labels do. It is the same value as the
parameter row.
- **Who has them.** Square, Rail, Fill, Blend Surface, Align and Skin.
- **Scale arrows.** Align's Tangent, Curvature and G3 scales are arrows on the row: the outer
arrows scale each end, the middle slides the row (Alias's).
- **Flow Control labels.** At the ends of a blend: Edge align, Extend, Connect, Free, cycled by a
click.
- **Variable values.** Radius, crown and offset handles along a blend, added with Shift-click on
its rail and deleted with Shift-right-click. This generalizes the variable fillet's points
(FUSION §9, parity round 2).
- **Partial range.** Arrows at the ends of the partial range, snapping to the master's ends.
## 8. Staged build plan
Each stage ends with `luc test` green in luced-3d and luce-cad, preview captures for the docs, and
both MODELING.md files updated. Tests drive the workspace as `cad_*_tests` and `edit_cad_*_tests`
do, and check geometry with Stage 0's measures. Where a closed form exists (a cylinder's curvature,
a Coons patch of four lines), they check against it.
**Stage 0: measuring** (S1).
**Stage 0: done** (2026-10-12). What was built:
- **luce-cad** `measure/` (public `CadMeasure`):
- `basis_jet` and third-order jets of every curve and surface kind, with one-sided limits at
knot lines (`geometry/jets.lucb`);
- `check` (the continuity, combs and the lines that draw them, as `CadCheck`);
- `deviation` (a colored tessellation and its statistics).
- **luce-gpu and luce-3d**: Draft shading (mesh shading 7), and the curvature map's radius band.
- **luced-3d**:
- the **Check** node (`cad_check.luc`), with Check continuity on selected edges;
- its lines published through the worker and drawn in four colors;
- Draft and the radius band in the shading menu.
Captures: `tools/preview.py --scene` with `surf_check`, `surf_check_g1`, `surf_check_g3`
(`--mode 7`), `surf_combs`, `surf_deviation`, `surf_band` (`--mode 9`) and `surf_draft`
(`--mode 10`).
Tests run against closed forms:
- a rational ellipse's curvature rate;
- G1, G2 and G3 fillets;
- split faces;
- a cylinder's combs;
- concentric spheres, and a G1 fillet's depth against its box.
Left for later:
- **Combs.** No combs on isoparms or on curves on surfaces (curves arrive in Stage 2). No
inflection marks, torsion quills or comb radius band.
- **Surface-relative combs** for edges.
- **Edges without a shared face.** No checks between faces that share no edge (Stage 3's
stitching).
- ~~**Labels.**~~ Done after Stage 0: Alias-style text labels on the model ("G2 κ 0.00%"), and
Deviation as a display tint over the CAD body rather than a mesh in its place.
- **Deviation's precision.** It resolves single precision tessellation points: about 1e-7 of the
model's size.
The plan as first written:
- luce-cad:
- third derivatives in `nurbs.lucb`;
- `continuity(model, edge, stations)`, giving the four measures per station;
- `curvature_comb(curve | edge | isoparm, samples)`;
- `deviation(a, b)`.
- luced-3d:
- comb and continuity overlays, and a Check node;
- the shading menu gains Draft angle;
- Curvature shading gains a radius band.
- Tests:
- a cylinder's comb is constant at 1/r;
- a G2 fillet's edge measures G2 within 1e-6 and fails G3;
- a G3 fillet's edge passes G3;
- the two pieces of a face cut by Split Face measure equal at every order.
**Stage 1: the NURBS toolkit and CV editing** (S2, S3).
- luce-cad: §6.9 in full, public, on curves and B-spline faces with their trims; degree cap 9 or
more.
- luced-3d:
- the CVs level's modes, Hull picking, Rows and Hull-distance falloff, proxy and steps (§7.2);
- Insert, Remove knot, Raise degree, Rebuild (all types), Convert to B-spline.
- Tests:
- every knot and degree operation leaves the surface within 1e-9 of where it was, except
reductions, which stay within their tolerance;
- Rebuild reports its deviation, and its result is within it;
- an NUV move of a planar face's middle CV keeps the others still and moves it along the normal;
- Rows falloff with Preceding 1 moves one neighbor by the exponent's weight.
**Stage 1: done** (2026-10-12). What was built:
- **luce-cad** `nurbs/` (public `CadNurbs`, `CadSpline`; luce-cad MODELING.md, The NURBS
toolkit):
- the degree cap raised to 11 (the bases twelve wide everywhere they are kept);
- knot insertion and removal, degree elevation and reduction, NURBS to Bezier, pieces,
on curves and across B-spline faces;
- least-squares rebuilds and fits whose end control points hold the source's derivatives to
G0–G3, Alias's Rebuild types (Explicit, Within tolerance, Reduce spans, Del multi knots,
Non-rational, Bezier) and Match Knots, each reporting how far it moved;
- exact conversion of planes, cylinders, cones, spheres and tori to rational B-splines;
- CV clouds that know their net places, and CV moves (World, NUV, Slide, Project, Parallel,
View) with Rows, Hull-distance and Radius falloff.
- **luced-3d** (`edit_cad_nets.luc`): the CVs level's mode row and falloff, the NUV gizmo, the
ghost hull, hull-row picking, and Insert Knot, Remove Knot, Raise Degree, Rebuild (with
Explicit Control) and Convert to B-spline as Edit CAD steps from the right-click, S and
Modify menus.
Captures: `tools/preview.py --scene` with `surf_cv_nuv`, `surf_cv_row`, `surf_rebuild`,
`surf_insert` and `surf_convert`.
Tests, against closed forms (luce-cad `nurbs_toolkit_tests.luc`, luced-3d
`edit_cad_nets_tests.luc`):
- insertion and elevation keep a circle and a G2 fillet's surface to 1e-12, its contacts G2;
- removal undoes insertion, and refuses a knot that would move the curve;
- a rebuild reports its deviation, holds end curvature to 1e-9, and keeps a G2 fillet's
contacts G2 as two quintic spans and as a single span of degree 7;
- a converted G1 fillet stays a cylinder of radius r to 1e-12, its contacts G1;
- an NUV move of a planar net's middle CV moves it along the normal alone; Rows falloff with
one row moves a neighbor by 0.5^e and a corner by its square.
Left for later, and what became of it (2026-10-12, with Stage 2):
- ~~**Insert's parameter by click.**~~ Done: while Insert Knot is the last step the isoparm
under the pointer shows green on the surface (the tool bar's direction) and a click puts the
knot there; Remove Knot lights the knot line nearest the pointer and a click removes it
(`knot_place.luc`; the surface reaches the viewport as text, luce-cad's `CadNetProbe`).
- ~~**Frames.**~~ Done: NUV moves along the surface's frame at each CV's Greville point (the
cloud carries it), as Alias does.
- ~~**Step size, Drag strength, arrow-key nudges, locks.**~~ Done: rows of the Edit CAD node; the
arrow keys nudge picked CVs with the Move tool on and the viewport holding the keyboard.
- ~~**Two falloffs.**~~ The CVs level's Parameters hold one falloff (Radius, Rows or Hull, each
with only its own rows) beside Symmetry, which mirrors CV moves too; Keep selection is gone
there.
- ~~**Aligned rows.**~~ Done with Stage 4: a CV drag on rows an Align step set runs that Align
again afterwards (`edit_cad_align.realigned`).
- ~~**Converting caps.**~~ Done: a face going round its axis with no seam is split through the
axis first, then converted.
- ~~**Curve tools.**~~ Stage 2.
**Stage 2: 3D curves and Blend Curve** (S4, S11 in part).
- luce-cad:
- a curve component in CAD geometry sets: exact NURBS curves, with links to the edges or faces
they came from;
- curves on faces (uv and 3D, §6.3);
- Blend Curve G0–G4 (§6.2).
- luced-3d:
- a Curves level in Edit CAD;
- Curve and Blend Curve nodes;
- Duplicate as curve;
- Stretch, Attach, Detach, Close, Reverse.
- The sketch's Blend Curve uses the 3D kernel.
- Tests:
- G0–G4 ends measure their continuity, and the CV count follows §6.2's table;
- a blend's end follows its edge when the body changes upstream;
- Attach Blend at 0.5 meets in the middle.
**Stage 2: done** (2026-10-12). What was built:
- **luce-cad**:
- `cad_curves` (public `CadCurves`): curves as objects of a geometry set beside its bodies and
sketches: exact rational B-splines, named, shown or hidden, with their source and, for a
curve on a face, the face and the curve in its chart coordinates; placed, joined, filtered,
saved; drawn (a curve on a face lifted off it a hair), picked (a pick mesh of the segments)
and edited in the CV cloud (a curve on a face's control points stay on the face);
- `curves` (public `CadCurveTools`): derivatives to the fifth order and by arc length; Blend
Curve G0–G4 as §6.2 has it (each end the curve reparameterized, k + 1 control points fixed by
a triangular solve, the rest minimizing ∫|B‴|², degree 5 on the spans §6.2's table gives,
degree 7 a single span to G3, extra spans, each end's tangent, curvature, rate and G4 shape);
CV and EP curves; edges and isoparms as curves, exactly; curves on faces (a 3D fit within a
tolerance); Attach (Blend at a bias to G3, or Connect), Close (Preserve Shape), Stretch
(Locked or Floating), Reverse; Detach is the toolkit's `piece`;
- `CadMeasure.curve_join`: G0–G4 between curves by arc-length derivatives (the Check tools'
measure for curves).
- **luced-3d**:
- Edit CAD's **Curves** level (key 7) and its steps (`edit_cad_curves.luc`): CV Curve, EP Curve
and Curve on Surface drawn with clicks; Duplicate Curve (edges, a face's isoparm); Blend Curve
between curves or edges; Attach, Detach, Close, Stretch, Reverse, Delete; curves' control
points at the CVs level with the surfaces'; from the right-click, A, S, Create and Modify
menus;
- the **Curve** and **Blend Curve** nodes of CAD networks (`cad_curve_nodes.luc`), their edges,
faces and curves picked in the viewport: a blend on a body's edges follows them;
- the sketch's Blend Curve takes its control points from the 3D kernel.
Captures: `tools/preview.py --scene` with `surf_curves`, `surf_curve_menu`, `surf_blend`,
`surf_blend_g4`, `surf_curve_cvs` and `surf_blend_node`, and for Stage 1's follow-ups
`surf_insert_click` (each also with `--background`).
Tests, against closed forms (luce-cad `curve_tests.luc`, luced-3d `edit_cad_curves_tests.luc`,
`edit_cad_nets_tests.luc`):
- blends G0–G4 measure the order asked at both ends by `curve_join` (and not one more by chance),
with 6 + spans − 1 control points as §6.2's table says, in luce-cad and from Edit CAD's tool
bar; a G2 blend leaving a circle of radius 2 starts at curvature 1/2;
- a Blend Curve node between two of a box's edges starts at the edge's end, and when the box is
made wider upstream its end moves with the edge;
- Attach Blend at 0.5 meets in the middle, G1; Close keeps G2 at its seam; Stretch lands its
handles exactly;
- edges and isoparms come out exactly (a circle's radius to 1e-12); a curve on a face lies on it.
Left for later, and what became of it (2026-10-12, with Stage 3):
- **Ends on surfaces.** A blend's end is a curve's or an edge's (continuity along it). Alias's
blend to a surface across its edge (Parametric or Geometric curvature type) waits for the
surface tools (Stage 4's Align reads the same cross derivatives).
- ~~**Blend handles.**~~ Done: at each end a tangent arrow (its length the tangent, a third of
the chord at 1) and at G2 or more a curvature arrow on from its tip, dragged in the viewport
on the Blend Curve step and node (`edit_cad_curves.blend_handles`, `feature_handles.luc`).
- ~~**Isoparms as objects**~~ Done: at the Curves level a double-click on a surface picks the
isoparm through the point (U or V) as a curve of the model, selected for the curve tools
(`CadCurveTools.isoparm_fraction`). ~~Combs on curves~~ in the Check node: done
(`CadMeasure.with_curve_combs`, `curve_check`), curves alone too.
- ~~**Stretch's handles**~~ Done: handles anywhere on the curve, up to degree + 1, dragged in
the plane facing the view, added and taken away by Shift-click (`stretch_handles.luc`).
- Also done: curves have their own icon in the outliner; and the first result of the compute
worker no longer frames over a camera set or moved while it cooked (a scene's, or the user's
orbit right after opening a project): the put-off frame happens only if the camera is where
it was asked (`Workspace.frame_cube`).
**Stage 3: project, intersect, trim, stitch** (S5–S7).
- luce-cad:
- Project (vector, normal, bidirectional, Completion) and Intersect, as curves on faces;
- trimming by curves in uv: Keep, Discard, Divide;
- Untrim with stages; Trim Convert; Shrink;
- per-edge and per-vertex precision; Stitch and Unstitch.
- luced-3d: those nodes and steps; region markers to click; Show Intersections.
- Tests:
- a circle projected along Z onto a cylinder's side gives the known intersection curve within
tolerance;
- Trim Keep of a disc region removes the outside, and its area matches;
- Divide then Stitch gives back one face's area and a closed edge loop;
- six squares stitch into a closed solid with the cube's volume;
- Untrim All gives the natural surface.
**Stage 3: done** (2026-10-12). What was built:
- **luce-cad** (`surfacing/`, public `CadSurfacing`; `modeling/trim`, `stitch`, `untrim`,
`face_meets`; `cad_trims`; luce-cad MODELING.md, Projection, trims and stitching):
- Project along a vector (Newton on S(u, v) = C(t) + λd, seeded along the curve, both ways or
ahead; a ray along a ruling takes the point's foot) or along the normals, pieces ending
exactly on the boundary edge they reach, each a curve on the face (chart curve degree 5
within a ten-millionth of the body, or Match original);
- Intersect, the booleans' face-face step, as curves on one face or both; with a plane too;
- Trim with the booleans' cutting and splitting: Keep, Discard, Divide; loose curve ends left
out and reported; region markers and crossings for the viewport; a trimmed solid an open
body;
- trim stages kept with the set (saved), Untrim Last and All, else the natural surface
(B-spline domain, plane rectangle, cylinder or cone band, sphere, torus);
- Trim Convert (Coons map of the four sides, least-squares fit, deviations reported) and
Shrink (the net cut to the trims by knot insertion);
- Stitch (vertices and edges merged within a gap, the shell oriented, closed into a solid when
every edge is shared) and Unstitch;
- per-edge and per-vertex precision (Parasolid's tolerant edges): new B-rep columns, saved;
edge building checks ends against a tolerant vertex's precision; meshing and modeling work
to the largest.
- **luced-3d**: the eight as Edit CAD steps (`edit_cad_surfaces.luc`) and CAD nodes
(`cad_surface_nodes.luc`, category Surfaces), shared code `surface_ops.luc`; Trim's region
markers and Show intersections (`trim_regions.luc`); Project's face pick; the commands in the
right-click, S and Modify › Surfaces menus (`surface_commands.luc`); the step's tool bar hides
while the right-click menu is open (it drew over it).
Captures: `tools/preview.py --scene` with `surf_project`, `surf_trim_markers`, `surf_trim_keep`,
`surf_divide`, `surf_surface_menu`, `surf_intersect`, `surf_stitch`, `surf_project_node`, and
for Stage 2's follow-ups `surf_blend_handles`, `surf_stretch`, `surf_isoparm`,
`surf_curve_combs` (each also with `--background`).
Tests, against closed forms (luce-cad `surfacing_tests.luc`, `curve_tests.luc`; luced-3d
`edit_cad_surfaces_tests.luc`, `edit_cad_curves_tests.luc`, `camera_frame_tests.luc`):
- a circle of radius 2 at z = 10 cast along −Z onto a cylinder of radius 3 lies on x² + y² = 4,
z = √(9 − x²) to 1e-5; a circle on the cylinder cast along its axis is itself to 1e-6; pulled
along the normals it keeps each height on the ray; a curve that misses is refused;
- the cylinder and the plane y = 2 meet in its circle; a box's wall x = 1 meets it in four lines
(both faces) at z = ±√8;
- Trim of a 4-box's top by a projected unit circle: Keep leaves π, Discard 16 − π, Divide both
faces summing to 16 with the box closed; the stage saves and loads; a dangling curve reports
its loose end and no regions;
- Divide, Unstitch, Stitch: one face's area round four open edges; Untrim gives back the closed
box of volume 64; two trims, then Untrim (one hole) and Untrim All (none); a stageless
B-spline face untrims to its whole square;
- six squares stitch into the cube (volume 8); a 0.01 gap within 0.02 stitches all twelve edges
with precision 0.01 (kept through a save) and Check passes G0 across them; within 0.005 the
top stays apart and a pair refuses; a filleted box unstitched and stitched again measures G1
across every fillet edge;
- Trim Convert of a G1 fillet within 1e-4, the body closed with its volume; Shrink keeps a disc's
area and moves the net's corner in;
- in the editor: Project by its face pick, Trim's markers clicked in the viewport (keep, let go),
Divide, Untrim, Intersect with a plane, Trim Convert, Unstitch and Stitch, the menus by level;
the nodes follow the box when it grows upstream; a blend's tangent arrow dragged to two
chords; a Stretch handle added mid-curve and dragged; an isoparm picked by a double-click;
curve combs in the Check node; curve icons in the outliner; a put-off frame keeping a camera
set meanwhile.
Answers from the reference tools (the doc's questions that Stage 3 met):
- **Trim's curves after trimming.** Alias keeps the curves on surface after a trim; so do we
(they lie on the new edges and can be deleted).
- **Divide's result.** Alias's Divide makes each region its own trimmed surface; here each
region is its own face of the body (the first keeps the face's name, the others
`<tag>/divide<k>[<face>]`), and Unstitch makes them bodies when wanted.
- **Trims on a solid.** Alias trims shells as well as surfaces and the shell opens; a trimmed
solid here is an open body (Stitch closes it again).
- **Stitch's gap.** Alias's range is 0.0001 to 1 and keeps the originals by default; ours takes
the same range; the originals stay in the history (Undo or the node upstream).
Left for later, and what became of it (2026-10-12, with Stage 4):
- ~~**3D Trimming**~~ Done: Trim's Curves row casts every curve of the model onto the face as the
trim runs (along a vector or the normals), and Intersect faces cuts it by other faces where
they meet it (luce-cad `trim_curves.lucb`). Still left: Trim Convert's Show deviations as a
map; Keep originals on Untrim.
- ~~**Curve ends short of the boundary**~~ Done: Extend curves carries a loose end on along the
face, straight on in its chart, to the boundary or the next curve. ~~Stitch's detach~~ Done:
Detach periodic (split through the axis and the seam; a closed B-spline face at the middle of the
direction it closes in, with Stage 5) and Detach single-curve boundaries (a closed edge in two).
- ~~**Per-edge precision in the booleans**~~ Done: the booleans merge and match by each edge's and
vertex's own precision and the pieces of a tolerant edge keep it (the tessellator's side is
another agent's). ~~A cone's band through its apex~~ Done: it untrims to the pointed side.
- ~~**Isoparm picking**~~ Done for Align's masters: a double-click on a surface while the master
is asked for is a temporary isoparm (kept as its point, drawn dashed), not a curve of the
model; the Curves level's double-click still makes a curve (a step). Other tools taking
curves (Project, Blend Curve) take curves of the model only.
- Also done: Trim waiting for its region clicks, and the drawn curves and isoparm steps waiting
for their clicks, read a neutral "waiting" instead of a warning badge.
**Stage 4: Align** (S8).
- luce-cad: §6.1. Rows G0–G3; Edge, Project, U/V and Vector types; Position Influence; Tangent
Balance; Blending; Partial; two masters; Modify Both; Explicit Control on and off; Refine;
curves; Symmetry Plane Align.
- luced-3d: the Align node and step; the row tints, scale arrows and partial arrows; diagnostic
feedback; Accept chains in Edit CAD.
- Tests:
- two quintic patches with an angle between them: after G1, G2 and G3 the edge measures each,
and rows beyond Extra CV Rows have not moved;
- with Position Influence 0, the input's knots are unchanged;
- a G3 request on a patch with fewer than eight rows is refused with "needs 8 rows across, has 6"
(Explicit Control on), or adds spans (off);
- Partial 0.2–0.8 leaves the edge outside the range where it was.
**Stage 4: done** (2026-10-12). What was built:
- **luce-cad** (`surfacing/align_rows.lucb`, `align_master.lucb`, `align.lucb`,
`align_apply.lucb`; `CadSurfacing.aligned`, `CadAlignEdit`, `CadSurfacing.patch`; luce-cad
MODELING.md, Align): §6.1 as written, with the cross curve handed on by its arc-length jet:
rows solved one by one, A' = vT, A'' = v'T + v²K, A''' = v''T + 3vv'K + v³K', the speeds set
by Alias's sliders on the hull (the input's own distances times the scales, start to end,
AutoScale, Tangent Balance by the master's speed, Skew turning the chart direction); each
row fitted at stations, ends exact; Edge, Project (with its curve on surface), U/V and
Vector types; Position Influence; Extra CV Rows and Blend Factor; Partial (full-multiplicity
knots and a span outside each end); two masters; Modify Both (averaged edge and jet);
Explicit Control on (refused with the rows it needs) and off (quintic across, spans
inserted, the master's degree and knots at Influence 1); Refine to the limits; curves (one
CV a row; Attach Point; Modify Both of two curves); Symmetry Plane Align (with Project For
Position). Diagnostic Feedback, the rows and the proxy hull come back with the result.
- **luced-3d**: the Align and Symmetry Align steps (`edit_cad_align.luc`), the nodes
(`cad_surface_nodes.luc`), the shared rows and cook (`align_ops.luc`), the row tints, proxy,
temporary isoparm and missed-edge dashes (`align_view.luc`), Tangent Scale and Partial arrows
as feature handles, the master picks (`edit_cad_picks.luc`, `modify_picks.luc`), the
right-click on edges, S and Modify menus; the CV drag that re-runs an Align; a tall tool bar
docked at the viewport's left.
Captures: `tools/preview.py --scene` with `surf_align_waiting`, `surf_align`,
`surf_align_proxy`, `surf_align_isoparm`, `surf_align_node`, `surf_symmetry`, `surf_trim_3d`
(each also with `--background`).
Tests, against closed forms (luce-cad `align_tests.luc`, `trim_followup_tests.luc`; luced-3d
`edit_cad_align_tests.luc`, `edit_cad_surfaces_tests.luc`):
- a flat quintic strip aligned to a quarter cylinder of radius 2 measures exactly G1, G2 and G3
as asked by the Check tools across the stitched edge (and fails the next order), its normal
curvature across the edge 1/2 to 1e-6 from G2 on; an unstitched box's top (a plane) aligned
G2 and G3 to its side does too, as a whole B-spline face;
- with Position Influence 0 the knots along the edge stay; Extra CV Rows 2 moves rows 2 and 3
by 2/3 and 1/3 of row 1's change and row 4 not at all;
- Explicit Control on refuses G3 on six rows ("needs 8 rows across, has 6"), off adds spans;
- Partial 0.2–0.8 aligns only that range: the edge outside it (and the span beyond) stays to
1e-9, inside it lies on the cylinder's edge;
- Modify Both on a symmetric roof moves both halves as mirror images, the ridge in place;
- Tangent Scale, AutoScale G2, Tangent Balance, Skew (10° reported at both ends, still G1), an
isoparm master (G2), U/V for a curve, Vector, two masters, Symmetry Plane Align, Refine
meeting a quarter circle a cubic edge misses, a curve's end G2 to a circle, Project leaving
Align1 on the floor;
- in the editor: Align from the right-click on an edge waits neutrally for its master, aligns
G1, draws its rows and arrows; a CV dragged off the tangent row goes back onto it (the
Align runs again); a double-click makes a temporary isoparm master; the node follows the box
upstream; Symmetry Align meets its plane.
Answers from the reference tools (the doc's questions that Stage 4 met):
- **Partial's range** is on the input's edge, as the plan's test reads (the master's nearest
part matched inside it); Alias's Start and End arrows are the range's ends.
- **The far side's rows** are kept to the same order (2(k + 1) rows across), as the plan's
"needs 8 rows across" reads: the far edge keeps whatever continuity it had.
- **Explicit Control off** gives the multi-span quintic: quintic across, spans added.
- **Accept / Restore** are the recipe itself: each Align is one step, the next starts from it.
Left for later, and what became of it (2026-10-12, with Stage 5):
- ~~The middle Tangent Scale arrow~~ Done: a third arrow in the row's middle slides the whole row,
both scales together (a "pair" handle, `feature_handles.luc`).
- ~~Temporary isoparms for tools other than Align's masters~~ Done: a double-click on a surface while
a builder (Square, Skin, Rail, Profile, Set Planar, the sheets) waits for curves, or a Project or
Blend Curve node asks for one, adds the isoparm through the point (`build_ops.resolve_isoparms`:
the one that fits the other curves); luce-cad's Project takes "isoparm" words. The Edit CAD
Project and Blend Curve steps take curves picked before them (a double-click at the Curves level
makes an isoparm curve there).
- ~~Modify Both of a curve with a surface's edge~~ Done with any master: against a surface (an edge,
an isoparm, a curve on a face, the face) the surface bends locally (a chart bump scaled so the met
point moves exactly halfway), its curves on face are lifted again, and the curve aligns to it
(`align_both.lucb`).
- The stray red line of `surf_align` was the G2 row of control points, correct but drawn alone above
the model: the aligned rows are now joined across by the hull's lines, and the proxy is the
input's whole old hull (its own control points, rows and columns), as Alias draws them.
- Stage 3's: Detach periodic splits closed B-spline faces too (`detach.lucb`), and 3D Trimming draws
its cast curves while Trim waits for clicks.
- Still left: Vector type at G3 (Alias offers it at G1 and G2).
**Stage 5: surfaces from curves** (S9, S10).
- luce-cad: Square (per edge Free, G0–G2, implied, tangent angle; Linear and Cubic blend);
Skin; Rail (one or two rails, generation curves, sweep modes, transform control); Profile;
Set Planar; sheet Extrude and Revolve; Extend (Linear, Natural, Soft, Reflective).
- luced-3d: the nodes and steps; per-edge labels; Boundary Labels.
- Tests:
- Square of four lines is the bilinear patch;
- Square G1 against four neighbors measures G1 on every edge;
- Skin of three circles is a surface of revolution within tolerance;
- Rail with two rails keeps each section's ends on both;
- Extend Natural of a B-spline is the same polynomial (a point past the old edge evaluates as
before).
**Stage 5: done** (2026-10-12). What was built:
- **luce-cad** (`surfacing/builders.lucb`, `square.lucb`, `skin.lucb`, `sweep.lucb`, `sheets.lucb`,
`extend.lucb`, `build_api.lucb`; public `CadSurfaceBuild`; luce-cad MODELING.md, Surfaces from
curves): the builders' curves are Align's master words (curves, edges, isoparms), so a boundary
on a surface answers its cross derivatives.
- **Square**: a Gordon-Coons patch with Hermite blending built as nets, exact: P1 + P2 − P12 of the
sides' fields (the boundary and ∂S/∂u, ∂²S/∂u² as B-spline curves on the pair's knots); per
boundary Free, G0 (Blend Linear: the bilinear Coons patch; Cubic: its slope), G1 (the field in
the neighbor's tangent plane), G2 (its normal part from the neighbor's second fundamental form),
Implied Tangent and Curvature (a planar boundary's plane as the mirror), Tangent Angle; the
corners' mixed derivatives one set every field holds; spans added until each field is within a
millionth; Explicit Control.
- **Skin**: sections turned alike, compatible (rational kept), interpolated across at the mean chord
(degree 5 or one less than the sections; exact surfaces of revolution from coaxial circles);
closed with three loops either side cut back; Start and End G0–G3 by Align's rows.
- **Rail** (one or two rails; Natural rotation-minimizing, Parallel and Vector frames; Scale,
Non-proportional scale, Rotate; generation curves blended by a bias; each side's continuity)
and **Profile** (Parallel, Radial, Surface normal; Linear, Local, Global, Limited): sections
placed by the fraction of the rail's length, fitted along it at degree 5 with knots at each
section's kink, within a ten-millionth.
- **Set Planar** (a plane face trimmed by the curves, odd regions kept), **Extrude** and
**Revolve** of free curves (exact sheets).
- **Extend**: Linear, Natural (de Casteljau past the end, homogeneous: the same surface), Soft (C2
easing to straight), Reflective (C2, the curvature's change mirrored); a distance or a
percentage; Merge on or off.
- **luced-3d**: the builders as Edit CAD steps (`edit_cad_build.luc`: started on the picks, waiting for
more, a click adding one, a double-click a temporary isoparm, Enter finishing) and CAD nodes
(`cad_surface_nodes.luc`, category Surfaces), the shared rows and cook (`build_ops.luc`), Boundary
Labels clicked to cycle (`build_labels.luc`), Square's Continuity Check drawn as the Check node's;
in the right-click on curves and edges, the S and Modify › Surfaces menus.
Captures: `tools/preview.py --scene` with `surf_square_waiting`, `surf_square`, `surf_square_node`,
`surf_skin`, `surf_rail`, `surf_profile`, `surf_planar`, `surf_sheets`, `surf_extend`, and for Stage 4's
follow-ups `surf_align`, `surf_align_proxy`, `surf_trim_3d` again (each also with `--background`).
Tests, against closed forms (luce-cad `surface_build_tests.luc`; luced-3d `edit_cad_build_tests.luc`):
- Square of four lines is the bilinear patch; of a hole in a smooth surface it meets the four
neighbors G0, G1 and G2 as asked on every edge, measured by the Check tools; Blend Cubic of a plane
is the plane; Implied Tangent leaves its plane square; Tangent Angle 30° leans 30°;
- Skin of two circles is a cylinder or a cone, of three a surface of revolution, exactly; closed it
turns less than 0.05° at its seam; Start G1 to an edge measures G1;
- Rail of a circle round a circle is the torus within a ten-millionth of its size; with two rails
each section reaches both;
- Profile passes each profile, Linear is two cones, Limited never overshoots;
- Set Planar of a circle with a hole has the ring's area; Extrude and Revolve are exact;
- Extend Natural is the same surface (an arc stays on its circle), Linear meets G1 and not G2,
Natural G3, Soft and Reflective G2;
- in the editor: Square from four edges clicked one by one (waiting until the fourth) fills the box's
top, its labels cycle on a click; Skin between two edges is the side again; Extend Linear carries
the top on; a double-click adds a temporary isoparm; the Square node follows the box upstream.
Answers from the reference tools (the doc's questions that Stage 5 met):
- **Square's corners.** Alias's Square needs the boundaries to meet; ours walks them end to end within
a ten-thousandth of their size and refuses a gap with its size. Where two neighbors cannot both be
met at a corner (a boundary leaving one neighbor's tangent plane), the patch takes the mean of what
each asks there, as a Gordon patch's twist; Alias's result has the same compromise.
- **Square's G3.** Alias's Square offers continuity to G2 (Curvature) and Implied; so does ours. G3 is
Skin's and Rail's (Align's rows), as Plasticity's Loft and Sweep stop at G2 and Alias's Rail at G2.
- **Free.** Alias's Free keeps the boundary but no slope; ours with Blend Cubic gives it the G0 patch's
own slope.
- **Extend's types.** Alias offers Linear and Extrapolate (our Natural); Soft and Reflective are
Parasolid's (C2 easing to straight, C2 mirrored), as the plan's S10 asked.
Left for later, and what became of it (2026-10-12, with Stage 6):
- ~~Square at corners whose neighbors disagree~~ Done: a G1 or G2 cap on a box's four perpendicular
walls measures G1 or G2 on all four. Such a corner is singular (each wall wants the patch square off
it, the next wall's top edge leaves the corner flat). As Gregory's patch keeps each side's field
everywhere but at the corner, each field is its own target plus the corner's mismatch carried down
to nothing by a quintic Hermite in a corner zone (1/256 of the side, a span of its own ending C2);
off the zones every edge holds. The G1 slope also turns its part across onto the neighbor's way on
with its length, so it does not shrink to nothing where the next boundary leaves the wall's plane.
Alias's Square leaves such corners broken too; there the break is confined to the zone.
- ~~Square's Rebuild per edge, Boundary Blend and Influence, Colinear Options~~ Done, as Alias's
2014 reference words them: Rebuild "to reduce data and improve parameterization" (refit by arc
length on the fewest uniform spans), Boundary Blend "the midpoint of influence between opposite
boundaries" (0.17 to 0.83), Influence "how much each boundary pair shapes the surface", Colinear
"line up the new surface's isoparametric curves with adjacent surfaces" ("like turning off Skews in
Align").
- ~~Rail's Spine mode, Sweep Pivot, Curve Segments and Fixed Curve~~ Done: Spine (sections square to a
spine curve), Sweep Pivot Closest, On Curve and Off Curve, Fixed Curve Rail and Gen., Curve Segments.
- ~~Skin's Multiple surfaces and Proportional Crown~~ Done: curve sets (Alias's), Single or Multiple
Surfaces, Proportional Crown (two sections). Skin's Flow Control and Modify Range wait.
- ~~Extend of several edges at once (Chain Select)~~ Done: several picks, and Chain Select (the edges
running on tangent).
- **Align's Vector type at G3**: not built, as Alias does not offer it: its 2015 reference gives
Vector for G1 and G2 only (G0 first, then the tangent and curvature rows along the vector); a G3 row
along a vector would leave the rate of curvature to the vector alone. Our refusal says so and points
to the Edge type.
- ~~Edit CAD's Project and Blend Curve with temporary isoparms~~ Done: started with nothing picked they
wait for curves, a double-click adding an isoparm (Project's Enter goes on to its face). While a
builder waits, its picks are lit along their length.
- ~~Still left: the builders' Explicit Control on Skin, Rail and Profile; Rail's Colinear Options and
Rebuild per curve.~~ Done with Stage 7.
**Stage 6: blends between surfaces** (S11).
- luce-cad: §6.7.
- Blend Surface: per side G0–G3, shape, crown, flow control, range, profiles.
- Surface Fillet between face sets: Radius or Chord; sections G0 chamfer, G1, G2, G3, Bias,
Lead, conic; one-sided curvature; Form Factor; variable; trim Automatic, curves on surface or
off.
- Tube.
- luced-3d: the nodes and steps; arrows that flip each set's side; variable handles.
- Tests:
- a Surface Fillet between two planes at 90° is today's edge fillet, face for face, for G1, G2
and G3;
- between a plane and a cylinder that do not touch, the G1 fillet's contact curves lie at r
from the ball's center;
- Blend Surface G3 both sides is three quintic spans across and measures G3.
**Stage 6: done** (2026-10-12). What was built:
- **luce-cad** (`surfacing/along.lucb`, `blend_surface.lucb`, `surface_fillet.lucb`, `tube.lucb`,
`blend_api.lucb`; public `CadSurfaceBlend`; luce-cad MODELING.md, Blends between surfaces):
- **Blend Surface** as §6.7 has it: two sides (chains of edges, isoparms, curves on faces, free
curves) matched by length (Connect ends) or square to side 1 (Free), within ranges; each section a
quintic B-spline across whose end rows are §6.1's by arc length from each side's cross curve (G0 to
G3; eight rows, three spans, at G3 both sides), the speed each side's Shape times the chord; the
middle the ends' cubic Hermite, bowed by Proportional Crown; profiles (Profile Blend) passed exactly
in their sections, their differences carried along; rows fitted along (`along_net`).
- **Surface Fillet** between face sets: Parasolid's rolling ball, the contacts by Newton in each
station's plane, the spine marched both ways to where a contact leaves its set (bisected), a cubic
through the centers; G0 Chamfer, G1 Circular (rational, exact), G2 and G3 Curvature (the edge
fillets' `fillet_section` on the same contacts, bent by the faces' normal curvature), Form Factor;
Radius or Chord; each set's side flipped; Trim Automatic (the contacts cast onto each face, the
part under the fillet discarded), Curves on surface, Off.
- **Tube**: exact circles along a curve (or an edge, an isoparm, a curve on a face) with Normal and
Tangent offsets and Flip.
- **luced-3d**: the three as Edit CAD steps and CAD nodes (`blend_ops.luc`), taking their picks as the
builders do (two lists and profiles; faces for the fillet), the right-click, S and Modify menus,
Blend Surface's side labels, the fillet's set labels flipping a side on a click, Continuity Check,
the picks lit while they wait (a face set by its outline).
Captures: `tools/preview.py --scene` with `surf_fillet_waiting`, `surf_fillet`, `surf_blend`,
`surf_blend_profile`, `surf_tube`, `surf_blend_node`, and for Stage 5's follow-ups `surf_cap`,
`surf_square_picks`, `surf_blend_isoparms`, `surf_rail_spine`, `surf_skin_crown` (each also with
`--background`).
Tests, against closed forms (luce-cad `blend_build_tests.luc`; luced-3d `edit_cad_blend_tests.luc`,
`edit_cad_wait_tests.luc`):
- a Surface Fillet between two perpendicular planes is the edge fillet: G1 exactly the cylinder of its
radius (to 1e-12) along the planes' whole length, and trimmed back the planes keep 12 of 16 each and
measure G1, G2 and G3 at the contacts as the section asks; Chordal keeps the chord between the
contacts;
- between a plane and a cylinder that do not touch, every section point lies a radius off the ball's
center and the contacts lie on both surfaces (to 1e-9);
- Blend Surface between two cylinders measures G0, G1, G2 and G3 at both edges as asked (and not more
by chance); G3 both sides is three quintic spans across; Crown lifts the middle; a profile lies on the
Profile Blend;
- Tube along a line is a cylinder exactly and along a circle a torus within 1e-7;
- in the editor: Surface Fillet between a box's top and a side (picked, clicked, Enter) is a quarter
cylinder inside the box, both faces trimmed (area 3.5 each), Continuity Check G1, its set label
flipping a side; Blend Surface between opposite walls' top edges waits for its second side and
profiles, then bridges them G1 with a label each; Tube on an edge is a cylinder round it; the Blend
Surface node follows the box upstream.
Answers from the reference tools (the doc's questions that Stage 6 met):
- **A free curve's side** is G0 only, as Alias's Freeform Blend says ("a side of free curves only is
G0"); higher is refused with that reason.
- **Lock Shape Controls** is on by default (side 2's Shape follows side 1's), as Alias's starts.
- **The fillet's default side** is toward the other set, as Alias's arrows start; Alias's Surface
Fillet trims Automatic by default, and so does ours.
- **Shape above 1** lengthens the tangents (tighter toward the corner), as Alias's words it.
Left for later, and what became of it (2026-10-12, with Stage 7):
- ~~Alias's Bias and Lead sections, one-sided Curvature, variable radius or chord along the fillet~~
Done (Bias Factor, Knee Ratio, Curvature Both/Side 1/Side 2/None, Variable with a middle and an end
size; the law as fraction and size pairs in luce-cad). A variable fillet's G3 contacts measure G2:
its sections lean off the plane square to the edge. Variable handles on the model are Stage 8's.
- ~~G3 Curvature's rate on faces whose curvature changes~~ Done: the rate measured along each leg.
- ~~Flow Control Edge align, Interior Edge Align, Explicit Control on the blends~~ Done: Edge align
matches the sides by their own parameters (their surfaces' isoparms), Interior Edge Align runs the
isoparms along slanted profiles, Explicit Control refits with the sides' rows held.
- ~~Tube's variable radius and its trims~~ Done: Curves on surface, Inside (the strip under it).
- ~~Stage 5's: Skin's Flow Control and Modify Range; Rail's Colinear and Rebuild per curve; Explicit
Control on Skin, Rail and Profile~~ Done (Free reads the curves by their lengths; Colinear places
sections by the rail's parameter).
- Still left: Symmetric Fillet, Round and the corner tools (Stage 8).
**Stage 7: fill** (S12).
- luce-cad: §6.8.
- Quad and N-sided; per-edge Free, G0, G1, G2.
- Guides and points; tension, flatness, boundary flow.
- Refine, quality, conflicts reported.
- The transfinite start.
- luced-3d: the Fill node and step; per-edge labels; conflicts drawn on the edges.
- Tests:
- a five-sided hole in a G2 body fills G2, measured on every edge within the tolerances;
- a four-sided hole between planes gives a plane;
- a guide curve lies on the result;
- Quad mode gives an untrimmed face.
**Stage 7: done** (2026-10-12). What was built:
- **luce-cad** (`surfacing/fill.lucb`, `fill_bounds`, `fill_net`, `fill_bands`, `fill_reference`,
`fill_solve`, `fill_refine`, `fill_api`; public `CadSurfaceFill`, `CadFill`, `FillConflict`; luce-cad
MODELING.md, Fill): §6.8 as written, with these choices:
- the net quintic both ways on uniform spans, halved while a boundary misses its tolerance (to 32;
graded nets met the boundaries worse), or Explicit Control's degrees (2 to 9) and spans;
- the energy bending (and with any G2 boundary its rate, Moreton and Séquin's, the order position,
slope and curvature are well posed in) of S less a reference R: the neighbors carried on into
the hole (each side's neighbor met along the chart's normal, a plane, sphere or cylinder in
closed form, else its tangent plane; blended by the inverse fourth power of the distance), so a
ball's cap fills with the ball, not with the clamped plate's paraboloid; Tension (membrane) and
Flatness of S itself;
- the constraints weighted a million times the energy's diagonal and driven to hold by the method
of multipliers (penalties alone trade exactness for the condition); G1 linear; G2 by
Gauss–Newton (iterating its right side alone diverges); the unknowns the change from the
reference, so the band's rounding is relative to it (a planar loop fills to 1e-12);
- the equations a band, factored by band Cholesky in Base;
- N-sided: Newell's plane as the chart, the net trimmed by the boundaries laid on it (their feet,
fitted to a billionth, by their own parameters); Quad: the boundary rows fixed, a weak
preference that the cross derivative leaves a neighbor its own way where G1 must turn it square
(a lid on vertical walls rises, not collapses);
- conflicts: corners whose neighbors' normals, tangent planes, twists (Gregory's compatibility)
or G2 curvatures disagree are found before the solve, eased within 3% of each side and reported;
what still fails is reported as runs; `CadSurfaceFill.hole` walks a hole's open edges from one
(seams between touching sheets passed over).
- Also fixed: Surface Fillet's ball at a fillet's very end (a contact on a B-spline face's edge)
carries the face on along its partials instead of failing.
- **luced-3d**: the Fill Surface step and node (`fill_ops.luc`), its labels and the conflicts drawn
on the model (`build_labels.luc`), the picks (boundaries, then guides), the menus.
Captures: `tools/preview.py --scene` with `surf_fill_waiting`, `surf_fill_quad` (also `--mode 7`,
zebra), `surf_fill_nsided`, `surf_fill_node` (each also with `--background`).
Tests, against closed forms and the Check tools (luce-cad `fill_tests.luc`; luced-3d
`edit_cad_fill_tests.luc`):
- a planar pentagon fills with its plane to 1e-9; a square hole in a tilted plane with the plane at
G1 and G2, N-sided and Quad (one untrimmed face);
- a square hole in a smooth height field fills G0, G1 and G2 on all four edges, N-sided and Quad;
- a 30° cap cut from a ball of radius 2 fills G1 and G2 within a thousandth of the radius of the
sphere, measuring G1 and G2 on its edge;
- a five-sided corner between three G2 fillets and two walls fills G1 on all five edges; with
circular fillets the corners where a fillet meets a wall's strip are reported (their twists
disagree);
- a guide curve and a point lie on the fill within a millionth, G1 kept; a hole is found from one
edge; Tension and Flatness lower a cap's dome, Explicit Control keeps its degrees and spans,
Normal flow leaves the cross isoparms square to the side;
- in the editor: Fill Surface from one edge of an open box's top takes the whole hole, waits for
boundaries then guides; N-sided G1 on the walls says "use Quad"; Quad G1 rises as a pillow inside
the walls, measured G1 on all four edges, its four corners conflicts; G0 is the flat top; a label
sets its boundary's own continuity; the node follows the box upstream.
Answers from the reference tools (the doc's questions that Stage 7 met):
- **Free** keeps the boundary's position, as Square's (Alias's N-sided Free trims there too); it is
not checked.
- **Quad sided** is off by default, as xNURBS's; **Tension** 0 to 1 and **Flatness** 0 to 1 (xNURBS's
ranges are narrower slices of the same pulls).
- **Boundary flow** applies to Quad, as xNURBS's notes it for quads; N-sided's isoparms are its chart's.
Left for later, and what became of it (2026-10-12, with Stage 8; luce-cad MODELING.md, Fill,
Follow-ups):
- ~~A Molded domain~~ Done: Auto molds a hole whose neighbors stand square to its plane (a polygon
inscribed in the circle, a corner where each side starts); four such sides mold onto the square,
Quad. Projected still refuses them, naming Molded and Quad. Its trimmed face can be hard to mesh where
it rises square off its boundaries.
- ~~Natural extensions of B-spline neighbors~~ Done: the end spans' polynomials carried on, half the
domain, before the tangent plane.
- ~~G2 at corners whose curvature rates disagree~~ Found before the solve: a G2 fillet's end at a wall
is a G2 corner conflict, a G3 fillet's is not. The five-sided G3 corner still fills G1, not G2.
- ~~G2 Quad lids on vertical walls~~ Done: G1 and G2 lids turn onto the walls' plane at their corners
(no pinch), four corner conflicts and every wall met elsewhere, at 4 by 4 spans.
- ~~Speed~~ Better: the multipliers by conjugate gradients, ribbons that give up early; the G1 corner
7.5 s to 3.9 s, G2 22 s to 10 s. Its band factor (n h²) is what is left.
- In luced-3d: conflicts gathered one mark a corner or a boundary's runs, their plates kept apart and
off the boundary labels; Fill's own prompts ("Pick fill boundaries", "Pick fill guides"); a Domain row.
**Stage 8: Parasolid's blend options on solids** (S13, S14).
- luce-cad:
- conic sections (rho, three ways); chamfer apex-range;
- overflow smooth, cliff and notch, with Parasolid's default order;
- limits (point, overlap) and caps; Y-blends; vertex blends;
- corners of four or more edges, with Round's corner options;
- G2 face blends by depth, skew and softness;
- identify blends;
- Ball Corner, Corner Blend, Bridge Fillet.
- luced-3d: those rows on the Fillet node and in Edit CAD.
- Tests:
- an overflow that Parasolid's table says is a cliff becomes one;
- a four-edge corner with setbacks measures G1 on every patch edge;
- conic ρ 0.5 relative with equal sizes is the circle.
**Stage 8: done in part** (2026-10-12). What was built:
- **luce-cad** (`modeling/blend_shape.lucb`, `blend.lucb`; `surfacing/bridge_fillet.lucb`; luce-cad
MODELING.md, Parasolid's sections, limits and setbacks; Blends between surfaces, Bridge Fillet):
- **sections**: a `BlendShape` (Fusion's weight, Parasolid's conic and G2 shapes) travels every
fillet path the Tangency weight did; conic by rho, rho relative (0.5 the circle) and middle
radius; G2 by depth and skew or softness, laid out as Fusion's G2 so setback corners and
loops take it; chamfers' distances were already apex ranges;
- **limits and caps**: a fillet between two fractions of one straight edge, its ends planes
square to the edge that cap it (`<tag>/cap`);
- **setbacks**: corners' fillets set back at least a number of radii, the setback patch filling the
gap;
- **overflow** on (the default rules: smooth, notch, cliff) or off (the fillet must fit its
faces);
- **corners of four or more edges** are the kernel's (SMLib study item 7, landed beside this:
2N-sided setback corners), and overflow's smooth, notch and cliff its default rules (item 8);
- **Bridge Fillet**: a circular blend tangent to three face sets (seven-unknown Newton on the
contacts and radius), the center set consumed;
- **Corner** (Ball Corner, Corner Blend) is Fill on the corner's hole; Fill now drops a
reference of disagreeing neighbors (a ball corner fills within 2.7% of the ball, was 22%).
- **luced-3d**: the Fillet node's and step's Conic, Rho, G2 shape, Depth, Skew, Softness, Limits,
Setback and Overflow rows; the Bridge Fillet and Corner steps and nodes (`blend_ops.luc`), offered on the
right-click on faces and the S and Modify menus, Bridge Fillet's third prompt "Pick center set".
Captures (`tools/preview.py --scene`, preview_corner.luc): `surf8_conic`, `surf8_g2_depth`,
`surf8_limits`, `surf8_setback`, `surf8_bridge`, `surf8_corner` (also `--mode 7` and
`--background`); Stage 7's follow-ups `surf_fill_lid`, `surf_fill_lid_g2`, `surf_fill_molded`.
Tests, against closed forms (luce-cad `blend_shape_tests.luc`, `blend_build_tests.luc`,
`fill_tests.luc`; luced-3d `edit_cad_corner_tests.luc`):
- conic ρ 0.5 relative with equal sizes is the circle (its volume, its middle (√2 − 1) r in);
ρ 0.5 absolute the parabola (r² / 6 taken per length, its middle halfway); a middle radius of the
circle's own the circle;
- G2 depth d puts the section's middle d of the way from the chord to the corner, G2 at both faces;
skews mirror; softness deepens;
- a fillet limited to the middle half of a box's edge takes half its section's area, two caps square
to it (G1 and G2);
- setbacks of three radii stop a corner's three G2 fillets 1.5 from it (0.75 by default);
- Bridge Fillet over a rib is the half cylinder to 1e-15, its walls trimmed, its top consumed;
- a four-edge corner with setbacks measures G1 on every patch edge, and an overflow over a concave
edge becomes a cliff: the kernel's `apex_tests` and `overflow_tests`;
- in the editor: the Fillet node's conic, depth and limits; Bridge Fillet's three prompts and its
half cylinder; Corner on a rounded corner's three fillets.
**Class-A corners and lids** (2026-10-12; luce-cad MODELING.md, Fill, Class-A corners and lids).
The ball corner's and the lid's zebra stripes drew into stars. Three constructions, measured by the
new `CadMeasure.fairness` (the mean curvature's spread and ripple, the peak curvature over the mean,
the smallest area element) before and after:
| Case | Before | After |
|---|---|---|
| Ball corner (three G1 fillets, ball taken away) | plate 2.7% of r off the ball; spread 18%, ripple 25%, peak 2.0 | the ball itself (rational window, poles off it), 1e-15 off; spread 0, ripple 0, peak 1.0 |
| Lid on four walls, Quad G1 / G2 | smallest area element 0.06 / 0.02 of the mean, peak 42 / 73, ripple 2247% / 5727%; 4 by 4 | 0.73 / 0.63, 4.7 / 4.1, 65% / 93% (strips held through the corners' turns); 16 by 16 / 32 by 32 |
| Five-sided corner, G3 fillets and walls, G2 | trimmed net 96 by 64, 107 s, G2 up to 199% off | five quads, about 1 s; G1 1e-4°, walls G2 exact, fillets within 2% but near the hole's corners |
| Box corner of three G3 fillets, setback patch taken away, G2 | (G1 trimmed fill) | six quads, G1 and G2 exact on all twelve edges, seams G2 |
The Fill step's and node's Domain row gains Quads; the Corner step fills a ball's hole with the ball
and a setback corner's with quads. Zebra's stars on a ball are the stripe cylinder's pole, not the
surface's (`surf8_corner` now shows the pole the ball itself shows). Captures: `surf8_corner`,
`surf8_corner_g2`, `surf_fill_lid` (all with `--mode 7`), and `cad_fillet_step`: the Edit CAD fillet
step's rows regrouped, the section's first and Limits, Setback and Overflow behind More options
(closed), Tangent chain beside Radius.
**Stage 8, second round** (2026-10-12; luce-cad MODELING.md, Parasolid's sections, limits and
setbacks, Identify blends and reblend, Shell, Stitch; luced-3d MODELING.md):
- **Overflow behaviours chosen** (`BlendLimits.overflow`, a set of Parasolid's tried in order):
smooth (rolling on over a split face, and now onto a curved face tangent to the face beyond it:
the SMLib study's item 8, curved case), cliff (a true cliff-edge blend: tangent to the other face
and through the edge where the face ends, G1; an inside corner's wall lower than the fillet too)
and notch. The Fillet node's and step's Overflow
gains Smooth, Cliff and Notch rows. Closed forms: F6 and the ledge plate with Cliff (1501.45 and
2301.45), the plate's bottom edge rounded 3 then its top 1.5 rolling onto it (G2 fuller).
- **Caps by faces or sheets** (`CadModeling.capped_fillet`): blends stopping at a face's surface
(of the body or another), the cut their cap; half the spandrel prism at x = 0, the prism cut at
its centroid by a plane at 45°, G2 half the whole edge's.
- **Identify blends** (`identified_blends`, `blend_radius`) and **reblend** (`CadDirect.reblended`):
cylinders, tori and corner balls met tangentially by their walls, found from the geometry alone;
reblend deletes the chain with healing and fillets it again as edge sets, the picked at the new
radius, the others at theirs. A cube rounded 2 reblended to 3 is Steiner's volume. In Edit CAD:
Select blends (right-click) and Reblend (Press Pull on fillet faces, as Fusion's), `cad_reblend`.
- **Selection sets and variable edges into a corner in the UI**: the Fillet node's Selection sets
(sets 2 to 9, Pick set k edges, Set k radius, an arrow per set) on `filleted_sets`; Variable radius
with set 2 the constant edges its law runs into (`variable_filleted_edges`); Edit CAD's Add as
fillet set on the last Fillet step. Captures `cad_fillet_sets`, `cad_variable_corner`,
`cad_fillet_step_sets` (and `--background`).
- **Kernel leftovers**: Stitch's sliver and short-edge removal that keeps a thin plate's sides (the
faces across a thin face's long edges decide); a body rounded on every edge shelled open at its
top with a wall thinner than the rounds (the closed shell opened square to the top); G2 and G3
strips, G2 setback corners and small chamfers swallowed by a shell's wall (healed, or the convex
cell of the flat faces' planes): luce-cad's SMLib study, items 11 and 12.
- **Fusion's overflow default** (probe 12): F6 and the ledge plate rounded 5 and 4.5 are Fusion's
cliff-edge blends to 1e-10 (not the notch), so the default takes all three behaviours, cliff
before notch; Fusion's rolled-on plate matches ours to 1e-4.
- **Corner's Center adjust** (Alias's Ball Corner): the patch's middle moved along its normal by a
share of the hole's size, through Fill's interior point (`surf8_corner_center`, G1 kept).
Captures (`tools/preview.py --scene`): `kernel_cliff_edge`, `kernel_rolled_on` (also `--mode 7`),
`cad_fillet_sets`, `cad_variable_corner`, `cad_fillet_step_sets`, `cad_reblend`, `surf8_corner_center`.
Not done in the second round: Y-blends and vertex blends, round order at mixed corners, cliff-end
and concave edges' rolled overflow, overlap limits, Alias's Pivot Curve Length Ratio and Corner
Blend's Edge Shape sliders, G2 Corner fills of G2 fillets, laws on chains round faces and loops
between curved faces at corners, and the face soup's arrangement for bodies that are not convex
(the third round, below).
**Stage 8, third round** (2026-10-13; luce-cad MODELING.md, Fillets meeting at corners (Y corners,
Vertex blends, the corner's controls), Parasolid's sections, limits and setbacks (Inside edges and
ends); probes 14 and 15, `luce_work/cad/fusion/FINDINGS.md` 31–37):
- **Y-blends** (`modeling/y_blend.lucb`, the direct build's fifth corner kind): an inside and an
outside fillet meeting where the third edge stays sharp. The one of the sharp edge's kind runs on,
the other's section rolls round its end: Fusion's torus at G1 (a boss's upright and one foot,
14 faces, the closed form 1815.952928 against Fusion's solid 1815.952915; radii 1 and 2 either
way; an L's inside upright and one top edge, 11 faces), the section swept round the rim at G2 and
G3 (fitted, held G2/G3 to every strip and face; the cut on the plate a crease, as Fusion's).
Fusion's reported volumes are its default accuracy's; its STEP solids are measured instead.
- **Mixed corners of three** (one of a kind and a pair): the same sweep round all of the lone
edge's end, built directly at G1, G2 and G3 (Fusion's rolling ball: its G1 tori; its G2 boss
1816.998776, ours 1816.997967).
- **Setbacks and vertex blends**: setback corners stop 2 r back (Fusion's; 1.5 r before), their G1
face curves Fusion's circles; under the Setback corner type G1 corners are built directly, and
mixed corners are vertex blends (the same six quads). Fusion's own patch is fuller (a hexagon's
transfinite fit): volumes within 0.2% (cube) to 1.2 (L); Corner fullness about 1.3 (G1) or 1.1
(G2) meets them.
- **G2 corners of G2 fillets**: the kernel's setback corners hold G2 on every edge exactly (the face
curves G2 sections, flat at their ends, so the strips' rows and the faces' agree at the hole's
corners; Fusion's circles there would break it). Corner (Fill) on such a hole: G2 exact while the
hole stays within about a third of the box (r 0.3 on a 2-box); larger holes leave Fill's quads
singular (a Fill limit, open). Fusion's own default for three G2 fillets is a three-sided patch
between their end sections at r (7845.375), which has the rate conflicts at its corners; ours keeps
the setback corner there.
- **Alias's corner controls** on setback corners: Corner edge shape (Corner Blend's Edge Shape:
the face curves' rho, 0.5 the circle) and Corner fullness (Ball Corner's Pivot Curve Length
Ratio: the patch's bulge scaled), on the Fillet node and step (More options).
- **Overflow on inside edges and ends**: an inside foot rolls onto its wall's rounded top (Fusion's
1764.688847); a foot over a step ends flush (cliff end, Fusion's); a notch under one end trims a
convex fillet (Fusion's 7761.5377437); Parasolid's overlap limit (Limits' At overlap) stops it
square where it stops fitting.
Captures (`tools/preview.py --scene`): `kernel_y_boss`, `kernel_y_boss_g2` (`--mode 7`),
`kernel_y_ell`, `kernel_mixed_g2` (`--mode 7`, `--background`), `kernel_vertex_blend` (its rows),
`kernel_inside_rolled`, `kernel_notch_end`.
**Stage 8, fourth round** (2026-10-13; luce-cad MODELING.md, Fillets meeting at corners, Variable
radius at corners, Shell; probes 17 and 18, `luce_work/cad/fusion/FINDINGS.md` 40–43):
- **Fusion's default corners**: three G2 or G3 fillets under Rolling ball stop through the ball's center
and three quads join their end sections (`three_sided.lucb`; Fusion's 7845.406289 and 7960.487036
for a 20 cube's corner rounded 4 and 2, within 0.01; G2 all round at a square corner); Setback
keeps the setback corner. Corner fullness 0 (Fusion's) is the default; the G2-rounded box's shell,
which had blocked it, closes (B-spline offsets fitted to a quarter of the tolerance over each span).
- **Setback reach for unequal radii** (probe 17, nineteen radius mixes, G1 and G2, both corner types):
past the farther crossing by the mean contact distance, the one smallest half its gap to the next
more; every case exact. Volumes within 0.3 to 3.6 (Fusion's face curves for unequal legs are fitted
cubics, no conic or superellipse within 1%).
- **Fill**: setback holes fill G2 exactly at any reach (a middle knot a rounding off 0.5 had split a
span of no length).
- **Variable radius into corners** (probe 18): a straight law runs in as Fusion's, a cone cut by the
corner, its stops by the same rule on the true contact lines (Fusion's to 1e-3); the patch's rows
along the rulings, G1 within thousandths of a degree (Fusion's own 0.4), G2 within 3% (Fusion's
150%); volumes within 5 (0.06%). Not built: Fusion's ball-like corner where the law's radius at the
crossing reaches the others'.
- **Shell by the cells of the planes** (`shell_cells.lucb`): an L rounded 1 on every edge shelled 2
closed, open and at G2 (Fusion's 3423.3006, 3107.4377, 3436.1456: ours within 0.005, 0.005, 0.2),
an L with a chamfer swallowed at 3 (4646 exactly); an inner G2 round is its strip's offset section.
Not done this round: laws on chains round faces and loops between curved faces meeting corners; the
five-sided wall corners' rate conflicts (exact sweep rows beside walls holding the sweep were tried:
the miss at the hole's corners rose to 100%, so the stations stay).
Captures (`tools/preview.py --scene`): `kernel_three_sided` (`--mode 7`, also `--background`),
`kernel_ell_shell`, `cad_variable_corner` (`--mode 7`).
## 9. Notes for the build
- **Parity checks without the apps.** Alias, Plasticity and Rhino are not installed here. A
behavior marked [unverified] stays so until a script in the real application settles it, as
FUSION §9 suggests for Fusion.
- **Don't copy.** The Parasolid Functional Description describes behavior and option sets, and we
match those. Its algorithms are not given there, and none of its code is used.
- **Degree 5 everywhere.** A reference tool's default degree (Alias's fillet sections at 7, its
N-sided at 3, Rhino's Patch at 3) becomes our degree 5 with the spans the continuity needs.
Explicit Control can still ask for theirs.
## 10. Questions answered by the owner
The owner's answers (2026-10-12):
1. **Curves and sheets as first-class objects: yes.** CAD geometry sets gain free 3D curves,
curves on surfaces and open surface bodies as objects, beside sketches.
2. **Single spans: yes, on request.** The default is the multi-span quintic. Explicit Control
offers a single span of degree 7.
3. **G4: on blend curves only.**
4. **Order: as planned.** Stages 0 to 8, in order.
5. **CV edits on aligned rows: re-run the Align.** In Edit CAD, a CV drag on a row that an Align
step constrained re-runs that Align afterwards (§6.10's toggle is not needed).
6. **Alias's production extras come after Stage 8.**
The questions as asked:
1. **Curves and sheets as first-class objects.** Alias's workflow needs free 3D curves, curves on
surfaces and open surface bodies in CAD networks and in Edit CAD (Stages 2–3). Agreed that CAD
geometry sets gain a curve component beside sketches?
2. **Single-span results.** Alias and Plasticity offer single-span (Bézier) patches. A G3 single
span needs degree 7. Default to multi-span quintic, with Explicit Control allowing degree 7
single spans on request?
3. **G4 for curves.** Alias and Rhino blend curves go to G4: five quintic spans by our rule. Offer
it on curves only, as they do?
4. **Order.** Measuring and the NURBS toolkit first (Stages 0–1), then curves, trims and Align
before the builders, blends and fill. Or should Align or Fill come earlier?
5. **History of CV edits.** CV edits in Edit CAD are direct. Should a CV drag on a row that an Align
step constrained be refused for that row, or re-run the Align afterward?
6. **Class A extras.** Light Tunnel, Highlights as curves, Fillet Flange, Panel Gap and Draft walls
are Alias tools for production surfacing. Include them in this round's parity, or after Stage 8?