Function PlayerShipBreakup

Descent3/Player.cpp:3149–3188

breaks off a random piece.

//	breaks off a random piece.
void PlayerShipBreakup(object *obj, float magnitude) {
  int subobjnum, i, j, idx;
  unsigned test_flag;
  int n_models = Death[obj->id].dying_model ? Death[obj->id].dying_model->n_models : 0;
  int n_remaining_models;

  //	don't break off object 0.
  if (n_models == 1)
    return;

  //	count number of valid subobjects skip 1st subobject
  n_remaining_models = 0;
  test_flag = obj->rtype.pobj_info.subobj_flags;
  for (i = 1; i < n_models; i++) {
    if (test_flag & (1 << i))
      n_remaining_models++;
  }

  // this is an INDEX into the VALID subobjects in the polymodel. (skip 1st subobj)
  idx = (ps_rand() * n_remaining_models / D3_RAND_MAX) + 1;

  subobjnum = -1;
  for (i = 1, j = 1; i < n_models; i++) {
    if (test_flag & (1 << i)) { // valid subobject?
      if (idx == j) {           // correct subobject index?
        test_flag &= ~(1 << i);
        subobjnum = i;
        break;
      }
      j++;
    }
  }

  //	okay, if no suboject found, blowup.
  if (subobjnum == -1) {
    StartPlayerExplosion(obj->id);
  } else {
    PlayerShipSpewPart(obj, subobjnum, magnitude);
  }
}

//	spews a part of the player ship and all its child subobjects
void PlayerShipSpewPartSub(object *obj, bsp_info *submodel, float magnitude);