System SZARP - dokumentacja techniczna: SZARP v.3.1 | ||
---|---|---|
Poprzedni | Rozdział 2. Konfiguracja SZARP 2.1 | Następny |
Program przeglądający draw korzysta z pliku PTT.act (Sekcja 2.3) oraz z własnych plików, opisujących dostępne zestawy wykresów (tzw. okna) i konkretne wykresy. Są dwa rodzaje tych plików, o bardzo zbliżonej składni. Pliki o nazwie ekrnXXXX.cor, gdzie XXXX należy zastąpić nazwą prefiksu konfiguracji zawierają spis okien i wykresów dla konfiguracji. Pliki o nazwie ekrnXXXX.def zawierają spis okien tzw. definiowalnych użytkownika, czyli zestawy wykresów samodzielnie tworzonych przez użytkownika (są one umieszczane w katalogu domowym użytkownika).
Plik ekrnxxxx.cor jest plikiem tekstowym. Wszystkie linie zaczynające się od znaku # (hash) traktowane są jako komentarz i mogą być pominięte, jednak ich kasowanie czy ręczna edycja nie ma większego sensu, ponieważ mogą być one zapisane przez program przeglądający wywołany z opcją:
/opt/szarp/bin/draw -drawupdateekrancor
Ponadto przy każdym zakończeniu program przeglądający zapisuje plik ekrnxxxx.def przypadku, gdy w danej sesji użytkownik przeglądał okna definiowalne i przynajmniej raz nacisnął w oknie tworzenia okna definiowalnego przycisk Ze zmianami.
Dobrze jest, jeśli dany wykres występuje tylko raz w pliku ekrnxxxx.cor (wszystkie wykresy w pliku ekrnxxxx.def pochodzą z pliku ekrnxxxx.cor), choć w praktyce zasada ta jest często łamana. Jest to o tyle niewygodne, że w oknie wyboru wykresów do okna definiowalnego umieszczone są nazwy pierwszych okien w pliku ekrnxxxx.cor, w których występują te wykresy, co czasem może być mylące dla użytkownika (wybrał np. Kocioł1|Wydajność, a pokazuje mu się potem Wydajności ciepłowni|Wydajność kotła 1).
W dalszej części tekstu jako nazwy pól przyjęto właśnie umieszczone przed nimi komentarze.
nazwa_ciepłowni ilość_okien <opis_okna_1> <opis_okna_2> ... <opis_okna_n>
Pola:
Nazwa: nazwa_ciepłowni
Typ: string, maksymalnie 80 znaków
Opis: Nazwa wyświetlana w tytułowym pasku okna programu przeglądającego.
Nazwa: ilość_okien
Typ: int, bez ograniczeń
Opis: Ilość struktur <opis_okna>, które opisano dalej. Należy pamiętać, aby po dodaniu nowego okna do pliku bezwzględnie zwiększyć odpowiednio wartość pola ilość_okien, ponieważ program przeglądający nie zasygnalizuje błędu, jeśli w pliku jest więcej struktur <opis_okna> niż wynosi wartość ilość_okien. W takim przypadku okna o numerach powyżej ilość_okien zostaną zignorowane, a przy zapisie na żądanie pliku ekrnxxxx.cor pominięte. W przypadku, gdy struktur <opis_okna> jest mniej niż wartość ilość_okien, program nie będzie działał prawidłowo.
Poprzedni | Spis treści | Następny |
Plik definable.cfg | Początek rozdziału | Struktura okna |