Contents, API Reference, Interfaces, iPathEngine, save2DContentSnapshot
Provided for generating snapshots of the source content when reporting bugs in the content processing functionality.
void save2DContentSnapshot(const iFaceVertexMesh* const * meshes_Buffer, uint32_t meshes_BufferEntries, const char *const* options, const char* format, iOutputStream& os);
(See Passing Arrays.)
An array of pointers to objects derived from
and specifying the geometry to be processed.
The objects pointed to will not be deleted by PathEngine
and pointers to these objects are not held after this method completes.
The same set of options as passed into iPathEngine::buildMeshFromContent().
(These will then be saved out as part of the snapshot,
and ensure that any issues with the content process can be repeated exactly.)
A C string specifying the format in which data should be output.
Currently this can be "xml" or "tok" (lower case).|
This format string is not retained after the call and can subsequently be safely deleted.
The content snapshot will be saved to this output stream.
In the case of crash bugs
a call to this method should be inserted directly before the call to
To avoid issues with truncated snapshots
it's important to make sure any buffers for the output stream are flushed to disk directly after the call
(and before any crash),
e.g. by putting a scope block around any stream objects and the call to this method, as follows:
pathEngine->saveContentData(&groundParts.front(), groundParts.size(), "tok", &fos);
iMesh* mesh = pathEngine->buildMeshFromContent(&groundParts.front(), groundParts.size(), 0);
void save2DContentSnapshot(FaceVertexMesh meshes, string options, string format, OutputStream os);
void save2DContentSnapshot(FaceVertexMesh meshes, String options, String format, OutputStream os);