|
Action:
|
Creates a sheet body that fits a surface through a mesh of wires contained in an array of bodies.
|
|
|
Prototype:
|
outcome api_net_wires (
|
|
|
int num_v_wires,
|
|
// number of wires in
|
|
|
|
|
|
// array
|
|
|
BODY* v_wires[],
|
|
// array of wires
|
|
|
int num_u_wires,
|
|
// number of wires in
|
|
|
|
|
|
// array
|
|
|
BODY* u_wires[],
|
|
// array of wires
|
|
|
BODY*& sheet_body,
|
|
// sheet body
|
|
|
|
|
|
// returned
|
|
|
skin_options* opts,
|
|
// skinning options
|
|
|
double net_tol
|
|
// net surface
|
|
|
|
= SPAresfit,
|
|
// intersection
|
|
|
|
|
|
// tolerance
|
|
|
AcisOptions* ao = NULL
|
// ACIS options such
|
|
|
|
|
// as version/journal
|
|
|
);
|
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "kernel/kernapi/api/api.hxx"
|
|
#include "kernel/kerndata/top/body.hxx"
|
|
#include "skin/kernapi/api/skinapi.hxx"
|
|
#include "skin/sg_husk/skin/skin_opts.hxx"
|
|
#include "baseutil/logical.h"
|
|
#include "kernel/kernapi/api/acis_options.hxx"
|
|
|
Description:
|
The given wires define the cross sections to be interpolated by the resulting sheet body. There must be at least two wires.
|
|
|
The wires are copies; i.e., the originals remain.
|
|
|
The wires can be either all open or all closed.
|
|
|
If only two wires are given, one wire may be a degenerate line; i.e., treated as a point. For example, skinning between a degenerate line and a circular arc will give a spline cone with the "point" being the apex.
|
|
|
If all of the curves intersect, then the surface passes through the curves and their intersections. If any of the
u curves of the net do not intersect all of
v curves at some point, the intersection is interpolated. The maximum distance for the interpolation is governed by the
net_tol argument. The default for this tolerance value is
SPAresfit. If
the tolerance is changed, a net surface can be created as long as the distance between
u curves or between
v curves (e.g., in the skin direction) is larger than the tolerance intersection distance between a
u curve and a
v curve. Thus, the curve interpolating accuracy of the net surface is controlled by the user's accuracy of the intersections of the cross sections.
|
|
|
Errors:
|
A wire pointer in the array is
NULL or not to a wire body.
|
|
|
Limitations:
|
The wire bodies are assumed to be simple; i.e., only the first wire of each body is used for skinning. Each wire must have continuous tangents (C1). Wires cannot share an end point (end points must be distinct). The surface and lateral curves are always splines; i.e., the function is not smart about using analytic representations in special cases. A prop edge is inserted when the wires are closed.
|
|
|
Library:
|
skin
|
|
|
Filename:
|
skin/skin/kernapi/api/skinapi.hxx
|
|
|
Effect:
|
Changes model
|