rna_boid.cc

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2009 by Janne Karhu. All rights reserved.
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
 
#include <cfloat>
#include <climits>
#include <cstdlib>
 
#include "DNA_boid_types.h"
#include "DNA_object_types.h"
#include "DNA_particle_types.h"
#include "DNA_scene_types.h"
 
#include "BLI_utildefines.h"
 
#include "RNA_define.hh"
#include "RNA_enum_types.hh"
 
#include "rna_internal.hh"
 
#include "WM_api.hh"
#include "WM_types.hh"
 
const EnumPropertyItem rna_enum_boidrule_type_items[] = {
    {eBoidRuleType_Goal,
     "GOAL",
     0,
     "Goal",
     "Go to assigned object or loudest assigned signal source"},
    {eBoidRuleType_Avoid,
     "AVOID",
     0,
     "Avoid",
     "Get away from assigned object or loudest assigned signal source"},
    {eBoidRuleType_AvoidCollision,
     "AVOID_COLLISION",
     0,
     "Avoid Collision",
     "Maneuver to avoid collisions with other boids and deflector objects in "
     "near future"},
    {eBoidRuleType_Separate, "SEPARATE", 0, "Separate", "Keep from going through other boids"},
    {eBoidRuleType_Flock,
     "FLOCK",
     0,
     "Flock",
     "Move to center of neighbors and match their velocity"},
    {eBoidRuleType_FollowLeader,
     "FOLLOW_LEADER",
     0,
     "Follow Leader",
     "Follow a boid or assigned object"},
    {eBoidRuleType_AverageSpeed,
     "AVERAGE_SPEED",
     0,
     "Average Speed",
     "Maintain speed, flight level or wander"},
    {eBoidRuleType_Fight, "FIGHT", 0, "Fight", "Go to closest enemy and attack when in range"},
#if 0
    {eBoidRuleType_Protect,
     "PROTECT",
     0,
     "Protect",
     "Go to enemy closest to target and attack when in range"},
    {eBoidRuleType_Hide,
     "HIDE",
     0,
     "Hide",
     "Find a deflector move to its other side from closest enemy"},
    {eBoidRuleType_FollowPath,
     "FOLLOW_PATH",
     0,
     "Follow Path",
     "Move along a assigned curve or closest curve in a group"},
    {eBoidRuleType_FollowWall,
     "FOLLOW_WALL",
     0,
     "Follow Wall",
     "Move next to a deflector object's in direction of its tangent"},
#endif
    {0, nullptr, 0, nullptr, nullptr},
};
 
#ifndef RNA_RUNTIME
static const EnumPropertyItem boidruleset_type_items[] = {
    {eBoidRulesetType_Fuzzy,
     "FUZZY",
     0,
     "Fuzzy",
     "Rules are gone through top to bottom (only the first rule which effect is above "
     "fuzziness threshold is evaluated)"},
    {eBoidRulesetType_Random, "RANDOM", 0, "Random", "A random rule is selected for each boid"},
    {eBoidRulesetType_Average, "AVERAGE", 0, "Average", "All rules are averaged"},
    {0, nullptr, 0, nullptr, nullptr},
};
#endif
 
#ifdef RNA_RUNTIME
 
#  include <fmt/format.h>
 
#  include "BLI_math_base.h"
 
#  include "BKE_context.hh"
#  include "BKE_particle.h"
 
#  include "DEG_depsgraph.hh"
#  include "DEG_depsgraph_build.hh"
 
