Action:
|
Checks the vertices in the given list for gaps worse than the specified tolerance.
|
|
Prototype:
|
outcome api_check_vertex_errors (
|
|
|
ENTITY_LIST const& vertices,// input vertex list
|
|
|
ENTITY_LIST& bad_vertices,
|
// bad vertex 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
|
|
|
|
|
|
// vertex is found
|
|
|
ENTITY_LIST& new_vertices
|
// tolerant vertices
|
|
|
|
=*(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 vertices in the given list for gaps worse than the specified tolerance. Any such vertices are added to the
bad_vertices list. If
new_vertices is given, such edges are converted into tolerant edges, and the end vertices are converted to tolerant vertices if necessary.
|
|
|
The
bad_vertices and
new_vertices lists are mapped so that
bad_vertices[i] is converted into
new_vertices[i].
|
|
|
If the
stop_immediately flag is
TRUE, processing stops after the first bad vertex 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."
|
|
|
api_check_edge_errors normally converts "bad" vertices into tolerant ones. This function is only needed to check for "bad" vertices where none of the adjacent edges needed to be made tolerant.
|
|
Library:
|
kernel
|
|
Filename:
|
kern/kernel/kernapi/api/kernapi.hxx
|
|
Effect:
|
Changes model
|