api_dm_rm_patch
List of: Functions
Subjects: Deformable Surfaces
Contents: ACIS Deformable Modeling

Action: Removes a patch from a deformable model's patch hierarchy.

Prototype: outcome api_dm_rm_patch (


ATTRIB_DM2ACIS* attrib_dm2acis, // sculpting data




// attribute


int tag_flag, // specify parent




// tgt_dmod to




// get new patch




// 1 =




// active_dmod




// else = dmod




// with tag =




// tag_flag


adm_options* adm_o // adm options


= NULL, //


AcisOptions* acisO // ACIS options such as



= NULL // version and journal


);

Includes: #include "kernel/acis.hxx"

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

#include "admhusk/ds2acis/ds2acis.hxx"

#include "admhusk/ds2acis/dsapi.hxx"

#include "admhusk/ds2acis/adm_options.hxx"

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

Description: Removes and deletes a deformable model patch and its offspring from the target's parent.


The target argument specifies which deformable model to use in a patch hierarchy. Valid values for target are:


1 = active deformable model

2 = root deformable model

-1 = active deformable model and offspring

-2 = root deformable model and offspring


Otherwise, the target is the deformable model whose tag identifier equals target.

Errors: DS_API_NOT_FACE_OR_EDGE

The entity is not a face or an edge, and therefore is not sculptable.



DS_API_NOT_IN_HIERARCHY

The value of the target deformable model is not valid.



DS_API_BAD_PATCH_DOMAIN

The patch domain is not contained by a parent or it overlaps a sibling patch.

Limitations: This function cannot be used to remove a root deformable model shape. It works only on children within the patch hierarchy.

Library: admhusk

Filename: adm/admhusk/ds2acis/dsapi.hxx

Effect: Changes model
PDF/ADM/07FN.PDF
HTM/DATA/ADM/ADM/07FN/0014.HTM