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

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