All Frameworks  Class Hierarchy  This Framework  Indexes

SPAblnd Global Function api_fix_blends


outcome api_fix_blends(ENTITY_LIST const& ents,
AcisOptions* ao= NULL )
Creates explicit blends by making a new face to replace each implicitly blended edge and vertex, or by computing an entity-entity blend.

Role: Occurs when given a list of edges and vertices marked with implicit blends, or a BODY is passed and there is an entity-entity blend attribute on the body. The entities passed should be either edges and vertices, or a body, not a mixture.

If the edges have similar blend types, the same convexity, and the same radius, all edges that meet at an unblended vertex are blended. When edges with different blend radii, convexity, and/or setback meet at a blended vertex, they are blended. Edges with different blend radii, convexity, and/or setback that meet smoothly (their adjoining faces meet at the edge with tangent plane continuity) at an unblended vertex, are blended.

Returns the blended edges and vertices of the graph in an entity list.

Errors: An entity in list is not an EDGE or VERTEX or BODY.

Limitations: Blending a single edge cannot handle blends extending beyond the adjacent face boundaries or stopped chamfers/rounds. Blending at a vertex where two edges meet cannot handle blending of edges meeting with a discontinuity.

Blending at a vertex where three edges meet if there are mixed convexities, the order in which blends are fixed is important. The edge with a different convexity must be fixed first. For example. if there are two convex blend edges and one concave, fix the single concave edge first.

Blending at a vertex where more than three edges meet, only single blends (blending of edges and not vertices) are supported.

api_fix_blends is not designed to handle edge lists that has edges from multiple bodies. If edges from multiple bodies must be blended simultaneously, the functions api_blend_edges and api_chamfer_edges can be used.

Cannot handle mixed convexities.

Effect: Changes model

Journal: Available

Parameters:
ents
list of edges and vertices, or body.
ao
ACIS options.

This object is included in the file: blendapi.hxx

Copyright (c) 1989-2007 by Spatial Corp. All rights reserved.