Runtime owner of bone state, connection strain, and PhysicsLink bindings. 更多...

#include <GeometryCollectionInstance.h>

Public 成员函数
	GeometryCollectionInstance (const GeometryCollectionInstance &)=delete

GeometryCollectionInstance &	operator= (const GeometryCollectionInstance &)=delete

	~GeometryCollectionInstance ()
	Geometry collection instance.

bool	hasLiveWorld () const noexcept
	Whether the owning world handle still resolves.

void	setStepBudget (DestructionStepBudget budget) noexcept
	Replace the per-step break/sleep budgets (0 = unlimited).

DestructionStepBudget	stepBudget () const noexcept
	Return the active per-step budgets.

eve::Result< FieldApplicationReceipt >	applyField (const DestructionField &field)
	Apply one destruction field; failure leaves instance unchanged.

eve::Result< DestructionStepReceipt >	step (SimulationStep step)
	Advance connection-graph breaks under the configured budget.

int	boneCount () const noexcept

int	edgeCount () const noexcept

BoneRuntimeState	boneState (int boneIndex) const

int	boneClusterId (int boneIndex) const

float	edgeStrain (int edgeIndex) const

bool	isEdgeBroken (int edgeIndex) const
	Whether the edge at index has already broken.

int	detachEventCount () const noexcept

BoneDetachEvent	detachEventAt (int index) const

int	clusterBreakEventCount () const noexcept

ClusterBreakEvent	clusterBreakEventAt (int index) const
	Cluster break event at.

int	pendingEdgeBreakCount () const noexcept
	Edges still waiting because of the break budget.

eve::Result< PhysicsLink >	boneLink (int boneIndex) const
	Resolve the PhysicsLink for one bone against the live world.

eve::Result< BonePresentation >	bonePresentation (int boneIndex) const
	Sample one bone's world pose and proxy extents for presentation.

std::uint64_t	sleepBatchRevision () const noexcept
	Monotonic revision bumped when any bone enters Sleeping (for batch rebuild).

eve::Result< GeometryCollectionInstanceSnapshot >	captureSnapshot () const
	Capture a process-portable runtime snapshot (no PhysicsLink handles). @ownership Caller owns the returned snapshot value.

eve::Result< void >	restoreSnapshot (const GeometryCollectionInstanceSnapshot &snapshot)
	Restore bone/edge state from a snapshot against the live world.

void	releaseBodies ()
	Destroy owned bodies if the world is still live; always clears links.

静态 Public 成员函数
static eve::Result< std::unique_ptr< GeometryCollectionInstance > >	create (World3D &world, const GeometryCollectionAsset &asset, float originX, float originY, float originZ)
	Create bodies for every bone and bind PhysicsLinks.

详细描述

Runtime owner of bone state, connection strain, and PhysicsLink bindings.

@ownership Owns Body3D objects it creates; never retains raw World3D or Body3D pointers across calls. Borrows World3D only through a process-local handle. @lifetime Instance-first teardown destroys owned bodies then clears links; world-first teardown makes later resolve/step/applyField return StaleHandle. Either order leaves PhysicsLinks resolvable without use-after-free.

在文件 GeometryCollectionInstance.h 第 96 行定义.

构造及析构函数说明

◆ GeometryCollectionInstance()

eve::physics::GeometryCollectionInstance::GeometryCollectionInstance ( const GeometryCollectionInstance & )

delete

◆ ~GeometryCollectionInstance()

eve::physics::GeometryCollectionInstance::~GeometryCollectionInstance ( )

Geometry collection instance.

在文件 GeometryCollectionInstance.cpp 第 36 行定义.

成员函数说明

◆ applyField()

eve::Result< FieldApplicationReceipt > eve::physics::GeometryCollectionInstance::applyField ( const DestructionField & field )

Apply one destruction field; failure leaves instance unchanged.

在文件 GeometryCollectionInstance.cpp 第 136 行定义.

