All Frameworks  Class Hierarchy  This Framework  Indexes

SPAcstr Global Function api_body_to_1d

outcome api_body_to_1d(	BODY*	`body`,
	logical	`fix_normals`,
	const ENTITY_LIST&	`ref_faces`	`= (ENTITY_LIST)NULL_REF`,
	AcisOptions*	`ao`	`= NULL` )

Modifies a double-sided body into a single-sided body.

Role: When fix_normals is set to FALSE, this function merely marks the faces as single-sided, without checking to see if the faces on the resulting single-sided body have consistent normal directions. For performance purposes, the user may want to use this setting when confident that no such inconsistencies exist. To guard against the creation of an invalid body, however, we recommend that this flag be set to TRUE. In that case, the user may provide a list of faces (one on each shell of the body) via the argument ref_faces, which specifies those faces whose normals are to remain unchanged if any face normals are found to have an inconsistent orientation. If this argument is not provided, or if any of the body's shells is not represented in the list, this function uses the first face on each of the unrepresented shells to determine the orientation of the result.

Note: Support for the fix_normals option does not extend to either non-manifold bodies, or to non-orientable manifold sheets (for example, a Moebius strip). If this option is nevertheless used in conjunction with such objects, undesirable results can occur. In the case of non-manifold bodies, face normals may be partially adjusted; in the case of non-orientable sheets, a system error (UNSUPPORTED_TOPOLOGY) will be thrown.

Limitations: The fix_normals option is not supported for non-manifold bodies or for non-orientable sheets.

Errors: The pointer to the body is NULL, one of more of the entities in ref_faces is not a face, one or more of the faces in ref_faces is owned by another body, or two or more of the faces in ref_faces belong to the same shell.

Effect: Changes model

Journal: Available

Parameters:

body: the body to be modified.
fix_normals: flag to check and fix inconsistent face normals.
ref_faces: optional list of faces whose normals are to remain unchanged by the operation.
ao: acis options.

This object is included in the file: cstrapi.hxx