panthera

Panthera Laufzeit

Panthera Runtime - Eine Entfaltungsbibliothek, mit der Animationen mit dem Panthera 2.0 -Editor , einer vielseitigen Animationssoftware erstellt wurden, in Entfaltungsprojekte integriert werden. Diese Laufzeitbibliothek vereinfacht den Prozess des Importierens und Abspielen von Panthera -Animationen und verbessert die visuelle Qualität und Interaktivität von Entfaltungsspielen und Anwendungen.

Merkmale

• Seamless Animationsintegration : Importieren und verwenden Sie Panthera 2.0 -Animationen direkt in der Entfaltung.
• Vollständiger Animationsunterstützung : Unterstützt alle Animationsfunktionen von Panthera 2.0, einschließlich Ereignissen, Animationsmischung, verschachtelten Animationen und vielem mehr.
• Flexible Nutzung : Kompatibel mit Spielobjekten und GUI -Knoten in der Entbindung und ermöglicht eine vielseitige Anwendung über verschiedene Spielelemente hinweg.
• Animation Cursor : Bietet eine Möglichkeit, die Animation manuell zu steuern und eine genaue Kontrolle über die Wiedergabe und Synchronisierung mit Spielereignissen zu ermöglichen.
• Hot Reloading : Animationen neu laden während der Entwicklung im laufenden Fliegen, ermöglichen eine schnelle Iteration und das Testen von Animationsgütern.

Panthera 2.0 Herausgeber

Lesen Sie den Panthera 2.0 -Editor Guide, um sich mehr über den Panthera 2.0 -Editor zu erfahren, ein innovatives Tool, das mit der Defold Engine entwickelt wurde, um die Erstellung von Animationen für Entfaltungsprojekte zu vereinfachen und zu verbessern.

Aufstellen

Abhängigkeit

Öffnen Sie Ihre Datei in game.project und fügen Sie die folgenden Zeilen zum Feld Abhängigkeiten im Bereich des Projekts hinzu:

Tweener entfachen

 https://github.com/Insality/defold-tweener/archive/refs/tags/3.zip

Panthera Laufzeit

 https://github.com/Insality/panthera/archive/refs/tags/runtime.4.zip

Wählen Sie anschließend Project ▸ Fetch Libraries aus, um Bibliotheksabhängigkeiten zu aktualisieren. Dies geschieht automatisch, wenn Sie ein Projekt öffnen, sodass Sie dies nur tun müssen, wenn sich die Abhängigkeiten ändern, ohne das Projekt erneut zu eröffnen.

Bibliotheksgröße

Hinweis: Die Bibliotheksgröße wird basierend auf dem Build -Bericht pro Plattform berechnet

Plattform	Bibliotheksgröße
HTML5	12.42 kb
Desktop / Mobile	21,35 kb

Heiße Nachladeanimationen für die Entwicklung [optional]

HINWEIS: Das heiße Nachladen ist nur für die Verwendung in Entwicklungsumgebungen ausgelegt. Hot Reloading funktioniert nur für Animationen aus JSON -Dateien. Wenn Sie einen Lua -Tisch für Animationen verwenden, funktioniert das heiße Nachladen nicht.

Panthera Runtime unterstützt das heiße Nachladen von Animationen für einen effizienteren Entwicklungsworkflow. Mit dieser Funktion können Animationen automatisch neu geladen werden, ohne Ihr Entfaltungsspiel neu zu starten, was die schnelle Iteration von Animationsgütern erleichtert.

Fügen Sie die folgenden Einstellungen in Ihr game.project -Datei ein, um das heiße Nachladen von Animationen zu aktivieren:

 [panthera]
hotreload_animations = 1

Konfigurationsdetails:

• Hotreload_animations : auf 1 einstellen, um das heiße Nachladen zu aktivieren. Diese Funktion ist nur im Debug -Modus aktiv.

Implementierung der heißen Reload in der Entfaltung:

Um heißes Nachladen zu verwenden, richten Sie einen Fensterereignis -Listener in Ihrem Entfaltungsskript ein, das panthera.reload_animation() auslöst, wenn das Spielfenster in den Fokus gewinnt. Dies stellt sicher, dass die Animationen während der Entwicklung automatisch aktualisiert werden:

 local panthera = require ( " panthera.panthera " )

-- Reload animation when window is focused, only for debug and on desktop
window . set_listener ( function ( _ , event )
    if event == window . WINDOW_EVENT_FOCUS_GAINED then
        panthera . reload_animation ()
    end
end )

API -Referenz

Schnelle API -Referenz

 panthera . create_gui ( animation_path_or_data , [ template ], [ nodes ])
