Jak przesłać zwierzaka

01 /07

Omówienie

Zwierzak to animowany sprite, mała postać, która przechodzi przez klatki i dzięki temu ożywa. Gdy ją prześlesz, może pojawić się w społecznościowej galerii Pets, aby każdy mógł jej używać i się nią cieszyć.

Są dwa sposoby przesłania zwierzaka. Najszybszy prowadzi przez Petdex: wklejasz jeden URL i gotowe. Drugi prowadzi przez GitHub, dla sprite'ów, które hostujesz samodzielnie jako spritesheet i sprite.json. Możesz przesłać istniejącego zwierzaka z Petdex albo stworzyć własnego, oryginalnego.

Obie metody są dostępne w aplikacji PicoPixel, więc najpierw musisz się zalogować.

02 /07

Zanim zaczniesz

Wszystko odbywa się w aplikacji PicoPixel. Aby przejść do ekranu przesyłania:

Otwórz aplikację pod adresem app.picopixel.io.
Zaloguj się, jeśli nie jesteś jeszcze zalogowany; logowanie odbywa się przez OAuth z Google albo GitHub. Jeśli pominiesz ten krok, zobaczysz prośbę o zalogowanie przed wysłaniem.
Kliknij swoje konto na dole lewego paska bocznego.
Wybierz "Your account".
Otwórz "Submit Sprite".

Ekran Submit Sprite oferuje dwie metody opisane poniżej.

NOTE

Aby cokolwiek przesłać, musisz być zalogowany. Jeśli nie jesteś zalogowany, aplikacja poprosi Cię o to przed kontynuacją.

03 /07

Przesyłanie przez Petdex

To zalecana i najszybsza metoda. Petdex to zewnętrzny katalog zwierzaków pod adresem petdex.crafter.run, gdzie możesz przeglądać, tworzyć i hostować zwierzaki. Każdy zwierzak ma tam link do udostępniania w formacie https://petdex.crafter.run/pets/<pet-id>.

Aby przesłać:

Znajdź albo utwórz zwierzaka w Petdex i skopiuj jego URL.
Na ekranie Submit Sprite wybierz "Submit via Petdex".
Wklej URL zwierzaka w polu "Petdex URL".
Dodaj pomocne informacje w opcjonalnym polu "Notes".
Wyślij formularz.

TIP

Przesyłanie przez Petdex jest najszybszą ścieżką; nie bez powodu ma etykiety RECOMMENDED i FASTEST. Wystarczy jeden URL.

04 /07

Przesyłanie przez GitHub

Użyj tej metody, gdy samodzielnie hostujesz sprite. Podajesz wtedy surowe pliki zamiast linku Petdex.

Umieść obraz spritesheet i pasujący plik sprite.json w publicznym repozytorium GitHub.
Na ekranie Submit Sprite wybierz "Submit via GitHub".
Wklej URL repozytorium (https://github.com/...).
Wypełnij "Credits / Author", aby praca została poprawnie przypisana.
Dodaj przydatne informacje w opcjonalnym polu "Notes", a potem wyślij.

Spritesheet i sprite.json muszą mieć określony format. Następna sekcja wyjaśnia go krok po kroku.

05 /07

Tworzenie własnego unikalnego zwierzaka

Zamiast używać wyróżnionego zwierzaka z Petdex, możesz stworzyć oryginalnego. Narzędzia AI, takie jak OpenAI Codex albo generatory obrazów AI, są praktycznym sposobem na przygotowanie spritesheetu postaci od zera.

Spritesheet to pojedynczy obraz (PNG albo WebP) ułożony jako równa siatka, czyli "atlas". Ułóż jedną animację w każdym wierszu i zachowaj identyczny rozmiar każdej klatki.

WARNING

Każda klatka musi mieć dokładnie tę samą szerokość i wysokość. Siatka z niedopasowanymi komórkami nie zostanie poprawnie pocięta, a animacja będzie skakać albo się zepsuje.

Plik sprite.json opisuje arkusz. Ma dwie główne części:

atlas, czyli układ siatki: columns, rows, frameWidth i frameHeight.
states, tablica animacji. Każdy stan ma id, label, wiersz row, liczbę frames, opcjonalne durationMs, group i caption.

Typowe stany to idle, wave, jump, run-right, run-left, running, waiting, failed i review. Sprite potrzebuje co najmniej dwóch stanów, więc wygeneruj popularne stany, przynajmniej idle oraz jeden ruch.

Dobry workflow: wygeneruj klatki w stałym rozmiarze, ułóż je w regularnej siatce z jedną animacją na wiersz, potem opisz siatkę i stany w sprite.json i prześlij przez Petdex albo GitHub.

TIP

Koncepcja sprite'ów, stanów, faz i ponownego użycia jest dokładniej opisana w LVGL Sprites.

06 /07

Co dzieje się później

Po wysłaniu zgłoszenia zespół PicoPixel sprawdza zwierzaka i może odezwać się, jeśli coś wymaga wyjaśnienia. Zatwierdzone zwierzaki pojawiają się w galerii Pets z przypisaniem do Ciebie. Od tego momentu każdy w społeczności może je znaleźć i używać.

07 /07