View source for Edytor/System pinezek

Głównym założeniem systemu jest możliwość usprawnienia prac nad sprawdzaniem scenerii w [https://git.ttsk.ngo/td2dev/scenery-review/-/blob/master/INSTRUKCJA%20MERYTORYCZNA.md?ref_type=heads SSS] poprzez częściowe lub całkowite wyeliminowanie konieczności prowadzenia skomplikowanych dyskusji na platformie [https://git.ttsk.ngo/ GitLab], których nieodzownym elementem jest wklejanie multimediów (wycinków ekranów, filmików) i obszernych opisów napotkanych błędów, niedociągnięć i uwag. Dodatkowo pinezki mogą wspomóc twórców w procesie planowania i budowy scenerii jako punkty odniesienia i miejsca na notatki.

Pinezki to obiekty, które można ustawić na scenerii w taki sam sposób jak elementy otoczenia.

[[Image:Screenshot 2025-10-20 22-02-25 builder.png|mały]]

Możliwe do edycji właściwości:

* pozycja na scenerii (vector3),

* notatka (text, limit 1024 znaków),

* status: domyślny, wymaga poprawki, zatwierdzony,

* typ: domyślny, informacja, ostrzeżenie, błąd.

Dane nieedytowalne:

* id pinezki,

* id autora,

* unikalne id scenerii na której ustawiono pinezkę (nie mylić z hashem, jest to unikalny ciąg generowany przy tworzeniu scenerii i zapisywany w nagłówku pliku .sc scenerii),

* data utworzenia pinezki,

* data ostatniej modyfikacji pinezki,

* pozycja kamery w momencie ostatniej edycji pinezki.

Obiekty pinezek nie są zapisywane w pliku .sc, a w '''dedykowanej bazie danych'''. Pozwoli to uniknąć sytuacji, w której twórca scenerii usunie pinezkę z uwagami stworzonymi przez recenzenta. W wymianie informacji pomiędzy edytorem scenerii a bazą danych bierze udział API. Prawo do edycji i usuwania pinezki mają:

* autor pinezki,

* konstruktorzy,

* administratorzy.

Nowy obiekt pinezki ustawiony na scenerii nie jest natychmiast zapisywany w bazie danych, następuje to dopiero po przyciśnięciu dedykowanego przycisku w panelu edycji pinezki (tzw. fajeczki), taki sam mechanizm zastosowany jest dla edycji właściwości zatwierdzonej pinezki. Niezatwierdzona pinezka oznaczona jest dodatkowo obwódką w białym kolorze. Sam obiekt pinezki składa się z modelu 3D, którego kolor jest zależny od typu (omówione wyżej) oraz notatki wyświetlanej w formie napisu 3D, który jest zwrócony w stronę kamery edytora. W pinezki możliwe jest wstawianie linków.

Do przeglądania pinezek stworzona została dedykowana przeglądarka. Umożliwia ona podgląd na wszystkie pinezki przypisane do edytowanej scenerii. Możliwe jest ukrycie pinezek oznaczonych jako zweryfikowane "Checked" przy użyciu przycisku z gwiazką. Dostępna jest opcja wyszukiwania po tekście i sortowania pinezek według parametrów: 

* id pinezki,

* autor pinezki,

* typ pinezki,

* status pinezki,

* data utworzenia pinezki,

* data ostatniej edycji pinezki,

* niezatwierdzone pinezki.

[[Image:Screenshot 2025-10-20 22-12-24 builder.png|mały]]

Po kliknięciu na ikonkę celownika obok wybranej pinezki kamera przeniesie się do lokalizacji pinezki.

'''Ważne''': aby rozpocząć zapis z systemem pinezek na swojej scenerii należy ją uprzednio zapisać w edytorze, aby w nagłówku pliku .sc powstał unikalny identyfikator, który będzie wiązał scenerię z pinezkami w bazie danych!