Short description

Graph Capture

• was designed for suitable plotting
  charts from text files
  or from programs text-windows, that
  have not charts themselfs;
  To plot from static file -
  just drag and drop .txt or .xls
  file into Graph Capture (other way
  described in plugin section).
  The source could be dynamic when
  data accumulates during the time.
  In that case plotting should be without delay if
  full size of incoming data limited by 2 Mb,
  increment happens infrequently (up to ~ 0.1 sec),
  or with delay in other cases;
  Plotting from dynamic data sources -
  press plagin button "Grub data",
  follow instructions.
  About plagin and program interaction
  see footnote.

---

Common information:

Briefly saying, to plot chart, data has to
contain X-values and corresponding
Y-values. Before discovery values from
data, you should set its shape, format
and position in data strings. This can be
done by using Regular expression editor
which takes expressions in Perl form
and some additional info. To call editor
press top button with wrench icon. You
can Select/Edit/Delete appropriate
template in it through submenu of template.

1) Loading Drag&Drop:
supported for excel and text
files, folders with files (up to 16 at one
time up to Win7). Shift+Drop to accumulate
data in main window.
While loading options (.ini files),
hold Shift for retaining previous
data (herewith "option files"
will not add in text fild).
Also it's possible to drag and drop
pictures to chart background and on
big side buttons, the pictures will
be saved and loaded in future.

2) Saving Drag&Drop:
Undock and drag corresponding big
button (on the right) in required directory.
Undock data -> file contains .txt or .xls data
Undock chart -> file contains .png picture
Undock options -> file contains .ini program options
Undock printer -> file contains .ini print options.

It's possible to navigate (forward/backward)
through items "Data"/"Chart"/"Options"
by additional mouse buttons.

---

Hot buttons:
-Tab on page "Data"
will switch view "text"/"excel"
-"Data" ~ (Ctrl+1)
-"Chart" ~ (Ctrl+2)
-"Options" ~ (Ctrl+3)
-"Print" ~ (Ctrl+4)
-"Exit" ~ (Ctrl+5)
- close child window ~ Esc

---

Chart:

1) To move chart, hold right mouse
button on chart canvas (not on line!)
and move mouse.

2) To zoom/unzoom chart press and hold
left mouse button on chart canvas (not on
line!) and, by mouse moving, pick out
chart area by appeared frame. Then if
release mouse button, part of chart
in selected area will take area's
proportions and streatch/shrink on
entire chart canvas. Or simple rotate
mouse scroll.

3.1) To see texts value,
that matches selected point
on chart line, hold Ctrl and left-click
on that point. Text window with selected
value should appears.

3.2) To see (and save) text data,
matches selected range on chart,
hold Crtl and select by left mouse
button part of chart. Release mouse
button and Ctrl, main text window
with selected range should
appears and after 1 sec. should come
save dialog (in case if "Propose
to save the selected area" chacked).

Option "Time in saved file name"
affects here on file name.

4) To change color of selected line
right click on it. Then color selection
window should appears (no advansed
settings mode).

5) To see precise values of X and Y
under mouse cursor it's necessary
to check "Link coordinates to mouse cursor".

6) To change text and properties of
legend/axes/chart title:
hover mouse in selected area and wait
while edit button appears. Press on it,
editor with current text and options
should appears.

7) To edit chart in details:
do double click on chart area (in advansed
mode full chart editor should appears).

---

The folders
"help", "opt", "pic",
"plugins", "dependence_dlls",
"crush_reports"
have to be in main programm
directory for proper operation.
Also near .exe file may lie
internationalization files.

*** FOOTNOTE ****

• • the plugin interface described in
    "I_GrabInterface.h". Additionally
    description comes below.

No visual interaction:
plagin's dll loaded dynamicly
on program's start and unloaded
when exiting. From beginning program calls

HRESULT CALL SetWorkerH(unsigned int ThreadH)

from plagin, passing in the argument
handle of it's worker thread.
When plugin "connected" to
data source, he call
ResumeThread((HANDLE)ThreadH)
from itself.
This causes to invoke thread ThreadH
in program. Thread periodically (or once)
call plugin function

HRESULT CALL GetDeltaData(BSTR data,
int ms, BOOL ones),

that returns through its arguments
"increment" of data (data), time (ms),
spent on internal work for obtaining "increment"
of data and flag (ones) that indicates type
of work (single treatment or continuous work
with data). In case of continuous work with data
thread ThreadH, based on time *ms (and not only),
forms period of requests to plugin.

---

Visual interaction:
plugin calls by function

HRESULT CALL ShowPluginWnd(int MWTop,
int MWLeft, int MWHeight, int MWWidth),

where MWxxx - corresponding characteristic
of parent (i.e this program) window.
Stop working ThreadH on current task carried
by menu item "Stop plotting" (or button in top)
or occurs automatically if plugin is running
in single treatment mode (flag BOOL(*ones) set).