Function AttachObject

Descent3/attach.cpp:473–520

Attaches 2 objects via attach points on each. The f_used_aligned allows for an aligned connection. NOTE: The child always moves to the parent

// Attaches 2 objects via attach points on each.  The f_used_aligned allows for an aligned connection.
// NOTE: The child always moves to the parent
bool AttachObject(object *parent, char parent_ap, object *child, char child_ap, bool f_use_aligned) {
  ASSERT(parent);
  ASSERT(child);

  poly_model *parent_pm = &Poly_models[parent->rtype.pobj_info.model_num];
  poly_model *child_pm = &Poly_models[child->rtype.pobj_info.model_num];

  if (parent_ap < 0 || parent_ap >= parent_pm->n_attach) {
    mprintf(0, "ATTACH: Parent AP invalid\n");
    return false;
  }

  if (child->flags & OF_ATTACHED) {
    mprintf(0, "ATTACH: Child already attached to someone\n");
    return false;
  }

  if (child_ap >= 0 && child_ap < child_pm->n_attach) {
    if (AttachDoPosOrient(parent, parent_ap, child, child_ap, false)) {
      child->flags |= OF_ATTACHED;
      child->attach_type = AT_ALIGNED;
      child->attach_index = child_ap;
      child->attach_parent_handle = parent->handle;

      parent->attach_children[parent_ap] = child->handle;
      ComputeUltimateAttachParent(child);
      ProprogateUltimateAttachParent(child, child->attach_ultimate_handle);

      AttachPropagateMass(child);

      AttachUpdateSubObjects(child);
      if ((Game_mode & GM_MULTI) && (Netgame.local_role == LR_SERVER)) {
        MultiSendAttach(parent, parent_ap, child, child_ap, f_use_aligned);
      }
      if (Demo_flags == DF_RECORDING) {
        DemoWriteAttachObj(parent, parent_ap, child, child_ap, f_use_aligned);
      }

      return true;
    }

    mprintf(0, "ATTACH: AP attach failed\n");
    return false;
  }

  mprintf(0, "ATTACH: Child AP (%d) - child only has %d attach points\n", child_ap, child_pm->n_attach);
  return false;
}

// Attaches a child object to a parent object by a percent of the radius of the child.
// NOTE: The child always moves to the parent and not the reverse