Penetration Point z Blenderu
Helper označuje lokální hrot na kolizní geometrii; exportuje se do JSON v6.
Workflow#
V Configuration Root přidej Penetration Point, nastav jedinečný Key a umísti jej na skutečný hrot kolizního tvaru. Lokální +Z určuje osu zasunutí. Nejde o hrot renderovaného BBMOD meshe, pokud se jeho kolize liší.
knife_tip = jolt_asset_create_penetrator_tip(
asset, "penetration", knife_body);
if (is_undefined(knife_tip)) {
show_debug_message(jolt_get_error().message);
}knife_body musí být živý Dynamic JoltBody. Helper předá nastavení a zapne tip při vytvoření. Vrací JoltPenetrator nebo undefined; export a načtení samy tip nevytvářejí. Native znovu atomicky ověří skutečný tvar, povrch a osu.
Validace a omezení#
Editor upozorňuje na helper mimo kolizní geometrii. Platný JSON není zárukou přijetí každého runtime tvaru. Strict Predictive vyžaduje skutečný vstup hrotu a může být blokován rohem plochého čela dříve, než vstoupí označený bod. Neřeš odmítnutí pouhým zvětšením tolerance bez kontroly geometrie.
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.
| Symbol / vlastník | Signatura | Kontrakt operace |
|---|---|---|
| jolt_asset_get_penetration_point | jolt_asset_get_penetration_point(asset,point_ref) | Asset + přesný key nebo kanonické UUID. Znovu validuje mutable asset a vrací nezávislý datový záznam, nikoliv fyzikální objekt; chyba undefined a managed error. |
Úplný seznam deklarací API#
Deklarace odpovídají produkčním GML zdrojům. Hodnota za = označuje volitelný argument. Toto je seznam signatur; význam, jednotky a omezení popisují příslušné části návodu. Název typu před tečkou označuje vlastníka metody, nikoli globální funkci.
| Symbol / vlastník | Signatura / hodnota |
|---|---|
| jolt_asset_create_penetrator_tip | jolt_asset_create_penetrator_tip(asset,point_ref,owner) |