Method makeAnnouncement

library/modules/Gui.cpp:1837–1930

// End of utility functions for reports

DFHACK_EXPORT int Gui::makeAnnouncement(df::announcement_type type, df::announcement_flags flags, df::coord pos, std::string message, int color, bool bright)
{
    if (!world->allow_announcements || !is_valid_enum_item(type) || type == df::announcement_type::NONE)
        return -1;
    else if (message.empty())
    {
        Core::printerr("Empty announcement {}\n", ENUM_AS_STR(type)); // DF would print this to errorlog.txt
        return -1;
    }

    if (flags.bits.PAUSE || flags.bits.RECENTER)
        pauseRecenter((flags.bits.RECENTER ? pos : df::coord()), flags.bits.PAUSE); // Does nothing if not dwarf mode

    bool adv_unconscious = false;
    if (auto adv = World::getAdventurer())
        adv_unconscious = adv->counters.unconscious > 0;

    if (flags.bits.DO_MEGA && !adv_unconscious)
        showPopupAnnouncement(message, color, bright);

    writeToGamelog(message);

    auto &reports = world->status.reports;
    auto &alerts = world->status.announcement_alert;

    // Check for repeat report as part of an existing alert
    if (*gamemode == game_mode::DWARF && !flags.bits.ALERT)
    {
        if (linear_index(alerts, &df::announcement_alertst::type, ENUM_ATTR(announcement_type, alert_type, type)) >= 0) // Alert of type exists
        {
            for (size_t i = reports.size(); i-- > 0;)
            {
                auto &cur_report = *reports[i];
                if (cur_report.text == message) // Repeat if text matches
                {
                    cur_report.duration = ANNOUNCE_LINE_DURATION;
                    cur_report.repeat_count++;

                    if (flags.bits.D_DISPLAY)
                        world->status.display_timer = ANNOUNCE_DISPLAY_TIME;

                    return -1;
                }
            }
        }
    }

    auto new_report = new df::report();
    new_report->type = type;
    new_report->text = message;
    new_report->color = color;
    new_report->bright = bright;
    new_report->flags.whole = adv_unconscious ? df::announcement_flag::mask_unconscious : 0x0;
    new_report->pos = pos;
    new_report->id = world->status.next_report_id++;
    new_report->year = *df::global::cur_year;
    new_report->time = *df::global::cur_year_tick;
    reports.push_back(new_report);