A 3D shape type that can reference a group of other 3D shapes (including other compounds, but not Mesh and Terrain shapes). Compound shape overlaps and physics colliders with compound shapes are supported. More...

Public Member Functions
void	AddShape (FrameBase f, ref Shape3D shape, bool updateCompoundMeta=true)
	Adds the shape to the compound buffer. More...

void	CopyFrom (FrameBase f, ref Shape3D shape)
	Creates a copy of another compound shape 's and any nested compound's buffers. The resultant shapes will not share data. More...

void	FreePersistent (FrameBase f, Boolean freeNestedPersistent=true)
	Dispose any persistently allocated memory for this compound shape. More...

readonly override int	GetHashCode ()
	Overrides the hash code generation of this type. More...

bool	GetShapes (FrameBase f, out Shape3D *shapesBuffer, out Int32 count)
	Gets a pointer to the buffer of shapes added to this compound. More...

bool	RemoveShapes (FrameBase f, Int32? userTag=null, bool resetCompoundMeta=true, Boolean removeFromNested=true)
	Removes all shapes in a compound that have a Shape3D.UserTag field matching the specified userTag . More...

void	ReserveCapacity (FrameBase f, Int32 capacity)
	Ensures that this compound shape capacity can hold at least capacity shapes. More...

void	ResetCompoundMeta (FrameBase f)
	Recomputes the compound shape broad radius, centroid and volume sum (the later is used internally). More...

Static Public Member Functions
static void	Serialize (void *ptr, FrameSerializer serializer)
	Serializes a CompoundShape3D into a FrameSerializer. More...

Static Public Attributes
const int	SIZE = Transform3D.SIZE + BoxShape.SIZE
	The size of the struct in bytes. More...

Properties
readonly Int32	Capacity `[get]`
	The current number of shapes that can be held by the compound buffer. More...

readonly Int32	Count `[get]`
	The number of shapes in the compound buffer. More...

readonly Boolean	IsPersistent `[get]`
	If the buffer of shapes is persistently allocated. More...

Detailed Description

A 3D shape type that can reference a group of other 3D shapes (including other compounds, but not Mesh and Terrain shapes). Compound shape overlaps and physics colliders with compound shapes are supported.

Member Function Documentation

◆ CopyFrom()

void Quantum.Shape3D.CompoundShape3D.CopyFrom	(	FrameBase	f,
		ref Shape3D	shape
	)

inline

Creates a copy of another compound shape 's and any nested compound's buffers. The resultant shapes will not share data.

Any existing persistent compounds in this shape's hierarchy are disposed before copying.

Parameters

f	The current frame being simulated.
shape	The compound shape that will be copied from.

◆ AddShape()

void Quantum.Shape3D.CompoundShape3D.AddShape	(	FrameBase	f,
		ref Shape3D	shape,
		bool	updateCompoundMeta = `true`
	)

inline

Adds the shape to the compound buffer.

Trying to add a compound shape that holds a buffer already reference in this shape's hierarchy will throw an error in debug mode.

Mesh and Terrain shapes cannot be added to a compound shape.

Parameters

f	The frame currently being simulated.
shape	The shape being added to the compound.
updateCompoundMeta	If the compound meta data (e.g. broad radius and centroid) should be automatically updated.

◆ RemoveShapes()

bool Quantum.Shape3D.CompoundShape3D.RemoveShapes	(	FrameBase	f,
		Int32?	userTag = `null`,
		bool	resetCompoundMeta = `true`,
		Boolean	removeFromNested = `true`
	)

inline

Removes all shapes in a compound that have a Shape3D.UserTag field matching the specified userTag .

Parameters

f	The frame currently being simulated.
userTag	A tag that specifies a shape or group of shapes. Any shape in a compound that has a matching Shape3D.UserTag field will be removed. If none is specified, all shapes are removed.
resetCompoundMeta	If the compound meta data (e.g. broad radius, centroid) should be automatically reset if any shapes are removed.
removeFromNested	If shapes should also be removed from any compound shape nested inside this.

Returns: true if at least one shape has been removed by this method.

◆ GetShapes()

bool Quantum.Shape3D.CompoundShape3D.GetShapes	(	FrameBase	f,
		out Shape3D *	shapesBuffer,
		out Int32	count
	)

inline

Gets a pointer to the buffer of shapes added to this compound.

Parameters

f	The frame currently being simulated.
shapesBuffer	A pointer to the buffer of shapes added to this compound. `null` if the compound doesn't have shapes.
count	The number of shapes in the shapesBuffer .

Returns: true if the buffer has at least one shape

◆ ResetCompoundMeta()

void Quantum.Shape3D.CompoundShape3D.ResetCompoundMeta ( FrameBase f )

inline

Recomputes the compound shape broad radius, centroid and volume sum (the later is used internally).

Parameters

f	The frame currently being simulated.

◆ FreePersistent()

void Quantum.Shape3D.CompoundShape3D.FreePersistent	(	FrameBase	f,
		Boolean	freeNestedPersistent = `true`
	)

inline

Dispose any persistently allocated memory for this compound shape.

Parameters

f	The frame currently being simulated.
freeNestedPersistent	If nested compound shapes should also have persistent buffers disposed.

◆ ReserveCapacity()

void Quantum.Shape3D.CompoundShape3D.ReserveCapacity	(	FrameBase	f,
		Int32	capacity
	)

inline

Ensures that this compound shape capacity can hold at least capacity shapes.

Parameters

f	The current Frame instance
capacity	The desired capacity. The resultant capacity can be greater than or equal this value.

◆ Serialize()

static void Quantum.Shape3D.CompoundShape3D.Serialize	(	void *	ptr,
		FrameSerializer	serializer
	)

inlinestatic

Serializes a CompoundShape3D into a FrameSerializer.

Parameters

ptr	The pointer to the CompoundShape3D.
serializer	The FrameSerializer instance into which the struct will be serialized.

◆ GetHashCode()

readonly override int Quantum.Shape3D.CompoundShape3D.GetHashCode ( )

inline

Overrides the hash code generation of this type.

Returns: A hash code of the current state of this instance.

Member Data Documentation

◆ SIZE

const int Quantum.Shape3D.CompoundShape3D.SIZE = Transform3D.SIZE + BoxShape.SIZE

static

The size of the struct in bytes.

Property Documentation

◆ IsPersistent

readonly Boolean Quantum.Shape3D.CompoundShape3D.IsPersistent

get

If the buffer of shapes is persistently allocated.

Persistently allocated memory is not disposed automatically. Call FreePersistent when done using a persistent compound.

◆ Count

readonly Int32 Quantum.Shape3D.CompoundShape3D.Count

get

The number of shapes in the compound buffer.

◆ Capacity

readonly Int32 Quantum.Shape3D.CompoundShape3D.Capacity

get

The current number of shapes that can be held by the compound buffer.

Quantum 3 3.0.9

Public Member Functions

Static Public Member Functions

Static Public Attributes

Properties

Detailed Description

Member Function Documentation

◆ CopyFrom()

◆ AddShape()

◆ RemoveShapes()

◆ GetShapes()

◆ ResetCompoundMeta()

◆ FreePersistent()

◆ ReserveCapacity()

◆ Serialize()

◆ GetHashCode()

Member Data Documentation

◆ SIZE

Property Documentation

◆ IsPersistent

◆ Count

◆ Capacity