Umožňuje sledování, zobrazování a archivování historických trendů analogových signálů. Data archivuje buď do standardního databázového souboru ve formátu dBase III (soubory DBF) nebo přes rozhraní ODBC do různých databází. Archivní soubory mohou vznikat jednorázově nebo periodicky podle časového období zachyceného v jednom archivním souboru. Lze také definovat jejich historii, resp. počet souborů uchovávaných na disku nebo v databázích.
trend trend_name; rem = string; bubble = string; timer = timer_name; owner = owner_name; position = integer, integer, integer, integer; win_disable = win_disable_list; win_title = string; access = integer; tab_select = integer; send_same_data; driver_exception = driver_name; file_name = string; file_type = file_type_identifier; file_length = ineger; file_start = integer, integer, integer, integer; file_history = integer; file_access = cardinal; file_name_type = identifier; odbc enable; dsn = string; user_name = string; password = string; file_extension = string; end_odbc; condition = boolean_expression; output = output_name; frame = integer; font = font_identifier, integer, style_identifier; content = identifier_list; title = string; title_font = font_identifier, integer, style_identifier; graph_length = integer, unit_identifier; h_grid = integer; v_grid = integer; show_grid; adjust_grid; item name = string; length = integer; dec_places = integer; expression = any_expression; range_from = real; range_to = real; units = string; label = string; color = color; status = identifier_list; end_item; item ... end_item; colors text = color; background = color; top_shadow = color; bottom_shadow = color; graph_background = color; h_grid = color; v_grid = color; value_text = color; value_background = color; value_top_shadow = color; value_bottom_shadow = color; select = color; button_up_background = color; button_up_top_shadow = color; button_up_bottom_shadow = color; button_down_background = color; button_down_top_shadow = color; button_down_bottom_shadow = color; end_colors; end_trend;
Podrobný popis parametrů pro definici archivních souborů je uveden v kapitole Databáze a archivace dat.
Úplný vzhled přístroje je vidět na obrázku:
Kliknete-li myší na tlačítko (ikona pro otevření souboru), zobrazí se dialogové okno, ve kterém jsou zobrazeny dostupné archivní soubory. Data vybraného souboru lze prohlížet nebo zpracovávat dostupnými DataView nebo soubor zkopírovat do jiného adresáře nebo jej uložit pod jiným jménem.
Kliknete-li myší na tlačítko s grafem, můžete měnit počet čar rastru a zobrazovaný počet vzorků grafu.
Pomocí tlačítek se šipkami lze ovladát pohyb časového kurzoru.
Tlačítko se zámkem přepne přístroj do prohlížecího módu.
Tlačítko s mřížkou zapíná nebo vypíná zobrazování rastru.
Pomocí tlačítek v dolní části panelu lze přepínat cejchování levé y-ové osy a zapínat nebo vypínat zobrazování příslušných sérií.
Ovládání časového kursoru z klávesnice:
Některé parametry mají implicitní nastavení
position = 0, 0, 300, 150; access = 4294967295; tab_select = 4294967295; file_type = relative; file_length = hour; file_start = 0, 0, 1, 1; file_history = 10; file_access = 4294967295; file_name_type = new_code; content = x_ruler, left_y_ruler, right_y_ruler, v_control_panel, tools, title; graph_length = 10, samples; h_grid = 0; v_grid = 0; show_grid; colors text = black; background = lgray; top_shadow = white; bottom_shadow = dgray; graph_background = dgray; h_grid = yellow; v_grid = yellow; value_text = black; value_background = lgray; value_top_shadow = dgray; value_bottom_shadow = white; select = black; button_up_background = lgray; button_up_top_shadow = white; button_up_bottom_shadow = dgray; button_down_background = lgray; button_down_top_shadow = dgray; button_down_bottom_shadow = white; end_colors;
Příklad nastavení přístroje
trend Trend; timer = 1; owner = background; position = 18, 35, 628, 301; win_title = 'Trend'; file_type = relative; file_length = minute; file_name = T; file_history = 30; condition = Enable; content = x_ruler, left_y_ruler, v_control_panel, tools; graph_length = 30, seconds; h_grid = 9; v_grid = 8; show_grid; item name = KANAL1; length = 5; dec_places = 1; expression = K1; range_from = 0; range_to = 100; units = 'MPa'; label = 'Tlak'; color = lgreen; status = invisible, select; end_item; item name = KANAL2; length = 5; dec_places = 1; expression = K2; range_from = -50; range_to = 50; units = '°C'; label = 'Teplota'; color = lred; status = select; end_item; end_trend;
DoArchive()
Provede archivaci nadefinovaných dat.
CopyToViewer()
Otevře TrendViewer a zkopíruje do něj aktuální data z přístroje.
CopyToViewer( TemplateFile : string )
Otevře TrendViewer a zkopíruje do něj data z přístroje. Jako šablonu nastavení vlastností pro TrendViewer použije parametry ze souboru v parametru TemplateFile.
GetLeftYLegend( &SerieName : string )
Vrátí v parametru SerieName název vybrané serie.
GetLeftYLegend( &SerieNumber : number )
Vrátí v parametru SerieNumber číslo vybrané serie.
SetLeftYLegend( SerieName : string )
Nastaví popis levé y-ové osy odpovídající zadanému názvu serie SerieName.
SetLeftYLegend( SerieNumber : number )
Nastaví popis levé y-ové osy odpovídající zadanému číslu serie SerieNumber.
GetGraphTimeInterval( &FromDate, &FromTime, &ToDate, &ToTime : string )
Vrátí v parametrech FromDate, FromTime, ToDate, ToTime právě zobrazený časový interval grafu. Formát data a času odpovídá systémovému nastavení.
GetCursorValue( SerieName : string; &Date, &Time : string; &Value : number )
Vrátí datum v parametru Date, čas v parametru Time a hodnotu v parametru Value pro sérii o názvu SerieName odpovídající aktuální pozici časového kurzoru.
GetCursorValue( SerieNumber : number; &Date, &Time : string; &Value : number )
Vrátí datum v parametru Date, čas v parametru Time a hodnotu v parametru Value pro sérii číslo SerieNumber odpovídající aktuální pozici časového kurzoru.
MoveCursor( ToLeft, ByPage : boolean )
Přesun kurzoru v prohlížecím módu doleva (parametr ToLeft nastaven na true) nebo doprava o jednu hodnotu. Je-li parametr ByPage true, pak je kurzor přesunut o Length vzorků (viz SetGraphLen).
MoveCursorOnClick( Enable : boolean )
Pokud je parametr Enable nastaven na hodnotu true, pak v prohlížecím módu bude časový kurzor přesunut na pozici ukazatele kurzoru myši.
SetGraphLen( Length, Units : number )
Definuje délku (počet vzorků) Length zobrazovaného grafu.
Hodnoty pro parametr Units:
SetGrid( On : boolean )
Bude-li mít parametr On hodnotu true, bude zobrazována mřížka.
SetGridLines( Horizontal, Vertical : number )
Definuje počet horizontálních (parametr Horizontal) a vertikálních (parametr Vertical) čar mřížky.
SetLock( On : boolean )
Bude-li mít parametr On hodnotu true, pak bude přístroj přepnut do prohlížecího módu.
SetRange( SerieName : string; RangeFrom, RangeTo : real )
Nastaví rozsah y-ové osy série s názvem SerieName od RangeFrom do RangeTo.
SetRange( SerieNumber : number; RangeFrom, RangeTo : real )
Nastaví rozsah y-ové osy série číslo SerieNumber od RangeFrom do RangeTo.
SetSerie( SerieName : string; Invisible : boolean )
Pokud je parametr Invisible nastaven na true, bude skryto zobrazování průběhu série s názvem SerieName.
SetSerie( SerieNumber : number; Invisible : boolean )
Pokud je parametr Invisible nastaven na true, bude skryto zobrazování průběhu série číslo SerieNumber.
SetSerieColor( SerieName : string; Color : number )
Nastavení barvy Color čáry grafu série s názvem SerieName.
Hodnoty parametru Color a odpovídající barvy:
SetSerieColor( SerieNumber, Color : number )
Nastavení barvy Color čáry grafu série číslo SerieNumber. Hodnoty parametru Color viz SetSerieColor.
SetSerieColor( SerieName : string; R, G, B : number )
Nastavení barvy čáry grafu série s názvem SerieName ve složkách R, G, B.
SetSerieColor( SerieNumber, R, G, B : number )
Nastavení barvy čáry grafu série číslo SerieNumber ve složkách R, G, B (viz SetSerieColor).
SetSerieLabel( SerieName, Label : string )
Nastavení textového popisu série s názvem SerieName na hodnotu v parametru Label.
SetSerieLabel( SerieNumber : number; Label : string )
Nastavení textového popisu série číslo SerieNumber na hodnotu v parametru Label.
SetTimeStamp( TimeFormat, DateFormat : string; ShowTime, ShowDate : boolean )
Nastavení zobrazování a formátu data a času časových značek na x-ové ose.
TimeFormat - formát zobrazovaného času (např. hh:mm:ss)
DateFormat - formát zobrazovaného data (např. dd-mm-yyyy)
ShowTime - pokud je true, bude zobrazován čas
ShowDate - pokud je false, bude zobrazován datum
SetTitle( Title : string )
Zobrazí Title jako nadpis grafu trendu.
SetPaperOrientation( Landscape : boolean )
Nastavení orientace tisku. Má-li parametr Landscape hodnotu true, bude se tisknou naležato.
Hide()
Skrytí viditelného přístroje.
Show()
Zobrazení skrytého přístroje.
Print()
Vytiskne zobrazený trend.
Print( TemplateFile : string )
Vytiskne zobrazený trend. Jako šablonu nastavení vlastností pro TrendViewer použije parametry ze souboru v parametru TemplateFile.
Print( BlackAndWhite : boolean )
Pokud má parametr BlackAndWhite hodnotu true, vytiskne zobrazený trend černobíle.
NewRect( x, y, w, d : number )
Zavoláním procedury je možné přístroji změnit současně jeho pozici a velikost. Nové rozměry v parametrech x, y, w, d jsou v bodech obrazovky.
Přístroj může volat standardní událostní procedury:
OnActivate() OnMouseDown( MouseX, MouseY : integer; LeftButton, MiddleButton, RightButton : boolean ) OnMouseDoubleClick( MouseX, MouseY : integer; LeftButton, MiddleButton, RightButton : boolean ) OnMouseUp( MouseX, MouseY : integer; LeftButton, MiddleButton, RightButton : boolean ) OnMouseMove( MouseX, MouseY : integer; LeftButton, MiddleButton, RightButton : boolean ) OnSelect() OnDeselect() OnShow() OnHide() OnNewPosition( RectX, RectY, RectW, RectD : integer ) OnWindowMinimize() OnWindowMaximize() OnWindowRestore( WasMinimized, WasMaximized : boolean ) OnWindowClose()
Podrobnější informace k těmto procedurám lze nalézt v kapitole Programování a procedury.