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

Action: Specifies an edge solution that a subsequent tweak will use.

Prototype: outcome api_tweak_pick_edge_solution (


EDGE* edge, // edge being specified


int soln_no, // the solution curve to




// use when curve is




// non-NULL


CURVE* curve = NULL, // the new edge geometry


AcisOptions* ao = NULL // ACIS options


);

Includes: #include "kernel/acis.hxx"

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

#include "lop_husk/api/lop_api.hxx"

#include "kernel/kerndata/geom/curve.hxx"

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

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

Description: After a call to api_tweak_faces_init, attributes containing EDGE solution curves are attached to EDGEs involved in the tweak. This function allows the user to specify which of multiple solutions a subsequent tweak will use. Note, it is possible to choose a solution that forces the tweak to fail or make a bad model. It is also possible to specify incompatible solutions. Therefore, the user must take care when using this function, particularly when specifying solutions on more than one EDGE.


If a curve is supplied, this curve will be used as the new edge geometry (if the curve is one of the possible solutions in the edge attribute) and the variable solution_no is ignored. If no curve is supplied, solution_no represents the index of the curve to be used.


To query the possible solutions on an edge, use api_tweak_query_edge_solutions.


To complete the tweak after any number of edge solutions have been specified, use api_tweak_faces.


Topology Changes:


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


Geometry Changes:


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

Errors: If the edge does not have a LOP_EDGE_ATTRIB attribute, i.e. the edge was not involved in the initial stages of a tweak, or the solution number is not valid LOP_TWK_NO_EDGE.

Library: lop_husk

Filename: lop/lop_husk/api/lop_api.hxx

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