Manuals
Manuals




This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English

Komponent Model

Defold jest w swej istocie silnikiem 3D. Nawet gdy pracujesz wyłącznie z materiałami 2D, całe renderowanie odbywa się w 3D, ale jest rzutowane na ekran w projekcji ortograficznej. Defold pozwala korzystać z pełnej zawartości 3D przez dodawanie zasobów 3D, czyli Models, do kolekcji. Możesz budować gry wyłącznie w 3D, używając tylko zasobów 3D, albo łączyć zawartość 3D i 2D według własnych potrzeb.

Tworzenie komponentu modelu

Komponenty modelu tworzy się tak samo jak każdy inny komponent obiektu gry. Możesz to zrobić na dwa sposoby:

  • Utwórz plik Model przez kliknięcie prawym przyciskiem myszy lokalizacji w przeglądarce Assets i wybranie New... ▸ Model.
  • Utwórz komponent osadzony bezpośrednio w obiekcie gry przez kliknięcie prawym przyciskiem myszy obiektu gry w widoku Outline i wybranie Add Component ▸ Model.

Model w obiekcie gry

Gdy model jest już utworzony, musisz określić kilka właściwości:

Właściwości modelu

Oprócz właściwości Id, Position i Rotation istnieją następujące właściwości specyficzne dla komponentu:

Scene
Plik glTF .gltf lub .glb zawierający geometrię modelu. Jeśli plik zawiera cele morfingu, są one importowane razem ze sceną. Ta właściwość wcześniej nosiła nazwę Mesh.
Mesh
Opcjonalna siatka o określonej nazwie z wybranej Scene. Pozostaw pole puste, aby renderować całą scenę z zaimportowanymi transformacjami. Wybierz siatkę, aby wyrenderować ją jednokrotnie w jej współrzędnych lokalnych, bez transformacji węzłów glTF. Ustaw pozycję, obrót i skalę komponentu modelu lub jego obiektu gry, aby rozmieścić wybraną siatkę.
Create GO Bones
Zaznacz tę opcję, aby utworzyć obiekt gry dla każdej kości modelu. Takie obiekty gry możesz wykorzystać do dołączania innych obiektów, na przykład broni do kości dłoni.
Skeleton
Ta właściwość powinna wskazywać plik glTF .gltf lub .glb zawierający szkielet używany do animacji. Pamiętaj, że Defold wymaga pojedynczej kości głównej w hierarchii.
Animations
Ustaw tę właściwość na Animation Set File zawierający animacje, których chcesz używać na modelu.
Default Animation
To animacja z zestawu animacji, która będzie automatycznie odtwarzana na modelu.

Oprócz właściwości powyżej będzie też pole, w którym można przypisać materiał do każdej siatki modelu:

Material
Ustaw tę właściwość na materiał odpowiedni dla modelu. Użyj wbudowanego materiału gltf do fizycznie poprawnego renderowania właściwości materiałów glTF, wbudowanego materiału model do ogólnego cieniowania modeli albo własnego materiału. Zobacz warianty materiałów poniżej i podręcznik PBR.

W zależności od materiału będzie dostępna jedna lub więcej właściwości tekstury:

Texture
Ta właściwość powinna wskazywać obraz tekstury, który ma zostać zastosowany do obiektu. Może to być osobny zasób projektu albo osadzony obraz udostępniony pod plikiem glTF lub GLB w panelu Assets.

Wybranie Scene glTF lub GLB albo zmiana wyboru Mesh może wywołać propozycję wypełnienia powiązań materiałów i tekstur. Auto Fill zastępuje istniejące powiązania tymi ze źródła; Keep Current zachowuje twoje powiązania przy zastosowaniu nowego wyboru sceny lub siatki. Zobacz przebieg importowania modelu.

Modyfikowanie w edytorze

Mając komponent modelu na miejscu, możesz swobodnie edytować i przekształcać komponent albo otaczający go obiekt gry za pomocą zwykłych narzędzi Scene Editor, aby przesuwać, obracać i skalować model według własnego uznania.

Modyfikowanie w czasie działania

Możesz manipulować modelami w czasie działania gry za pomocą wielu różnych funkcji i właściwości (zobacz dokumentację API dotyczącą użycia).

Wiggler w grze

Animacja w czasie działania

Defold zapewnia rozbudowane wsparcie dla sterowania animacją w czasie działania gry. Więcej informacji znajdziesz w instrukcji animacji modelu:

local play_properties = { blend_duration = 0.1 }
model.play_anim("#model", "jump", go.PLAYBACK_ONCE_FORWARD, play_properties)

Kursor odtwarzania animacji można animować ręcznie albo za pomocą systemu animacji właściwości:

-- ustaw animację biegu
model.play_anim("#model", "run", go.PLAYBACK_NONE)
-- animuj kursor
go.animate("#model", "cursor", go.PLAYBACK_LOOP_PINGPONG, 1, go.EASING_LINEAR, 10)

Modele mogą też używać animacji celów morfingu z glTF. Wagi celów morfingu są animowane funkcją model.play_anim() tak jak inne animacje modelu, a w czasie działania można je odczytywać lub nadpisywać za pomocą model.get_blend_weights() i model.set_blend_weights(). Szczegóły znajdziesz w sekcji o celach morfingu w instrukcji animacji modeli.

