PathEngine home previous: Interfacesnext: iPathEngine::buildMeshFederation_FromWorldMesh()
Contents, API Reference, Interfaces, iPathEngine

Interface iPathEngine

Description

The root interface to PathEngine. All functionality (apart from testbed functionality) is obtained through this interface, or through objects obtained from this interface.

Defined in SDKRoot/include/i_pathengine.h.

Construction and Deletion

A pointer to the iPathEngine interface is obtained by calling the entrypoint to the PathEngine dll, DLLExport_GetIPathEngine, in the case of dll linkage, or PathEngine_InitialiseAndObtainRootInterface, in the case of static or Linux shared object linkage, or is passed into a test application, in the case of an application running under the testbed.
Refer to Linking with the SDK for more details.
There is only one instance of the object that provides this interface. This object cannot be deleted so operator delete for iPathEngine has been made private.

Methods:

buildMeshFederation_FromWorldMesh

Returns a newly created Interface iMeshFederation object, and generates the corresponding set of federated iMeshes, from a single large 'world mesh'. with range determined by the range of worldMesh, and with the specified tile size, and overlap.

Federation tiles will be generated during this process and passed in to tileGeneratedCallBack.
These are numbered according to a 'tile index' within the federation, (which is passed into the callback). Note, however, that it is possible for there to be tiles within a federation with no ground geometry, and meshes will not be generated for any such tiles.

buildMeshFederation_TilingOnly

Returns a newly created Interface iMeshFederation object, to encapsulate a mesh federation tiling, but without actually generating any federated iMesh instances.

buildMeshFromContent

Constructs an iMesh object by processesing geometry specified in 'face/vertex' form.

buildMeshFromGroundTiles

Constructs a single iMesh object by connecting multiple tiled ground pieces together at tile borders.

buildRegularSourceTiling

Returns a newly created Interface iSourceTiling object that can be used to perform 'tile-by-tile' content processing.

collisionPreprocessVersionIsCompatible

Used to check if persistent data saved out for collision preprocess from an older version of the library can be loaded into this version.

deleteAllObjects

Deletes all objects that have been created by PathEngine.

getErrorHandler

Retrieves the error callback currently used by PathEngine.

getInterfaceMajorVersion

Returns the major version number for the code supporting this interface.

getInterfaceMinorVersion

Returns the minor version number for the code supporting this interface.

getReleaseNumbers

Returns release numbers for the code supporting this interface.

getVersionAttributes

Obtains a set of attributes for the object that provides this interface.

largeStaticObstacleShapeIsValid

Checks whether coordinates are valid for iMesh::placeLargeStaticObstacle().

loadContentChunk

Constructs an iContentChunk object from a data buffer previously saved out by iContentChunk::save().

loadFederation

Constructs an iMeshFederation object from a data buffer previously saved out by iMeshFederation::save().

loadMeshFromBuffer

Constructs an iMesh object from a data buffer containing a 3d ground mesh.

loadSourceTiling

Constructs an iSourceTiling object from a data buffer previously saved out by iSourceTiling::save().

maximumMemoryAllocated

Returns the peak amount of memory allocated by PathEngine, if memory tracking is enabled.

newContentChunk

Constructs a content chunk object which can then be saved out and later loaded for instantiation in a separate content tool.

newShape

Creates a new iShape object.

pathfindPreprocessVersionIsCompatible

Used to check if persistent data saved out for pathfinding preprocess from an older version of the library can be loaded into this version.

resetMaximumMemoryAllocated

Resets PathEngine internal counter for peak memory allocated, if memory tracking is enabled.

save2DContentSnapshot

Provided for generating snapshots of the source content when reporting bugs in the content processing functionality.

saveContentData

(Depreciated)
Provided for generating snapshots of the source content when reporting bugs in the content processing functionality.

setErrorHandler

Enables you to change the error callback used by PathEngine.

setPathPoolParameters

Controls PathEngine's path caching mechanism.

setRandomSeed

Seeds PathEngine's internal pseudo-random sequence.

shapeIsValid

Checks whether coordinates are valid for newShape().

totalMemoryAllocated

Returns the amount of memory allocated by PathEngine, if memory tracking is enabled.


Documentation for PathEngine release 5.17 - Copyright © 2002-2008 PathEnginenext: iPathEngine::buildMeshFederation_FromWorldMesh()