MultiMesh

public MultiMesh();

Creates an owned empty resource: 2D format, count 0, visible -1, colors/custom disabled, Fast interpolation quality. Display requires a separate consumer.

public float[] Buffer { get; set; }

Full InstanceCount × stride float buffer. Stride = (3D:12 / 2D:8) + colors:4 + custom:4. Getter returns a copy; setter uploads the entire buffer. Neither bytes nor a live view.

public Color[] ColorArray { get; set; }

SDK Obsolete: legacy colors array accessing instances element by element. Use corresponding Set/GetInstance methods or Buffer for new code; not a live view.

public Aabb CustomAabb { get; set; }

Local-space bounds of the whole group, including full Mesh size and movement. Zero Aabb removes the renderer custom override. Setter emits Changed; does not create collision.

public Color[] CustomDataArray { get; set; }

SDK Obsolete: legacy custom data array accessing instances element by element. Use corresponding Set/GetInstance methods or Buffer for new code; not a live view.

public int InstanceCount { get; set; }

Nonnegative record capacity. Setting allocates backend data; do not assume records survive capacity changes. Set format/flags beforehand.

public Mesh Mesh { get; set; }

Shared Mesh for every record or null. Materials come from the shared Mesh/consumer; does not create a separate Material per record.

public MultiMesh.PhysicsInterpolationQualityEnum PhysicsInterpolationQuality { get; set; }

Fast by default or High interpolation method. Does not enable interpolation, increase physics frequency or fix uninitialized transforms.

public Vector2[] Transform2DArray { get; set; }

SDK Obsolete: legacy 2D transforms array accessing instances element by element. Use corresponding Set/GetInstance methods or Buffer for new code; not a live view.

public Vector3[] TransformArray { get; set; }

SDK Obsolete: legacy 3D transforms array accessing instances element by element. Use corresponding Set/GetInstance methods or Buffer for new code; not a live view.

public MultiMesh.TransformFormatEnum TransformFormat { get; set; }

Transform layout, 2D by default. Change only at zero capacity; select Transform3D before InstanceCount for 3D.

public bool UseColors { get; set; }

Four additional color floats per record, disabled by default. Configure only at count 0; visible use depends on material.

public bool UseCustomData { get; set; }

Four additional custom floats per record, disabled by default. Configure at count 0; shader reads the values.

public int VisibleInstanceCount { get; set; }

Number of leading records to display, -1 for all. Not allocated-array size or automatic individual culling.

public Aabb GetAabb();

Queries group bounds from the renderer rather than one instance bounds or the CustomAabb getter. Dummy returns default, so headless does not establish bounds/culling.

public float[] GetBuffer();

Gets a managed copy of the bulk float buffer. Edits require another upload; renderer readback can be expensive.

public Aabb GetCustomAabb();

Reads the stored custom override rather than computed group bounds.

public Color GetInstanceColor(int instance);

Reads record color with UseColors = true and a valid index. Dummy getter returns default rather than verified GPU color.

public int GetInstanceCount();

Reads allocated record count, also InstanceCount. Not visible-object count.

public Color GetInstanceCustomData(int instance);

Reads four custom floats through Color with UseCustomData = true. Shader defines their meaning; dummy returns default.

public Transform3D GetInstanceTransform(int instance);

Reads a 3D-format record local Transform3D rather than an Entity global transform. Dummy returns identity regardless of scalar setter.

public Transform2D GetInstanceTransform2D(int instance);

Reads a 2D-format record local Transform2D. Use the other method for 3D; dummy returns identity.

public Mesh GetMesh();

Returns the shared source Mesh reference or null rather than MeshInstance3D or copied geometry.

public MultiMesh.PhysicsInterpolationQualityEnum GetPhysicsInterpolationQuality();

Reads selected Fast/High, not whether interpolation is enabled or current physics FPS.

public MultiMesh.TransformFormatEnum GetTransformFormat();

Reads the 2D/3D format configured before record allocation.

public int GetVisibleInstanceCount();

Reads prefix limit: -1 all, 0 none, N first N. A setting rather than an actual visible-pixel count.

public bool IsUsingColors();

Reads color-channel configuration rather than whether material uses that color.

public bool IsUsingCustomData();

Reads custom-channel configuration rather than whether shader logic consumes it.

public void ResetInstancePhysicsInterpolation(int instance);

With active interpolation, copies one current record to previous. Call after writing teleport placement to avoid blending from the old location. Dummy has no interpolator.

public void ResetInstancesPhysicsInterpolation();

Resets every previous record to current. Does not move objects or enable interpolation; requires an interpolator.

public void SetBuffer(ReadOnlySpan<float> buffer);

Uploads a full float buffer of exact length. Array/span overloads share layout. Ignored at count 0; wrong lengths with positive count are rejected. Does not emit Changed.

public void SetBuffer(float[] buffer);

Uploads a full float buffer of exact length. Array/span overloads share layout. Ignored at count 0; wrong lengths with positive count are rejected. Does not emit Changed.

public void SetBufferInterpolated(ReadOnlySpan<float> bufferCurr, ReadOnlySpan<float> bufferPrev);

Supplies current and previous matching-layout data for physics interpolation rather than two render draw calls. Requires a renderer interpolator; dummy does nothing. Does not replace enabling consumer interpolation.

public void SetBufferInterpolated(float[] bufferCurr, float[] bufferPrev);

Supplies current and previous matching-layout data for physics interpolation rather than two render draw calls. Requires a renderer interpolator; dummy does nothing. Does not replace enabling consumer interpolation.

public void SetCustomAabb(Aabb aabb);

Sets group CustomAabb and emits Changed. Enclose every local instance and shader deformation; unconverted world-space bounds are wrong here.

public void SetInstanceColor(int instance, Color color);

Writes one index color with UseColors = true. Material must use instance/vertex color; no Changed notification. Dummy does not store this write.

public void SetInstanceCount(int count);

Allocates a nonnegative count using the selected layout. Refill required data and check VisibleInstanceCount after changing it.

public void SetInstanceCustomData(int instance, Color customData);

Writes four custom floats for one index with its channel enabled. Color carries shader INSTANCE_CUSTOM data; no Changed notification.

public void SetInstanceTransform(int instance, Transform3D transform);

Writes local Transform3D for 3D format and a valid index. Does not create an Entity/collision. No Changed notification; dummy does not store it.

public void SetInstanceTransform2D(int instance, Transform2D transform);

Writes local Transform2D for 2D format. Unlike the 3D setter, emits Changed. Dummy notifies without storing the transform.

public void SetMesh(Mesh mesh);

Assigns shared Mesh or null without copying geometry. Assign MultiMesh itself to a display consumer too.

public void SetPhysicsInterpolationQuality(MultiMesh.PhysicsInterpolationQualityEnum quality);

Selects Fast/High interpolation method. Does not enable it or establish smooth output; headless checks only stored selection.

public void SetTransformFormat(MultiMesh.TransformFormatEnum format);

Sets 2D/3D only with InstanceCount = 0. Even writing the same value with positive count is rejected.

public void SetUseColors(bool enable);

Enables the color channel only with InstanceCount = 0. Configure material separately.

public void SetUseCustomData(bool enable);

Enables four custom floats per record only with InstanceCount = 0. Shader consumption is separate.

public void SetVisibleInstanceCount(int count);

Sets visible prefix: -1 or 0…InstanceCount. Does not change capacity or reorder records.