13.2 PDPLog Functions

GetHeaders()
Tells all the processes that update this log to send their current headers to this log. Use this if you have changed the statistics being sent to this log. Note that it causes all existing data to be removed. The log will automatically adjust to the addition and removal of statistics, so this isn't necessary in those cases. However, it won't notice if a name of a statistic has changed.
SetSaveFile(char* file_nm)
Pulls up a file chooser dialog that allows one to select the file that the log will save data into, or sets the log file to the argument if called from the script language. This does not save any existing data in the file, it just opens the file so that any new data will be recorded. Use BufferToFile after setting the save file to actually save currently buffered data to the file. Note that this will overwrite any existing file of the same name.
SetAppendFile(char* file_nm)
This is just like SetSaveFile, but it appends to an existing file instead of writing over it.
LoadFile(char* file_nm)
This will load data from a previously-saved log file into this log. Note that it is possible to load from a log file created by any process, since it will read the header information from the log file itself. Thus, one can open a new project, create a GraphLog object, and do a Load file on a log from a project that was run in the background, and get a graph of what happened.
CloseFile()
Closes any open files. Note that LoadFile does not close the log file, because if the file is longer than the current buffer, it needs to be read from as the user scrolls through the file.
HeadToFile()
Sends the current header information to an open log file.
BufferToFile()
Sends the entire contents of the buffer to an open log file.