static void rna_Boids_reset(Main * /*bmain*/, Scene * /*scene*/, PointerRNA *ptr)
{
  if (ptr->type == &RNA_ParticleSystem) {
    ParticleSystem *psys = (ParticleSystem *)ptr->data;
 
    psys->recalc = ID_RECALC_PSYS_RESET;
 
    DEG_id_tag_update(ptr->owner_id, ID_RECALC_GEOMETRY);
  }
  else {
    DEG_id_tag_update(ptr->owner_id, ID_RECALC_GEOMETRY | ID_RECALC_PSYS_RESET);
  }
 
  WM_main_add_notifier(NC_OBJECT | ND_PARTICLE | NA_EDITED, nullptr);
}
static void rna_Boids_reset_deps(Main *bmain, Scene * /*scene*/, PointerRNA *ptr)
{
  if (ptr->type == &RNA_ParticleSystem) {
    ParticleSystem *psys = (ParticleSystem *)ptr->data;
 
    psys->recalc = ID_RECALC_PSYS_RESET;
 
    DEG_id_tag_update(ptr->owner_id, ID_RECALC_GEOMETRY);
  }
  else {
    DEG_id_tag_update(ptr->owner_id, ID_RECALC_GEOMETRY | ID_RECALC_PSYS_RESET);
  }
 
  DEG_relations_tag_update(bmain);
 
  WM_main_add_notifier(NC_OBJECT | ND_PARTICLE | NA_EDITED, nullptr);
}
 
static StructRNA *rna_BoidRule_refine(PointerRNA *ptr)
{
  BoidRule *rule = (BoidRule *)ptr->data;
 
  switch (rule->type) {
    case eBoidRuleType_Goal:
      return &RNA_BoidRuleGoal;
    case eBoidRuleType_Avoid:
      return &RNA_BoidRuleAvoid;
    case eBoidRuleType_AvoidCollision:
      return &RNA_BoidRuleAvoidCollision;
    case eBoidRuleType_FollowLeader:
      return &RNA_BoidRuleFollowLeader;
    case eBoidRuleType_AverageSpeed:
      return &RNA_BoidRuleAverageSpeed;
    case eBoidRuleType_Fight:
      return &RNA_BoidRuleFight;
    default:
      return &RNA_BoidRule;
  }
}
 
static std::optional<std::string> rna_BoidRule_path(const PointerRNA *ptr)
{
  const BoidRule *rule = (BoidRule *)ptr->data;
  char name_esc[sizeof(rule->name) * 2];
  BLI_str_escape(name_esc, rule->name, sizeof(name_esc));
  return fmt::format("rules[\"{}\"]", name_esc); /* XXX not unique */
}
 
static PointerRNA rna_BoidState_active_boid_rule_get(PointerRNA *ptr)
{
  BoidState *state = (BoidState *)ptr->data;
  BoidRule *rule = (BoidRule *)state->rules.first;
 
  for (; rule; rule = rule->next) {
    if (rule->flag & BOIDRULE_CURRENT) {
      return rna_pointer_inherit_refine(ptr, &RNA_BoidRule, rule);
    }
  }
  return rna_pointer_inherit_refine(ptr, &RNA_BoidRule, nullptr);
}
static void rna_BoidState_active_boid_rule_index_range(
    PointerRNA *ptr, int *min, int *max, int * /*softmin*/, int * /*softmax*/)
{
  BoidState *state = (BoidState *)ptr->data;
  *min = 0;
  *max = max_ii(0, BLI_listbase_count(&state->rules) - 1);
}
 
static int rna_BoidState_active_boid_rule_index_get(PointerRNA *ptr)
{
  BoidState *state = (BoidState *)ptr->data;
  BoidRule *rule = (BoidRule *)state->rules.first;
  int i = 0;
 
  for (; rule; rule = rule->next, i++) {
    if (rule->flag & BOIDRULE_CURRENT) {
      return i;
    }
  }
  return 0;
}
 
static void rna_BoidState_active_boid_rule_index_set(PointerRNA *ptr, int value)
{
  BoidState *state = (BoidState *)ptr->data;
  BoidRule *rule = (BoidRule *)state->rules.first;
  int i = 0;
 
  for (; rule; rule = rule->next, i++) {
    if (i == value) {
      rule->flag |= BOIDRULE_CURRENT;
    }
    else {
      rule->flag &= ~BOIDRULE_CURRENT;
    }
  }
}
 
