Method OkToPull

scripts/AIGame3.cpp:4734–4808

Checks to see if tractor beam pulling can commence/continue

// Checks to see if tractor beam pulling can commence/continue
bool Lifter::OkToPull(int me, bool initial_check /*=true*/) {
  matrix orient;
  vector vec_to_target;
  int target_handle;
  float fov_angle;

  // If it's the initial check, make sure we're in alert mode
  if (initial_check) {
    char type;
    AI_Value(me, VF_GET, AIV_C_ANIMATION_TYPE, &type);

    // Wait until the current anim type is alert, then return to normal
    if (type != AS_ALERT)
      return false;
  }

  // Make sure we still have a target
  AI_Value(me, VF_GET, AIV_I_TARGET_HANDLE, &target_handle);
  if (target_handle == OBJECT_HANDLE_NONE)
    return false;

  // Make sure it's a pullable target
  int type;
  Obj_Value(target_handle, VF_GET, OBJV_I_TYPE, &type);
  if (type != OBJ_PLAYER)
    return false;

  // If it's not the initial pull, make sure the target hasn't changed
  if (!initial_check && target_handle != memory->pull_target)
    return false;

  // Make sure the target isn't cloaked
  if (qObjectCloakTime(target_handle) != 0.0f)
    return false;

  // check distance to target
  float dist;
  AI_Value(me, VF_GET, AIV_F_DIST_TO_TARGET, &dist);
  if (dist > LIFTER_MAX_PULLING_DIST)
    return false;

  // Only check min distance if it's the initial decision check (whether to start pulling)
  if (initial_check && dist < LIFTER_MIN_PULLING_DIST)
    return false;

  // check FOV position of target (greater than 45 degrees is too much)
  Obj_Value(me, VF_GET, OBJV_M_ORIENT, &orient);

  // NOTE: do my own vec to target here! (chris' doesn't update quick enough)
  AI_Value(me, VF_GET, AIV_V_VEC_TO_TARGET, &vec_to_target);
  vm_VectorNormalize(&vec_to_target);
  fov_angle = orient.fvec * vec_to_target;
  if (fov_angle < 0.7f)
    return false;

  // see if anything is in the way
  ray_info ray;
  int flags, fate;