Reference API Tipu

Veřejné settery a diagnostické metody objektu JoltPenetrator včetně chování při aktivaci a změnách.

Tip získáte přes jolt_penetrator_tip(body, config). Uložte si vrácený objekt, ověřte is_struct a při pozdější práci is_valid(). Nativní handle není GameMaker instance ID; jednotlivé hroty téhož body mají vlastní identity.

Před první aktivací je is_valid() platnost připraveného objektu; get_info() vrací handle=0, enabled=false a prázdné relationships. První set_enabled(true) ověří polohu špičky na povrchu. Chyba dovolí opravit nastavení a aktivaci zopakovat. Po registraci settery konfigurují ihned a respektují Busy během spojení/rearm.

tip.set_local_position(x, y, z);
tip.set_local_axis(x, y, z);
tip.set_max_angle(degrees);
tip.set_max_insertion(metres);
tip.set_max_simultaneous_penetrations(count);
tip.set_max_capture_axial_speed(speed);
tip.set_mask(bits);
tip.set_capture_model(model);
tip.set_probe_length(metres);
tip.set_probe_radius(metres);
tip.set_capture_gap(metres);
tip.set_capture_overlap(metres);
tip.set_tip_surface_tolerance(metres);
tip.set_rearm_separation(metres);
tip.set_contact_assisted(enabled);
tip.set_contact_tolerance(metres);
tip.set_enabled(true);

Bezpečná změna a čtení#

if (is_struct(tip) && tip.is_valid()) {
    if (!tip.set_max_angle(35)) {
        show_debug_message(jolt_get_error_message());
    }
    var info = tip.get_info();
    if (is_struct(info)) {
        show_debug_message("Model: " + string(info.capture_model));
        show_debug_message("Relationships: " + string(array_length(info.relationships)));
    }
}

Obsah get_info()#

Struct obsahuje schema=1, handle, body_handle, enabled, state, reject_reason, relationships a všechny aktuální konfigurační položky: mask, local_position, local_axis, max_angle, contact_tolerance, max_insertion, max_simultaneous_penetrations, max_capture_axial_speed, capture_model, contact_assisted, probe_length, probe_radius, capture_gap, capture_overlap, tip_surface_tolerance a rearm_separation. relationships je pole číselných handles; pro objekty volejte get_relationships().

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.