Wtyczka programowa MIDI Controller 

       
        MIDI Controller jest wtyczką programową do Winampa. Jego zadaniem jest wysyłanie rozkazów MIDI podczas odtwarzania plików audio. Rozkazy są wysyłane we wcześniej ustalonych momentach, określonych czasem odtwarzanego pliku audio (na przykład: nanase.mp3) a zawartych w odpowiednich plikach tekstowych (na przykład: nanase.txt). Rozkazy poprzez złącze MIDI OUT komputera docierają do sterownika ML-640PS. Są przez niego interpretowane i w postaci sygnału DMX 512 przekazane zostają do urządzeń wchodzących w skład oświetlenia scenicznego. Sterują tymi urządzeniami w sposób zsynchronizowany z odtwarzanym plikiem audio (rys. 1).

       Wtyczka została zapisana w pliku vis_midicon.dll. Aby program Winamp mógł z nią współpracować, plik zawierający wtyczkę należy skopiować do podkatalogu Plugins znajdującym się w katalogu zawierającym wykonywalny plik programu Winamp – Winamp.exe (zazwyczaj nosi on nazwę również Winamp). Wtyczka należy do kategorii Visualization. Po uruchomieniu Winampa należy z listy możliwych do wykorzystania wtyczek wybrać właściwą. W tym celu należy uruchomić menu główne Winampa (2.xx) poprzez kliknięcie prawym przyciskiem myszy w chwili, kiedy jej wskaźnik znajduje się na jednym z paneli programu. Z głównego menu należy wybrać podmenu Visualization a po jego pojawieniu się – opcję Select plug-in (rys. 2).

       Po tych czynnościach pojawi się okno Winamp Preferences w którym należy wskazać wtyczkę MIDI Controller (rys. 3).

       Wtyczka MIDI Controller posiada własne okno konfiguracyjne umożliwiające ustawienie parametrów wtyczki (rys. 4). Okno to może zostać wywołane poprzez naciśnięcie przycisku Configure w oknie Winamp Preferences lub wybranie opcji Configure Plug-in w podmenu Visualization.

       Jeżeli w „Panelu sterowania” w „Ustawieniach regionalnych” zostanie ustawione „Polska” – wszystkie opisy w oknie konfiguracyjnym pojawią się w języku polskim. Przy każdym innym ustawieniu opisy będą wyświetlone w języku angielskim.

       Okno konfiguracyjne zawiera trzy grupy elementów umożliwiających konfigurowanie wtyczki. Pierwsza grupa dotyczy parametrów plików w których będą zapisane znaczniki czasu, rozkazy MIDI i komentarze. Pliki te są plikami tekstowymi dlatego ich domyślnie rozszerzenie ustawione zostało jako TXT. Można to zmienić wypełniając odpowiednio pole tekstowe „Rozszerzenie pliku”. Aby Winamp automatycznie odszukał plik tekstowy zawierający dane dotyczące odtwarzanego pliku audio, nazwy tych plików (audio i tekstowego) muszą być takie same – powinny różnić się jedynie rozszerzeniem. Plik tekstowy najpierw szukany jest w katalogu w którym znajdował się Winamp, a następnie przeszukiwany jest katalog określony w polu tekstowym „Ścieżka do pliku”. Jeżeli przeszukiwanie zakończy się sukcesem zostanie wyświetlone główne okno wtyczki „MIDI Controller”. Przykładowy wygląd takiego okna prezentuje rysunek 5.

       Jeżeli Check Box „Wyświetl znaczniki czasu” zostanie zaznaczony, w oknie pojawią się znaczniki czasu w postaci [xx:yy:z] gdzie xx oznacza minuty, yy – sekundy, z – dziesiąte części sekundy. W ten sposób określony zostaje moment w którym mają zostać wysłane rozkazy MIDI. Rozkazy te wyspecyfikowane są pomiędzy kolejnymi (po nawiasach ze znacznikami czasu) nawiasami kwadratowymi. Jeżeli rozkazy MIDI mają być widoczne w oknie wtyczki (tak jak na rysunku nr 5), należy zaznaczyć Check Box „Wyświetl rozkazy MIDI” w drugiej grupie elementów. Grupa nosi nazwę „Ustawienia MIDI”. Można w niej również ustawić domyślny kanał MIDI w którym wysyłane będą rozkazy, poprzez ustawienie wartości od 01 do 16 w Combo Box nazwanym „Kanał MIDI”. Kolejny Combo Box, nazwany „Urządzenie MIDI”, służy do wybrania interfejsu MIDI przez który rozkazy MIDI będą wysyłane z komputera. Interfejs może zostać wybrany spośród wszystkich automatycznie wyszukanych podczas uruchamiania wtyczki.

       Ostatnią grupę elementów konfiguracyjnych stanowią trzy elementy typu Check Box. Za ich pośrednictwem można zdecydować czy:

- podświetlana linia, z aktualnie wysyłanymi rozkazami MIDI, ma automatycznie zawsze znajdować się na środku okna wtyczki,

- okno wtyczki ma pojawiać się na środku ekranu po jej wywołaniu,

- okno wtyczki ma automatycznie dopasować swoją szerokość do najdłuższej linii wpisanego tekstu.

