Category Curve and surface collection, Object ProCrvcollection

Function ProCrvcollectionRegenerate


Description
Generate the selection based on the instructions set in the curve collection.

Note: This function will not be able to extract geometry, if some or all of the resulting geometry is inactive due to material removal features occuring in the model. In order to extract the reference geometry for such a collection, use ProFeatureInsertModeActivate() to roll back the model before the material removal feature.

Replacement in Object TOOLKIT: wfcWModel::GenerateSelectionsFromCollection
Synopsis
#include <ProCrvcollection.h>
ProErrorProCrvcollectionRegenerate(
ProCollection collection
/* (In)
The curve collection.
*/
ProSelection** r_result_sellist
/* (Out)
ProArray of selections allocated by the function. Use ProSelectionarrayFree() to free the memory. Note: For curve collections containing one or more "Extend" instructions, the ProArray returned will include at least one invalid selection. This selection represents the entity that is created by extension of a selected curve or edge beyond its actual boundary. The invalid selection can be identified by ProSelectionVerify(), which returns PRO_TK_INVALID_TYPE for this type of selection.
*/
int* r_result_sel_num
/* (Out)
Number of selections made.
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully generated the collection.
PRO_TK_OUT_OF_MEMORYThere was a memory error.
PRO_TK_BAD_INPUTSThe input argument is invalid.
PRO_TK_GENERAL_ERRORThere was a general error.
PRO_TK_E_AMBIGUOUSThe curve collection chain cannot be regenerated because there is an ambiguity which could not be resolved.
PRO_TK_E_NOT_FOUNDThe curve collection chain cannot be regenerated because a reference could not be found while collecting edges/curves/points.
PRO_TK_NOT_VALIDThe checking of the curve collection failed.

Manual References:

  1. User Interface: Curve and Surface Collection: Creation and Modification of Curve Collections
  2. User Interface: Curve and Surface Collection: Access of Collection Object from Feature Element Trees

Sample Code References:

  1. pt_userguide ( UgGeomCurveLength.c )