Quantum.Shape3D.CompoundShape3D Struct Reference

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...
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	ResetCompoundMeta (FrameBase f)
	Recomputes the compound shape broad radius, centroid and volume sum (the later is used internally). More...

Properties
Int32	Count [get]
	The number of shapes in the compound buffer. More...
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.

Property Documentation

IsPersistent

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

Int32 Quantum.Shape3D.CompoundShape3D.Count

get

The number of shapes in the compound buffer.