Method twistExtrude

cadquery/cq.py:2980–3028

Extrudes a wire in the direction normal to the plane, but also twists by the specified angle over the length of the extrusion. The center point of the rotation will be the center of the workplane. See extrude for more details, since this method is the same except f

(
        self: T,
        distance: float,
        angleDegrees: float,
        combine: CombineMode = True,
        clean: bool = True,
    )

    # TODO: duplicated code with _extrude and extrude
    def twistExtrude(
        self: T,
        distance: float,
        angleDegrees: float,
        combine: CombineMode = True,
        clean: bool = True,
    ) -> T:
        """
        Extrudes a wire in the direction normal to the plane, but also twists by the specified
        angle over the length of the extrusion.

        The center point of the rotation will be the center of the workplane.

        See extrude for more details, since this method is the same except for the the addition
        of the angle. In fact, if angle=0, the result is the same as a linear extrude.

        **NOTE**  This method can create complex calculations, so be careful using it with
        complex geometries

        :param distance: the distance to extrude normal to the workplane
        :param angle: angle (in degrees) to rotate through the extrusion
        :param combine: True or "a" to combine the resulting solid with parent solids if found,
            "cut" or "s" to remove the resulting solid from the parent solids if found.
            False to keep the resulting solid separated from the parent solids.
        :param clean: call :meth:`clean` afterwards to have a clean shape
        :return: a CQ object with the resulting solid selected.
        """
        faces = self._getFaces()

        # compute extrusion vector and extrude
        eDir = self.plane.zDir.multiply(distance)

        # one would think that fusing faces into a compound and then extruding would work,
        # but it doesn't-- the resulting compound appears to look right, ( right number of faces, etc)
        # but then cutting it from the main solid fails with BRep_NotDone.
        # the work around is to extrude each and then join the resulting solids, which seems to work

        # underlying cad kernel can only handle simple bosses-- we'll aggregate them if there
        # are multiple sets
        shapes: List[Shape] = []
        for f in faces:
            thisObj = Solid.extrudeLinearWithRotation(
                f, self.plane.origin, eDir, angleDegrees
            )
            shapes.append(thisObj)

        r = Compound.makeCompound(shapes).fuse()

        return self._combineWithBase(r, combine, clean)

    def extrude(
        self: T,