All Frameworks  Class Hierarchy  This Framework  Indexes

SPAblnd Global Function api_set_const_rounds

Sets an implicit constant radius round on each entity on a list of edges or vertices.

Role: This API attaches implicit rounds as attributes to each edge in the list. Supplies the round radius and start and end setbacks in the local space of the body. The start and end setbacks are zero or positive. They determine the approximate distance from the blended start or end vertex where the blend surface for the vertex ends and the blend surface for the edge begins. Setback is ignored if the vertex is not blended.

Setbacks along the left and right spring curves can be made to differ and a non circular cross curve obtained by giving a nonzero (signed) value of (right setback - left setback) and setting the appropriate logical argument TRUE. At the start, the actual setbacks are found by

 start_right_setback = start_setback +
               (0.5 * start_sb_diff)
 start_left_setback = start_setback -
               (0.5 * start_sb_diff) 

If start_sb_diff_set is given as FALSE, the setbacks are determined from the intersection of the left or right spring curves with the spring curves of the neighboring blended edges at the start. To ensure a circular cross curve at the start, the setback difference should be set to zero and the logical start_sb_diff_set given as TRUE. These are the default values. The end is treated similarly.

If start stop angle or end stop angle values are specified, the edge blend is stopped and capped with a stop plane at given setback distance. This stop plane is constructed such that the angle between stop plane and edge direction, about the line passing through end points of blend cross section, is equal to the specified stop angle value at that end. Stop angle value of 180 degrees is treated as a special case. In such a case, stop plane is constructed such that it passes through end vertex and end points of blend cross section at given setback distance.

Errors: An entity in the list is not an EDGE.

Radius less than -SPAresabs.

Start or end setback less than -SPAresabs.

Limitations: Entity-entity blends cannot create a stopped blend. The stopping location is based upon the edge being blended, thus entity-entity blends do not have this defined location.

Effect: Changes model

Journal: Available

Parameters:

entities

entities to be rounded.

radius

round radius.

start_setback

starting setback.

end_setback

ending setback.

start_setback

diff start setback difference.

end_setback_diff

end setback difference.

start_setback_diff_set

TRUE if start setback difference is set.

end_setback_diff_set

TRUE if end setback difference is set.

start_stop_ang

start stop angle.

end_stop_ang

end stop angle.

eprop

for future use.

ao

ACIS options.

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