Action:
|
Checks whether edges have errors that require them to be made tolerant, and optionally performs this conversion.
|
|
Prototype:
|
outcome api_check_edge_errors (
|
|
|
ENTITY_LIST const& edges,
|
// input edges
|
|
|
ENTITY_LIST& bad_edges,
|
|
// bad edge list
|
|
|
ENTITY*& worst_entity,
|
|
// worst entity
|
|
|
double& worst_error,
|
|
// worst error
|
|
|
double tol
|
|
// given tolerance
|
|
|
|
= SPAresabs,
|
|
|
logical stop_immediately
|
|
// if TRUE, stop
|
|
|
|
= FALSE,
|
|
// after first bad
|
|
|
|
|
|
// edge is found
|
|
|
ENTITY_LIST& new_edges
|
|
// tolerant edges
|
|
|
|
=*(ENTITY_LIST*)NULL_REF,
|
|
|
AcisOptions* ao = NULL
|
// acis options
|
|
|
);
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "baseutil/logical.h"
|
|
#include "kernel/kernapi/api/api.hxx"
|
|
#include "kernel/kernapi/api/kernapi.hxx"
|
|
#include "kernel/kerndata/data/entity.hxx"
|
|
#include "kernel/kerndata/lists/lists.hxx"
|
|
#include "kernel/kernapi/api/acis_options.hxx"
|
|
Description:
|
Checks the edges in the given list for gaps worse than the specified tolerance. Any such edges are added to the
bad_edges list. If
new_edges is given, such edges are converted into tolerant edges, and the end vertices are converted to tolerant vertices if necessary.
|
|
|
The
bad_edges and
new_edges lists are mapped so that
bad_edges[i] is converted into
new_edges[i].
|
|
|
If the
stop_immediately flag is
TRUE, processing stops after the first bad edge is found.
|
|
|
The
worst_entity and
worst_error
always get set, even if the error in question was sufficiently small that the entity reported is not actually "bad".
|
|
|
Note that
api_check_edge_errors normally converts "bad" edges into tolerant ones. This function is only needed to check for "bad" edges where none of the adjacent edges there needed to be made tolerant.
|
|
Library:
|
kernel
|
|
Filename:
|
kern/kernel/kernapi/api/kernapi.hxx
|
|
Effect:
|
Changes model
|