Function EfxFreeEffect

Descent3/TelComEffects.cpp:250–395

Frees up any memory allocated for effect, sets type to EFX_NONE

// Frees up any memory allocated for effect, sets type to EFX_NONE
void EfxFreeEffect(tceffect *tce) {
  ASSERT(tce);

  // unlink it out of the list
  int prev, next;
  prev = tce->prev;
  next = tce->next;

  if (prev == -1) {
    // removing a root
    if (next != -1) {
      Screen_roots[tce->screen] = next;
    } else {
      Screen_roots[tce->screen] = -1;
    }
  } else {
    // removing a middle node
    TCEffects[prev].next = next;
    if (next != -1)
      TCEffects[next].prev = prev;
  }
  tce->prev = tce->next = -1;

  if (tce->text_buffer) {
    mem_free(tce->text_buffer);
    tce->text_buffer = NULL;
  }

  if (tce->has_focus) {
    // disable the tab stop
    tce->tab_stop = false;

    // uh oh, we're removing the item on the screen that has focus
    Screen_has_effect_with_focus[tce->screen] = false;

    // see if we can find another item and give it focus
    int node = Screen_roots[tce->screen];
    while (node != -1) {
      if (TCEffects[node].tab_stop) {
        // ok we found some one with a tab stop, give em focus
        TCEffects[node].has_focus = true;
        Screen_has_effect_with_focus[tce->screen] = true;
        break;
      }
      node = TCEffects[node].next;
    }
  }

  int i;

  switch (tce->type) {
  case EFX_TEXT_TYPE:
    TelcomStopSound(TCSND_TYPING);
    break;
  case EFX_TEXT_STATIC:
  case EFX_TEXT_FADE:
    break;
  case EFX_BMP_STATIC: