BRepGraph_VersionStamp Struct Reference

Snapshot of a graph item identity and its freshness generation. More...

#include <BRepGraph_VersionStamp.hxx>

Public Types
enum class	Domain : uint8_t { None = 0 , Node = 1 , Reference = 2 }
	Identity domain encoded in this stamp. More...

Public Member Functions
	BRepGraph_VersionStamp ()
	Default constructor. Creates an invalid stamp (invalid UID, zero counters).
	BRepGraph_VersionStamp (const BRepGraph_UID &theUID, const uint32_t theMutationGen, const uint32_t theGeneration)
	Construct a node-domain stamp from components.
	BRepGraph_VersionStamp (const BRepGraph_RefUID &theRefUID, const uint32_t theMutationGen, const uint32_t theGeneration)
	Construct a reference-domain stamp from components.
bool	IsValid () const
	Check if the stamp has a valid identity in its domain.
bool	IsNodeStamp () const
	True when this is a definition-node-domain stamp.
bool	IsRefStamp () const
	True when this is a reference-domain stamp.
BRepGraph_ItemUID	ItemUID () const
	Return the active generic item identity.
bool	operator== (const BRepGraph_VersionStamp &theOther) const
	Full equality: same domain, UID, OwnGen, and Generation. Two invalid stamps are equal.
bool	operator!= (const BRepGraph_VersionStamp &theOther) const
bool	IsSameItem (const BRepGraph_VersionStamp &theOther) const
	Check if two stamps refer to the same graph item regardless of version. Compares active UID only, ignoring OwnGen and Generation.
Standard_GUID	ToGUID (const Standard_GUID &theGraphGUID) const
	Derive a deterministic Standard_GUID from this stamp. The graph GUID is incorporated into the hash, making per-node GUIDs globally unique across different graph instances. One-way: cannot reconstruct stamp fields from the resulting GUID.
size_t	HashValue () const
	Compute hash value consistent with operator==.

Data Fields
BRepGraph_UID	myNodeUID
	Definition-node identity for node-domain stamps.
BRepGraph_RefUID	myRefUID
	Reference-entry identity for reference-domain stamps.
uint32_t	myMutationGen
	OwnGen counter at snapshot time.
uint32_t	myGeneration
	Graph BRepGraph::Clear() generation at snapshot time.
Domain	myDomain
	Active identity domain.

Detailed Description

Snapshot of a graph item identity and its freshness generation.

Combines a persistent node or reference UID with OwnGen (own-data mutation counter) and graph Generation (BRepGraph::Clear() cycle). It is intended for custom cache and layer freshness checks, not as a separate topology identity model.

Usage pattern:

BRepGraph_VersionStamp aStamp = aGraph.UIDs().StampOf(aFaceId);
// ... later, after mutations ...
if (aGraph.UIDs().IsStale(aStamp))
  recomputeDerivedData();

Member Enumeration Documentation

Domain

enum class BRepGraph_VersionStamp::Domain : uint8_t

strong

Identity domain encoded in this stamp.

Enumerator
None
Node
Reference

Constructor & Destructor Documentation

BRepGraph_VersionStamp() [1/3]

BRepGraph_VersionStamp::BRepGraph_VersionStamp ( )

inline

Default constructor. Creates an invalid stamp (invalid UID, zero counters).

BRepGraph_VersionStamp() [2/3]

BRepGraph_VersionStamp::BRepGraph_VersionStamp ( const BRepGraph_UID & theUID, const uint32_t theMutationGen, const uint32_t theGeneration )

inline

Construct a node-domain stamp from components.

Parameters

[in]	theUID	persistent definition-node identity
[in]	theMutationGen	OwnGen counter (own-data mutation counter)
[in]	theGeneration	graph BRepGraph::Clear() generation

BRepGraph_VersionStamp() [3/3]

BRepGraph_VersionStamp::BRepGraph_VersionStamp ( const BRepGraph_RefUID & theRefUID, const uint32_t theMutationGen, const uint32_t theGeneration )

inline

Construct a reference-domain stamp from components.

Parameters

[in]	theRefUID	persistent reference identity
[in]	theMutationGen	OwnGen counter (own-data mutation counter)
[in]	theGeneration	graph BRepGraph::Clear() generation

Member Function Documentation

HashValue()

size_t BRepGraph_VersionStamp::HashValue

(

)

const

Compute hash value consistent with operator==.

Returns

hash combining active UID, domain, OwnGen, and Generation

IsNodeStamp()

bool BRepGraph_VersionStamp::IsNodeStamp ( ) const

inline

True when this is a definition-node-domain stamp.

IsRefStamp()

bool BRepGraph_VersionStamp::IsRefStamp ( ) const

inline

True when this is a reference-domain stamp.

IsSameItem()

bool BRepGraph_VersionStamp::IsSameItem

(

const BRepGraph_VersionStamp &

theOther

)

const

Check if two stamps refer to the same graph item regardless of version. Compares active UID only, ignoring OwnGen and Generation.

Parameters

[in]

theOther

stamp to compare with

Returns

true if both stamps have the same domain and UID

IsValid()

bool BRepGraph_VersionStamp::IsValid ( ) const

inline

Check if the stamp has a valid identity in its domain.

ItemUID()

BRepGraph_ItemUID BRepGraph_VersionStamp::ItemUID ( ) const

inline

Return the active generic item identity.

operator!=()

bool BRepGraph_VersionStamp::operator!= ( const BRepGraph_VersionStamp & theOther ) const

inline

operator==()

bool BRepGraph_VersionStamp::operator==

(

const BRepGraph_VersionStamp &

theOther

)

const

Full equality: same domain, UID, OwnGen, and Generation. Two invalid stamps are equal.

ToGUID()

Standard_GUID BRepGraph_VersionStamp::ToGUID

(

const Standard_GUID &

theGraphGUID

)

const

Derive a deterministic Standard_GUID from this stamp. The graph GUID is incorporated into the hash, making per-node GUIDs globally unique across different graph instances. One-way: cannot reconstruct stamp fields from the resulting GUID.

Parameters

[in]

theGraphGUID

the owning graph's identity GUID

Returns

deterministic Standard_GUID derived from stamp + graph GUID

Field Documentation

myDomain

Domain BRepGraph_VersionStamp::myDomain

Active identity domain.

myGeneration

uint32_t BRepGraph_VersionStamp::myGeneration

Graph BRepGraph::Clear() generation at snapshot time.

myMutationGen

uint32_t BRepGraph_VersionStamp::myMutationGen

OwnGen counter at snapshot time.

myNodeUID

BRepGraph_UID BRepGraph_VersionStamp::myNodeUID

Definition-node identity for node-domain stamps.

myRefUID

BRepGraph_RefUID BRepGraph_VersionStamp::myRefUID

Reference-entry identity for reference-domain stamps.

---

The documentation for this struct was generated from the following file:

• BRepGraph_VersionStamp.hxx