PathEngine home previous: Colour Stringsnext: Key Strings
Contents, API Reference, Values and Strings, Face Attributes

Face Attributes

These values are defined in SDKRoot/include/i_pathengine.h.

Refer to Setting Face Attributes for information about adding face attributes to a ground mesh.

Name
Description
PE_FaceAttribute_SurfaceType

An application specific value that may be used to define the type of surface at a given point on the ground.
So, for example, the application could define values to correspond with wood, stone, grass, dirt, and so on.
This value is passed through during content processing and can later be queried with iMesh::getSurfaceType().
Defaults to 0.

This surface type attribute can be used to set up regions with traversal cost, as described in Representing Regions with Cost to Traverse.

PE_FaceAttribute_SectionID This attribute is used to split ground meshes into sections.
These section IDs can be used to setup callback functions for terrain areas.
Refer to Working with Terrain for more details about the terrain callback functionality.
-1 is used to indicate that the section ID is not defined for a face.
PE_FaceAttribute_UserData

This attribute can be used to store arbitrary application defined values relating to a piece of ground. Defaults to 0.
PE_FaceAttribute_MarksPortal (2D content processing only)
This attribute is used to define 'portals' for the automatic building connection functionality.
(Refer to Building Entrance Connections for details.)
Defaults to 0.
Faces that are being used as portal markers should have this attribute set to 1.
PE_FaceAttribute_MarksTerrainPortal (2D content processing only)
This attribute is used to define 'terrain portals' for the automatic building connection functionality.
(Refer to Building Entrance Connections for details.)
Defaults to 0.
Faces that are being used as terrain portal markers should have this attribute set to 1.
PE_FaceAttribute_MarksExternalShape (2D content processing only)
This attribute is used to define 'building external shapes' for the automatic building connection functionality.
(Refer to Building Entrance Connections for details.)
Defaults to 0.
Faces on building external shapes should have this attribute set to 1.
PE_FaceAttribute_MarksConnectingEdge (2D content processing only)
This attribute is used to define connecting edges for the automatic edge connection functionality.
(Refer to Matching Edge Connections for details.)
Defaults to 0.
Faces that are being used as connecting edge markers should have this attribute set to 1.
PE_FaceAttribute_CP3D_ExcludeFromGroundResult (3D content processing only)
Defaults to 0.
Geometry with this attribute set to 1 is included in 3D combination stage of the 3D process, but excluded from the ground result.
So this geometry can block movement by reducing headroom below agent height, but will never in itself be considered as walkable ground.
(A concrete example could be something like a building roof, if pathfinding agents are never intended to walk on the roof.)
Documentation for PathEngine release 5.29 - Copyright © 2002-2012 PathEnginenext: Key Strings