api_offset_faces_specific
List of: Functions
Subjects: Local Operations
Contents: Local Ops

Action: Offsets an array of faces, each face as required.

Prototype: outcome api_offset_faces_specific (


int const& n_def_face, // number of faces offset


FACE* def_face[], // faces being offset


double def_offset, // default distance to




// offset


int const& n_spec_face, // number of faces with




// specific offsets


FACE* spec_face[], // faces with specific




// offsets


double spec_offset[], // specific offset values


SPAposition box_low, // start of intersection




// box to be used


SPAposition box_high, // end of intersection




// box to be used


AcisOptions* ao = NULL // ACIS options


);

Includes: #include "kernel/acis.hxx"

#include "kernel/kernapi/api/api.hxx"

#include "kernel/kerndata/top/face.hxx"

#include "lop_husk/api/lop_api.hxx"

#include "baseutil/vector/position.hxx"

#include "kernel/kernapi/api/acis_options.hxx"

Description: Replaces surfaces of supplied faces with surfaces offset. Unless in the specific array, each face in the face array is offset by the default offset distance. If a face is in the specific array, the face is offset by the amount in the corresponding entry in the specific distance array. Note that faces with specific offsets must be in both face arrays.


Radial faces with surfaces which cannot be so offset are removed and the resulting wound healed by the surrounding face surfaces.


The offset operation on the faces is determined by four arguments, the number of faces and which faces, the number of faces with specific offsets and the faces with specific offsets.


The default offset distance is defined by a double. The specific offset distances are defined by an array of doubles.


The box low and high arguments are used to limit any geometrical intersections and so improve performance. Limiting the intersection improves performance. The box must contain the final faces and if omitted defaults to the size box.


Topology Changes:


In addition to the following, refer to the topology changes listed for the function, api_tweak_faces.


Faces with radial surfaces which cannot be offset by the distance without degenerating or inverting (spheres, cones, blended edges, blended vertices, and tori) are removed and the resulting wound healed by the surrounding face surfaces,before the offset.


Geometry Changes:


Refer to the geometry changes listed for the function, api_tweak_faces.

Errors: In addition to the following, refer to the Errors listed for the function, api_tweak_faces.



Valid offset ( greater than minus the body box max side ), and not a zero offset ( magnitude greater than twice SPAresabs ) or error;-


LOP_OFF_BAD_OFFSET

Limitations: Refer to the Limitations listed for the function, api_tweak_faces.

Library: lop_husk

Filename: lop/lop_husk/api/lop_api.hxx

Effect: Changes model
PDF/LOP/03FN.PDF
HTM/DATA/LOP/LOP/03FN/0007.HTM