DM_set_delta
List of: Functions
Subjects: Deformable Model Management, Deformable Modeling
Contents: Standalone Deformable Modeling

Action: Sets the deformable model's delta and returns 0 for success or an error.

Prototype: void DM_set_delta (


int& rtn_err, // out: 0=success




// or negative err code


DS_dmod* dmod, // in: dmod to modify


double delta // in: desired value



= 0.0, // to store


int walk_flag // in: specify how deep



= 0, // to go




// 0=dmod only,




// 1=dmod and offspring




// 2=dmod, siblings




// and offspring


SDM_options* sdmo // in:SDM_options pointer



= NULL //


);

Includes: #include "kernel/acis.hxx"

#include "dshusk/dskernel/dmapi.hxx"

#include "dshusk/dskernel/dsdmod.hxx"

#include "dshusk/dskernel/sdm_options.hxx"

Description: Modifies deformable model->dmo_delta.


Sets the deformable model's resistance to displacement delta values. A walk_flag value of 0 specifies that just the deformable model is modified, and a walk_flag value of 1 specifies that the deformable model and all its offspring are modified. A walk_flag value of 2 specifies that the deformable model, its siblings, and all their offspring are modified.


The delta term was added as an experiment to approximate the behavior of the default shape mechanism before it was built. Since default shapes have been added to the system, we do not recommend that you use a non-zero value for delta when sculpting. The default shapes with delta set to 0 are much more intuitive to use.

Errors: DM_NULL_INPUT_PTR

The deformable model cannot be NULL on entry.



DM_BAD_WALK_FLAG_VALUE

The walk_flag must be 0, 1 or 2.

Library: dshusk

Filename: ds/dshusk/dskernel/dmapi.hxx

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