Function StartPersistentHUDMessage

Descent3/hudmessage.cpp:1326–1383

Start playing a persistent HUD message

// Start playing a persistent HUD message
void StartPersistentHUDMessage(ddgr_color color, int x, int y, float time, int flags, int sound_index, char *message) {
  if (Demo_flags == DF_RECORDING) {
    DemoWritePersistantHUDMessage(color, x, y, time, flags, sound_index, message);
  }

  // set x and y if special formatting.
  grtext_SetFont(HUD_FONT);
  if (x == HUD_MSG_PERSISTENT_CENTER) {
    x = Game_window_x + (Game_window_w - grtext_GetLineWidth(message)) / 2;
  }
  if (y == HUD_MSG_PERSISTENT_CENTER) {
    y = Game_window_y + (Game_window_h - grfont_GetHeight(HUD_FONT)) / 2;
  }

  // add custom text item
  tHUDItem huditem;

  memset(&huditem, 0, sizeof(huditem));

  huditem.alpha = HUD_ALPHA;
  huditem.color = color;
  huditem.type = HUD_ITEM_CUSTOMTEXT;
  huditem.x = x * DEFAULT_HUD_WIDTH / Max_window_w;
  huditem.y = y * DEFAULT_HUD_HEIGHT / Max_window_h;
  huditem.data.text = message;
  huditem.stat = STAT_MESSAGES;
  huditem.flags = HUD_FLAG_PERSISTANT | HUD_FLAG_SMALL; // when hud is shrunk, this will draw outside of normal view

  AddHUDItem(&huditem);

  Hud_persistent_msg_id = huditem.id;
  Hud_persistent_msg_timer = time;
  Hud_persistent_msg_flags = flags;

  // Set up for FreeSpace-style effect
  if (flags & HPF_FREESPACE_DRAW) {

    // Create additional hud item for leading character
    static char single_char[2] = { 'a', '\0' }; ; // single-character string
    huditem.alpha = 255;
    huditem.data.text = single_char;
    huditem.saturation_count = 2;
    AddHUDItem(&huditem);
    Hud_persistent_msg_id2 = huditem.id;

    tHUDItem *item = GetHUDItem(Hud_persistent_msg_id);
    tHUDItem *item2 = GetHUDItem(Hud_persistent_msg_id2);

    item2->data.text[0] = item->data.text[0];
    item->data.text[0] = 0;

    Hud_persistent_msg_current_len = 0;
    Hud_persistent_msg_char_timer = CHAR_DELAY;

    if (sound_index != SOUND_NONE_INDEX)
      Hud_persistent_msg_sound_handle = Sound_system.Play2dSound(sound_index);
  }
}