|
Action:
|
Sets an implicit blend on a vertex, computing and assigning setbacks automatically.
|
|
|
Prototype:
|
outcome api_set_vblend_auto (
|
|
|
VERTEX* this_vertex,
|
// vertex to be blended
|
|
|
double bulge,
|
// bulge factor [0...2]
|
|
|
bl_continuity bl_contin
|
// blend continuity
|
|
|
|
= slope_continuous,
|
|
|
bl_v_property bl_v_prop
|
// blend property
|
|
|
|
= bl_v_unset,
|
|
|
AcisOptions* ao
|
// ACIS
|
|
|
|
= NULL
|
// options
|
|
|
);
|
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "blend/kernapi/api/blendapi.hxx"
|
|
#include "blend/kernbool/blending/vbl_enum.hxx"
|
|
#include "kernel/kernapi/api/api.hxx"
|
|
#include "kernel/kernbool/blending/bl_enum.hxx"
|
|
#include "kernel/kerndata/top/vertex.hxx"
|
|
#include "kernel/kernapi/api/acis_options.hxx"
|
|
|
Description:
|
An implicit blend is attached as an attribute of the given vertex. The bulge may be given a value between zero and two (one is usual). A larger value increases the fullness of the blend.
|
|
|
Setbacks are computed and applied to each edge of the vertex. Setback values depend on the geometry of the body local to the blended vertex and on sizes of blends already assigned to edges ending in the vertex. The caller should ensure that blend attributes are set on the edges of the vertex before this API is called. Setbacks on edges blended with blends of zero size are left unchanged.
|
|
|
The details of the blend face are found from the radius and setbacks of the edges that end in the vertex.
|
|
|
The
bl_continuity can be set to:
unset_continuity,
position_continuous,
slope_continuous (default), or
curvature_continuous.
|
|
|
The blend property can be set to:
|
|
|
bl_v_cap
|
means a cap or miter at a vertex joined to one or two blended edges (same as default behavior with no attribute on the vertex at the end of a blend sequence).
|
|
bl_v_roll_on
|
means close off the open end or continue on to the next blended edge at the vertex using edge-face or edge-edge blends.
|
|
bl_v_runout
|
means close off the open end using a variable-radius blend.
|
|
bl_v_unset
|
is a vertex blend.
|
|
bl_v_blend
|
is a vertex blend.
|
|
|
Errors:
|
Pointer to vertex is
NULL or not to a
VERTEX.
|
|
Bulge factor less than 0 or greater than 2.0.
|
|
|
Library:
|
blend
|
|
|
Filename:
|
blnd/blend/kernapi/api/blendapi.hxx
|
|
|
Effect:
|
Changes model
|