Ustawienie wszystkich parametrów konfiguracyjnych należy zaakceptować poprzez kliknięcie przycisku „TAK”. Powoduje to zapisanie parametrów w pliku plugin.ini znajdującego się w katalogu z wtyczkami (Plugins). Przykładową zawartość sekcji „MIDI Controller” pliku przedstawiono poniżej:

[MIDI Controller]

Screen_x=50

Screen_y=50

Client_height=380

ExtFname=TXT

DisplayTagTime=1

UserPath=c:\Prezentacja\Pokaz_1

MIDI_Device=Portman PC/P Out

DisplayTagMIDI=1

IndexChannelMIDI=9

IndexDeviceMIDI=2

AutoResize=1

CenterHighlight=1

CenterWindow=0

       Główne okno wtyczki zawiera linie składające się z trzech części.

       Pierwszą stanowi znacznik czasu i może przyjąć jedną z dwóch postaci: [xx:yy:z] lub [xx:yy], gdzie xx – minuty, yy – sekundy, z – dziesiąte części sekundy. Znacznik czasu określa, w której chwili odtwarzanego pliku muzycznego ma nastąpić wysłanie rozkazów MIDI. Przed znacznikami czasu może znajdować się również tekst złożony ze wszystkich znaków oprócz nawiasów kwadratowych i przecinków.

       Druga część linii to obszar między drugą parą nawiasów kwadratowych. Zawiera on listę rozkazów MIDI którą należy wysłać z komputera w danej chwili. Poszczególne elementy rozkazów oddzielone są przecinkami. Rozkaz rozpoczyna się identyfikatorem statusu. Można go zapisać w różny sposób:

- jeżeli status rozpoczyna litera „c” lub „C”, zostanie  zinterpretowany jako Control Change. Może on mieć zatem postać: c, cc, CC, Control Change itp.

- jeżeli status rozpoczyna litera „p” lub „P”, zostanie zinterpretowany jako Program Change, np.: p, P, PC, Program Change itp.

- jeżeli status rozpoczyna litera „n” lub „N” to ważna jest również następna litera. Jeżeli będzie to litera „f” lub „F”, rozkaz zostanie zinterpretowany jako Note Off. Dla każdej innej litery zostanie zinterpretowany jako Note On.

- jeżeli status rozpoczyna litera „x” to oznacza, że następne dwa znaki określają wartość statusu (tzw. bajt sterujący) rozkazu MIDI zapisaną w postaci szestnastkowej. Można w ten sposób zapisać każdy rozkaz MIDI i wysłać go w dowolnym kanale MIDI (bajty sterujące komunikatów kanałowych przedstawia tabela nr 1).

       Dane każdego rozkazu MIDI zapisywane są jako liczby z zakresu 0-127 (w postaci dziesiętnej). Wszystkie rozkazy których statusy zapisane zostały za pomocą ich nazwy (pełnej lub skróconej, np. CC, PC, NO itp.) są wysyłane w kanale MIDI określonym w oknie konfiguracyjnym (ustawienie „Kanał MIDI”). Jeżeli rozkazy mają być wysyłane w różnych kanałach, należy statusy tych rozkazów zapisywać w postaci szestnastkowej. Kanał MIDI ostatnio wysłanego w ten sposób rozkazu jest zapamiętywany przez wtyczkę i staje się domyślnym kanałem dla następnych rozkazów.

       Jeżeli kolejne dane dotyczą tego samego typu rozkazu (to znaczy - status następnego rozkazu jest taki sam jak poprzedniego), można pominąć status i zapisywać tylko kolejne dane.

       Trzecią część linii stanowi tekst opisu złożony z dowolnych znaków za wyjątkiem nawiasów kwadratowych i przecinków. W oknie konfiguracyjnym można określić które części linii mają być widoczne w oknie wtyczki. W skrajnym przypadku mogą zostać uwidocznione jedynie opisy tekstowe.

       Każda linia może zawierać dowolną ilość znaczników czasu. Dzięki temu zamiast powtarzać linię zawierającą taki sam zestaw rozkazów MIDI i opis, można przy już zapisanej umieścić kolejny znacznik. Kolejność znaczników w tekście nie ma znaczenia – w danej chwili wtyczka odnajdzie linię tekstu oznaczoną odpowiednim znacznikiem czasu i wyśle zapisane w niej rozkazy.

       W czasie odtwarzania pliku audio, w chwilach określonych znacznikami czasu, poszczególne linie są podświetlane i zapisane w nich rozkazy MIDI wysyłane zostają przez złącze MIDI OUT. Jeżeli będą to rozkazy wchodzące w skład MIDI Light System a urządzeniem je odbierającym – sterownik MIDI-LIGHT (np. ML-640PS), uzyskamy możliwość zsynchronizowania sterowania oświetleniem scenicznym z odtwarzanym utworem muzycznym. W ściśle określonych chwilach mamy możliwość sterowania urządzeniami podłączonymi do sterownika jak również wszystkimi parametrami sterownika. Daje to olbrzymie możliwości tworzenia powtarzalnych ciągów zachowań wszystkich urządzeń. Ich praca jest w pełni kontrolowana a zachowanie zależy wyłącznie od wyobraźni tworzącego pokaz.

       Wtyczka może być wykorzystywana nie tylko do współpracy ze sterownikami MIDI-LIGHT. Urządzeń wyposażonych w złącze MIDI jest przecież wiele ...