FACE Class Reference
[Topology]

Represents a bounded portion of a SURFACE. More...

#include <face.hxx>

Inheritance diagram for FACE:

Collaboration diagram for FACE:

List of all members.

Public Member Functions

virtual void add ()

If this ENTITY is use counted, adds one to the count.

virtual logical apply_transform (SPAtransf const &, ENTITY_LIST &, logical=FALSE, logical=TRUE)

Transforms this ENTITY.

ATTRIB * attrib () const

Returns this ENTITY's attribute pointer, or NULL if there is no attached attribute.

ENTITY * backup ()

Creates a duplicate record and a change bulletin, if needed, as a backup for roll back.

SPAbox * bound () const

Returns a geometric bounding region (box) for this FACE.

int bulletin_count () const

Returns the number of bulletins referring to this ENTITY.

virtual logical call_method (METHOD_ID const &, METHOD_ARGS const &)

Executes the implementation function for a routine virtual method.

CONTBIT cont () const

Returns the containment of this FACE.

virtual ENTITY * copy_data (ENTITY_LIST &, pointer_map *pm=NULL, logical dpcpy_skip=FALSE, SCAN_TYPE reason=SCAN_COPY) const

Allocates a new ENTITY and calls copy_common to fill it in.

virtual void copy_scan (ENTITY_LIST &, SCAN_TYPE reason=SCAN_COPY, logical dpcpy_skip=FALSE) const

Adds dependent ENTITYs of this ENTITY to the list of ENTITYs to be copied.

virtual void debug_ent (FILE *) const

Prints the type and address of this ENTITY, roll back pointer, attributes, and any unknown subtype information.

virtual logical deletable () const

Indicates whether or not this ENTITY is normally destroyed by lose.

FACE (FACE *face, LOOP *loop, logical update=TRUE)

Constructs a FACE from a list of LOOPs and a connected FACE already in the owning SHELL.

FACE (LOOP *loop, FACE *face, SURFACE *surf, REVBIT sense)

Constructs a FACE from a SURFACE, a list of LOOPs, and a connected FACE already in the owning SHELL.

FACE ()

Constructs a FACE (default constructor).

virtual void fix_pointers (ENTITY *[], SCAN_TYPE reason=SCAN_COPY)

Converts pointers from copy indices into real pointers.

virtual void full_size (SizeAccumulator &est, logical countSelf=TRUE) const

Increments the SizeAccumulator by the size, in bytes, of everything owned by this ENTITY and, optionally, of the ENTITY itself.

SURFACE * geometry () const

Returns a pointer to the underlying SURFACE defining this FACE.

HISTORY_STREAM * history () const

Returns a pointer to the history stream for this ENTITY.

virtual int identity (int=0) const

Returns a type identifier for this ENTITY.

virtual logical is_deepcopyable () const

Returns TRUE if this ENTITY can be deep copied.

virtual logical is_use_counted () const

Indicates if this ENTITY is use-counted or not.

virtual int lookup (logical) const

Looks up this ENTITY in the appropriate debug list.

LOOP * loop () const

Returns a pointer to the first LOOP of COEDGEs bounding this FACE.

virtual void lose ()

Posts a delete bulletin to the bulletin board indicating the instance is no longer used in the active model.

logical needs_rollback () const

Checks whether or not the record is already backed up.

FACE * next (PAT_NEXT_TYPE next_type=PAT_CAN_CREATE) const

Returns the next FACE in a complete enumeration of all the FACEs in the SHELL.

FACE * next_in_list (PAT_NEXT_TYPE next_type=PAT_CAN_CREATE) const

Returns a pointer to the next FACE in the list of FACEs contained directly by a SHELL or SUBSHELL.

ENTITY * owner () const

Returns a pointer to the owning entity.

virtual void remove (logical lose_if_zero=TRUE)

Decrements the use count of this ENTITY.

void restore_common ()

Restores data for a record from disc to memory.

void restore_end (char *id_str)

Terminates a restore record.

void roll_notify (BULLETIN_TYPE, ENTITY *)

Fields notifications of rollback operations.

BULLETIN *& rollback () const

Returns the pointer to the bulletin board entry for this ENTITY.

virtual void save (ENTITY_LIST &) const

Performs a save operation.

REVBIT sense (REVBIT rev) const

Returns the sense of this FACE relative to its SURFACE, and compounded with the supplied argument.

REVBIT sense () const

Returns the sense of this FACE relative to its SURFACE.

void set_attrib (ATTRIB *attr)

Changes the attribute pointer of this ENTITY to point to the given attribute.

void set_bound (SPAbox *in_box)

Sets the bounding region (box) of this FACE to the specified box.

void set_cont (CONTBIT cont, logical reset_pattern=TRUE)

Sets the containment bit of this FACE.

void set_geometry (SURFACE *surf, logical reset_pattern=TRUE)

Sets the geometry pointer of this FACE to the specified SURFACE.

void set_loop (LOOP *loop, logical reset_pattern=TRUE)

Sets the loop pointer of this FACE to the specified LOOP.

void set_next (FACE *face, logical reset_pattern=TRUE)

Sets the next pointer of this FACE to the specified FACE.

void set_sense (REVBIT rev, logical reset_pattern=TRUE)

Sets the sense of this FACE with respect to its SURFACE.

void set_shell (SHELL *shell, logical reset_pattern=TRUE)

Sets the shell pointer of this FACE to the specified SHELL.

void set_sides (SIDESBIT sides, logical reset_pattern=TRUE)

Sets the sides bit of this FACE to single-sided or double-sided.

void set_subshell (SUBSHELL *subshell, logical reset_pattern=TRUE)

Sets the subshell pointer of this FACE to the specified SUBSHELL.

virtual void set_use_count (int use)

