AStar.Navigator

Description

Provides access to data and methods related to a model's A* navigator.

Properties

travelers References the set of travelers that are members of the A* network.

Methods

addDynamicBarrier Adds a dynamic barrier to the navigator's A* grid network.
getCell Gets the cell associated with a given model location.
getLocation Gets the model location associated with a given AStar.Cell.
removeDynamicBarrier Removes a dynamic barrier that was added with addDynamicBarrier().

Details

Do no remove, this fixes the anchor on doc.flexsim.com

AStar.Navigator.travelers

readonly travelers

Description

References the set of travelers that are members of the A* network.

This property is available so you can visit each of the navigator's travelers when something like a grid change happens.

Do no remove, this fixes the anchor on doc.flexsim.com

AStar.Navigator.addDynamicBarrier()

Variant addDynamicBarrier( Variant val , int skipOnChange = 0 )
treenode addDynamicBarrier( Vec3 location , Vec3 size , Vec3 rotation , int skipOnChange = 0 )

Parameters

val The value containing the barrier(s) to add. The value can either by a reference to an object, an array of references to objects, or a 3x3 array of numbers. If it is an object, it will add that object as a dynamic barrier. If it is an array of objects, it will add each object in the array as a barrier. If it is a 3x3 number array, it will construct 3 Vec3s from the array and forward to the Vec3-based overload.
location The location of a barrier you want to add.
size The size of a barrier you want to add.
rotation The rotation of a barrier you want to add.
skipOnChange Optional. If 1, the call to the navigator's OnGridChange event will be skipped.

Description

Adds a dynamic barrier to the navigator's A* grid network.

This method lets you dynamically change the A* path calculation mechanism during a simulation run. It is more flexible than the standard barrier condition rule in that you can add and remove barriers that have been dynamically created, or that are moving around during the simulation. You call this method to integrate the object's current location as a barrier into the navigation grid.

Calling this method will only affect the path calculation algorithm. It does not affect the paths of objects who are actively traveling on their path. If you want them to recalculate their path after adding the barrier, you should preempt them so they will restart their travel operation. You can query whether an active traveler's path has been blocked by a dynamic barrier by calling AStar.Traveler(object).travelPath.isBlocked().

The return value is a reference to a treenode that represents the added dynamic barrier. If you pass an array of object references into this method, then an array of treenodes will be returned. Once the barrier is destroyed or moves, you should call removeDynamicBarrier() to remove it, passing in the value that was returned by this method.

Do no remove, this fixes the anchor on doc.flexsim.com

AStar.Navigator.getCell()

AStar.Cell getCell( Vec3 modelLoc )

Parameters

modelLoc The target model location.

Description

Gets the cell associated with a given model location.

AStar.Cell cell = AStar.navigator.getCell(Vec3(10, 3, 0));
Do no remove, this fixes the anchor on doc.flexsim.com

AStar.Navigator.getLocation()

Vec3 getLocation( AStar.Cell cell )

Parameters

cell The target cell.

Description

Gets the model location associated with a given AStar.Cell.

Vec3 loc = AStar.navigator.getLocation(traveler.travelPath[1].cell);
Do no remove, this fixes the anchor on doc.flexsim.com

AStar.Navigator.removeDynamicBarrier()

removeDynamicBarrier( Variant barrier )

Parameters

barrier The value that was returned from a call to addDynamicBarrier().

Description

Removes a dynamic barrier that was added with addDynamicBarrier().