static int particle_id_check(const PointerRNA *ptr)
{
  const ID *id = ptr->owner_id;
 
  return (GS(id->name) == ID_PA);
}
 
static std::optional<std::string> rna_BoidSettings_path(const PointerRNA *ptr)
{
  const BoidSettings *boids = (BoidSettings *)ptr->data;
 
  if (particle_id_check(ptr)) {
    ParticleSettings *part = (ParticleSettings *)ptr->owner_id;
 
    if (part->boids == boids) {
      return "boids";
    }
  }
  return std::nullopt;
}
 
static PointerRNA rna_BoidSettings_active_boid_state_get(PointerRNA *ptr)
{
  BoidSettings *boids = (BoidSettings *)ptr->data;
  BoidState *state = (BoidState *)boids->states.first;
 
  for (; state; state = state->next) {
    if (state->flag & BOIDSTATE_CURRENT) {
      return rna_pointer_inherit_refine(ptr, &RNA_BoidState, state);
    }
  }
  return rna_pointer_inherit_refine(ptr, &RNA_BoidState, nullptr);
}
static void rna_BoidSettings_active_boid_state_index_range(
    PointerRNA *ptr, int *min, int *max, int * /*softmin*/, int * /*softmax*/)
{
  BoidSettings *boids = (BoidSettings *)ptr->data;
  *min = 0;
  *max = max_ii(0, BLI_listbase_count(&boids->states) - 1);
}
 
static int rna_BoidSettings_active_boid_state_index_get(PointerRNA *ptr)
{
  BoidSettings *boids = (BoidSettings *)ptr->data;
  BoidState *state = (BoidState *)boids->states.first;
  int i = 0;
 
  for (; state; state = state->next, i++) {
    if (state->flag & BOIDSTATE_CURRENT) {
      return i;
    }
  }
  return 0;
}
 
static void rna_BoidSettings_active_boid_state_index_set(PointerRNA *ptr, int value)
{
  BoidSettings *boids = (BoidSettings *)ptr->data;
  BoidState *state = (BoidState *)boids->states.first;
  int i = 0;
 
  for (; state; state = state->next, i++) {
    if (i == value) {
      state->flag |= BOIDSTATE_CURRENT;
    }
    else {
      state->flag &= ~BOIDSTATE_CURRENT;
    }
  }
}
 
#else
 