panthera . create_go ( animation_path_or_data , [ collection_name ], [ objects ])
panthera . create ( animation_path_or_data , adapter , get_node )
panthera . clone_state ( animation_state )
panthera . play ( animation_state , animation_id , [ options ])
panthera . stop ( animation_state )
panthera . set_time ( animation_state , animation_id , time )
panthera . get_time ( animation_state )
panthera . get_duration ( animation_state , animation_id )
panthera . is_playing ( animation_state )
panthera . get_latest_animation_id ( animation_state )
panthera . set_logger ([ logger_instance ])
panthera . reload_animation ([ animation_path ])

API -Referenz

Lesen Sie die API -Referenzdatei, um die vollständige API -Dokumentation für das Modul anzuzeigen.

Nutzungsbeispiele

Integrieren Sie Panthera -Animationen in diese präzisen Beispiele in die Entleerung:

Beispiel 1: Starten Sie die Animation in Go

Laden und spielen Sie eine Animationsdatei mit dem Go -Adapter ab.

 local panthera = require ( " panthera.panthera " )
local animation = require ( " path.to.panthera_animation " )

function init ( self )
    self . animation = panthera . create_go ( animation )
    panthera . play ( self . animation , " run " , { is_loop = true })
end

Dieses Beispiel wendet eine Looping -Laufanimation auf ein Spielobjekt an, wenn das Spiel beginnt.

Beispiel 2: Animation in GUI starten

Laden und spielen Sie eine Animationsdatei mit dem GUI -Adapter ab.

 local panthera = require ( " panthera.panthera " )
local animation = require ( " path.to.panthera_animation " )

function init ( self )
    self . animation = panthera . create_gui ( animation )
    panthera . play ( self . animation , " fade_in " )
end

Dieses Beispiel wendet eine Fade-In-Animation auf einen GUI-Knoten an, wenn das Spiel beginnt

Beispiel 3: Überprüfen Sie, ob die Animation abgespielt wird

Überprüfen Sie, ob derzeit eine Animation abgespielt wird, und abrufen die aktuelle Animations -ID.

 local panthera = require ( " panthera.panthera " )

function init ( self )
    -- You can use JSON instead of Lua tables, but it should be accessible with sys.load_resource()
    self . animation = panthera . create_gui ( " /animations/animation.json " )
    local is_playing = panthera . is_playing ( self . animation )
    local animation_id = panthera . get_latest_animation_id ( self . animation )

    if is_playing then
        print ( " The animation is currently playing: " , animation_id )
    else
        print ( " The animation is not playing " )
    end
end

Gehen Sie Animationsbeschränkungen

Bei der Integration von Panthera 2.0 -Animationen in Defold Game -Objekte (GOS) ist es wichtig zu wissen, welche Eigenschaften Sie animieren können:

Standardmäßig verwenden Sprite -Komponenten die tint -Eigenschaft und Etikettenkomponenten verwenden die color . Panthera versucht, color zu verwenden. Um color zu aktivieren, sollten Sie das Material der Sprite -Komponente auf /panthera/materials/sprite.material einstellen oder ein anderes Material mit color verwenden.

• Position : Objekte bewegen.
• Rotation : Objekte drehen.
• Skala : Skalierungsobjekte.
• Farbe : Aktualisieren Sie die Farbe der Sprite- oder Textkomponente.
• Slice9 : Slice9 Eigenschaften der Sprite -Komponente aktualisieren.
• Größe : Aktualisierung der Größe der Sprite -Komponente.
• Text : Textinhalt der Beschriftungskomponente aktualisieren.
• Textur : Wechseln Sie Texturen der Sprite -Komponente.
• Aktiviert : Toggle -Objekt aktiviert/deaktiviert.

Animationsmischung

Lesen Sie den Animations -Mischanleitung, um zu erfahren, wie Sie mehrere Animationen gleichzeitig auf derselben Entität mischen und komplexe, geschichtete Animationen erstellen, die die visuelle Treue und Dynamik Ihres Spiels verbessern.

Anpassen Ihres Adapters

Während Panthera Runtime einen Standardadapter für Spielobjekte und GUI bietet, müssen Sie Ihren Adapter möglicherweise anhand der Anforderungen Ihres Projekts anpassen. Lesen Sie das Anpassen Ihres Adapterhandbuchs, um zu erfahren, wie Sie Lockerungstypen zuordnen, benutzerdefinierte Ereignisse abwickeln und Ihren benutzerdefinierten Adapter mit Panthera -Laufzeit verwenden.

Lizenz

Die Panthera -Laufzeit ist unter der MIT -Lizenz lizenziert - Einzelheiten finden Sie in der Lizenzdatei.

Probleme und Vorschläge

Für Probleme, Fragen oder Vorschläge erstellen Sie bitte ein Problem.

Changelog

Lesen Sie den ChangeLog, um die neuesten Updates und Funktionen in Panthera -Laufzeit zu erfahren.

? Mitwirkende

❤️ Unterstützen Sie das Projekt ❤️

Ihre Unterstützung motiviert mich, weiterhin Projekte zur Entfaltung zu erstellen und zu pflegen. Erwägen Sie Unterstützung, wenn Sie meine Projekte hilfreich und wertvoll finden.