2.5.4. Struktura opisu wykresu

Item y
Menuitem y
DivBy y
Color y
WhichRecord y
WhichField y / IPKName y
Drawunit y
Axisnr y

Pola:

• Nazwa: Item

• Typ: char, maksymalna długość 10 znaków

• Opis: Skrótowa nazwa wykresu, ta sama co PTT -> tab[y].sym, czyli 3 pozycja w odpowiednim wierszu PTT.act (patrz niżej opis WhichRecord i WhichField). Przy modyfikacji pliku ekrnxxxx.cor na systemie z działającym parcook'iem tej pozycji można nie wpisywać (tzn. trzeba wpisać cokolwiek, ale nie musi to być zgodne z rzeczywistą nazwą parametru), gdyż wynika ona jednoznacznie z numeru rekordu i pola w rekordzie (patrz dalej).

• Nazwa: Menuitem

  Typ: char, maksymalna długość 30 znaków, zalecane do 23

  Opis: Pełna nazwa wykresu, ta sama co PTT -> tab[y].alt, czyli 7 - ostatnia (przed komentarzem) pozycja w odpowiednim wierszu PTT.act (patrz niżej opis WhichRecord i WhichField). Przy modyfikacji pliku ekrnxxxx.cor na systemie z działającym parcook'iem tej pozycji można nie wpisywać (tzn. trzeba wpisać cokolwiek, ale nie musi to być zgodne z rzeczywistą nazwą parametru), gdyż wynika ona jednoznacznie z numeru rekordu i pola w rekordzie (patrz dalej).

• Nazwa: DivBy

  Typ: double

  Opis: Przez ile należy dzielić wartość z bazy aby dostać wartość rzeczywistą, czyli 10 do potęgi miejsce przecinka, gdzie miejsce przecinka to PTT -> tab[y].dot , czyli 2 pozycja w odpowiednim wierszu PTT.act (patrz niżej opis WhichRecord i WhichField). Przy modyfikacji pliku ekrnxxxx.cor na systemie z działającym parcook'iem tej pozycji można nie wpisywać (tzn. trzeba wpisać cokolwiek, ale nie musi to być zgodne z rzeczywistą nazwą parametru), gdyż wynika ona jednoznacznie z numeru rekordu i pola w rekordzie (patrz dalej).

• Nazwa: Color

  Typ: unsigned char

  Opis: Indeks koloru wykresu, od 1 do 12. Poszczególne kolory są zdefiniowane w /opt/szarp/resources/Motif/SzarpDraw/SzarpDraw.res.

• Nazwa: WhichRecord

  Typ: int

  Opis: Tradycyjnie był to numer rekordu, w którym są dane z wykresu. Numery zaczynają się od 1, dla numeru 0 wykres jest niewyświetlany (tożsame z brakiem danych). Numer rekordu jest w bazie wartością pola ID. WhichRecord można wyliczyć z numeru wiersza w PTT.act (pomijając pierwszy wiersz opisujący ilość linii pliku):

  WhichRecord = <numer_wiersza> div 15 + 1

  Nowa konwencja umożliwia nadanie temu polu wartości -1, która umożliwia identyfikację parametru przez nazwę a nie indeks w bazie.

  Nazwa: WhichField lub IPKName

  Typ: int, zakres 0 - 14, lub string

  Opis: Tradycyjnie był to numer pola w rekordzie numer WhichRecord, zawierającego dane z wykresu. Numery zaczynają się od 0. Cały rekord ma 15 pól. Numer pola określa w bazie pole o nazwie FIELDXX, gdzie XX to WhichField. WhichField można wyliczyć z numeru wiersza w PTT.act (pomijając pierwszy wiersz opisujący ilość linii pliku):

  WhichField = (<numer_wiersza> - 1) mod 15

  Odwrotnie: aby znaleźć w PTT.act wiersz opisujący dany parametr należy (pomijając pierwszy wiersz z informacjami ogólnymi) znaleźć wiersz o numerze:

  <numer_wiersza> = (WhichRecord - 1) * 15 + WhichField + 1

  Jeżeli wartość WhichRecord była mniejsza od 0, to zamiast pola WhichField powinno wystąpić pole IPKName, zawierające pełną nazwę parametru. Decyzja, czy spodziewać się tej nazwy, czy też numeru pola jest podejmowana na podstawie wartości WhichRecord.

• Nazwa: Drawunit

  Typ: char, maksymalna długość 10 znaków

  Opis: Nazwa jednostki wykresu, ta sama co zawartość nawiasów kwadratowych pola PTT -> tab[y].full, czyli 6 pozycji w odpowiednim wierszu PTT.act (patrz wyżej opis WhichRecord i WhichField). Każda linia musi więc mieć jednostkę w nawiasach kwadratowych, o czym należy pamiętać modyfikując PTT.act, zwłaszcza przy temperaturach i wartościach bez mian, np. korektach (należy wówczas wpisać jednostkę "nic" czyli [-]). Przy modyfikacji pliku ekrnxxxx.cor na systemie z działającym parcook'iem tej pozycji można nie wpisywać (tzn. trzeba wpisać cokolwiek, ale nie musi to być zgodne z rzeczywistą nazwą parametru), gdyż wynika ona jednoznacznie z numeru rekordu i pola w rekordzie (patrz wyżej).

• Nazwa: Axisnr

  Typ: unsigned char

  Opis: Indeks osi odpowiadającej danemu wykresowi (patrz opis struktury osi). Indeksy zaczynają się od 0.