Mapa i znaczniki#

Ta strona opisuje, jak narysowane są znaczniki na mapie: dlaczego nie są zwykłymi pinezkami, jakie rodzaje i kolory występują oraz ile to kosztuje wydajności.

Jedna warstwa znaczników#

Znaczniki nie są adnotacjami mapy — nie ma pinezek, kółek ani emoji zawieszonych nad ludzikiem. Rysuje je jedna własna warstwa graficzna w aplikacji i przygotowane rysunki (sprite'y) z tej samej palety na stronie. Powody są trzy:

• pełna kontrola nad wyglądem — znacznik wygląda tak samo w aplikacji i w przeglądarce,
• zero źródeł i warstw stylu mapy na znaczniki (nic nie wpada do stylu kafelków i nic go nie spowalnia),
• jeden dodatkowy koszt rysowania na wszystkie ludziki i znaczniki zamiast kilkunastu osobnych warstw.

To była zmiana z wcześniejszego podejścia: pierwsza wersja rysowała znajdźki bitmapą „naklejoną” na mapę i kółka klastrów z liczbami, przez co styl znaczników odstawał od postaci. Teraz wszystko jest w stylu blocky — tak samo jak ludziki, więc mapa czyta się jednym językiem.

Ludziki (gracz, inni gracze, lobby, boty) to jeden zbiorczy layer zamiast kilkunastu osobnych warstw, a pionek postaci rysowany jest tym samym rendererem 3D co na mapie głównej i w mini-mapie widoku AR.

Rodzaje i kolory#

Znajdźki#

Klocek złożony z trzech części: ciemnogranatowa podstawa, złota skrzynka i kremowa iskra nad nią.

Rozmiar na ekranie to 14–30 px: z bliska znacznik trzyma górny wymiar, z daleka działa podłoga rozmiaru, żeby znajdźka nie zamieniła się w pół piksela. To poprawka po zgłoszeniu „znajdźki nie są widoczne, dopiero po przybliżeniu”.

Punkty trasy#

Pięć stanów, każdy z własną bryłą, wysokością i kolorem:

Rozmiar liczony jest w pikselach ekranu, nie w metrach: od 14 px przy zbliżeniu 12,5 do 34 px przy zbliżeniu 17 (z zapasem na pulsowanie). Dzięki temu koniec z „flagą wielkości budynku” przy oddalaniu. Etykietę dostaje stop wyróżniony (ten, do którego prowadzi nawigacja) albo dotknięty; na stronie nazwa ląduje pod znacznikiem, żeby nie zasłaniać modelu.

Boty NPC#

Bot to ludzik chodzący po drogach. Żeby dało się go znaleźć z miasta, dostaje pierścień pod stopami i nazwę — i tylko tyle, bez żadnej adnotacji zawieszonej nad głową.

Ikony z jednego źródła#

Znacznik znajdźki pojawia się w trzech miejscach: na mapie w aplikacji, na mapie w przeglądarce i jako ikona w plecaku. Żeby nie powstał drugi, „podobny” rysunek, każde z nich pochodzi z jednego planu:

• plan rysunku znajdźki opisany jest w module mapy strony: z niego powstaje obrazek wstrzykiwany do mapy, i z niego generowana jest ikona wektorowa dla aplikacji (jedna definicja obsługuje każdą gęstość ekranu),
• paleta kolorów jest wspólna dla tych rysunków i dla brył 3D w aplikacji,
• test pilnuje, że ikona w plecaku to wariant niezebranej (kolorowej) znajdźki, a nie odbarwiony.

Zasada jest szersza: paleta, progi zbliżenia i kolejność stanów znaczników są porównywane maszynowo między aplikacją a stroną. Rozjazd (na przykład dodanie koloru tylko po jednej stronie) kończy się nieudaną kontrolą, a nie cichą różnicą w wyglądzie.

Wydajność mapy#

Wydajność mierzymy przed i po każdej optymalizacji, dokładając kolejne warstwy: pionek → znajdźki → trasa → gracze → lobby → boty. Zmierzone i pilnowane liczby:

Opis zgodny z aplikacją 0.120.1 (zaktualizowano 2026-09-26).