loft() bug

[garywill]

To Reproduce

import cadquery as cq
import math

OP = cq.Vector(0, 0, 0)
X = cq.Vector(1, 0, 0)
Y = cq.Vector(0, 1, 0)
Z = cq.Vector(0, 0, 1)

wr_elp = cq.Wire.makeEllipse(15, 16, OP, Z, X)

wr_circ =cq.Wire.makeCircle(15.5, OP, Z).moved(0, 0, 30)

sld_lofted = (
    cq.Workplane()
    .add(wr_elp)
    .toPending()
    .add(wr_circ)
    .toPending()
    .loft()
)

sld_lofted.export('loft-test.stl')

loft-test.stl.zip

Environment

OS: Linux
Python 3.11

Was CadQuery installed using Conda?: no

Using:

I install by pip install cadquery

aiohappyeyeballs-2.6.1 aiohttp-3.13.1 aiosignal-1.4.0 attrs-25.4.0 cadquery-2.6.0 cadquery-ocp-7.8.1.1.post1 casadi-3.7.2 contourpy-1.3.3 cycler-0.12.1 ezdxf-1.4.2 fonttools-4.60.1 frozenlist-1.8.0 idna-3.11 kiwisolver-1.4.9 matplotlib-3.10.7 more-itertools-10.8.0 msgpack-1.1.2 multidict-6.7.0 multimethod-1.12 nlopt-2.9.1 numpy-2.3.4 packaging-25.0 path-17.1.1 pillow-12.0.0 propcache-0.4.1 pyparsing-3.2.5 python-dateutil-2.9.0.post0 pyyaml-6.0.3 six-1.17.0 trame-3.12.0 trame-client-3.11.2 trame-common-1.0.1 trame-server-3.6.3 trame-vtk-2.10.0 typing_extensions-4.15.0 typish-1.9.3 vtk-9.3.1 wslink-2.4.0 yarl-1.22.0

[lorenzncode]

The following results in 3 pending wires where you expected 2.

cq.Workplane().add(wr_elp).toPending().add(wr_circ).toPending()

The correct usage is:

result = cq.Workplane().add([wr_elp, wr_circ]).toPending().loft()

To avoid confusion over Workplane and toPending usage I'd suggest to directly use the free function API.

There is no need to involve Workplane here and toPending. Workplane anyway calls the free function loft. You can instead directly specify the edges or wires to loft.

from cadquery.func import *

e_elp = ellipse(16.0, 15.0).moved(rz=90)
e_circ = circle(15.5).moved(z=30)
result = loft(e_elp, e_circ, cap=True)

[garywill]

Question about free function api:
Although free function api looks brief, clear and handy, but in doc, most tutorials and examples use workplane. So, Is free function api ready for use? The doc says:

The free function API is experimental and may change.

[adam-urbanczyk]

Yes, you can use it. It might be still tweaked, but I don't expect anything major.