Edytor cue

Edytor cue to główne miejsce, w którym tworzysz, modyfikujesz i organizujesz poszczególne polecenia (cue) w swoim skrypcie. Arthoff oferuje bogaty zestaw wbudowanych typów cue oraz możliwość definiowania własnych (poprzez wtyczki lub przyszłe integracje).

Interfejs edytora

Po wybraniu cue z listy (lub kliknięciu „+ Dodaj cue”) ekran dzieli się na trzy główne sekcje:

📋 Lista cue i sekcji

Po lewej stronie – drzewo sekcji i cue. Umożliwia szybką nawigację, przeciąganie i upuszczanie oraz podgląd struktury.

✏️ Panel edycji

W środku – formularz właściwości wybranego cue. Zawiera pola wspólne (nazwa, opis, sekcja) oraz specyficzne dla typu cue (np. tekst dialogu, kanał DMX, parametr efektu).

👁️ Podgląd i akcje

Po prawej – podgląd tego, jak cue będzie wyglądać w widoku live (dla typu dialogue – balon z tekstem; dla oświetlenia – symulacja kanałów; dla dźwięku – fala audio). Dodatkowo przyciski akcji: anuluj, zapisz, duplikuj, usuń.

Dodawanie nowego cue

Edytowanie istniejącego cue

Szybka edycja w linii

Dla niektórych typów cue (np. Dialogue, Comment) możesz edytować główną zawartość bezpośrednio na liście:

• Dwukliknij na tekst cue na liście → pojawi się pole edycji w linii.
• Wprowadź zmiany i naciśnij Enter aby zatwierdzić lub Escape aby anulować.

Typy cue i ich pola

Arthoff dostarcza następujące wbudowane typy cue. Każdy typ ma własny ikonę, kolor oraz określony zestaw właściwości.

Dialogue

• Ikona: balon z tekstem
• Kolor: --cue-dialogue
• Pola:
  • Tekst – wypowiedź aktora (wymagane)
  • Postać – imię lub opis postaci (opcjonalnie)
  • Uwaga reżyserska – tekst wyświetlany tylko w widoku presentera (opcjonalnie)
  • Opóźnienie startu – czas w sekundach po poprzednim cue, zanim to cue stanie się aktywne (domyślnie 0)
  • Tryb wyświetlania – Napis, Balon lewy, Balon prawy, Balon środek

Audio

• Ikona: głośnik
• Kolor: --cue-audio
• Pola:
  • Źródło dźwięku – plik MP3/WAV lub strumień (URL)
  • Głośność – 0–100%
  • Panorama – lewy/prawy (−100 … +100)
  • Fade in/out – czas w sekundach
  • Tryb odtwarzania – Raz, W pętli, Do następnego cue
  • Wyzwalacz – Automatycznie, Po wciśnięciu spacji, Po sygnale MIDI/OSC

Lighting

• Ikona: reflektor
• Kolor: --cue-lighting
• Pola:
  • Kanały DMX – lista kanałów i ich wartości (0–255) – można wprowadzać zakresy
  • Grupy – wybór wcześniej zdefiniowanych grup oświetleniowych
  • Preset – wybór zapisanego scenariusza oświetlenia (jeśli zintegrowany z konsolą)
  • Czas fade – długość przejścia od poprzednich wartości
  • Tryb – Snapshot (natychmiastowe ustawienie), Fade (płynne przejście)

Camera

• Ikona: kamera
• Kolor: --cue-camera
• Pola:
  • Numer kamery lub nazwa preset
  • Ustawienia ostrości, zoom, przesłona (jeśli kamerą steruje się poprzez protokół VISCA/NDI)
  • Przejście – Cut, Fade, Wipe
  • Czas przejścia

Stage Move

• Ikona: postaci lub przesuwany obiekt
• Kolor: --cue-stage-move
• Pola:
  • Obiekt/postać – która ma się poruszyć
  • Docelowa pozycja – współrzędne X,Y na scenie (lub nazwa punktu oznaczona wcześniej)
  • Prędkość – jednostki na sekundę
  • Trasę – Prosta linia, Z punktami pośrednimi
  • Opóźnienie rozpoczęcia

Comment

• Ikona: komentarz
• Kolor: --cue-comment
• Pola:
  • Tekst komentarza – uwaga dla zespołu (nie wyświetlane w żywo)
  • Kolor tła – do wizualnego odróżnienia (żółty, niebieski, zielony, różowy)
  • Do kogo – oznaczenie aktora lub działu (opcjonalnie)

Timer

• Ikona: zegar
• Kolor: --cue-timer
• Pola:
  • Czas trwania – w sekundach
  • Typ – Odliczanie w dół, Stopwatch
  • Dźwięk sygnału końcowego – opcjonalny plik dźwiękowy
  • Powiadomienie – wyświetl komunikat presentera po zakończeniu

OSC Placeholder (przyszła integracja)

• Ikona: fale
• Kolor: --cue-osc
• Pola:
  • Adres OSC – np. /light/1/intensity
  • Wartość – liczba lub tablica
  • Typ danych – float, int, string, blob
  • Port docelowy – domyślnie 8000 (konfigurowalne w ustawieniach projektu)

Custom (dla wtyczek)