Zmienianie właściwości

Model ma też kilka właściwości, którymi można manipulować za pomocą go.get() i go.set():

animation
Bieżąca animacja modelu (hash) (TYLKO DO ODCZYTU). Animację zmieniasz za pomocą model.play_anim() (zobacz wyżej).
cursor
Znormalizowany kursor animacji (number).
material
Materiał modelu (hash). Możesz go zmieniać za pomocą właściwości zasobu materiału i go.set(). Przykład znajdziesz w dokumentacji API.
playback_rate
Szybkość odtwarzania animacji (number).
textureN
Tekstury modelu, gdzie N ma wartość od 0 do 15 (hash). Możesz odczytywać te właściwości za pomocą go.get() i zmieniać je przy użyciu właściwości zasobu tekstury oraz go.set(). Defold obsługuje najwyżej 16 tekstur na jedno wywołanie rysowania, ale shader może użyć ich mniej na adapterach graficznych z niższym limitem samplerów tekstur.

Materiał

Oprogramowanie 3D zwykle pozwala ustawiać na wierzchołkach obiektu właściwości, takie jak kolor i teksturowanie. Informacje te trafiają do pliku glTF .gltf lub .glb, który eksportujesz z programu 3D. W zależności od potrzeb gry musisz wybrać i/lub utworzyć odpowiednie i wydajne materiały dla swoich obiektów. Materiał łączy programy cieniujące z zestawem parametrów renderowania obiektu.

W katalogu /builtins/materials/ dostępne są następujące wbudowane materiały:

Typ modelu Ogólne cieniowanie modeli Cieniowanie PBR glTF
Statyczny, bez instancjonowania model.material gltf.material
Statyczny, instancjonowany model_instanced.material gltf_instanced.material
Ze skinningiem (animowany), bez instancjonowania model_skinned.material gltf_skinned.material
Ze skinningiem (animowany), instancjonowany model_skinned_instanced.material gltf_skinned_instanced.material

Materiały gltf zapewniają wbudowane oświetlenie metallic/roughness korzystające z zaimportowanych danych materiałów glTF. Powiązania tekstur, światła i własne shadery opisano w podręczniku PBR.

Wszystkie te wbudowane materiały używają lokalnej przestrzeni wierzchołków. Dla modeli ze skinningiem pozwala ona shaderowi wierzchołków wykonywać skinning na GPU przy użyciu tekstury macierzy kości; lokalna przestrzeń jest również wymagana przy instancjonowaniu modeli. Własny materiał przeznaczony dla modeli ze skinningiem GPU lub instancjonowanych powinien więc używać ustawienia przestrzeni wierzchołków Local.

Cache macierzy kości używa tekstury RGBA32F. Jeśli aktywny adapter graficzny nie obsługuje tego formatu tekstury, Defold nie może utworzyć animowanego komponentu Model używającego materiału w przestrzeni lokalnej. W OpenGL ES 2.0 i WebGL 1.0 obsługa zależy więc od rozszerzenia tekstur zmiennoprzecinkowych adaptera. Aby zachować zgodność z adapterem, który go nie ma, użyj własnego materiału w przestrzeni świata; taki materiał wykonuje skinning na CPU i nie pozwala instancjonować modeli. Wymiary cache można dostosować w ustawieniach projektu Model.

Jeśli chcesz tworzyć własne materiały dla modeli, zajrzyj do dokumentacji materiałów, aby uzyskać więcej informacji. Instrukcja shaderów zawiera informacje o tym, jak działają programy cieniujące.

Stałe materiału

Domyślny materiał komponentu typu model posiada stałe, które można zmienić za pomocą funckji go.set() lub go.animate() (więcej szczegółów znajdziesz w instrukcji do materiałów). Przykłady:

go.set("#model", "tint", vmath.vector4(1,0,0,1))
go.animate("#model", "tint", go.PLAYBACK_LOOP_PINGPONG, vmath.vector4(1,0,0,1), go.EASING_LINEAR, 2)
tint
Odcień kolorystyczny modelu (vector4). Wektor typu vector4 służy do reprezentowania odcienia, a składowe x, y, z i w odpowiadają odpowiednio za odcień czerwony, zielony, niebieski i alfa.

Renderowanie

Domyślny skrypt renderowania rysuje materiały ze znacznikiem model, w tym wbudowane materiały modeli i glTF. Aby renderować je we własnym skrypcie renderowania, utwórz pasujący predykat i narysuj go z widokiem i projekcją odpowiednimi dla sceny. Na przykład:


  function init(self)
    self.model_pred = render.predicate({"model"})
    ...
  end

  function update()
    ...
    render.set_depth_mask(true)
    render.enable_state(graphics.STATE_DEPTH_TEST)
    render.set_projection(stretch_projection(-1000, 1000))  -- ortograficzna
    render.draw(self.model_pred)
    render.set_depth_mask(false)
    ...
  end

Szczegóły działania skryptów do renderowania znajdziesz w dokumentacji renderowania.

⌂ 换网址