buildAndSaveGround

previous: iContentProcessing3D::addExternalRef()

next: iContentProcessing3D::buildGround()

Contents, API Reference, Interfaces, iContentProcessing3D, buildAndSaveGround

iContentProcessing3D::buildAndSaveGround()

Description

Runs the 3D content processing functionality on a specified set of 3D source data and saves out the resulting ground mesh.

Syntax

void buildAndSaveGround(const iFaceVertexMesh* const * meshes_Buffer, uint32_t meshes_BufferEntries, const iSolidObjects* solidObjects, int32_t extrudeHeight, int32_t maxStepHeight, int32_t maxSlope, const char *const* options, iProgressCallBack* progressCallBack, const char* format, bool includeMapping, iOutputStream& outputStream) const;

Parameters

	meshes_Buffer, meshes_BufferEntries		An array of pointers to objects derived from iFaceVertexMesh and specifying the face vertex mesh part of 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.
	solidObjects		Pointer to an object derived from the iSolidObjects interface class, to encapsulate a set of convex solid objects in the form of a series of 'point clouds'. The 3D content processing will generate a convex hull for each of these point clouds, and treat the contained volume as an obstructed solid. Refer to Input Representation for more information about this solid objects representation. A null pointer may be passed into this argument, in the case where there are no solid objects in the source data.
	extrudeHeight		See 3D Content Processing Parameters.
	maxStepHeight		See 3D Content Processing Parameters.
	maxSlope		See 3D Content Processing Parameters.
	options		A set of named attributes to control additional options for how the geometry is processed, and which are also passed on to PathEngine's ground mesh creation. Refer to 3D Content Processing Options for information about options relating specifically to the 3D content process. Refer to Mesh Loading Options for information about options relating to ground mesh creation in general.
	progressCallBack		A pointer to an object derived from the iProgressCallBack interface, or zero. If a callback is specified then this will receive progress updates as the 3D content processing executes.
	format		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.
	includeMapping		Specifies whether the mapping to 2D should be saved out with the mesh. Storing this mapping with the mesh ensures that cPositions stored for this mesh will remain valid if the way PathEngine generates this mapping changes with a new release.
	outputStream		The mesh will be saved to this output stream.

Remarks

When using this method to generate a 'source tiling' for mesh federation construction, buildGround_IGround should be preferred (to avoid some unnecessary overhead in setting up full iMesh objects, when pathfinding is not actually required).

iContentProcessing3D::saveSnapshot() can be used to save a snapshot of the data and options being passed in to this method (which can then be used e.g. as a repeat case for any issues with the 3D process, or for import into a 3rd party content application for detailed visualisation).

If errors occur during the 3D content processing then these will be reported to the current error handler, and no ground mesh saved out.

If the ground result from the 3D processing operation would be empty (e.g. if no ground surfaces are present in the source data), then no ground mesh is saved out.

Refer to 3D Content Processing for a general explanation of the 3D content processing functionality.

C# Mapping

void buildAndSaveGround(FaceVertexMesh[] meshes, SolidObjects solidObjects, int extrudeHeight, int maxStepHeight, int maxSlope, string[] options, ProgressCallBack progressCallBack, string format, bool includeMapping, OutputStream outputStream);

Java Mapping

void buildAndSaveGround(FaceVertexMesh[] meshes, SolidObjects solidObjects, int extrudeHeight, int maxStepHeight, int maxSlope, String[] options, ProgressCallBack progressCallBack, String format, boolean includeMapping, OutputStream outputStream);