Function GraSegSave() Foundation
Save a graphic segment to disk
GraSegSave( [oPS], <cFileName>, <nSegId> ) --> <lSuccess> GraSegSave( [oPS], @<aSegBuf>, [<aSegIds>] ) --> <lSuccess>
The function returns the logical value .T. (true) if the segment is saved. Otherwise, .F. (false) is returned.
Function GraSegSave() saves graphic segments, so they can later be reloaded using GraSegLoad() function. GraSegSave() can be operated in two modes; in single segment-mode, the graphic segment specified in <nSegId> is saved to a file. In this mode, only one segment can be saved at a time. If used in array mode, any number of segments can be saved to memory with GraSegSave(). In this mode, a buffer with segment data is returned in parameter <aSegBuf> for each segment saved. In the array mode, the application has full control over the way in which graphic segments are stored. Segments may be kept in memory or saved to disk using the file API. See the function FOpen() for further information.
Saving and loading allows the reuse of existing segments without having to reexecute the graphical primitives which define the image. In a print preview application, for example, this mechanism can be used to save the segments which contain the pages already prepared, and to reload them later as need be.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.