pw:: Surface

pw::Surface create

This action creates a new surface object.

Parameters

none

Returns

This action returns a new pw::Surface object.

pw::Surface createFromCurves ?-tolerance tol? curves

This action automatically creates new surfaces using the given curves as boundaries for Coons patches.

Parameters

Returns

This action returns a list of new pw::Surface objects.

See Also

pw::Database.createSurfacesFromCurves, which works similar to this action except that it makes trimmed planes instead of Coons patches when the input curves are planar.  pw::Surface.interpolate and pw::Surface.patch also create Coons patches with more explicit control over the boundary curves.

pw::Surface join ?-reject rejectVar? ?-tolerance tol? surfs

This action joins as many of the given surfaces together as possible.

Parameters

Returns

This action returns a list of the pw::Surface objects that were joined.

Information

This command supports progress updates.

$surface getPosition ?-parameter? value

This action gets the position in the defining space of the surface at the given parameter.

Parameters

Returns

This action returns a point giving the position on the surface (may be in the form “u v dbentity”).

$surface getXYZ ?-parameter? value

This action gets the position of the surface in model space at the given parameter.

Parameters

Returns

This action returns an XYZ vector.

$surface getBoundaryCount

This action gets the number of boundaries of the surface.

Parameters

none

Returns

This action returns the number of boundaries of the surface.

$surface getBoundary < index | boundary >

This action gets a surface boundary.

Parameters

Returns

This action returns a boundary.

Information

The boundary index 1 corresponds to VMinimum, 2 corresponds to UMaximum, 3 corresponds to VMaximum and 4 corresponds to UMinimum.

$surface getBoundaries

This action gets a surface boundary list.

Parameters

The action has no parameters.

Returns

This action returns a boundary list.

Information

$surface getInteriorCurves

This action gets all the curves that are at least partially on the surface.  Curves along the boundary of the surface will be returned as well, but this function uses the name “interior” to differentiate from the boundary curves that are returned by getBoundary

Parameters

This action has no parameters.

Returns

This action returns a list of pw::Curve objects.

$surface clear

This action sets the surface to the initial cleared state.

Parameters

This action has no parameters.

Returns

This action returns nothing.

$surface sweep ?-reverse? generatrix vector

This action sets the surface by sweeping a curve by a vector.

Parameters

Returns

This action returns nothing.

$surface interpolate ?-orient < Same | Opposite | Best >? ?-tolerance tol? rail1 rail2 ?rail3 rail4?

This action sets the surface by interpolating between the given curves.  If two curves are given a ruled surface is created.  If four curves are given a Coons patch is created with rail1 specifying the minimum u border and the rest of the rails arranged based on their ends being within the given tolerance, and the -orient flag is ignored.

Parameters

Returns

This action returns nothing.

$surface patch ?-tolerance tol? ?-surfaceTolerance tol? ?-fitTolerance tol? ?-fitInterior threshold? ?-fitEntities entities? ?-fitted fittedVar? rail1 rail2 rail3 rail4

This action sets the surface by creating a patch between the given rails.  The rails can be one or more curves and borders and do not necessarily need to match exactly end to end, but should come within the given tolerance of each other or intersect.

Parameter

Returns

This action returns nothing.

Examples

Code

# Simple coons surface w/ 4 curves
surf(patch1) [pw::Surface create]
$surf(patch1) patch [list $curve(1)] [list $curve(2)] \
    [list $curve(3)] [list $curve(4)]

# Coons surface with sharp angle along side
set ccrv(p1) [create2PtCurve {10 10 30} {11 15 30}]
set ccrv(p2) [create2PtCurve {11 15 30} {19 15 30}]
set ccrv(p3) [create2PtCurve {19 15 30} {20 10 30}]
set ccrv(p4) [create2PtCurve {10 0 30} {10 10 30}]
set ccrv(p5) [create2PtCurve {10 0 30} {20 0 30}]
set ccrv(p6) [create2PtCurve {20 0 30} {20 10 30}]
$surf(patch1) patch [list $ccrv(p1) $ccrv(p2) $ccrv(p3)] \
    [list $ccrv(p4)] [list $ccrv(p5)] [list $ccrv(p6)]

