Function VisEffectCreate

Descent3/viseffect.cpp:567–627

initialize a new viseffect. adds to the list for the given room returns the vis number

// initialize a new viseffect.  adds to the list for the given room
// returns the vis number
int VisEffectCreate(uint8_t type, uint8_t id, int roomnum, vector *pos) {
  int visnum;
  vis_effect *vis;

  if ((Game_mode & GM_MULTI) && Dedicated_server)
    return -1; // Dedicated servers don't need to create vis effects

  if (ROOMNUM_OUTSIDE(roomnum)) {
    if (CELLNUM(roomnum) > TERRAIN_WIDTH * TERRAIN_DEPTH)
      return -1;
    if (CELLNUM(roomnum) < 0)
      return -1;

    if (Gametime - Last_terrain_render_time > 5.0)
      return -1;
  } else {
    ASSERT(roomnum >= 0 && roomnum <= Highest_room_index && Rooms[roomnum].used);

    // Don't create viseffects in rooms we haven't seen in a while
    if (Gametime - Rooms[roomnum].last_render_time > 5.0)
      return -1;
  }

  // Find next free object
  visnum = VisEffectAllocate();

  if (visnum == -1) // no free objects
    return -1;

  ASSERT(VisEffects[visnum].type == VIS_NONE); // make sure unused

  vis = &VisEffects[visnum];

  ASSERT(vis->roomnum == -1);

  memset(vis, 0, sizeof(vis_effect));

  // Fill in fields
  vis->type = VIS_FIREBALL;
  vis->id = id;
  vis->pos = *pos;
  vis->flags = 0;
  vis->phys_flags = 0;
  vis->roomnum = roomnum;
  vis->movement_type = MT_NONE;
  vis->attach_info.end_vertnum = -1;
  vis->next = -1;
  vis->prev = -1;
  vis->lighting_color = 0;

  ASSERT(roomnum != -1);

  vis->creation_time = Gametime;

  // Initialize all the type-specific info
  VisEffectInitType(vis);

  VisEffectLink(visnum, roomnum);