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

Action: Gets the deformable model's beta values and returns 0 or an error.

Prototype: void DM_get_beta (


int& rtn_err, // out: 0=success




// or negative err code


DS_dmod* dmod, // in: dmod to be queried


double* beta, // out: resistance to




// bending values




// curves: [beta=5.0],




// sized:[1]




// surfs: [bu=5.0,




// bv=5.0, btheta=0.0],




// sized:[3]


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: Returns the deformable model's resistance to bending beta values. For curves there is only one beta value and it is stored in beta[0]. In surfaces the beta value is a second order tensor which can be described with three numbers, a u_dir resistance, a v_dir resistance, and a rotation. The rotation is the angle between the u and v principle directions of the surface and the material property directions. The beta values are stored as beta[0] = bu, beta[1] = bv, beta[2] = btheta.


In practice we have discovered that if end users become accustomed to sculpting by dragging point constraints, attempting to sculpt with beta values is very counter intuitive. When sculpting, we recommend that you leave the beta values at their default values and rely solely on loads and constraints for sculpting.

Errors: DM_NULL_INPUT_PTR

The deformable model cannot be NULL on entry.



DM_NULL_OUTPUT_PTR

The beta cannot be NULL on entry.

Library: dshusk

Filename: ds/dshusk/dskernel/dmapi.hxx

Effect: Read-only
PDF/DS/04FNG.PDF
HTM/DATA/DS/DS/04FNG/0006.HTM