Function ObjCreate

Descent3/object.cpp:1682–1750

----------------------------------------------------------------------------- initialize a new object. adds to the list for the given room returns the object number

// initialize a new object.  adds to the list for the given room
// returns the object number
int ObjCreate(uint8_t type, uint16_t id, int roomnum, vector *pos, const matrix *orient, int parent_handle) {
  int objnum;
  object *obj;
  int handle;

  ASSERT(type != OBJ_NONE);

  if (ROOMNUM_OUTSIDE(roomnum)) {
    ASSERT(CELLNUM(roomnum) <= TERRAIN_WIDTH * TERRAIN_DEPTH);
    ASSERT(CELLNUM(roomnum) >= 0);

    roomnum = GetTerrainRoomFromPos(pos);

    if (roomnum == -1)
      return -1;
  }

  // Get next free object
  objnum = ObjAllocate();
  if (objnum == -1) // no free objects
    return -1;
  obj = &Objects[objnum];

  // Make sure the object is ok
  ASSERT(obj->type == OBJ_NONE); // make sure unused
  ASSERT(obj->roomnum == -1);    // make sure unlinked

  // Compute the new handle
  handle = obj->handle + HANDLE_COUNT_INCREMENT;

  // Check for handle wrap
  if ((handle & HANDLE_COUNT_MASK) == HANDLE_COUNT_MASK) // Going to wrap!
    Int3();                                              // Show this to Matt, or email him if he's not here

  // Initialize the object
  if (!ObjInit(obj, type, id, handle, pos, Gametime, parent_handle)) { // Couldn't init!
    obj->type = OBJ_NONE;                                              // mark as unused
    ObjFree(objnum);                                                   // de-allocate object
    return -1;
  }

#ifdef _DEBUG
  if (print_object_info) {
    mprintf(0, "Created object %d of type %d\n", objnum, obj->type);
  }
#endif

  // Set the object's orietation
  // THIS MUST BE DONE AFTER ObjInit (as ObjInit could load in a polymodel and set the anim and wall offsets)
  ObjSetOrient(obj, orient ? orient : &Identity_matrix);

  // Link object into room or terrain cell
  ObjLink(objnum, roomnum);

  // Type specific should have set up the size, so now we can compute the bounding box.
  ObjSetAABB(obj);

  // Let the demo system know about this object