Spis treści 1 Moduł Mapy 2 1.1 Elementy planu............................. 2 1.1.1 Interfejs widoku......................... 3 1.1.1.1 Panel sterujacy.................... 3 1.1.1.2 Suwak regulujacy przybliżenie........... 4 1.2 Miniatura planu............................. 4 1.2.1 Elementy ustawiane przez użytkownika............ 5 1.2.1.1 Plan budynku.................... 5 1.2.1.2 Strefy......................... 5 1.2.1.3 Ikony......................... 6 1.2.1.4 Urzadzenia...................... 6 1.3 Konfigurowanie Modułu Mapy..................... 7 1.3.1 Lista planów.......................... 7 1.3.2 Konfiguracja planu....................... 8 1.3.2.1 Konfiguracja podstawowa.............. 8 1.3.2.2 Konfiguracja stref.................. 8 1.3.2.3 Konfiguracja ikon................... 10 1.3.2.4 Konfiguracja urzadzeń................ 17 1.4 Współpraca Modułu Mapy z jednostka decyzyjna........... 18 1.4.1 Sygnały, warunki i akcje.................... 18 1.5 Obsługa Modułu Mapy......................... 19 1.6 Błędy generowane przez Moduł Mapy................. 20 1.6.1 Strefa zdefiniowana w module mapy nie istnieje w systemie. 20 1.6.2 Nie odnaleziono pliku graficznego z tłem............ 20 1.6.3 Bład Direct X........................... 21 1.6.4 Bład podczas inicjalizacji. Sprawdź, czy posiadasz najnowsza wersję Direct X.......................... 21 1.6.5 Bład podczas wyświetlania obrazu............... 21 1.6.6 Bład podczas ładowania tekstur................. 21 1.7 Przykłady................................ 21 1
1 Moduł Mapy Moduł Mapy daje użytkownikowi możliwość interakcji z Systemem za pośrednictwem graficznego interfejsu, np. w postaci planu budynku. W ramach modułu można zdefiniować grupę planów (np. dla budynku wielopiętrowego plan każdego piętra). Rysunek 1 przedstawia przykładowy widok planu mieszkania. Rysunek 1: Widok przykładowego planu mieszkania 1.1 Elementy planu Plan składa się z czterech podstawowych elementów, definiowanych przez użytkownika: Schematu budynku, mieszkania, pomieszczenia, wczytywanego z obrazu w formacie BMP lub JPG, Stref, odpowiadających zdefiniowanym strefom w Systemie, Ikon funkcyjnych, Ikon urządzeń. Poza elementami skonfigurowanymi oraz dodanymi przez użytkownika, istnieje grupa obiektów dostępnych w widoku. Pozwalają one na interakcję użytkownika z modułem i nazywane są interfejsem widoku. Do grupy tej zaliczają się: Panel sterujący pozwalający na poruszanie się po planie, przechodzenie między planami itd., Suwak regulujący przybliżenie widoku planu, 2
Miniatura planu, pozwalająca w łatwy sposób poruszać się po dużym planie, oraz określić aktualnie podglądany obszar planu. 1.1.1 Interfejs widoku 1.1.1.1 Panel sterujący Panel sterujący został przedstawiony na rysunku 2. Jego funkcjonalność opisuje poniższa tabela. Rysunek 2: Panel sterujacy Wyświetla listę wszystkich planów, pozwala przejść do wybranego. Przesuwa podgląd widoku w górę. Wyświetla widok planu w trybie pełnoekranowym. Przesuwa podgląd widoku w lewo. Ustawia podgląd widoku w domyślnej pozycji. Przesuwa podgląd widoku w prawo. 3
Oddala podgląd widoku dalej od planu. Przesuwa podgląd widoku w dół. Przybliża podgląd widoku bliżej do planu. 1.1.1.2 Suwak regulujący przybliżenie Suwak pozwala regulować przybliżenie podglądu widoku. Jego reprezentacja graficzna została przedstawiona na rysunku 3. Regulacja może odbywać się za pomocą przycisków plus, minus, lub poprzez przeciąganie suwaka w odpowiednie miejsce na skali. Rysunek 3: Suwak regulujacy przybliżenie podgladu widoku 1.2 Miniatura planu Miniatura planu wyświetla cały obszar planu. Pozwala w łatwy sposób przemieszczać się po nim - wystarczy kliknąć miniaturę w miejsce, które ma zostać wyświetlone. Pozwala również zidentyfikować obecnie oglądany fragment planu, który określony jest jako czerwony prostokąt. Rysunek 4 przedstawia wygląd miniatury planu w widoku. 4
Rysunek 4: Minimapa 1.2.1 Elementy ustawiane przez użytkownika 1.2.1.1 Plan budynku Rysunek z planem budynku stanowi podstawowy element modułu, na którym wyświetlane są strefy, ikony i urządzenia. Rysunek może zostać wczytany z formatu JPG lub BMP. Plan nie zostanie poprawnie zainicjalizowany, jeśli rysunek z planem nie zostanie wczytany. 1.2.1.2 Strefy Każda strefa zdefiniowana w Systemie może mieć graficzną reprezentację w postaci kolorowego wielokąta umieszczanego na planie. Pozwala to na zdefiniowanie ciągłej akcji z nią związanej - miganie obszaru na ustalony w akcji kolor. Rysunek 5 przedstawia przykładowy trójkatny obszar migający w kolorze zielonym. Rysunek 5: Wyświetlony obszar (zielony) 5
1.2.1.3 Ikony Ikony umieszczane są w obrębie planu. Istnieje pięć podstawowych typów ikon: Sygnalizator - pozwala ustalić akcję w jednostce decyzyjnej, Sygnalizator z przyciskiem - pozwala ustalić warunek i akcję w jednostce decyzyjnej, Przycisk/Suwak - pozwala ustalić warunek w jednostce decyzyjnej, Przejście do planu - pozwala przejść do innego, zdefiniowanego w konfiguracji planu, Regulator - pozwala impulsowo sterować urządzeniami. Sygnalizator posiada cztery podtypy: Dwustanowy - sygnalizator binarny posiadający sygnał ciągły, Liczba całkowita - sygnalizator wyświetlający wartość całkowitą, posiadający sygnał ciągły, Liczba rzeczywista - sygnalizator wyświetlający wartość liczby rzeczywistej posiadający sygnał ciągły, Tekstowy - sygnalizator wyświetlający wartość tekstową posiadający sygnał ciągły. Przycisk/Suwak posiada trzy podtypy: Dwustanowy - przycisk binarny posiadający sygnał impulsowy (dla monostabilnego) lub ciągły (dla bistabilnego), Liczba całkowita - suwak pozwalający ustawić wartość w dobranym zakresie, posiadający sygnał ciągły, Liczba rzeczywista - suwak pozwalający ustawić wartość rzeczywistą, posiadający sygnał ciągły. Sygnalizator z przyciskiem łączy funkcjonalność przycisku oraz sygnalizatora binarnego. Pozwala ustalić w jednostce decyzyjnej warunek impulsowy (dla przycisku monostabilnego) lub ciągły (dla przycisku bistabilnego) oraz ciągłą akcję. 1.2.1.4 Urządzenia Ten element reprezentuje urządzenia pewnych typów, posiadających możliwość prezentacji w widoku (np. kamera). Konkretny egzemplarz jest tożsamy 6
z pojedyńczym elementem modułu, zdefiniowanym uprzednio w Systemie. Po kliknięciu na mapie ikonki symbolizującej dany typ urządzenia, wyświetlana jest ramka z podglądem. Może ona zostać później przełączona w tryb pełnoekranowy poprzez kliknięcie wewnątrz ramki. Symbol krzyżyka umożliwia zamknięcie podglądu. Przykładowy element tego typu, wyświetlający obraz z kamery przedstawia rysunek 6. Rysunek 6: Okno podgladu obrazu z urzadzenia na przykładzie kamery 1.3 Konfigurowanie Modułu Mapy Rozdział ten zawiera informacje na temat zarządzania i konfiguracji Modułu Mapy. 1.3.1 Lista planów Lista zdefiniowanych planów dostępna jest po wybraniu opcji: Konfiguracja -> Moduły -> Moduł Mapy. Rysunek 7 przedstawia okno zawierające listę wszystkich planów. Kliknięcie przycisku Dodaj powoduje wyświetlenie okna konfiguracji nowego planu. Kliknięcie przycisku Usuń powoduje usunięcie z listy wybranego planu. Po wciśnięciu przycisku Modyfikuj wyświetlane jest okno konfiguracji dla wybranego planu. Zamknięcie okna następuje po wcisnięciu przycisku Zamknij. Podgląd mapy planu widoczny jest w ramce podglądu. 7
Rysunek 7: Lista wszystkich planów 1.3.2 Konfiguracja planu Okno konfiguracji planu podzielone jest na trzy części: Drzewo zakładek konfiguracji, Panelu podglądu, Głównej ramki konfiguracyjnej, która jest zależna od wybranej zakładki w drzewie. Drzewo posiada cztery zakładki: Podstawowe - ustalenie bazowych parametrów planu, Strefy - wyznaczenie stref w obrębie planu, Ikony - rozmieszczenie i konfigurowanie ikon funkcyjnych, Urządzenia - rozmieszczenie i konfigurowanie ikon urządzeń. 1.3.2.1 Konfiguracja podstawowa Okno konfiguracji podstawowej zostało przedstawione na rysunku 8. Konfiguracja podstawowa musi zostać wykonana, aby móc przejść do kolejnych zakładek. W formatce tej należy określić nazwę planu, czy konfigurowany plan ma być domyślnie wyświetlanym, plik graficzny z mapą planu oraz opcje dodatkowe: rozmiar ikon, wyświetlane elementy oraz opis. 1.3.2.2 Konfiguracja stref Okno, w którym użytkownik ma możliwość rozmieszczenia stref przedstawione zostało na rysunku 9. 8
Rysunek 8: Okno konfiguracji planu - zakładka Podstawowe Rysunek 9: Okno konfiguracji planu - zakładka Strefy Po kliknięciu na przycisk Wstaw strefę wyświetlane jest okno wyboru strefy, która ma zostać przypisana do nowo tworzonego wielokąta. Okno to przedstawia rysunek 10. Po wybraniu strefy użytkownik ma możliwość wyznaczenia na planie obszaru - prawe kliknięcie myszy dodaje wierzchołek wielokąta określającego obszar. Po wyznaczeniu wszystkich wierzchołków, aby zakończyć tryb tworzenia obszaru, należy kliknąć przycisk Zakończ obszar. Kliknięcie przycisku Wyczyść wszystko usuwa wszystkie strefy naniesione na plan, natomiast kliknięcie przycisku Usuń strefę powoduje usunięcie tylko zaznaczonej strefy. 9
Rysunek 10: Wybór strefy, ktora ma zostać przedstawiona graficznie 1.3.2.3 Konfiguracja ikon Po wybraniu zakładki Ikony wyświetlane jest okno umożliwiające rozmieszczenie i konfigurację ikon funkcyjnych, które zostało przedstawione na rysunku 11. Rysunek 11: Okno konfiguracji planu - zakładka Ikony Po kliknięciu przycisku Wstaw ikonę wyświetlane jest okno konfiguracyjne pozwalające ustalić parametry nowo tworzonej ikony funkcyjnej. Po skonfigurowaniu ikony, kliknięcie na planie umieszcza ją we wskazanym miejscu. Wciśnięcie przycisku Wyczyść wszystko powoduje usunięcie wszystkich naniesionych ikon z planu. Chcąc usunąć wybraną ikonę, należy kliknąc Usuń ikonę, natomiast kliknięcie przycisku Konfiguruj wyświetla okno konfiguracji zaznaczonej ikony. Rysunek 12 przedstawia okno konfiguracji ikony na przykładzie ikony sygnal- 10
izatora binarnego. Rysunek 12: Konfiguracja ikony funkcyjnej - Sygnalizator binarny Po prawej stronie znajduje się lista rodzajów ikon: Sygnalizator, Sygnalizator z przyciskiem, Przycisk/Suwak, Przejście do planu, Regulator. Po prawej znajduje się panel konfiguracyjny dla wybranego rodzaju ikony oraz podgląd. Parametry, które należy zdefiniować dla sygnalizatora, zostały przedstawione w tabeli: Rodzaj danych Wybór rodzaju sygnału: dwustanowy, całkowity, rzeczywisty, tekstowy. Nazwa elementu Nazwa ikony wyświetlana na planie. Typ ikony Reprezentacja graficzna ikony wyświetlana na planie. Kolor Kolor ikony. 11
12
Rysunek 13 przedstawia okno konfiguracji sygnalizatora liczby całkowitej. Rysunek 13: Konfiguracja ikony funkcyjnej - Sygnalizator liczby całkowitej Dla sygnalizatora reprezentującego liczbę całkowitą (także rzeczywistą lub tekstową) należy ustalić następujące parametry: Nazwa Typ Nazwa ikony wyświetlana na planie. Format wyświetlania. Jednostka Jednostka, która określa wyświetlaną wartość. 13
Na rysunku 14 zostało przedstawione okno konfiguracji sygnalizatora z przyciskiem. Rysunek 14: Konfiguracja ikony funkcyjnej - Sygnalizator z przyciskiem Dla sygnalizatora z przyciskiem należy określić parametry przedstawione w tabeli: Rodzaj danych Nazwa elementu Typ ikony Kolor Wartość, jaką reprezentuje sygnalizator (dwustanowy). Nazwa wyświetlana na przycisku ikony. Reprezentacja graficzna ikony. Kolor ikony. Typ binarny Rodzaj przycisku ikony (monostabilny/bistabilny). 14
Rysunek 15 przedstawia okno konfiguracyjne ikony typu Przycisk/Suwak. Rysunek 15: Konfiguracja ikony funkcyjnej - Suwak Dla przycisku należy skonfigurować parametry, które zostały zaprezentowane w tabeli: Rodzaj danych Nazwa elementu Typ ikony Kolor Typ binarny Dla przycisku: dwustanowy. Nazwa ikony wyświetlana na planie. Graficzna reprezentacja ikony. Kolor ikony. Rodzaj przycisku: monostabilny lub bistabilny. Dla suwaka należy ustalić parametry przedstawione w tabeli: Rodzaj danych Nazwa elementu Dla suwaka: całkowity lub rzeczywisty. Nazwa ikony wyświetlana na planie. 15
Typ ikony Dla suwaka: suwak. Maksymalna wartość Górna granica, której nie może przekroczyć wartość suwaka. Minimalna wartość Dolna granica, której nie może przekroczyć wartość suwaka. Jednostka Jednostka opisująca wartość suwaka. Okno konfiguracji ikony przejścia do planu zostało przedstawione na rysunku 16. Rysunek 16: Konfiguracja ikony funkcyjnej - Przejście do planu Poprawna konfiguracja ikony przejścia do innego planu przewiduje ustalenie parametrów, które zostały przedstawione w tabeli: Plan Typ ikony Plan, który ma zostać wyświetlony po kliknięciu ikony. Reprezentacja graficzna ikony. 16
Rysunek 17 przedstawia okno konfiguracji ikony regulatora. Rysunek 17: Konfiguracja ikony funkcyjnej - regulator. Dla regulatora należy skonfigurować parametry przedstawione w tabeli: Nazwa Nazwa elementu wyświetlana na ikonie regulatora. 1.3.2.4 Konfiguracja urządzeń Po wybraniu zakładki Urządzenia wyświetlane jest okno umożliwiające rozmieszczenie i konfigurację ikon urządzeń, które zostało przedstawione na rysunku 18. Po kliknięciu przycisku Wstaw urządzenie wyświetlane jest okno konfiguracji urządzenia, które zostało przedstawione na rysunku 19. Kliknięcie przycisku Wyczyść wszystko usuwa z aktualnego planu wszystkie ikony urządzeń. Po kliknięciu przycisku Konfiguruj urządzenie wyświetlane jest 17
Rysunek 18: Okno konfiguracji planu - zakładka urzadzenia okno konfiguracyjne wybranej ikony urządzenia. Kliknięcie przycisku Usuń urządzenie powoduje usunięcie wybranej ikony urządzenia z planu. Rysunek 19: Konfiguracja urzadzenia Tabela przedstawia listę parametrów ikony, które można ustalić za pomocą okna konfiguracyjnego urządzenia: Typ Urządzenie Kolor Rodzaj urządzenia (np. kamera, wykres). Konkretne urządzenie w Systemie Vision. Kolor ikony wyswietlanej na planie. 1.4 Współpraca Modułu Mapy z jednostka decyzyjna Rozdział ten zawiera informacje na temat sygnałów, warunków i akcji, jakie oferuje Moduł Mapy, oraz opis przykładowej 18 konfiguracji warunków i akcji w jednostce decyzyjnej. Interakcja Modułu Mapy z jednostką decyzyjną odbywa się poprzez wyko-
Sygnalizator z przyciskiem monostabilnym Sygnalizator z przyciskiem bistabilnym Przycisk monostabilny Przycisk bistabilny Suwak z wartością całkowitą Suwak z wartością rzeczywistą Regulator Sygnał impulsowy. Sygnał ciągły. Sygnal impulsowy. Sygnal ciagły. Sygnał ciągły. Sygnał ciągły. Sygnały impulsowe. Tabela przedstawia akcje udostępniane przez ikony i strefy: Sygnalizator dwustanowy Sygnalizator całkowity Sygnalizator rzeczywisty Sygnalizator tekstowy Sygnalizator z przyciskiem Strefa Sygnał ciągły. Sygnał impulsowy. Sygnał impulsowy. Sygnał impulsowy. Sygnał ciągły. Sygnał impulsowy. 1.5 Obsługa Modułu Mapy Aby podgląd planu był widoczny na ekranie, należy skonfigurować plany oraz dodać Moduł Mapy do odpowiedniego widoku. Ekran z podglądem planu został przedstawiony na rysunku 20. Poza elementami interfejsu widoku, omówionymi w rozdziale 1.1.1, użytkownik ma 19
możliwość interakcji z elementami umieszczonymi na planie. Po kliknięciu przycisku myszki na ikonę zostaje wywołana akcja, jeśli takowa została zdefiniowana w jednostce decyzyjnej. Jeśli zostanie kliknięty i przytrzymany przycisk myszki poza ikoną oraz zostanie przesunięty kursor, podgląd zostanie przesunięty zgodnie z ruchem kursora. Przesuwanie podglądu może również odbywać się za pomocą ikonek panelu sterującego, przedstawionego na rysunku 2, którego pełna funkcjonalność została opisana w rozdziale 1.1.1.1. Sterowanie przybliżeniem widoku odbywa się za pomocą specjalnego suwaka, który został przedstawiony na rysunku 3. Dodatkowo dostępna jest miniatura planu, której funkcjonalność została opisana w rozdziale 1.2. Rysunek 20: Przykładowy widok planu 1.6 Błędy generowane przez Moduł Mapy W przypadku wystąpienia błędów podczas działania Modułu Mapy, generowane są następujące komunikaty: 1.6.1 Strefa zdefiniowana w module mapy nie istnieje w systemie. Komunikat ten informuje o sytuacji, w której strefy skonfigurowane w Module Mapy zostały usunięte z konfiguracji systemu Vision.W tej sytuacji należy ponownie stworzyć wskazaną strefę w systemie lub usunąć ją z Modułu Mapy. 1.6.2 Nie odnaleziono pliku graficznego z tłem. Komunikat ten występuje w przypadku, gdy został usunięty plik graficzny z tłem planu. Należy wejść do konfiguracji planu i wskazać nowy plik z tłem. 20
1.6.3 Bład Direct X. Komunikat ten informuje o błędzie bibliotek Microsoft DirectX. W tym przypadku należy zainstalować najnowszą wersję bibliotek Direct X 9. 1.6.4 Bład podczas inicjalizacji. Sprawdź, czy posiadasz najnowsza wersję Direct X. Komunikat ten informuje o błędach, które wystąpiły podczas inicjalizacji Modulu Mapy. Prawdopodobnie nie została zainstalowana najnowsza wersja bibliotek Microsoft Direct X 9. 1.6.5 Bład podczas wyświetlania obrazu. Komunikat ten informuje o błędach krytycznych Modułu Mapy, które wystąpiły podczas wyświetlania planu. 1.6.6 Bład podczas ładowania tekstur. Komunikat ten oznacza, że Moduł Mapy nie mógł załadować grafiki. Prawdopodobnie zabrakło pamięci karty graficznej lub plik wykonywalny został uszkodzony. 1.7 Przykłady Na planie zostały zdefiniowane dwa elementy: Ikona przycisku bistabilnego, Strefa. Celem przykładu jest zdefiniowanie reguły w jednostce decyzyjnej, aby wciśnięty przycisk powodował miganie strefy. W tym celu należy zdefiniować regułę w jednostce decyzyjnej o warunku: Typ urządzenia: Moduł Mapy, Urządzenie: Moduł Mapy, Warunek: <Nazwa planu> - Przyciski - <Nazwa przycisku> Okno konfiguracji wyżej wymienionego warunku zostało przedstawione na rysunku 21. Akcję należy zdefiniować następująco: 21
Rysunek 21: Konfiguracja reguły w jednostce decyzyjnej - warunek Typ urządzenia: Moduł Mapy, Urządzenie: Moduł Mapy, Akcja: Piętro obszar, Kolor: kolor, na jaki ma migać obszar. Okno konfiguracji wyżej opisanej akcji w jednostce decyzyjnej zostało przedstawione na rysunku 22. Rysunek 22: Konfiguracja reguły w jednostce decyzyjnej - akcja 22