Instance Handle

A lightweight struct used to uniquely identify and reference individual instances.

A FloraInstanceHandle identifies one instance managed by FloraSystem.

Validity

A handle is valid while its Index and Version match an active instance. Destroying the instance invalidates all copies of its handle.

Usage

Create

FloraInstanceHandle handle = FloraSystem.GetOrCreate().CreateInstance(
    prefab,
    parentObject,
    position,
    rotation,
    scale
);

Destroy

FloraSystem.Instance.DestroyInstance(handle);
FloraSystem.Instance.DestroyInstances(handlesArray);

Check validity

bool exists = handle.Exists();

Enable or disable

bool isEnabled = FloraSystem.Instance.IsInstanceEnabled(handle);
FloraSystem.Instance.SetInstanceEnabled(handle, true);

Read position or bounds

float3 position = FloraSystem.Instance.GetInstancePosition(handle);
Bounds bounds = FloraSystem.Instance.GetInstanceBounds(handle);

Terrain details do not have instance handles. They are transient GPU data and cannot be queried or modified individually through FloraSystem.