Jak przesłać pupila

01/07

Omówienie

Pupil 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ć.

Pupila możesz zgłosić na dwa sposoby. Najszybszy to wklejenie adresu z Petdex. Jeśli przechowujesz własny arkusz klatek i plik sprite.json, skorzystaj z GitHub. Możesz zgłosić gotowego pupila z Petdex albo stworzyć własnego.

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 pupili pod adresem petdex.crafter.run, gdzie możesz przeglądać, tworzyć i hostować pupile. Każdy pupil ma tam link do udostępniania w formacie https://petdex.crafter.run/pets/<pet-id>.

Aby przesłać:

Znajdź albo utwórz pupila w Petdex i skopiuj jego URL.
Na ekranie Submit Sprite wybierz "Submit via Petdex".
Wklej URL pupila 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ść arkusz klatek 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 poprawnie wskazać autora.
Dodaj przydatne informacje w opcjonalnym polu "Notes", a potem wyślij.

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

05/07

Tworzenie własnego unikalnego pupila

Zamiast korzystać z gotowego pupila z Petdex, możesz stworzyć własną postać. Narzędzia AI, takie jak OpenAI Codex albo generatory obrazów AI, są praktycznym sposobem na przygotowanie arkusza klatek postaci od zera.

Arkusz klatek (spritesheet) to jeden obraz PNG lub WebP, na którym klatki są ułożone w regularną siatkę, nazywaną atlasem. 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.

Sprawdzony sposób pracy: 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 Sprite’y w LVGL.

06/07

Co dzieje się później

Po wysłaniu zgłoszenia zespół PicoPixel sprawdza pupila i może odezwać się, jeśli coś wymaga wyjaśnienia. Zatwierdzone pupile 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