Enum Behavior

Source

pub enum Behavior<A> {
Show 13 variants
    Wait(Float),
    WaitForever,
    Action(A),
    Invert(Box<Behavior<A>>),
    AlwaysSucceed(Box<Behavior<A>>),
    Select(Vec<Behavior<A>>),
    If(Box<Behavior<A>>, Box<Behavior<A>>, Box<Behavior<A>>),
    Sequence(Vec<Behavior<A>>),
    While(Box<Behavior<A>>, Vec<Behavior<A>>),
    WhileAll(Box<Behavior<A>>, Vec<Behavior<A>>),
    WhenAll(Vec<Behavior<A>>),
    WhenAny(Vec<Behavior<A>>),
    After(Vec<Behavior<A>>),
}

Expand description

Describes a behavior.

This is used for more complex event logic. Can also be used for game AI.

Variants§

§

Wait(Float)

Waits an amount of time before continuing

Float: Time in seconds

§

WaitForever

Wait forever.

§

Action(A)

A high level description of an action.

An Action can either be “condition” which does not alter the system and returns either Success or Failure

e.g IsDoorOpen? IsNetworkDown?

Or it can be an “act” that can alter the system and returns either Success, Failure or Running

e.g OpenDoor, NetworkShutdown

§

Invert(Box<Behavior<A>>)

Converts Success into Failure and vice versa.

§

AlwaysSucceed(Box<Behavior<A>>)

Ignores failures and returns Success.

§

Select(Vec<Behavior<A>>)

Runs behaviors one by one until a behavior succeeds.

If a behavior fails it will try the next one. Fails if the last behavior fails. Can be thought of as a short-circuited logical OR gate.

§

If(Box<Behavior<A>>, Box<Behavior<A>>, Box<Behavior<A>>)

If(condition, success, failure)

§

Sequence(Vec<Behavior<A>>)

Runs behaviors one by one until all succeeded.

The sequence fails if a behavior fails. The sequence succeeds if all the behavior succeeds. Can be thought of as a short-circuited logical AND gate.

§

While(Box<Behavior<A>>, Vec<Behavior<A>>)

Loops while conditional behavior is running.

Succeeds if the conditional behavior succeeds. Fails if the conditional behavior fails, or if any behavior in the loop body fails.

§Panics

Panics if the given behavior sequence is empty.

§

WhileAll(Box<Behavior<A>>, Vec<Behavior<A>>)

Runs a sequence on repeat as long as a conditional behavior that precedes the sequence is running.

Conditional behavior is only checked before the sequence runs and not during the sequence.

Succeeds if the conditional behavior succeeds. Fails if the conditional behavior fails, or if any behavior in the sequence fails.

§Panics

Panics if the given behavior sequence is empty.


use bonsai_bt::{BT, Running, Failure, Success, Action, UpdateArgs, Behavior::WhileAll, ActionArgs};
use bonsai_bt::Event;

#[derive(Clone, Debug)]

enum Ex { A, B, C }

let rs = WhileAll(
   Box::new(Action(Ex::A)),
   vec![Action(Ex::B), Action(Ex::C)],
);

let (SUCCESS, FAILURE, RUNNING ) = ((Success, 0.0), (Failure, 0.0), (Running, 0.0));

let mut bt = BT::new(rs, ());

let mut i = 0;
let status = bt.tick(&Event::zero_dt_args(), &mut |args: ActionArgs<Event, Ex>, _| {
   match args.action {
       Ex::A => {
           i += 1;
           if i == 4 {
               SUCCESS
           }
           else {
               RUNNING
           }
       }
       Ex::B => {
           i += 1;
           SUCCESS
       }
       Ex::C => {
           i += 1;
           SUCCESS
       }
   }
});
assert!(i == 4);