Download ADK User`s Manual (Includes Tecplot GUI Builder)

9.2. Data Set Loaders
An instruction string sent to your data set loader engine could look like:
'"-banana""-apple""-sourcefile myfile.dat"'
After decoding the instructions, your loader should do the following:
1.
(Optional) Call TecUtilDialogLaunchPercentDone to show a percent done dialog
on the screen.
2.
Call TecUtilDataSetCreate to create a new data set.
3.
Call TecUtilDataSetAddZone for each zone created.
4.
(Optional) Call TecUtilDialogCheckPercentDone every once in a while to update
the percent done dialog.
5.
Call TecUtilDataValueGetRef to obtain handles to the field data and then:
Call TecUtilDataValueSetByRef to stuff the values (faster)
or
Call TecUtilDataValueSetByZoneVar (slower).
6.
(Optional) Call TecUtilDialogDropPercentDone.
7.
Call TecUtilFrameSetMode to set the frame mode.
8.
Call TecUtilRedraw to show the first image.
See the sample loader mentioned in Section 9.2.7, “Data Set Loader Example.”
9.2.3. Appending Data with a Data Loader
A data loader can provide the capability to append data. Data loaders can also append data to
an existing dataset. If your loader wishes to do this you must do the following:
1.
Prior to appending it is a good idea to query the existing dataset in Tecplot to make
sure it is compatible with the data you wish to append.
2.
Prior to calling any TecUtil functions that modify data you must suspend dataset
marking in tecplot by calling: TecUtilDataSetSuspendMarking(TRUE);
3.
Do not call TecUtilDataSetCreate(). Just call TecUtilDataSetAddVar and/or
TecUtilDataSetAddZone.
4.
After appending data call TecUtilStateChanged (or TecUtilStateChangedX) with
StateChanged_ZonesAdded and/or StateChanged_VarsAltered - depending on what
you did.
67