api_check_vertex_errors
List of: Functions
Subjects: Debugging, Tolerant Modeling
Contents: Kernel

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
PDF/KERN/16FNA.PDF
HTM/DATA/KERN/KERN/16FNA/0020.HTM