Surfaces

Vytvořte displej ve 3D světě a zobrazujte na něm vlastní text, obrázky nebo rozhraní.

Co jsou Render Surfaces?#

Render Surface je obdélníková zobrazovací plocha připojená k fyzikálnímu tělesu. V GameMakeru na ni kreslíte běžný 2D obsah a BBMOD jej zobrazí ve 3D scéně. Hodí se například pro obrazovku přístroje, palubní displej nebo informační panel.

V Blenderu určíte umístění a velikost plochy. V GameMakeru nastavíte, co se na ní zobrazí. Plocha při pohybu a otáčení následuje své těleso.

Vytvoření v Blenderu#

Vyberte JoltPhysics Root a přidejte Render Surface z nabídky Add → JoltPhysics → Helpers. Nastavte mu Key, například dashboard_display; stejný klíč použijete k vyhledání plochy v GameMakeru.

Pozice a rozměry#

Vyberte Render Surface a otevřete jeho nastavení. Key je identifikátor používaný v kódu; Display Name je popisný název. Pro následující ukázku nastavte Key na dashboard_display. Pomocí Position a Rotation určete umístění a natočení plochy.

Plochu posuňte a natočte podle svého objektu. Celou šířku a výšku v metrech nastavujte pomocí Width a Height, nikoli změnou Scale objektu.

Obdélník je vystředěný kolem svého počátku a leží v lokální rovině XY. Přední strana míří ve směru lokální +Z a horní okraj ve směru +Y. Pomocí vodicích šipek natočte přední stranu k pozorovateli; plocha je jednostranná.

Spusťte Validate a exportujte konfiguraci jako Jolt JSON. Pokud ze stejného assetu budete vytvářet i vlastnící těleso, přidejte také kolizní tvary: samotná Render Surface kolizní těleso nedefinuje.

Použití v GameMakeru#

Nejprve načtěte exportovaný asset a vytvořte jeho těleso podle návodu Začínáme. Následující ukázka předpokládá, že asset obsahuje načtená data, body je platné fyzikální těleso našeho systému a BBMOD renderer je již připravený. Pokud se objekt rendereru ve vašem projektu jmenuje jinak, nahraďte o_control_bbmod_renderer jeho názvem.

• Začínáme: export a načtení assetu›

V události Create vlastnícího objektu, až budou tyto prostředky připravené, vytvořte a zaregistrujte displej:

display = jolt_asset_create_surface(asset, "dashboard_display", body);
if (is_undefined(display)) {
    show_debug_message(jolt_get_error().message);
} else {
    display.set_resolution(512, 256);
    display.set_update_rate(30);
    display.set_renderer(o_control_bbmod_renderer.renderer);
}

Vykreslení vlastního obsahu#

Tento kód vložte do Draw Begin tak, aby se provedl před vykreslením scény přes BBMOD. Vykreslí tmavé pozadí a text Ready. Souřadnice se zadávají v pixelech textury od levého horního rohu.

if (!is_undefined(display) && display.draw_begin()) {
    try {
        draw_clear(c_black);
        draw_set_color(c_white);
        draw_text(20, 20, "Ready");
    } finally {
        display.draw_end();
    }
}

Kreslete pouze tehdy, když draw_begin() vrátí true, a každé úspěšné volání zakončete draw_end(). Hodnota false může pouze znamenat, že ještě není čas obsah obnovit. Uvnitř bloku neměňte vykreslovací cíl ani nastavení displeje.

Nastavení zobrazení#

Úklid#

V Clean Up uvolněte displej před zrušením jeho tělesa nebo ukončením fyzikálního světa:

if (!is_undefined(display)) {
    display.destroy();
    display = undefined;
}

Technické poznámky#

Render Surfaces používají záznamy surfaces[] v JSON v4. Blender ukládá umístění a rozměry; obsah pixelů, rozlišení a kreslicí callbacky se nastavují za běhu hry. Současný displej je neprůhledný, takže průhledné pixely nevytvoří otvory.

Rozlišení přijímá celá čísla 1–2048 pixelů pro každou stranu; frekvence obnovy přijímá 0–1000 Hz. Ztracená textura nebo změna jejího rozlišení vyžaduje nové vykreslení při příštím úspěšném draw_begin(). Alternativou je automatické kreslení přes set_draw_callback(); úspěšné ruční kreslení tento callback nahradí. Kreslicí bloky nevnořujte. JOLT_DEBUG_SURFACES ukazuje hrany a přední směr i skrytých platných displejů.

Přehled API#

Signatury veřejných funkcí a metod. Metody volejte na vrácené instanci; parametry s výchozí hodnotou jsou volitelné.

Související návody#

• Převod staršího kódu›
• Surface input›
• Ragdolls›

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.