static void rna_def_boidrule_goal(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleGoal", "BoidRule");
  RNA_def_struct_ui_text(srna, "Goal", "");
  RNA_def_struct_sdna(srna, "BoidRuleGoalAvoid");
 
  prop = RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
  RNA_def_property_pointer_sdna(prop, nullptr, "ob");
  RNA_def_property_flag(prop, PROP_EDITABLE);
  RNA_def_property_ui_text(prop, "Object", "Goal object");
  RNA_def_property_update(prop, 0, "rna_Boids_reset_deps");
 
  prop = RNA_def_property(srna, "use_predict", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BRULE_GOAL_AVOID_PREDICT);
  RNA_def_property_ui_text(prop, "Predict", "Predict target movement");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule_avoid(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleAvoid", "BoidRule");
  RNA_def_struct_ui_text(srna, "Avoid", "");
  RNA_def_struct_sdna(srna, "BoidRuleGoalAvoid");
 
  prop = RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
  RNA_def_property_pointer_sdna(prop, nullptr, "ob");
  RNA_def_property_flag(prop, PROP_EDITABLE);
  RNA_def_property_ui_text(prop, "Object", "Object to avoid");
  RNA_def_property_update(prop, 0, "rna_Boids_reset_deps");
 
  prop = RNA_def_property(srna, "use_predict", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BRULE_GOAL_AVOID_PREDICT);
  RNA_def_property_ui_text(prop, "Predict", "Predict target movement");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "fear_factor", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(
      prop, "Fear Factor", "Avoid object if danger from it is above this threshold");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule_avoid_collision(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleAvoidCollision", "BoidRule");
  RNA_def_struct_ui_text(srna, "Avoid Collision", "");
 
  prop = RNA_def_property(srna, "use_avoid", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BRULE_ACOLL_WITH_BOIDS);
  RNA_def_property_ui_text(prop, "Boids", "Avoid collision with other boids");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "use_avoid_collision", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BRULE_ACOLL_WITH_DEFLECTORS);
  RNA_def_property_ui_text(prop, "Deflectors", "Avoid collision with deflector objects");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "look_ahead", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(prop, "Look Ahead", "Time to look ahead in seconds");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule_follow_leader(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleFollowLeader", "BoidRule");
  RNA_def_struct_ui_text(srna, "Follow Leader", "");
 
  prop = RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
  RNA_def_property_pointer_sdna(prop, nullptr, "ob");
  RNA_def_property_flag(prop, PROP_EDITABLE);
  RNA_def_property_ui_text(prop, "Object", "Follow this object instead of a boid");
  RNA_def_property_update(prop, 0, "rna_Boids_reset_deps");
 
  prop = RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(prop, "Distance", "Distance behind leader to follow");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "queue_count", PROP_INT, PROP_NONE);
  RNA_def_property_int_sdna(prop, nullptr, "queue_size");
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(prop, "Queue Size", "How many boids in a line");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "use_line", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BRULE_LEADER_IN_LINE);
  RNA_def_property_ui_text(prop, "Line", "Follow leader in a line");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule_average_speed(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleAverageSpeed", "BoidRule");
  RNA_def_struct_ui_text(srna, "Average Speed", "");
 
  prop = RNA_def_property(srna, "wander", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 1.0f);
  RNA_def_property_ui_text(prop, "Wander", "How fast velocity's direction is randomized");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "level", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 1.0f);
  RNA_def_property_ui_text(prop, "Level", "How much velocity's z-component is kept constant");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "speed", PROP_FLOAT, PROP_FACTOR);
  RNA_def_property_range(prop, 0.0f, 1.0f);
  RNA_def_property_ui_text(prop, "Speed", "Percentage of maximum speed");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule_fight(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidRuleFight", "BoidRule");
  RNA_def_struct_ui_text(srna, "Fight", "");
 
  prop = RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(prop, "Fight Distance", "Attack boids at max this distance");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "flee_distance", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0f, 100.0f);
  RNA_def_property_ui_text(prop, "Flee Distance", "Flee to this distance");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
static void rna_def_boidrule(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  /* data */
  srna = RNA_def_struct(brna, "BoidRule", nullptr);
  RNA_def_struct_ui_text(srna, "Boid Rule", "");
  RNA_def_struct_refine_func(srna, "rna_BoidRule_refine");
  RNA_def_struct_path_func(srna, "rna_BoidRule_path");
 
  /* strings */
  prop = RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
  RNA_def_property_ui_text(prop, "Name", "Boid rule name");
  RNA_def_struct_name_property(srna, prop);
 
  /* enums */
  prop = RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
  RNA_def_property_clear_flag(prop, PROP_EDITABLE);
  RNA_def_property_enum_sdna(prop, nullptr, "type");
  RNA_def_property_enum_items(prop, rna_enum_boidrule_type_items);
  RNA_def_property_ui_text(prop, "Type", "");
 
  /* flags */
  prop = RNA_def_property(srna, "use_in_air", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "flag", BOIDRULE_IN_AIR);
  RNA_def_property_ui_text(prop, "In Air", "Use rule when boid is flying");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "use_on_land", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "flag", BOIDRULE_ON_LAND);
  RNA_def_property_ui_text(prop, "On Land", "Use rule when boid is on land");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