• Ikona: puzzle
• Kolor: --cue-custom
• Pola: definiowane przez twórcę wtyczki – pojawiają się po załadowaniu wtyczki w panelu administracyjnym.

Widoki specjalne

Podgląd prezentera

Klikając ikonę 👓 (okulary) w prawym górnym rogu edytora cue, przełączasz tryb podglądu, który pokazuje:

• Jak tekst dialogu pojawi się w widoku aktora (balon lub napis)
• Symulację wartości DMX (paski poziomu)
• Fala audio i poziom głośności
• Kamerę – podgląd RTSP/NDI jeśli dostępny

Połączenia i zależności

Niektóre cue mogą mieć określone „wyzwalacze” zależne od innych cue:

• W edytoru cue otwórz zakładkę „Zaawansowane” → „Wyzwalacz”.
• Możesz ustawić, aby to cue uruchamiało się automatycznie po określonym czasie po poprzednim cue, lub ręcznie po wciśnięciu klawisza, sygnale MIDI/OSC, lub po zakończeniu poprzedniego cue typu Timer.

Komentarze i dyskusje przy cue

Każde cue posiada własny wątek komentarzy:

Historia wersji cue

Każde cue przechowuje własną historię (podobnie jak cały skrypt):

Eksport pojedynczego cue

Chociaż najczęściej eksportuje się cały skript, możesz wyeksportować pojedyncze cue:

• W edytorze cue otwórz menu … (trzy kropki) → „Eksportuj cue jako JSON”.
• Plik zawiera wszystkie pola cue oraz jego metadane (ID, sekcja, autor, czas utworzenia).

Najczęstsze scenariusze użycia edytora cue

Scenariusz 1: Reżyser pisze dialog

• Dodaje cue typu Dialogue, wpisuje tekst, wybiera postać.
• Ustawia małe opóźnienie (0.5s) po poprzednim cue, aby aktor miał czas na reakcję.
• Dodaje komentarz: „Zwróć uwagę na emocję w ostatnim zdaniu”.
• Wysyła powiadomienie operatorowi dźwięku, aby przygotował efekt pogłosu na kolejne cue.

Scenariusz 2: Operator oświetlenia tworzy scenę

• Dodaje cue typu Lighting.
• Wprowadza wartości kanałów dla reflektorów prowadzących i światła tylnego.
• Ustawia fade 2s, aby przejście było płynne.
• Kopiuje cue (Ctrl+D) i lekko modyfikuje wartości dla kolejnego momentu (np. zwiększa intensywność światła tylnego).
• Ustawia wyzwalacz „Automatycznie” – cue uruchamia się po zakończeniu poprzedniego (np. po wypowiedzi aktora).

Scenariusz 3: Operator dźwięku odtwarza muzykę

• Dodaje cue typu Audio.
• Wybiera plik MP3 z motywem przewodnim.
• Ustawia fade in 1.5s, fade out 2s, głośność 80%.
• Zaznacza „Do następnego cue” – muzyka będzie grać w tle aż do kolejnego cue dźwiękowego lub jawnego zatrzymania.
• Ustawia wyzwalacz „Po sygnale MIDI” – uruchamia się gdy naciśnie pedał na kontrolerze MIDI.

Scenariusz 4: Operator kamery zmienia ujęcie

• Dodaje cue typu Camera.
• Wybiera kamerę 2, ustawia zbliżenie na postać.
• Przejście typu Fade trwające 1s.
• Ustawia wyzwalacz „Automatycznie” – zmienia się po zakończeniu poprzedniego cue ruchu scenicznego.

Scenariusz 5: Aktor zaznacza swój tekst

• Aktor loguje się, przechodzi do widoku /show.
• Widzi jedynie cue typu Dialogue, gdzie jego postać jest zaznaczona.
• Nie może edytować cue, jedynie oznaczyć je jako „gotowe” (ikona V) po odtworzeniu linii.

Najczęstsze pytania (FAQ)

Jak zmienić domyślny czas trwania fade dla wszystkich nowych cue oświetleniowych?

W ustawieniach projektu → sekcja „Oświetlenie” możesz zdefiniować domyślne wartości fade-in/fade-out oraz domyślne kanały dla nowych cue typu Lighting.

Czy mogę podglądać efekt DMX bez podłączonej konsoli?

Tak. W podglądzie prezentera (ikonka okularów) pojawią się suwaki pokazujące wartości 0–255 dla każdego kanału, które możesz obsługiwać myszą lub wprowadzić wartości bezpośrednio.

Jak dodać własny typ cue (np. dla efektów pirotechnicznych)?

Obecnie wymaga to wdrożenia wtyczki przez zespół rozwojowy (lub własny zespół, jeśli masz dostęp do kodu). W przyszłości planujemy interfejs „Cue Builder” w panelu administracyjnym, gdzie będzie można definiować pola i logikę bez pisania kodu.

Czy istnieje limit liczby cue w jednym skrypcie?

Nie ma sztywnego limitu technicznego, ale dla komfortu pracy zalecamy nie przekraczać 500 cue w jednym skrypcie. W przypadku bardzo dużych produkcji warto podzielić wydarzenie na kilka skryptów (np. po aktach) i łączyć je poprzez przejścia w trybie prezentera.