Životní cyklus constraintu

Vysvětluje validitu, ownership, deaktivaci, collision filtering, invalidaci závislostí a bezpečný cleanup.

Managed JoltConstraint vlastní jeden world-scoped generační native handle. Odkazuje na připojená tělesa, ale nikdy nevlastní jejich GML wrappers ani gameplay data.

Stavy#

Ownership pravidla#

• destroy() zničí pouze constraint, nikdy připojená tělesa.
• destroy() je idempotentní a bezpečný při opakovaném volání.
• Stale generační handle nemůže adresovat pozdější constraint využívající stejný interní slot.
• Body-to-body constrainty musí zůstat ve stejném managed default worldu jako jejich tělesa.
• World constraints interně odkazují na immutable fixed body Jolt a externě na jedno user body.

Disable versus destroy#

joint.set_enabled(false); // keep limits and motor settings

// Later:
joint.set_enabled(true);

// Permanent release:
joint.destroy();

Disable použijte pro mechanismus, který se bude znovu používat. Destroy použijte po úplném ukončení vztahu, kdy se má uvolnit native solver resource.

Collision připojených těles#

• collision:false nebo set_collision_enabled(false) potlačí jen danou user-body pair.
• Potlačení je reference-counted: zničení jednoho z více constraintů neaktivuje dvojici předčasně.
• Změna nastavení invaliduje cached contacts a probudí dotčená tělesa.
• World constraints vždy hlásí collision disabled, protože nemají druhé user collision body.

Bezpečný cleanup#

if (is_struct(joint) && joint.is_valid()) {
    joint.destroy();
}

body_a.destroy();
body_b.destroy();

// Global managed cleanup is ordered and idempotent.
jolt_stop();

Zpracování chyb#

var joint = jolt_hinge(a, b, 0,0,2, 0,0,1);
if (is_undefined(joint)) {
    var error = jolt_get_error();
    show_debug_message(string(error.code) + " / " + error.context + ": " + error.message);
}

Ruční cleanup order#

Uvolněte dependent constrainty před tělesy, potom reusable shape/layer resources před worldem a runtime. jolt_stop() provede managed pořadí automaticky a bezpečně i opakovaně.

Ověřené kontrakty operací#

Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.