struct MAGES::MeshDeformations::RuntimeParticleData¶

Overview¶

Represents the runtime data for particles in the XPBD solver. More…

struct RuntimeParticleData
{
    // fields

    bool IsCreated;
    int Count;
    NativeArray Enabled;
    NativeArray Breakable;
    NativeArray PhysicsMaterialIndex;
    NativeArray InitialPosition;
    NativeArray Position;
    NativeArray PredictedPosition;
    NativeArray TemporaryPositionBuffer;
    NativeArray LocalRestPosition;
    NativeArray Velocity;
    NativeArray InverseMass;
    NativeArray AdjustedInverseMass;
    NativeArray Phase;
    NativeArray SimulationMeshDescriptorIndex;
    NativeArray PositionCorrections;
    NativeArray PositionCorrectionsCount;
    NativeArray ParticleLocks;

    // methods

    void Create(
        in int size,
        NativeArrayOptions nativeArrayOptions = NativeArrayOptions.ClearMemory
    );

    int Resize(in int newSize);
    int InsertAdditionalEmptySpace(in int additionalSize, in int emptySpacePosition);
    void RemoveRange(in int index, in int length);
    void Dispose();
};

Detailed Documentation¶

Represents the runtime data for particles in the XPBD solver.

Fields¶

bool IsCreated

Indicates whether the particle data has been initialized.

int Count

The number of particles.

NativeArray Enabled

Indicates whether each particle is enabled.

NativeArray Breakable

Indicates whether each particle is breakable.

NativeArray PhysicsMaterialIndex

The index of the physics material for each particle.

NativeArray InitialPosition

The initial position of each particle.

NativeArray Position

The current position of each particle.

NativeArray PredictedPosition

The predicted position of each particle for the next simulation step.

NativeArray TemporaryPositionBuffer

The temporary position buffer used for friction solving.

NativeArray LocalRestPosition

The local rest position of each particle relative to the simulation mesh’s center of mass.

NativeArray Velocity

The velocity of each particle.

NativeArray InverseMass

The inverse mass of each particle.

NativeArray AdjustedInverseMass

The adjusted inverse mass of each particle for faster convergence.

NativeArray Phase

The phase (group) of each particle for collision handling.

NativeArray SimulationMeshDescriptorIndex

The index of the simulation mesh descriptor for each particle.

NativeArray PositionCorrections

The position corrections to be applied to each particle.

NativeArray PositionCorrectionsCount

The count of position corrections for each particle.

NativeArray ParticleLocks

The locks array used for atomic operations on particles.

Methods¶

void Create(
    in int size,
    NativeArrayOptions nativeArrayOptions = NativeArrayOptions.ClearMemory
)

Initializes the particle data arrays.

Parameters:

int Resize(in int newSize)

Resizes the data arrays.

Parameters:

Returns:

The old size before resizing.

int InsertAdditionalEmptySpace(in int additionalSize, in int emptySpacePosition)

Inserts additional empty space into the data arrays.

Parameters:

Returns:

The index at which the new cells begin.

void RemoveRange(in int index, in int length)

Removes a range of data from the arrays.

Parameters:

void Dispose()

Disposes of the native arrays.