#  if 0
  prop = RNA_def_property(srna, "show_expanded", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_flag(prop, PROP_NO_DEG_UPDATE);
  RNA_def_property_boolean_sdna(prop, nullptr, "mode", eModifierMode_Expanded);
  RNA_def_property_ui_text(prop, "Expanded", "Set modifier expanded in the user interface");
#  endif
 
  /* types */
  rna_def_boidrule_goal(brna);
  rna_def_boidrule_avoid(brna);
  rna_def_boidrule_avoid_collision(brna);
  rna_def_boidrule_follow_leader(brna);
  rna_def_boidrule_average_speed(brna);
  rna_def_boidrule_fight(brna);
}
 
static void rna_def_boidstate(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidState", nullptr);
  RNA_def_struct_ui_text(srna, "Boid State", "Boid state for boid physics");
 
  prop = RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
  RNA_def_property_ui_text(prop, "Name", "Boid state name");
  RNA_def_struct_name_property(srna, prop);
 
  prop = RNA_def_property(srna, "ruleset_type", PROP_ENUM, PROP_NONE);
  RNA_def_property_enum_items(prop, boidruleset_type_items);
  RNA_def_property_ui_text(prop, "Rule Evaluation", "How the rules in the list are evaluated");
 
  prop = RNA_def_property(srna, "rules", PROP_COLLECTION, PROP_NONE);
  RNA_def_property_struct_type(prop, "BoidRule");
  RNA_def_property_ui_text(prop, "Boid Rules", "");
 
  prop = RNA_def_property(srna, "active_boid_rule", PROP_POINTER, PROP_NONE);
  RNA_def_property_struct_type(prop, "BoidRule");
  RNA_def_property_pointer_funcs(
      prop, "rna_BoidState_active_boid_rule_get", nullptr, nullptr, nullptr);
  RNA_def_property_ui_text(prop, "Active Boid Rule", "");
 
  prop = RNA_def_property(srna, "active_boid_rule_index", PROP_INT, PROP_UNSIGNED);
  RNA_def_property_int_funcs(prop,
                             "rna_BoidState_active_boid_rule_index_get",
                             "rna_BoidState_active_boid_rule_index_set",
                             "rna_BoidState_active_boid_rule_index_range");
  RNA_def_property_ui_text(prop, "Active Boid Rule Index", "");
 
  prop = RNA_def_property(srna, "rule_fuzzy", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "rule_fuzziness");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(prop, "Rule Fuzziness", "");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "volume", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Volume", "");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "falloff", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 10.0);
  RNA_def_property_ui_text(prop, "Falloff", "");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
static void rna_def_boid_settings(BlenderRNA *brna)
{
  StructRNA *srna;
  PropertyRNA *prop;
 
  srna = RNA_def_struct(brna, "BoidSettings", nullptr);
  RNA_def_struct_path_func(srna, "rna_BoidSettings_path");
  RNA_def_struct_ui_text(srna, "Boid Settings", "Settings for boid physics");
 
  prop = RNA_def_property(srna, "land_smooth", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "landing_smoothness");
  RNA_def_property_range(prop, 0.0, 10.0);
  RNA_def_property_ui_text(prop, "Landing Smoothness", "How smoothly the boids land");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "bank", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "banking");
  RNA_def_property_range(prop, 0.0, 2.0);
  RNA_def_property_ui_text(prop, "Banking", "Amount of rotation around velocity vector on turns");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "pitch", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "pitch");
  RNA_def_property_range(prop, 0.0, 2.0);
  RNA_def_property_ui_text(prop, "Pitch", "Amount of rotation around side vector");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "height", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 2.0);
  RNA_def_property_ui_text(prop, "Height", "Boid height relative to particle size");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  /* states */
  prop = RNA_def_property(srna, "states", PROP_COLLECTION, PROP_NONE);
  RNA_def_property_struct_type(prop, "BoidState");
  RNA_def_property_ui_text(prop, "Boid States", "");
 
  prop = RNA_def_property(srna, "active_boid_state", PROP_POINTER, PROP_NONE);
  RNA_def_property_struct_type(prop, "BoidRule");
  RNA_def_property_pointer_funcs(
      prop, "rna_BoidSettings_active_boid_state_get", nullptr, nullptr, nullptr);
  RNA_def_property_ui_text(prop, "Active Boid Rule", "");
 
  prop = RNA_def_property(srna, "active_boid_state_index", PROP_INT, PROP_UNSIGNED);
  RNA_def_property_int_funcs(prop,
                             "rna_BoidSettings_active_boid_state_index_get",
                             "rna_BoidSettings_active_boid_state_index_set",
                             "rna_BoidSettings_active_boid_state_index_range");
  RNA_def_property_ui_text(prop, "Active Boid State Index", "");
 
  /* character properties */
  prop = RNA_def_property(srna, "health", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Health", "Initial boid health when born");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "strength", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Strength", "Maximum caused damage on attack per second");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "aggression", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Aggression", "Boid will fight this times stronger enemy");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "accuracy", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(prop, "Accuracy", "Accuracy of attack");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "range", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Range", "Maximum distance from which a boid can attack");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  /* physical properties */
  prop = RNA_def_property(srna, "air_speed_min", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "air_min_speed");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(
      prop, "Min Air Speed", "Minimum speed in air (relative to maximum speed)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "air_speed_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "air_max_speed");
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Max Air Speed", "Maximum speed in air");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "air_acc_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "air_max_acc");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(
      prop, "Max Air Acceleration", "Maximum acceleration in air (relative to maximum speed)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "air_ave_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "air_max_ave");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(prop,
                           "Max Air Angular Velocity",
                           "Maximum angular velocity in air (relative to 180 degrees)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "air_personal_space", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 10.0);
  RNA_def_property_ui_text(
      prop, "Air Personal Space", "Radius of boids personal space in air (% of particle size)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_jump_speed", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Jump Speed", "Maximum speed for jumping");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_speed_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "land_max_speed");
  RNA_def_property_range(prop, 0.0, 100.0);
  RNA_def_property_ui_text(prop, "Max Land Speed", "Maximum speed on land");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_acc_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "land_max_acc");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(
      prop, "Max Land Acceleration", "Maximum acceleration on land (relative to maximum speed)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_ave_max", PROP_FLOAT, PROP_NONE);
  RNA_def_property_float_sdna(prop, nullptr, "land_max_ave");
  RNA_def_property_range(prop, 0.0, 1.0);
  RNA_def_property_ui_text(prop,
                           "Max Land Angular Velocity",
                           "Maximum angular velocity on land (relative to 180 degrees)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_personal_space", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 10.0);
  RNA_def_property_ui_text(
      prop, "Land Personal Space", "Radius of boids personal space on land (% of particle size)");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "land_stick_force", PROP_FLOAT, PROP_NONE);
  RNA_def_property_range(prop, 0.0, 1000.0);
  RNA_def_property_ui_text(
      prop, "Land Stick Force", "How strong a force must be to start effecting a boid on land");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  /* options */
  prop = RNA_def_property(srna, "use_flight", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BOID_ALLOW_FLIGHT);
  RNA_def_property_ui_text(prop, "Allow Flight", "Allow boids to move in air");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "use_land", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BOID_ALLOW_LAND);
  RNA_def_property_ui_text(prop, "Allow Land", "Allow boids to move on land");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
 
  prop = RNA_def_property(srna, "use_climb", PROP_BOOLEAN, PROP_NONE);
  RNA_def_property_boolean_sdna(prop, nullptr, "options", BOID_ALLOW_CLIMB);
  RNA_def_property_ui_text(prop, "Allow Climbing", "Allow boids to climb goal objects");
  RNA_def_property_update(prop, 0, "rna_Boids_reset");
}
 
void RNA_def_boid(BlenderRNA *brna)
{
  rna_def_boidrule(brna);
  rna_def_boidstate(brna);
  rna_def_boid_settings(brna);
}
 
#endif