引用了 body, eve::physics::FieldApplicationReceipt::bonesAffected, dx, dy, dz, edge, eve::physics::FieldApplicationReceipt::edgesAffected, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::InvalidArgument, eve::physics::FieldApplicationReceipt::sleepsDeferred, eve::StaleHandle, state, eve::Result< T >::success(), vx, vy, vz, weight , 以及 world.

◆ boneClusterId()

int eve::physics::GeometryCollectionInstance::boneClusterId ( int boneIndex ) const

在文件 GeometryCollectionInstance.cpp 第 386 行定义.

引用了 clusterId.

◆ boneCount()

int eve::physics::GeometryCollectionInstance::boneCount ( ) const

inlinenoexcept

在文件 GeometryCollectionInstance.h 第 141 行定义.

被这些函数引用 eve::physics::GeometryCollectionRenderer::draw().

◆ boneLink()

eve::Result< PhysicsLink > eve::physics::GeometryCollectionInstance::boneLink ( int boneIndex ) const

Resolve the PhysicsLink for one bone against the live world.

在文件 GeometryCollectionInstance.cpp 第 411 行定义.

引用了 body, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::InvalidArgument, eve::StaleHandle, eve::Result< T >::success() , 以及 world.

◆ bonePresentation()

eve::Result< BonePresentation > eve::physics::GeometryCollectionInstance::bonePresentation ( int boneIndex ) const

Sample one bone's world pose and proxy extents for presentation.

返回: Owning snapshot, or StaleHandle/InvalidArgument without mutating state.

在文件 GeometryCollectionInstance.cpp 第 424 行定义.

被这些函数引用 eve::physics::GeometryCollectionRenderer::draw().

◆ boneState()

BoneRuntimeState eve::physics::GeometryCollectionInstance::boneState ( int boneIndex ) const

在文件 GeometryCollectionInstance.cpp 第 381 行定义.

引用了 state.

◆ captureSnapshot()

eve::Result< GeometryCollectionInstanceSnapshot > eve::physics::GeometryCollectionInstance::captureSnapshot ( ) const

Capture a process-portable runtime snapshot (no PhysicsLink handles). @ownership Caller owns the returned snapshot value.

在文件 GeometryCollectionInstance.cpp 第 452 行定义.

◆ clusterBreakEventAt()

ClusterBreakEvent eve::physics::GeometryCollectionInstance::clusterBreakEventAt ( int index ) const

Cluster break event at.

在文件 GeometryCollectionInstance.cpp 第 406 行定义.

引用了 index.

◆ clusterBreakEventCount()

int eve::physics::GeometryCollectionInstance::clusterBreakEventCount ( ) const

inlinenoexcept

在文件 GeometryCollectionInstance.h 第 150 行定义.

◆ create()

eve::Result< std::unique_ptr< GeometryCollectionInstance > > eve::physics::GeometryCollectionInstance::create	(	World3D &	world,
		const GeometryCollectionAsset &	asset,
		float	originX,
		float	originY,
		float	originZ
	)

static

Create bodies for every bone and bind PhysicsLinks.

参数

world	Borrowed World3D that must outlive successful physics writes.
asset	Immutable bone/edge definition (copied).
originX	Origin of the collection in world metres.
originY	Origin of the collection in world metres.
originZ	Origin of the collection in world metres.

返回: Owning instance, or a structured failure without partial bodies. @ownership Caller owns the returned unique_ptr; Instance owns created bodies. @lifetime World must remain live for physics writes until releaseBodies or Instance destruction; world destruction first yields StaleHandle.

在文件 GeometryCollectionInstance.cpp 第 38 行定义.

引用了 body, bone, eve::physics::GeometryCollectionAsset::bones, edge, eve::physics::GeometryCollectionAsset::edges, eve::Diagnostic::error(), eve::Failed, eve::StaleHandle, valid, eve::physics::GeometryCollectionAsset::validate(), world, x, y , 以及 z.