api_ct_propagate_cface_attribs
List of: Functions
Subjects: Attributes, Cellular Topology
Contents: Cellular Topology

Action: Copies the cface volume attributes (ATTRIB_CFACE_VOL) on a lump.

Prototype: outcome api_ct_propagate_cface_attribs (


LUMP* lump, // lump of interest


AcisOptions* ao = NULL // acis options


);

Includes: #include "kernel/acis.hxx"

#include "ct_husk/api/ctapi.hxx"

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

#include "kernel/kerndata/top/lump.hxx"

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

Description: This API propagates any attributes descended from ATTRIB_CFACE_VOL on the cell data on the lump. Such attributes are intended to represent cell volume data, such as material type, and must be propagated after any change to the model (such as a Boolean) to reflect volume containment and merging.


The algorithm follows:


First, copy each attribute descended from ATTRIB_CFACE_VOL found on a cface to all other cfaces on the CELL3D, unless other cfaces already have that attribute.


Then, if the cface has an attribute copied to it, it is also copied to the partner (opposing) cface, if any.


After propagation, the cell data can be scanned for attribute conflicts, such as two different material types on one cell.

Errors: Pointer to lump is NULL or not to a LUMP.

No cell data attached to lump.

Library: ct_husk

Filename: ct/ct_husk/api/ctapi.hxx

Effect: Changes model
PDF/CT/03FN.PDF
HTM/DATA/CT/CT/03FN/0017.HTM