Sets the reference use count of this ENTITY.

SHELL * shell () const

Returns a pointer to the SHELL containing this FACE.

SIDESBIT sides () const

Indicates whether this FACE is single-sided or double-sided.

virtual unsigned size () const

Returns the size, in bytes, of this ENTITY.

SUBSHELL * subshell () const

Returns a pointer to the SUBSHELL containing this FACE directly.

tag_id_type tag (logical assign_new=TRUE) const

Data reading routine.

virtual const char * type_name () const

Returns a name for this ENTITY's type.

virtual int use_count () const

Returns the use count of this ENTITY.

Static Public Member Functions

static MethodFunction add_method (METHOD_ID const &, MethodFunction)

Registers an implementation function for a run-time virtual method.

Protected Member Functions

virtual logical bulletin_no_change_vf (ENTITY const *other, logical identical_comparator) const

Compares subclass data.

void check_destroy () const

Checks that entity deletion is legitimate.

void copy_common (ENTITY_LIST &list, const ENTITY *from, pointer_map *pm=NULL, logical dpcpy_skip=FALSE, SCAN_TYPE reason=SCAN_COPY)

Fills in this ENTITY with data from the copied ENTITY, converting pointers into indices in the supplied ENTITY_LIST.

void fix_common (ENTITY *[], SCAN_TYPE reason=SCAN_COPY)

Converts pointers from copy indices into real pointers.

void fixup_copy (ENTITY *rollback) const

Fixes any pointers in the ENTITY after copying for backup.

logical holds_pattern () const

Returns TRUE if this entity can have a pattern_holder.

logical is_unknown_entity (void) const

Returns TRUE if this is an unknown entity.

void save_begin (logical terminator=FALSE) const

Starts a save record.

void save_common (ENTITY_LIST &) const

Handles the save operation.

void save_end (ENTITY_LIST &list) const

Terminates a save record.

Detailed Description

Represents a bounded portion of a SURFACE.

Role: A face is a bounded portion of a single geometric surface, the two-dimensional analog of a body. The boundary is represented by one or more loops or edges. Each face is simply connected, implying that one can traverse from any point on the interior of the face to any other point on the interior of the face without crossing the boundary of the face. In general, it is not meaningful to distinguish exterior and interior loops of edges, though for certain surface types this may be possible and some algorithms may do so.

Face loops need not necessarily be closed, and if not, either open end may be finite or infinite. If either end is infinite, then the face is infinite; if either end is finite, then the face is "incompletely-bounded", or just "incomplete." Although such faces can be represented in ACIS, most algorithms cannot handle such faces.

Users may find the topological traversal functions located in query.hxx useful for generating lists of faces on other topological entities or lists of edges and vertices on faces. The get_face_box function may be useful to retrieve or recalculate a face's bounding box. The reset_boxes function may be useful to reset the bounding box of a face and its parents. Other functions of note include:

point_in_face determines the containment of a point versus a face.

raytest_face determines the intersection of a ray with a face.

sg_get_face_normal calculates a normal at a point on a face.

find_cls_ptto_face finds the closest point to a specified point on a face.

See also:: LOOP, SHELL, SUBSHELL, SURFACE

Constructor & Destructor Documentation

FACE::FACE ( )

Constructs a FACE (default constructor).

Role: Requests memory for this object but does not populate it. The allocation constructor is used primarily by restore. Applications should call this constructor only with the overloaded new operator, because this reserves the memory on the heap, a requirement to support roll back and history management.

FACE::FACE	(	LOOP *	loop,
		FACE *	face,
		SURFACE *	surf,
		REVBIT	sense
	)

Constructs a FACE from a SURFACE, a list of LOOPs, and a connected FACE already in the owning SHELL.

Role: Requests memory for this object and populates it with the data supplied as the argument. Applications should call this constructor only with the overloaded new operator, because this reserves the memory on the heap, a requirement to support roll back and history management.

This constructor creates a FACE, initializing the record and interfacing with the bulletin board. The arguments initialize the first LOOP on the face, the next FACE on the BODY, the underlying SURFACE geometry, and the sense of the FACE relative to the surface (FORWARD or REVERSED) respectively. It increments the SURFACE use count to reflect this new use. It also sets the backpointers (to the FACE) in the LOOPs that must be correctly chained together before this constructor is called. The calling routine must set shell_ptr or subshell_ptr to refer to the owning SHELL or SUBSHELL, and if desired, bound_ptr, using set_shell or set_subshell and set_bound.

Parameters:

	loop	pointer to a list of LOOPs to be contained by the constructed FACE.
	face	next FACE in the owning SHELL.
	surf	the geometry of the constructed face.
	sense	the sense (FORWARD or REVERSED) of the constructed face relative to surf.

FACE::FACE	(	FACE *	face,
		LOOP *	loop,
		logical	update = `TRUE`
	)

Constructs a FACE from a list of LOOPs and a connected FACE already in the owning SHELL.

Role: Requests memory for this object and populates it with the data supplied as the argument. Applications should call this constructor only with the overloaded new operator, because this reserves the memory on the heap, a requirement to support roll back and history management.

Creates a FACE, using the given LOOP list, but taking geometry, senses, and shell and subshell owners from the old FACE. Optionally updates the SHELL or SUBSHELL FACE list to contain the new FACE (by default).

Parameters:

	face	next FACE in the owning SHELL.
	loop	pointer to a list of LOOPs to be contained by the constructed FACE.
	update	flag to update the SHELL or SUBSHELL FACE list with the constructed FACE.

Member Function Documentation

virtual void ENTITY::add ( ) [virtual, inherited]

If this ENTITY is use counted, adds one to the count.

Role: If this ENTITY is not use counted, signals an error.

