UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
Usage Examples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins
Migration
Migrating to UNIGINE 2.0
C++ API Migration
Migrating from UNIGINE 2.0 to UNIGINE 2.1

Obstacle Capsule

An obstacle capsule is a capsule-shaped obstacle that is detected and bypassed by other objects during pathfinding. The obstacle capsule can be added, for example, for the capsule-shaped nodes (trunks, columns, chimney shafts and so on) that are placed inside a navigation area and should be bypassed.

An obstacle capsule and a fur

The obstacle capsule is set by radius and height, where:

  • radius is the radius of the cylinder and hemispheres of the capsule.
  • height is the height of the cylinder of the capsule.

See also

  • A ObstacleCapsule class to edit capsule obstacles via UnigineScript
  • The PathRoute class to create 2D and 3D routes among obstacles
  • The article on Creating Routes
  • A set of articles on Navigation Areas
  • A set of samples located in the data/samples/paths folder:
    1. obstacle_00
    2. route_01
    3. route_02

Adding Obstacle Capsule

To add a capsule obstacle to the scene via UnigineEditor:

  1. Run UnigineEditor.
  2. On the Menu bar, click Create -> Path -> Obstacle Capsule.

  3. Click somewhere in the world to place the obstacle.

The new obstacle capsule will be added to UnigineEditor and you will be able to edit it via the Nodes panel. See also the example on obstacle usage.

Editing Obstacle Capsule

On the Obstacle tab of the Nodes panel, you can adjust the following parameters of the obstacle box:

Obstacle Obstacle mask. The obstacle mask of the obstacle capsule must match the obstacle mask of the route that is calculated during pathfinding. Otherwise, the obstacle will not be taken into account during pathfinding. Also by using the obstacle mask, you can specify obstacle spheres that should be ignored during pathfinding.
Radius Radius of the obstacle capsule in units.
Height Height of the obstacle capsule in units.
Last update: 2017-07-03