$surface fillet ?-rho rho? ?-tolerance tol? rail1 rail2 intersection ?spine?

This action sets the surface by connecting two curves using a polyconic.

Parameters

Returns

This action returns nothing.

$surface revolve ?-angle revolve? ?-tolerance tol? generatrix < axis | point normal >

This action sets the surface by revolving a curve around another curve or axis.

Parameters

Returns

This action returns nothing.

$surface spline ?surface?

This action sets this surface to a smooth interpolation of the control points of the given surface.

Parameters

Returns

This action returns nothing.

$surface fitLSQ ?-tolerance tol? ?-interior? ?entities?

This action sets this surface to a least squares fit approximation of the given entities.

Parameters

Returns

This action returns nothing.

Information

As a first step to fitting, the surface’s control points will be projected in the direction of the surface normal at that location in both directions on to the given dbentities.  This will inform the fitting routine what will be fitted to.  Because of this, even if an entity is given in the dbentities list

Example

Code

set b1 [create2PtCurve {70 0 0} {75 0 5}]
set b2 [create2PtCurve {75 0 5} {75 10 5}]
set b3 [create2PtCurve {75 10 5} {70 10 0}]
set b4 [create2PtCurve {70 10 0} {70 0 0}]
set surf(fit) [pw::Surface createFromCurves [list $b1 $b2 $b3 $b4]]
$surf(fit) fitLSQ -interior

$surface split ?< -U | -V >? parameters

This action splits the surface in the given direction at a given parameter value.

Parameters

Returns

This action returns a list of the new pw::Surface objects.

Information

Any duplicate parameters will be ignored, as will parameters at the limits of the surface.

$surf setOrientation u_edge v_edge

This action sets the orientation of this surface by specifying the umin and vmin edges of the surface.

Parameters

Returns

This action returns nothing.

Information

For both the u_egde and v_edge the following boundary keywords or the associated index may be used: VMinimum = 1, UMaximum = 2, VMaximum = 3, UMinimum = 4.

$surf alignOrientation ?-tolerance tol? surfaces

This action aligns the UV orientation of the given surfaces with this surface.  If any surfaces in the given list are not connected within the given tolerance to this surface, they will be ignored.

Parameters

Returns

This action returns nothing.

$surface isClosed ?< -U | -V >?

This action checks if the surface is closed in the given direction.

Parameters

Returns

This action returns a boolean, which is true if the surface is closed in the given direction.

$surface isPole ?< -UMin | -UMax | -VMin | -Vmax >?

This action checks if the surface Edge is a pole.

Parameters

Returns

This action returns a boolean, which is true if the given surface Edge is a pole.

$surface getDiscontinuities ?< -U | -V >? ?angle?

This action returns a list of parameters in the given direction at discontinuites with a bend angle greater than the given angle.

Parameters

Returns

This action returns a list of parameters at discontinuities.

$surface getXYZsAtParameter ?< -U | -V >? parameter

This action gets a list of points along a constant parameter of a surface suitable for rendering.

Parameters

Returns

This action returns a list of the xyz points.

$surface getXYZsAtIntervals ?dimensionVar?

This action gets a list of points along the U- and V-intervals.

Parameters

Returns

This action returns xyz points representing constant U- and V-parameter lines at the surface’s intervals.  The result will be a list of lines, with each line specified as a list of XYZ vector values.  The number of lines will be equal to the number of U- and V-intervals (ie, the sum of the values returned in dimensionVar).  The U-interval lines will be listed first, followed by the V-interval lines.

$surface getIntervalParameters ?< -U | -V >

This action gets the list of interval parameters in the U or V direction on a surface.

Parameters

Returns

This action returns a list of parameters for the specified direction.