5.2.10. Element draw

Element draw opisuje wykres, na którym ma być widoczna wartość parametru w programie przeglądającym. Podobnie jak w przypadku raportów, można umieścić kilka takich elementów, umieszczając w ten sposób parametr na kilku wykresach. Element draw ma następujące atrybuty:

• title - tytuł wykresu (okna z wykresami), wymagany. Wykresy o tym samym tytule tworzą opis okna programu przeglądającego.

• max - liczba rzeczywista - maksymalna wartość parametru, określająca górny zakres osi na wykresie parametru. Jest to wartość w takiej postaci, w jakiej będzie widziana na wykresie, a więc po wszelkich przeskalowaniach. Obecność tego atrybutu jest wymagana przez program przeglądający Szarp Draw 2.1.

• min - podobnie jak wyżej, tylko dolna granica zakresu wartości dla parametru. Uwaga - w IPK nie ma pojęcia "osi" (axis) występującego w plikach konfiguracyjnych eknrXXXX.cor. Osie są tworzone automatycznie na podstawie atrybutów min i max.

• scale - atrybut potrzebny do skalowania części wykresu. Program przeglądający pozwala przeskalować część wykresu, tak żeby pewien zakres wartości zajmował inną część osi, niż bez przeskalowania. Granice przedziału skalowania określają dwa następne atrybuty, zaś ten atrybut jest liczbą całkowitą, mówiącą o tym, ile procent osi powinien zajmować podany przedział wartości. Jeżeli atrybut jest nieobecny lub ma wartość 0, przeskalowanie nie jest dokonywane.

• minscale - liczba rzeczywista - dolny zakres wartości podlegających przeskalowaniu - patrz wyżej.

• maxscale - jak wyżej, tylko górny zakres wartości.

• color - kolor wykresu, teoretycznie w jednej ze standardowych postaci (a więc nazwa symboliczna, zapis szesnastkowy wartości RGB itp.). Dla programu SzarpDraw 2.1 jest wymagany, co więcej powinien mieć jedną z wartości: black, red, #FFC246, cyan, green, yellow, #B9F4BE, blue, magenta, #00B6FF, #A6A550, #FF825F, #AFAFFF (odpowiedniki kolorów 1 - 12 z pliku ekrnXXXX.cor). Jeśli nie zostanie podany, przy generacji pliku ekrnXXXX.cor kolory zostaną dobrane automatycznie.

• prior - priorytet wykresu - liczba rzeczywista dodatnia. W formacie konfiguracji SZARP 2.1 kolejność okien z wykresami była ustalana przez kolejność wpisów w pliku ekrnXXXX.cor. Aby umożliwić zachowanie tej kolejności, można podać priorytet - im mniejszy, tym wyżej będzie okno na liście. Priorytet dotyczy okna (a nie wykresu), uwzględniany jest najmniejszy priorytet spośród wszystkich wykresów należących do danego okna. Ponieważ jest to liczba rzeczywista nie trzeba przeliczać innych priorytetów przy przestawieniu jednego okna (zawsze da się coś wcisnąć). Zaleca się używanie tylko jednego atrybutu prior na okno (a więc tylko w jednym z wykresów należących do okna).

• order - podobnie jak prior jest to liczba rzeczywista dodatnia, ale dotyczy kolejności wykresu w oknie. Wykresy nie mające tego atrybutu będą umieszczane na końcu okna.

• special - atrybut specjalny dla program SzarpDraw 2.1, wartość tekstowa, jedna z:

  • "piedraw" - parametr jest liczony do wykresu kołowego

  • "hoursum" - parametr jest liczony do sumowania godzinowego

  • "valve" - zawory, atrybut dla kompatybilności wstecz

  • "rel" - jeśli w oknie są dwa wykresy, to w oknie dodatkowym pojawi się wyliczenie stosunku wartości parametrów z wykresów

  • "diff" - w oknie dodatkowym pojawia się różnica wartości końcowej i początkowej dla wykresu.

  • "none" - wartość domyślna, brak specjalnych właściwości.

  Dokładne omówienie znaczenia tych atrybutów znajduje się w pliku resources/documentation/draw.ekran.README.html w repozytorium SZARP.

Przykładowy opis wykresu może wyglądać tak:

        <draw title="Kocioł WR 5 - temperatury" prior="81" color="cyan" min="0"
max="150" order="2"/>