DM_set_cstrn_src_data
List of: Functions
Subjects: DML Constraints, Deformable Modeling
Contents: Standalone Deformable Modeling

Action: Modifies the value of the pass through src_data pointer stored with each constraint.

Prototype: void DM_set_cstrn_src_data (


int& rtn_err, // out: 0=success or




// neg err code


DS_dmod* dmod, // in: member of target




// dmod hierarchy




// to search


int tag, // cstrn identifier


int tgt // for link_cstrns,



= 1, // tgt = 1 or 2


void* src_data // new src_data ptr value



= NULL, //


SDM_options* sdmo // in:SDM_options pointer



= NULL // note: sets active dmod


);

Includes: #include "kernel/acis.hxx"

#include "dshusk/dskernel/dmapi.hxx"

#include "dshusk/dskernel/dsdmod.hxx"

#include "dshusk/dskernel/sdm_options.hxx"

Description: Sets the tag constraint's src_data pointer value. The src_data pointer value is stored with each constraint as a convenience for the application program which might want to store application specific data. The DM Modeler package never accesses or uses the src_data pointer. Calling applications that use this pointer must guard against memory leaks on their own as the constraints are deleted.

Errors: DM_NULL_INPUT_PTR

The deformable model cannot be NULL on input.



DM_TAG_OBJECT_NOT_FOUND

The input tag cannot identify a constraint in the deformable model hierarchy.



DM_BAD_SRC_DATA_TGT_VALUE

The input target value must be 1 or 2.

Library: dshusk

Filename: ds/dshusk/dskernel/dmapi.hxx

Effect: Changes model
PDF/DS/05FNJ.PDF
HTM/DATA/DS/DS/05FNJ/0043.HTM