Every held pointer to a use counted ENTITY should be declared by calling add. There should a corresponding call to remove when the user is done with the pointer. For normal ENTITYs, simply call lose when the ENTITY is no longer part of the active model. For use counted ENTITYs, the implementations of add and remove come from macros in usecount.hxx. Use counted ENTITYs implemented without the macros should implement these virtual methods manually.

Reimplemented in CURVE, EE_LIST, SPAGROUP, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SURFACE, and VERTEX_TEMPLATE.

static MethodFunction FACE::add_method	(	METHOD_ID const &	method_id,
		MethodFunction	method_func
	)			`[static]`

Registers an implementation function for a run-time virtual method.

Role: (Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

Parameters:

	method_id	method id.
	method_func	method function.

Reimplemented from ENTITY.

virtual logical FACE::apply_transform	(	SPAtransf const &	t,
		ENTITY_LIST &	list,
		logical	negate = `FALSE`,
		logical	reset_pattern = `TRUE`
	)			`[virtual]`

Transforms this ENTITY.

Role: The ENTITY_LIST is used to prevent sub-entities from being transformed more than once. This method is not included with the standard ENTITY methods in order to allow nontransformable ENTITYs to use the default implementation. (Supplied by the TRANSFORM_FUNCTION and TRANSFORM_DEF macros.)

Parameters:

	t	the transform to apply.
	list	list of entities to which the transform has already been applied.
	negate	negation flag.
	reset_pattern	internal use only.

Reimplemented from ENTITY.

ATTRIB* ENTITY::attrib ( ) const [inline, inherited]

Returns this ENTITY's attribute pointer, or NULL if there is no attached attribute.

ENTITY* ENTITY::backup ( ) [inherited]

Creates a duplicate record and a change bulletin, if needed, as a backup for roll back.

Role: The duplication is done via the virtual function make_copy, to let each derived type do its own backup. Before performing a change, each routine checks whether the data structure is posted on the bulletin board. If not, the posting is done automatically. Called by all system change functions.

SPAbox* FACE::bound ( ) const [inline]

Returns a geometric bounding region (box) for this FACE.

Role: Returns a box that includes the entire FACE (with respect to the internal coordinate system of the BODY). The return may be NULL if the bound was not calculated since the FACE was last modified.

int ENTITY::bulletin_count ( ) const [inline, inherited]

Returns the number of bulletins referring to this ENTITY.

virtual logical FACE::bulletin_no_change_vf	(	ENTITY const *	other,
		logical	identical_comparator
	)			const `[protected, virtual]`

Compares subclass data.

Role: This virtual method is called by bulletin_no_change. When the identical_comparator argument is TRUE, it requires an exact match when comparing doubles, and returns the result of memcmp as a default (for non-overridden subclasses). A FALSE argument indicates tolerant compares, in which case FALSE is returned by default.

Parameters:

	other	other ENTITY in the bulletin.
	identical_comparator	identity compare flag.

Reimplemented from ENTITY.

virtual logical FACE::call_method	(	METHOD_ID const &	method_id,
		METHOD_ARGS const &	method_args
	)			`[virtual]`

Executes the implementation function for a routine virtual method.

Role: (Supplied by the ENTITY_FUNCTIONs and UTILITY_DEF macros).

Parameters:

	method_id	method id.
	method_args	method args.

Reimplemented from ENTITY.

void ENTITY::check_destroy ( ) const [inline, protected, inherited]

Checks that entity deletion is legitimate.

Role: This method complains if there is an attempt to delete an entity other than through the private member function destroy, which is carefully controlled.

CONTBIT FACE::cont ( ) const [inline]

Returns the containment of this FACE.

Role: Returns BOTH_OUTSIDE or BOTH_INSIDE. This value is meaningless if the face is single-sided.

void ENTITY::copy_common	(	ENTITY_LIST &	list,
		const ENTITY *	from,
		pointer_map *	pm = `NULL`,
		logical	dpcpy_skip = `FALSE`,
		SCAN_TYPE	reason = `SCAN_COPY`
	)			`[protected, inherited]`

Fills in this ENTITY with data from the copied ENTITY, converting pointers into indices in the supplied ENTITY_LIST.

Role: Supports the copy operation. (Supplied by the ENTITY_FUNCTIONS and COPY_DEF macros.) Whenever the operation encounters a pointer to a dependent ENTITY, it find the index of the latter in the supplied ENTITY_LIST and sets the corresponding pointer in the copy to that index.

Parameters:

	list	list of ENTITYs being copied.
	from	original ENTITY being copied.
	pm	pointer map.
	dpcpy_skip	Used only by the base ENTITY and base ATTRIB class. No other derived entity or attribute should need to utilize this value. This logical indicates how non- deepcopyable attributes are handled during a deep copy. If TRUE, the copy will continue even if it encounters attributes marked as not deep-copyable. By default (FALSE), if any attributes that are found to be not deep-copyable, a sys_error will be thrown. (This flag only effects how attributes are handled; any non-deepcopyable non-attribute entities encountered will cause a sys_error to be thrown regardless of this flag's setting.)
	reason	type of scan.

virtual ENTITY* FACE::copy_data	(	ENTITY_LIST &	list,
		pointer_map *	pm = `NULL`,
		logical	dpcpy_skip = `FALSE`,
		SCAN_TYPE	reason = `SCAN_COPY`
	)			const `[virtual]`

Allocates a new ENTITY and calls copy_common to fill it in.

Role: Supports the copy operation. (Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

Parameters:

	list	ENTITYs to copy.
	pm	pointer map.
	dpcpy_skip	Used only by the base ENTITY and base ATTRIB class. No other derived entity or attribute should need to utilize this value. This logical indicates how non- deepcopyable attributes are handled during a deep copy. If TRUE, the copy will continue even if it encounters attributes marked as not deep-copyable. By default (FALSE), if any attributes that are found to be not deep-copyable, a sys_error will be thrown. (This flag only effects how attributes are handled; any non-deepcopyable non-attribute entities encountered will cause a sys_error to be thrown regardless of this flag's setting.)
	reason	scan type.

Reimplemented from ENTITY.

virtual void FACE::copy_scan	(	ENTITY_LIST &	list,
		SCAN_TYPE	reason = `SCAN_COPY`,
		logical	dpcpy_skip = `FALSE`
	)			const `[virtual]`

Adds dependent ENTITYs of this ENTITY to the list of ENTITYs to be copied.

Role: Supports the copy operation. (Supplied by the ENTITY_FUNCTIONS and SCAN_DEF macros.) The default type of scan (reason) is SCAN_COPY.

Parameters:

	list	ENTITYs to copy.
	reason	type of copy.
	dpcpy_skip	Used only by the base ENTITY and base ATTRIB class. No other derived entity or attribute should need to utilize this value. This logical indicates how non- deepcopyable attributes are handled during a deep copy. If TRUE, the copy will continue even if it encounters attributes marked as not deep-copyable. By default (FALSE), if any attributes that are found to be not deep-copyable, a sys_error will be thrown. (This flag only effects how attributes are handled; any non-deepcopyable non-attribute entities encountered will cause a sys_error to be thrown regardless of this flag's setting.)

Reimplemented from ENTITY.

virtual void FACE::debug_ent ( FILE * file_pointer ) const [virtual]

Prints the type and address of this ENTITY, roll back pointer, attributes, and any unknown subtype information.

Role: This method is called by DEBUG_LIST::debug for an entirely unknown ENTITY type, or at the start of any derived class's debug_ent method. Each derived class's debug_ent method uses the debug function described in the Spatial Product Documentation to print information added at that level. (Supplied by the ENTITY_FUNCTIONS and DEBUG_DEF macros.)

Parameters:

file_pointer

file pointer.

Reimplemented from ENTITY.

virtual logical ENTITY::deletable ( ) const [virtual, inherited]

Indicates whether or not this ENTITY is normally destroyed by lose.

Role: Returns FALSE if the ENTITY is shared among multiple owners by means of a use count, and so gets destroyed implicitly when every owner has been lost. Most ENTITYs are destroyed explicitly using lose, so the default returns TRUE.

Reimplemented in ANNOTATION, ATTRIB_TAG, ATTRIB, CELL, CFACE, CSHELL, CURVE, EE_LIST, SPAGROUP, ID_ATTRIB, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SUPERCELL, SURFACE, TRANSFORM, and VERTEX_TEMPLATE.

void FACE::fix_common	(	ENTITY *	array[],
		SCAN_TYPE	reason = `SCAN_COPY`
	)			`[protected]`

Converts pointers from copy indices into real pointers.

Role: Called by fix_pointers. For ENTITY, converts the attribute pointer, and any pointers in the unknown_entity_text record. (Supplied by the ENTITY_FUNCTIONS and FIX_POINTER_DEF macros.)

Parameters:

	array	ENTITY pointers to fix.
	reason	type of scan.

Reimplemented from ENTITY.

virtual void FACE::fix_pointers	(	ENTITY *	entity_array[],
		SCAN_TYPE	reason = `SCAN_COPY`
	)			`[virtual]`

Converts pointers from copy indices into real pointers.

Role: The fix_pointers method for each entity in the restore array is called, with the given array as an argument. This calls fix_common, which calls its parent's fix_common, and then corrects any pointers in the derived class. In practice there is never anything special for fix_pointers to do, but it is retained for consistency and compatibility. (Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

Parameters:

	entity_array	ENTITY pointers to fix.
	reason	type of scan.

Reimplemented from ENTITY.

void ENTITY::fixup_copy ( ENTITY * rollback ) const [protected, inherited]

Fixes any pointers in the ENTITY after copying for backup.

Role: For ENTITY, this method has nothing to do, but because it is called by all data types, it is required to terminate the copy chain. (Supplied by the ENTITY_FUNCTIONS and SIMPLE_COPY_CONE macros.)

Parameters:

rollback

the ENTITY to copy for backup.

Reimplemented in GA_WORKSPACE.

virtual void ENTITY::full_size	(	SizeAccumulator &	est,
		logical	countSelf = `TRUE`
	)			const `[virtual, inherited]`

Increments the SizeAccumulator by the size, in bytes, of everything owned by this ENTITY and, optionally, of the ENTITY itself.

Role: If countSelf is TRUE, increments the SizeAccumulator by the size, in bytes, of the ENTITY and everything owned by the ENTITY. If countSelf is FALSE, increments the SizeAccumulator by the size, in bytes, of everything owned by the ENTITY, but not including the size of the ENTITY itself.

For example, if an ENTITY contained a character string and full_size were called with countSelf == FALSE, the SizeAccumulator would be incremented by the size, in bytes, of the character string.

Reimplemented in ATTRIB_CELL_INT_PRECEDENCE, ATTRIB_GEN_NAME, ATTRIB_GEN_STRING, ATTRIB_GEN_WSTRING, ATTRIB_BLEND, ATTRIB_FFBLEND, CELL, SPACOLLECTION, CONE, CSHELL, CURVE, EE_LIST, ELLIPSE, GA_WORKSPACE, SPAGROUP, HELIX, INTCURVE, LAW, PCURVE, PLANE, APOINT, SPHERE, SPLINE, STRAIGHT, SUPERCELL, SURFACE, TEXT_ENT, TORUS, UNDEFC, and ATTRIB_VAR_BLEND.

SURFACE* FACE::geometry ( ) const

Returns a pointer to the underlying SURFACE defining this FACE.

HISTORY_STREAM* ENTITY::history ( ) const [inline, inherited]

Returns a pointer to the history stream for this ENTITY.

logical FACE::holds_pattern ( ) const [inline, protected, virtual]

Returns TRUE if this entity can have a pattern_holder.

For internal use only.

Reimplemented from ENTITY.

virtual int FACE::identity ( int level = 0 ) const [virtual]

Returns a type identifier for this ENTITY.

Role: If level is unspecified or 0, returns the type identifier ENTITY_TYPE. If level is specified, returns ENTITY_TYPE for that level of derivation from ENTITY. The level of this class is defined as ENTITY_LEVEL.

A positive level specifies the level of derivation down from the ENTITY class to examine. ENTITY itself has level 0. If level is unspecified or 0, the type of the most specific class of object is returned. If level is 1, the type of the class one level down from ENTITY is returned. If level is 2, the type of the parent class 2 levels down from ENTITY is returned, and so on. If level is greater than the level of the instance, -1 ("unknown") is returned.

A negative level similarly specifies the level of derivation up from the most specific class of object returned.

(Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

Parameters:

level

the derivation level at which the object is to be identified.

Reimplemented from ENTITY.

virtual logical FACE::is_deepcopyable ( ) const [virtual]

Returns TRUE if this ENTITY can be deep copied.

Reimplemented from ENTITY.

logical ENTITY::is_unknown_entity ( void ) const [protected, inherited]

Returns TRUE if this is an unknown entity.

An unknown entity is one that is restored from SAT/SAB but is not native to the running app.

virtual logical ENTITY::is_use_counted ( ) const [virtual, inherited]

Indicates if this ENTITY is use-counted or not.

Role: The default implementation returns FALSE.

Reimplemented in CURVE, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SURFACE, and VERTEX_TEMPLATE.

virtual int FACE::lookup ( logical insert ) const [virtual]

Looks up this ENTITY in the appropriate debug list.

Role: This method is not included among the standard ENTITY methods because often subclasses may wish to be included in their parent's debug list. This is done simply by not including a lookup method in the subclass.

When the logical argument is TRUE, the ENTITY is inserted into the debug list if it does not already exist in the list. If it is FALSE and the ENTITY does not exist in the list, a -1 is returned. (Supplied by the LOOK_FUNCTION and LOOKUP_DEF macros.)

Parameters:

insert

flag to insert into debug list.

Reimplemented from ENTITY.

LOOP* FACE::loop ( ) const

Returns a pointer to the first LOOP of COEDGEs bounding this FACE.

virtual void FACE::lose ( ) [virtual]

Posts a delete bulletin to the bulletin board indicating the instance is no longer used in the active model.

Role: The lose methods for attached attributes are also called.

Reimplemented from ENTITY.

logical ENTITY::needs_rollback ( ) const [inline, inherited]

Checks whether or not the record is already backed up.

FACE* FACE::next ( PAT_NEXT_TYPE next_type = PAT_CAN_CREATE ) const

Returns the next FACE in a complete enumeration of all the FACEs in the SHELL.

Role: The next_type argument controls how the next method treats patterns, and can take any one of three values:

PAT_CAN_CREATE: If the next face is to be generated from a pattern, create it if it doesn't yet exist and return its pointer.

PAT_NO_CREATE: If the next face is to be generated from a pattern, but hasn't yet been created, bypass it and return the pointer of the next already-created face (if any).

PAT_IGNORE: behave as though there is no pattern on the face.

Parameters:

next_type

how the next method treats patterns.

FACE* FACE::next_in_list ( PAT_NEXT_TYPE next_type = PAT_CAN_CREATE ) const

Returns a pointer to the next FACE in the list of FACEs contained directly by a SHELL or SUBSHELL.

Role: The next_type argument controls how the next method treats patterns, and can take any one of three values:

PAT_CAN_CREATE: If the next face is to be generated from a pattern, create it if it doesn't yet exist and return its pointer.

PAT_NO_CREATE: If the next face is to be generated from a pattern, but hasn't yet been created, bypass it and return the pointer of the next already-created face (if any).

PAT_IGNORE: behave as though there is no pattern on the face.

Parameters:

next_type

how the next method treats patterns.

ENTITY* FACE::owner ( ) const [virtual]

Returns a pointer to the owning entity.

Reimplemented from ENTITY.

virtual void ENTITY::remove ( logical lose_if_zero = TRUE ) [virtual, inherited]

Decrements the use count of this ENTITY.

Role: If the use count reaches 0, the ENTITY's lose method is called if the argument lose_if_zero is set to TRUE. (If the entity is not use counted, an error is signaled.)

Every held pointer to a use counted ENTITY should be declared by calling add. There should a corresponding call to remove when the user is done with the pointer. For normal ENTITYs, simply call lose when the ENTITY is no longer part of the active model. For use counted ENTITYs, the implementations of add and remove come from macros in usecount.hxx. Use counted ENTITYs implemented without the macros should implement these virtual methods manually.

Parameters:

lose_if_zero

flag to lose the ENTITY when the use count drops to 0.

Reimplemented in CURVE, SPAGROUP, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SURFACE, and VERTEX_TEMPLATE.

void FACE::restore_common ( )

Restores data for a record from disc to memory.

Role: Writes pointers as indices (fix_pointers turns them back into pointers) and returns a pointer to the ENTITY made. Generally, "common" functions that do the main work are protected, as they are called only from the main entry functions or by themselves up the derivation tree.

This method is public, however, because the main restore function is not a member function, and making it a friend would make it unable to be declared static, i.e., local to the defining module. (Supplied by the ENTITY_FUNCTIONS and RESTORE_DEF macros.)

    read_ptr  Pointer to record in save file for first attribute owned by entity.
    if (restore_version_number >= ENTITY_TAGS_VERSION)
       read_int      new tag

Reimplemented from ENTITY.

void ENTITY::restore_end ( char * id_str ) [inherited]

Terminates a restore record.

Role: Reads any trailing text and fills in the unknown text pointer. Used only by the save/restore system.

Parameters:

id_str

the id string.

void FACE::roll_notify	(	BULLETIN_TYPE	bulletin_type,
		ENTITY *	ent
	)			`[virtual]`

Fields notifications of rollback operations.

Role: The first argument specifies the type of bulletin being rolled back (create, delete or change). In the case of a change notification, the second argument contains the information to be restored into this object. The base implementation, which is used for almost every derived class, does nothing at all.

Parameters:

	bulletin_type	type of bulletin being rolled back.
	ent	information to be restored into this argument.

Reimplemented from ENTITY.

BULLETIN*& ENTITY::rollback ( ) const [inline, inherited]

Returns the pointer to the bulletin board entry for this ENTITY.

virtual void FACE::save ( ENTITY_LIST & entity_list ) const [virtual]

Performs a save operation.

Role: Calls save_begin, the particular class's save_common, and then save_end. (Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

This save method is just like any other save, except that it calls save_begin with an optional argument to suppress writing of a trailing dash, because save_common does not write out an identifier, or call any parent class's save_common.

Parameters:

entity_list

ENTITYs to save.

Reimplemented from ENTITY.

void ENTITY::save_begin ( logical terminator = FALSE ) const [protected, inherited]

Starts a save record.

Role: Writes a preamble to a save file record, which contains any subclass identifiers not known to this version of ACIS. Called by the save method.

Parameters:

terminator

terminator flag.

void FACE::save_common ( ENTITY_LIST & entity_list ) const [protected]

Handles the save operation.

Role: Writes out the savable data associated with the base class. In the case of ENTITY, saveable data is simply the attribute pointer. In the case of child classes derived from ENTITY, class-specific save_common methods handle the class-specific data. Called by the save method. (Supplied by the ENTITY_FUNCTIONS and SAVE_DEF macros.)

Each derived class's save_common method first writes out that class's identifier, calls its parent class's save_common method, and then writes out data particular to the derived class. Thus the save record consists of identifiers in leaf-to-base order, followed by class data in base-to-leaf order. As it writes out any ENTITY pointers, it adds them to the ENTITY_LIST, so that any dependent data also gets written to the file.

Parameters:

entity_list

ENTITYs to save

Reimplemented from ENTITY.

void ENTITY::save_end ( ENTITY_LIST & list ) const [protected, inherited]

Terminates a save record.

Role: Writes out any data associated with subclasses not known to this version of ACIS before terminating the record. Called by the save method.

Parameters:

list

list of entities.

REVBIT FACE::sense ( REVBIT rev ) const [inline]

Returns the sense of this FACE relative to its SURFACE, and compounded with the supplied argument.

Role: Useful when traversing the FACE in a reverse direction.

Parameters:

rev

flags whether the return value represents the internal sense of the FACE, or its reverse.

REVBIT FACE::sense ( ) const [inline]

Returns the sense of this FACE relative to its SURFACE.

Role: Returns FORWARD or REVERSED. Every SURFACE has a direction sense. Its normal direction is a continuous function of position. The normal to the FACE can be the same as that of the SURFACE at any position, or can be the reverse of it, as determined by sense. When a FACE bounds a region of space, its normal always points away from the region bounded.

void ENTITY::set_attrib ( ATTRIB * attr ) [inherited]

Changes the attribute pointer of this ENTITY to point to the given attribute.

Parameters:

attr

the new attribute.

void FACE::set_bound ( SPAbox * in_box )

Sets the bounding region (box) of this FACE to the specified box.

Role: Sets the FACE's SPAbox pointer to point to the given SPAbox. Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

box

the new SPAbox.

void FACE::set_cont	(	CONTBIT	cont,
		logical	reset_pattern = `TRUE`
	)

Sets the containment bit of this FACE.

Role: Indicates whether the FACE is to be considered fully contained within a solid region, or not. Valid values for the CONTBIT are BOTH_OUTSIDE or BOTH_INSIDE. This parameter is meaningless if the face is single-sided. Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	cont	the new containment bit value.
	reset_pattern	internal use only.

void FACE::set_geometry	(	SURFACE *	surf,
		logical	reset_pattern = `TRUE`
	)

Sets the geometry pointer of this FACE to the specified SURFACE.

Role: A side effect of this method is that the routine adjusts the use counts of the existing and new geometry and deletes the old if it is no longer referenced. Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	surf	the new SURFACE.
	reset_pattern	internal use only.

void FACE::set_loop	(	LOOP *	loop,
		logical	reset_pattern = `TRUE`
	)

Sets the loop pointer of this FACE to the specified LOOP.

Role: Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	loop	the new LOOP.
	reset_pattern	internal use only.

void FACE::set_next	(	FACE *	face,
		logical	reset_pattern = `TRUE`
	)

Sets the next pointer of this FACE to the specified FACE.

Role: Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	face	the new next FACE.
	reset_pattern	internal use only.

void FACE::set_sense	(	REVBIT	rev,
		logical	reset_pattern = `TRUE`
	)

Sets the sense of this FACE with respect to its SURFACE.

Role: Sets the FACE's sense to FORWARD or REVERSED, indicating the direction of the face with respect to the underlying SURFACE. Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	rev	the new sense.
	reset_pattern	internal use only.

void FACE::set_shell	(	SHELL *	shell,
		logical	reset_pattern = `TRUE`
	)

Sets the shell pointer of this FACE to the specified SHELL.

Role: Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	shell	the new parent SHELL.
	reset_pattern	internal use only.

void FACE::set_sides	(	SIDESBIT	sides,
		logical	reset_pattern = `TRUE`
	)

Sets the sides bit of this FACE to single-sided or double-sided.

Role: Indicates whether the FACE bounds a solid region of not. Valid values for the SIDESBIT are SINGLE_SIDED or DOUBLE_SIDED. Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	sides	the new sides bit value.
	reset_pattern	internal use only.

void FACE::set_subshell	(	SUBSHELL *	subshell,
		logical	reset_pattern = `TRUE`
	)

Sets the subshell pointer of this FACE to the specified SUBSHELL.

Role: Before performing the change, it checks if the data structure is posted on the bulletin board. If not, the method calls backup to put an entry on the bulletin board.

Parameters:

	subshell	the new parent SUBSHELL.
	reset_pattern	internal use only.

virtual void ENTITY::set_use_count ( int use ) [virtual, inherited]

Sets the reference use count of this ENTITY.

Role: If the ENTITY is not use counted, this method does nothing.

Parameters:

use

new use count.

Reimplemented in CURVE, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SURFACE, and VERTEX_TEMPLATE.

SHELL* FACE::shell ( ) const [inline]

Returns a pointer to the SHELL containing this FACE.

Role: Returns the pointer directly, or through a hierarchy of SUBSHELLs.

SIDESBIT FACE::sides ( ) const [inline]

Indicates whether this FACE is single-sided or double-sided.

Role: Returns either SINGLE_SIDED or DOUBLE_SIDED.

virtual unsigned FACE::size ( ) const [virtual]

Returns the size, in bytes, of this ENTITY.

Role: (Supplied by the ENTITY_FUNCTIONS and UTILITY_DEF macros.)

Reimplemented from ENTITY.

SUBSHELL* FACE::subshell ( ) const [inline]

Returns a pointer to the SUBSHELL containing this FACE directly.

Role: The return is NULL if the FACE belongs directly to the owning SHELL.

tag_id_type ENTITY::tag ( logical assign_new = TRUE ) const [inline, inherited]

Data reading routine.

Parameters:

assign_new

flag to assign a new tag number or not.

virtual const char* FACE::type_name ( ) const [virtual]

Returns a name for this ENTITY's type.

Role: For the ENTITY class, unknown is returned.

Reimplemented from ENTITY.

virtual int ENTITY::use_count ( ) const [virtual, inherited]

Returns the use count of this ENTITY.

Role: Returns zero if the ENTITY is not use counted.

Reimplemented in CURVE, PCURVE, PHLV5_OCC, APOINT, REFINEMENT, RH_MATERIAL, RH_TEXTURE_SPACE, SURFACE, and VERTEX_TEMPLATE.


Public Member Functions
virtual void	add ()
	If this `ENTITY` is use counted, adds one to the count.
virtual logical	apply_transform (SPAtransf const &, ENTITY_LIST &, logical=FALSE, logical=TRUE)
	Transforms this `ENTITY`.
ATTRIB *	attrib () const
	Returns this `ENTITY`'s attribute pointer, or `NULL` if there is no attached attribute.
ENTITY *	backup ()
	Creates a duplicate record and a change bulletin, if needed, as a backup for roll back.
SPAbox *	bound () const
	Returns a geometric bounding region (box) for this `FACE`.
int	bulletin_count () const
	Returns the number of bulletins referring to this `ENTITY`.
virtual logical	call_method (METHOD_ID const &, METHOD_ARGS const &)
	Executes the implementation function for a routine virtual method.
CONTBIT	cont () const
	Returns the containment of this `FACE`.
virtual ENTITY *	copy_data (ENTITY_LIST &, pointer_map *pm=NULL, logical dpcpy_skip=FALSE, SCAN_TYPE reason=SCAN_COPY) const
	Allocates a new `ENTITY` and calls `copy_common` to fill it in.
virtual void	copy_scan (ENTITY_LIST &, SCAN_TYPE reason=SCAN_COPY, logical dpcpy_skip=FALSE) const
	Adds dependent `ENTITYs` of this `ENTITY` to the list of `ENTITYs` to be copied.
virtual void	debug_ent (FILE *) const
	Prints the type and address of this `ENTITY`, roll back pointer, attributes, and any unknown subtype information.
virtual logical	deletable () const
	Indicates whether or not this `ENTITY` is normally destroyed by `lose`.
	FACE (FACE face, LOOP loop, logical update=TRUE)
	Constructs a `FACE` from a list of `LOOPs` and a connected `FACE` already in the owning `SHELL`.
	FACE (LOOP loop, FACE face, SURFACE *surf, REVBIT sense)
	Constructs a `FACE` from a `SURFACE`, a list of `LOOPs`, and a connected `FACE` already in the owning `SHELL`.
	FACE ()
	Constructs a `FACE` (default constructor).
virtual void	fix_pointers (ENTITY *[], SCAN_TYPE reason=SCAN_COPY)
	Converts pointers from copy indices into real pointers.
virtual void	full_size (SizeAccumulator &est, logical countSelf=TRUE) const
	Increments the `SizeAccumulator` by the size, in bytes, of everything owned by this `ENTITY` and, optionally, of the `ENTITY` itself.
SURFACE *	geometry () const
	Returns a pointer to the underlying `SURFACE` defining this `FACE`.
HISTORY_STREAM *	history () const
	Returns a pointer to the history stream for this `ENTITY`.
virtual int	identity (int=0) const
	Returns a type identifier for `this` ENTITY.
virtual logical	is_deepcopyable () const
	Returns `TRUE` if this `ENTITY` can be deep copied.
virtual logical	is_use_counted () const
	Indicates if this `ENTITY` is use-counted or not.
virtual int	lookup (logical) const
	Looks up this `ENTITY` in the appropriate debug list.
LOOP *	loop () const
	Returns a pointer to the first `LOOP` of `COEDGEs` bounding this `FACE`.
virtual void	lose ()
	Posts a delete bulletin to the bulletin board indicating the instance is no longer used in the active model.
logical	needs_rollback () const
	Checks whether or not the record is already backed up.
FACE *	next (PAT_NEXT_TYPE next_type=PAT_CAN_CREATE) const
	Returns the next `FACE` in a complete enumeration of all the `FACEs` in the `SHELL`.
FACE *	next_in_list (PAT_NEXT_TYPE next_type=PAT_CAN_CREATE) const
	Returns a pointer to the next `FACE` in the list of `FACEs` contained directly by a `SHELL` or `SUBSHELL`.
ENTITY *	owner () const
	Returns a pointer to the owning entity.
virtual void	remove (logical lose_if_zero=TRUE)
	Decrements the use count of this `ENTITY`.
void	restore_common ()
	Restores data for a record from disc to memory.
void	restore_end (char *id_str)
	Terminates a restore record.
void	roll_notify (BULLETIN_TYPE, ENTITY *)
	Fields notifications of rollback operations.
BULLETIN *&	rollback () const
	Returns the pointer to the bulletin board entry for this `ENTITY`.
virtual void	save (ENTITY_LIST &) const
	Performs a save operation.
REVBIT	sense (REVBIT rev) const
	Returns the sense of this `FACE` relative to its `SURFACE`, and compounded with the supplied argument.
REVBIT	sense () const
	Returns the sense of this `FACE` relative to its `SURFACE`.
void	set_attrib (ATTRIB *attr)
	Changes the attribute pointer of this `ENTITY` to point to the given attribute.
void	set_bound (SPAbox *in_box)
	Sets the bounding region (box) of this `FACE` to the specified box.
void	set_cont (CONTBIT cont, logical reset_pattern=TRUE)
	Sets the containment bit of this `FACE`.
void	set_geometry (SURFACE *surf, logical reset_pattern=TRUE)
	Sets the geometry pointer of this `FACE` to the specified `SURFACE`.
void	set_loop (LOOP *loop, logical reset_pattern=TRUE)
	Sets the loop pointer of this `FACE` to the specified `LOOP`.
void	set_next (FACE *face, logical reset_pattern=TRUE)
	Sets the next pointer of this `FACE` to the specified `FACE`.
void	set_sense (REVBIT rev, logical reset_pattern=TRUE)
	Sets the sense of this `FACE` with respect to its `SURFACE`.
void	set_shell (SHELL *shell, logical reset_pattern=TRUE)
	Sets the shell pointer of this `FACE` to the specified `SHELL`.
void	set_sides (SIDESBIT sides, logical reset_pattern=TRUE)
	Sets the sides bit of this `FACE` to single-sided or double-sided.
void	set_subshell (SUBSHELL *subshell, logical reset_pattern=TRUE)
	Sets the subshell pointer of this `FACE` to the specified `SUBSHELL`.
virtual void	set_use_count (int use)
	Sets the reference use count of this `ENTITY`.
SHELL *	shell () const
	Returns a pointer to the `SHELL` containing this `FACE`.
SIDESBIT	sides () const
	Indicates whether this `FACE` is single-sided or double-sided.
virtual unsigned	size () const
	Returns the size, in bytes, of this `ENTITY`.
SUBSHELL *	subshell () const
	Returns a pointer to the `SUBSHELL` containing this `FACE` directly.
tag_id_type	tag (logical assign_new=TRUE) const
	Data reading routine.
virtual const char *	type_name () const
	Returns a name for this `ENTITY`'s type.
virtual int	use_count () const
	Returns the use count of this `ENTITY`.
Static Public Member Functions
static MethodFunction	add_method (METHOD_ID const &, MethodFunction)
	Registers an implementation function for a run-time virtual method.
Protected Member Functions
virtual logical	bulletin_no_change_vf (ENTITY const *other, logical identical_comparator) const
	Compares subclass data.
void	check_destroy () const
	Checks that entity deletion is legitimate.
void	copy_common (ENTITY_LIST &list, const ENTITY from, pointer_map pm=NULL, logical dpcpy_skip=FALSE, SCAN_TYPE reason=SCAN_COPY)
	Fills in this `ENTITY` with data from the copied `ENTITY`, converting pointers into indices in the supplied `ENTITY_LIST`.
void	fix_common (ENTITY *[], SCAN_TYPE reason=SCAN_COPY)
	Converts pointers from copy indices into real pointers.
void	fixup_copy (ENTITY *rollback) const
	Fixes any pointers in the `ENTITY` after copying for backup.
logical	holds_pattern () const
	Returns TRUE if this entity can have a pattern_holder.
logical	is_unknown_entity (void) const
	Returns TRUE if this is an unknown entity.
void	save_begin (logical terminator=FALSE) const
	Starts a save record.
void	save_common (ENTITY_LIST &) const
	Handles the save operation.
void	save_end (ENTITY_LIST &list) const
	Terminates a save record.

`point_in_face`	determines the containment of a point versus a face.
`raytest_face`	determines the intersection of a ray with a face.
`sg_get_face_normal`	calculates a normal at a point on a face.
`find_cls_ptto_face`	finds the closest point to a specified point on a face.

`PAT_CAN_CREATE`:	If the next face is to be generated from a pattern, create it if it doesn't yet exist and return its pointer.
`PAT_NO_CREATE`:	If the next face is to be generated from a pattern, but hasn't yet been created, bypass it and return the pointer of the next already-created face (if any).
`PAT_IGNORE`:	behave as though there is no pattern on the face.

FACE Class Reference [Topology]

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

FACE Class Reference
[Topology]