System Pinezek

Głównym założeniem systemu jest możliwość usprawnienia prac nad sprawdzaniem scenerii w SSS poprzez częściowe lub całkowite wyeliminowanie konieczności prowadzenia skomplikowanych dyskusji na platformie 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.

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

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!