path_next(ENTITY*)

Sets the entity onto the next path in the level if the entity already has a path assigned. Otherwise the entity is set to the first path in the level.

Parameters:

ENTITY* - entity pointer.

Returns:

Number of nodes in the path, or 0 is no path was found.

Modifies:

ENTITY* - set onto the next existing path.

Speed:

Medium

Example:

result = path_next(me); // assign My-Entity to the next path

See also:

path_set, path_scan, path_nextnode, num_paths

► latest version online