OpenTTD Source 20260512-master-g20b387b91f
news_gui.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
9
10#include "stdafx.h"
11#include "gui.h"
12#include "viewport_func.h"
13#include "strings_func.h"
14#include "window_func.h"
15#include "vehicle_base.h"
16#include "vehicle_func.h"
17#include "vehicle_gui.h"
18#include "roadveh.h"
19#include "station_base.h"
20#include "industry.h"
21#include "town.h"
22#include "sound_func.h"
23#include "string_func.h"
24#include "statusbar_gui.h"
26#include "company_func.h"
27#include "engine_base.h"
28#include "engine_gui.h"
30#include "command_func.h"
31#include "company_base.h"
32#include "settings_internal.h"
33#include "group_gui.h"
34#include "zoom_func.h"
35#include "news_cmd.h"
36#include "news_func.h"
37#include "timer/timer.h"
38#include "timer/timer_window.h"
40
41#include "widgets/news_widget.h"
42
43#include "table/strings.h"
44
45#include "safeguards.h"
46
47static const uint MIN_NEWS_AMOUNT = 30;
48static const uint MAX_NEWS_AMOUNT = 1U << 10;
49
51
58static NewsIterator _forced_news = std::end(_news);
59
61static NewsIterator _current_news = std::end(_news);
62
65
71{
72 return (_statusbar_news == std::end(_news)) ? nullptr : &*_statusbar_news;
73}
74
80{
81 return _news;
82}
83
90{
91 struct visitor {
92 TileIndex operator()(const std::monostate &) { return INVALID_TILE; }
93 TileIndex operator()(const TileIndex &t) { return t; }
94 TileIndex operator()(const VehicleID) { return INVALID_TILE; }
95 TileIndex operator()(const StationID s) { return Station::Get(s)->xy; }
96 TileIndex operator()(const IndustryID i) { return Industry::Get(i)->location.tile + TileDiffXY(1, 1); }
97 TileIndex operator()(const TownID t) { return Town::Get(t)->xy; }
98 TileIndex operator()(const EngineID) { return INVALID_TILE; }
99 };
100
101 return std::visit(visitor{}, reference);
102}
103
128
131 WindowPosition::Manual, {}, 0, 0,
133 {},
135);
136
138static constexpr std::initializer_list<NWidgetPart> _nested_vehicle_news_widgets = {
142 /* Layer 1 */
146 EndContainer(),
147 EndContainer(),
148 /* Layer 2 */
150 SetFill(1, 1),
152 SetMinimalSize(400, 0),
154 SetStringTip(STR_EMPTY),
155 SetTextStyle(TC_BLACK, FontSize::Large),
156 EndContainer(),
161 SetMinimalSize(350, 0),
163 SetFill(1, 0),
165 SetMinimalSize(350, 32),
166 SetFill(1, 0),
169 SetMinimalSize(350, 0),
171 SetFill(1, 0),
172 EndContainer(),
173 EndContainer(),
174 EndContainer(),
175 EndContainer(),
176};
177
180 WindowPosition::Manual, {}, 0, 0,
182 {},
184);
185
223
226 WindowPosition::Manual, {}, 0, 0,
228 {},
230);
231
258
261 WindowPosition::Manual, {}, 0, 0,
263 {},
265);
266
268static constexpr std::initializer_list<NWidgetPart> _nested_small_news_widgets = {
269 /* Caption + close box. The caption is not WWT_CAPTION as the window shall not be moveable and so on. */
275 SetAspect(WidgetDimensions::ASPECT_VEHICLE_ICON),
276 SetResize(1, 0),
277 SetToolTip(STR_NEWS_SHOW_VEHICLE_GROUP_TOOLTIP),
278 EndContainer(),
279 EndContainer(),
280
281 /* Main part */
284 SetPIP(0, WidgetDimensions::unscaled.vsep_normal, 0),
285 SetPadding(2),
288 SetMinimalSize(274, 47),
289 EndContainer(),
292 SetMinimalSize(275, 0),
294 EndContainer(),
295 EndContainer(),
296};
297
300 WindowPosition::Manual, {}, 0, 0,
302 {},
304);
305
310 &_thin_news_desc, // NewsStyle::Thin
311 &_small_news_desc, // NewsStyle::Small
312 &_normal_news_desc, // NewsStyle::Normal
313 &_vehicle_news_desc, // NewsStyle::Vehicle
314 &_company_news_desc, // NewsStyle::Company
315};
316
317static WindowDesc &GetNewsWindowLayout(NewsStyle style)
318{
319 uint layout = to_underlying(style);
320 assert(layout < lengthof(_news_window_layout));
321 return *_news_window_layout[layout];
322}
323
328 /* name, age, sound, */
329 NewsTypeData("news_display.arrival_player", 60, SND_1D_APPLAUSE ),
330 NewsTypeData("news_display.arrival_other", 60, SND_1D_APPLAUSE ),
331 NewsTypeData("news_display.accident", 90, SND_BEGIN ),
332 NewsTypeData("news_display.accident_other", 90, SND_BEGIN ),
333 NewsTypeData("news_display.company_info", 60, SND_BEGIN ),
334 NewsTypeData("news_display.open", 90, SND_BEGIN ),
335 NewsTypeData("news_display.close", 90, SND_BEGIN ),
336 NewsTypeData("news_display.economy", 30, SND_BEGIN ),
337 NewsTypeData("news_display.production_player", 30, SND_BEGIN ),
338 NewsTypeData("news_display.production_other", 30, SND_BEGIN ),
339 NewsTypeData("news_display.production_nobody", 30, SND_BEGIN ),
340 NewsTypeData("news_display.advice", 150, SND_BEGIN ),
341 NewsTypeData("news_display.new_vehicles", 30, SND_1E_NEW_ENGINE),
342 NewsTypeData("news_display.acceptance", 90, SND_BEGIN ),
343 NewsTypeData("news_display.subsidies", 180, SND_BEGIN ),
344 NewsTypeData("news_display.general", 60, SND_BEGIN ),
345};
346
347static_assert(std::size(_news_type_data) == to_underlying(NewsType::End));
348
354{
355 const SettingDesc *sd = GetSettingFromName(this->name);
356 assert(sd != nullptr && sd->IsIntSetting());
357 return static_cast<NewsDisplay>(sd->AsIntSetting()->Read(nullptr));
358}
359
361struct NewsWindow : Window {
362 uint16_t chat_height = 0;
363 uint16_t status_height = 0;
364 const NewsItem *ni = nullptr;
365 static int duration;
366
367 NewsWindow(WindowDesc &desc, const NewsItem *ni) : Window(desc), ni(ni)
368 {
369 NewsWindow::duration = 16650;
371 this->chat_height = (w != nullptr) ? w->height : 0;
372 this->status_height = FindWindowById(WC_STATUS_BAR, 0)->height;
373
375
376 this->CreateNestedTree();
377
378 bool has_vehicle_id = std::holds_alternative<VehicleID>(ni->ref1);
380 if (nwid_sel != nullptr) nwid_sel->SetDisplayedPlane(has_vehicle_id ? 0 : SZSP_NONE);
381
383 if (has_vehicle_id && nwid != nullptr) {
384 const Vehicle *v = Vehicle::Get(std::get<VehicleID>(ni->ref1));
385 switch (v->type) {
387 nwid->SetString(STR_TRAIN);
388 break;
390 nwid->SetString(RoadVehicle::From(v)->IsBus() ? STR_BUS : STR_LORRY);
391 break;
393 nwid->SetString(STR_SHIP);
394 break;
396 nwid->SetString(STR_PLANE);
397 break;
398 default:
399 break; // Do nothing
400 }
401 }
402
403 this->FinishInitNested(0);
404
405 /* Initialize viewport if it exists. */
407 if (nvp != nullptr) {
408 if (std::holds_alternative<VehicleID>(ni->ref1)) {
409 nvp->InitializeViewport(this, std::get<VehicleID>(ni->ref1), ScaleZoomGUI(ZoomLevel::News));
410 } else {
412 }
414 if (!this->ni->flags.Test(NewsFlag::InColour)) {
416 } else if (this->ni->flags.Test(NewsFlag::Shaded)) {
418 }
419 }
420
422 }
423
424 void DrawNewsBorder(const Rect &r) const
425 {
428
429 ir = ir.Expand(1);
430 GfxFillRect( r.left, r.top, ir.left, r.bottom, PC_BLACK);
431 GfxFillRect(ir.right, r.top, r.right, r.bottom, PC_BLACK);
432 GfxFillRect( r.left, r.top, r.right, ir.top, PC_BLACK);
433 GfxFillRect( r.left, ir.bottom, r.right, r.bottom, PC_BLACK);
434 }
435
436 Point OnInitialPosition([[maybe_unused]] int16_t sm_width, [[maybe_unused]] int16_t sm_height, [[maybe_unused]] int window_number) override
437 {
438 Point pt = { 0, _screen.height };
439 return pt;
440 }
441
442 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
443 {
444 FontSize fontsize = FontSize::Normal;
445 std::string str;
446 switch (widget) {
447 case WID_N_CAPTION: {
448 /* Caption is not a real caption (so that the window cannot be moved)
449 * thus it doesn't get the default sizing of a caption. */
450 Dimension d2 = GetStringBoundingBox(STR_NEWS_MESSAGE_CAPTION);
451 d2.height += WidgetDimensions::scaled.captiontext.Vertical();
452 size = maxdim(size, d2);
453 return;
454 }
455
456 case WID_N_MGR_FACE:
457 size = maxdim(size, GetScaledSpriteSize(SPR_GRADIENT));
458 break;
459
460 case WID_N_MESSAGE:
462 fontsize = this->GetWidget<NWidgetLeaf>(widget)->GetFontSize();
463 str = this->ni->headline.GetDecodedString();
464 break;
465
466 case WID_N_VEH_NAME:
467 case WID_N_VEH_TITLE:
468 str = this->GetNewVehicleMessageString(widget);
469 break;
470
471 case WID_N_VEH_INFO: {
472 assert(std::holds_alternative<EngineID>(ni->ref1));
473 EngineID engine = std::get<EngineID>(this->ni->ref1);
474 str = GetEngineInfoString(engine);
475 break;
476 }
477
478 case WID_N_SHOW_GROUP:
479 if (std::holds_alternative<VehicleID>(ni->ref1)) {
481 d2.height += WidgetDimensions::scaled.captiontext.Vertical();
482 d2.width += WidgetDimensions::scaled.captiontext.Horizontal();
483 size = d2;
484 }
485 return;
486
487 default:
488 return; // Do nothing
489 }
490
491 /* Update minimal size with length of the multi-line string. */
492 Dimension d = size;
493 d.width = (d.width >= padding.width) ? d.width - padding.width : 0;
494 d.height = (d.height >= padding.height) ? d.height - padding.height : 0;
495 d = GetStringMultiLineBoundingBox(str, d, fontsize);
496 d.width += padding.width;
497 d.height += padding.height;
498 size = maxdim(size, d);
499 }
500
501 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
502 {
503 if (widget == WID_N_DATE) {
504 return GetString(STR_JUST_DATE_LONG, this->ni->date);
505 } else if (widget == WID_N_TITLE) {
506 const CompanyNewsInformation *cni = static_cast<const CompanyNewsInformation*>(this->ni->data.get());
507 return GetString(cni->title);
508 }
509
510 return this->Window::GetWidgetString(widget, stringid);
511
512 }
513
514 void DrawWidget(const Rect &r, WidgetID widget) const override
515 {
516 switch (widget) {
517 case WID_N_CAPTION:
518 DrawCaption(r, Colours::LightBlue, this->owner, TC_FROMSTRING, GetString(STR_NEWS_MESSAGE_CAPTION), SA_CENTER, FontSize::Normal);
519 break;
520
521 case WID_N_PANEL:
522 this->DrawNewsBorder(r);
523 break;
524
525 case WID_N_MESSAGE:
526 case WID_N_COMPANY_MSG: {
527 const NWidgetLeaf &nwid = *this->GetWidget<NWidgetLeaf>(widget);
528 DrawStringMultiLine(r, this->ni->headline.GetDecodedString(), nwid.GetTextColour(), SA_CENTER, false, nwid.GetFontSize());
529 break;
530 }
531
532 case WID_N_MGR_FACE: {
533 const CompanyNewsInformation *cni = static_cast<const CompanyNewsInformation*>(this->ni->data.get());
534 DrawCompanyManagerFace(cni->face, cni->colour, r);
536 break;
537 }
538 case WID_N_MGR_NAME: {
539 const CompanyNewsInformation *cni = static_cast<const CompanyNewsInformation*>(this->ni->data.get());
540 DrawStringMultiLine(r, GetString(STR_JUST_RAW_STRING, cni->president_name), TC_FROMSTRING, SA_CENTER);
541 break;
542 }
543
544 case WID_N_VEH_BKGND:
546 break;
547
548 case WID_N_VEH_NAME:
549 case WID_N_VEH_TITLE:
550 DrawStringMultiLine(r, this->GetNewVehicleMessageString(widget), TC_FROMSTRING, SA_CENTER);
551 break;
552
553 case WID_N_VEH_SPR: {
554 assert(std::holds_alternative<EngineID>(ni->ref1));
555 EngineID engine = std::get<EngineID>(this->ni->ref1);
556 DrawVehicleEngine(r.left, r.right, CentreBounds(r.left, r.right, 0), CentreBounds(r.top, r.bottom, 0), engine, GetEnginePalette(engine, _local_company), EIT_PREVIEW);
558 break;
559 }
560 case WID_N_VEH_INFO: {
561 assert(std::holds_alternative<EngineID>(ni->ref1));
562 EngineID engine = std::get<EngineID>(this->ni->ref1);
564 break;
565 }
566 }
567 }
568
569 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
570 {
571 switch (widget) {
572 case WID_N_CLOSEBOX:
574 this->Close();
575 _forced_news = std::end(_news);
576 break;
577
578 case WID_N_CAPTION:
579 if (std::holds_alternative<VehicleID>(ni->ref1)) {
580 const Vehicle *v = Vehicle::Get(std::get<VehicleID>(this->ni->ref1));
582 }
583 break;
584
585 case WID_N_VIEWPORT:
586 break; // Ignore clicks
587
588 case WID_N_SHOW_GROUP:
589 if (std::holds_alternative<VehicleID>(ni->ref1)) {
590 const Vehicle *v = Vehicle::Get(std::get<VehicleID>(this->ni->ref1));
592 }
593 break;
594 default:
595 if (std::holds_alternative<VehicleID>(ni->ref1)) {
596 const Vehicle *v = Vehicle::Get(std::get<VehicleID>(this->ni->ref1))->GetMovingFront();
598 } else {
599 TileIndex tile1 = GetReferenceTile(this->ni->ref1);
600 TileIndex tile2 = GetReferenceTile(this->ni->ref2);
601 if (_ctrl_pressed) {
602 if (tile1 != INVALID_TILE) ShowExtraViewportWindow(tile1);
603 if (tile2 != INVALID_TILE) ShowExtraViewportWindow(tile2);
604 } else {
605 if ((tile1 == INVALID_TILE || !ScrollMainWindowToTile(tile1)) && tile2 != INVALID_TILE) {
607 }
608 }
609 }
610 break;
611 }
612 }
613
614 void OnResize() override
615 {
616 if (this->viewport != nullptr) {
618 nvp->UpdateViewportCoordinates(this);
619
620 if (!std::holds_alternative<VehicleID>(ni->ref1)) {
621 ScrollWindowToTile(GetReferenceTile(ni->ref1), this, true); // Re-center viewport.
622 }
623 }
624
626 if (wid != nullptr) {
627 int y = GetStringHeight(GetString(STR_JUST_RAW_STRING, static_cast<const CompanyNewsInformation *>(this->ni->data.get())->president_name), wid->current_x);
628 if (wid->UpdateVerticalSize(y)) this->ReInit(0, 0);
629 }
630 }
631
637 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
638 {
639 if (!gui_scope) return;
640 /* The chatbar has notified us that is was either created or closed */
641 int newtop = this->top + this->chat_height - data;
642 this->chat_height = data;
643 this->SetWindowTop(newtop);
644 }
645
646 void OnRealtimeTick([[maybe_unused]] uint delta_ms) override
647 {
648 /* Decrement the news timer. We don't need to action an elapsed event here,
649 * so no need to use TimerElapsed(). */
650 if (NewsWindow::duration > 0) NewsWindow::duration -= delta_ms;
651 }
652
658 const IntervalTimer<TimerWindow> scroll_interval = {std::chrono::milliseconds(210) / GetCharacterHeight(FontSize::Normal), [this](uint count) {
659 int newtop = std::max(this->top - 2 * static_cast<int>(count), _screen.height - this->height - this->status_height - this->chat_height);
660 this->SetWindowTop(newtop);
661 }};
662
663private:
668 void SetWindowTop(int newtop)
669 {
670 if (this->top == newtop) return;
671
672 int mintop = std::min(newtop, this->top);
673 int maxtop = std::max(newtop, this->top);
674 if (this->viewport != nullptr) this->viewport->top += newtop - this->top;
675 this->top = newtop;
676
677 AddDirtyBlock(this->left, mintop, this->left + this->width, maxtop + this->height);
678 }
679
680 std::string GetNewVehicleMessageString(WidgetID widget) const
681 {
682 assert(std::holds_alternative<EngineID>(ni->ref1));
683 EngineID engine = std::get<EngineID>(this->ni->ref1);
684
685 switch (widget) {
686 case WID_N_VEH_TITLE:
687 return GetString(STR_NEWS_NEW_VEHICLE_NOW_AVAILABLE, GetEngineCategoryName(engine));
688
689 case WID_N_VEH_NAME:
690 return GetString(STR_NEWS_NEW_VEHICLE_TYPE, PackEngineNameDParam(engine, EngineNameContext::PreviewNews));
691
692 default:
693 NOT_REACHED();
694 }
695 }
696};
697
698/* static */ int NewsWindow::duration = 0; // Instance creation.
699
704static void ShowNewspaper(const NewsItem *ni)
705{
706 SoundFx sound = _news_type_data[to_underlying(ni->type)].sound;
707 if (sound != 0 && _settings_client.sound.news_full) SndPlayFx(sound);
708
709 new NewsWindow(GetNewsWindowLayout(ni->style), ni);
710}
711
717{
718 if (_settings_client.sound.news_ticker) SndPlayFx(SND_16_NEWS_TICKER);
719
720 _statusbar_news = ni;
722}
723
726{
727 _news.clear();
728 _forced_news = std::end(_news);
729 _current_news = std::end(_news);
730 _statusbar_news = std::end(_news);
732}
733
740{
741 const NewsItem *ni = GetStatusbarNews();
742 if (ni == nullptr) return true;
743
744 /* Ticker message
745 * Check if the status bar message is still being displayed? */
746 return !IsNewsTickerShown();
747}
748
755{
756 if (_forced_news == std::end(_news) && _current_news == std::end(_news)) return true;
757
758 /* neither newsticker nor newspaper are running */
759 return (NewsWindow::duration <= 0 || FindWindowById(WC_NEWS_WINDOW, 0) == nullptr);
760}
761
764{
765 /* There is no status bar, so no reason to show news;
766 * especially important with the end game screen when
767 * there is no status bar but possible news. */
768 if (FindWindowById(WC_STATUS_BAR, 0) == nullptr) return;
769
770 /* No news to move to. */
771 if (std::empty(_news)) return;
772
773 /* if we're not at the latest item, then move on */
774 while (_statusbar_news != std::begin(_news)) {
776 const NewsType type = _statusbar_news->type;
777
778 /* check the date, don't show too old items */
779 if (TimerGameEconomy::date - _news_type_data[to_underlying(type)].age > _statusbar_news->economy_date) continue;
780
781 switch (_news_type_data[to_underlying(type)].GetDisplay()) {
782 default: NOT_REACHED();
783 case NewsDisplay::Off: // Show nothing only a small reminder in the status bar.
785 return;
786
787 case NewsDisplay::Summary: // Show ticker.
789 return;
790
791 case NewsDisplay::Full: // Show newspaper, skipped here.
792 break;;
793 }
794 }
795}
796
799{
800 /* There is no status bar, so no reason to show news;
801 * especially important with the end game screen when
802 * there is no status bar but possible news. */
803 if (FindWindowById(WC_STATUS_BAR, 0) == nullptr) return;
804
805 CloseWindowById(WC_NEWS_WINDOW, 0); // close the newspapers window if shown
806 _forced_news = std::end(_news);
807
808 /* No news to move to. */
809 if (std::empty(_news)) return;
810
811 /* if we're not at the latest item, then move on */
812 while (_current_news != std::begin(_news)) {
814 const NewsType type = _current_news->type;
815
816 /* check the date, don't show too old items */
817 if (TimerGameEconomy::date - _news_type_data[to_underlying(type)].age > _current_news->economy_date) continue;
818
819 switch (_news_type_data[to_underlying(type)].GetDisplay()) {
820 default: NOT_REACHED();
821 case NewsDisplay::Off: // Show nothing only a small reminder in the status bar, skipped here.
822 break;
823
824 case NewsDisplay::Summary: // Show ticker, skipped here.
825 break;
826
827 case NewsDisplay::Full: // Sshow newspaper.
829 return;
830 }
831 }
832}
833
839static std::list<NewsItem>::iterator DeleteNewsItem(std::list<NewsItem>::iterator ni)
840{
841 bool update_current_news = (_forced_news == ni || _current_news == ni);
842 bool update_statusbar_news = (_statusbar_news == ni);
843
844 if (update_current_news) {
845 /* When we're the current news, go to the next older item first;
846 * we just possibly made that the last news item. */
847 if (_current_news == ni) ++_current_news;
848 if (_forced_news == ni) _forced_news = std::end(_news);
849 }
850
851 if (update_statusbar_news) {
852 /* When we're the current news, go to the next older item first;
853 * we just possibly made that the last news item. */
855 }
856
857 /* Delete the news from the news queue. */
858 ni = _news.erase(ni);
859
860 if (update_current_news) {
861 /* About to remove the currently forced item (shown as newspapers) ||
862 * about to remove the currently displayed item (newspapers) */
864 }
865
866 if (update_statusbar_news) {
867 /* About to remove the currently displayed item (ticker, or just a reminder) */
868 InvalidateWindowData(WC_STATUS_BAR, 0, SBI_NEWS_DELETED); // invalidate the statusbar
870 }
871
872 return ni;
873}
874
890{
891 /* show this news message in colour? */
892 if (TimerGameCalendar::year >= _settings_client.gui.coloured_news_year) this->flags.Set(NewsFlag::InColour);
893}
894
895std::string NewsItem::GetStatusText() const
896{
897 if (this->data != nullptr) {
898 /* CompanyNewsInformation is the only type of additional data used. */
899 const CompanyNewsInformation &cni = *static_cast<const CompanyNewsInformation*>(this->data.get());
900 return GetString(STR_MESSAGE_NEWS_FORMAT, cni.title, this->headline.GetDecodedString());
901 }
902
903 return this->headline.GetDecodedString();
904}
905
919void AddNewsItem(EncodedString &&headline, NewsType type, NewsStyle style, NewsFlags flags, NewsReference ref1, NewsReference ref2, std::unique_ptr<NewsAllocatedData> &&data, AdviceType advice_type)
920{
921 if (_game_mode == GM_MENU) return;
922
923 /* Create new news item node */
924 _news.emplace_front(std::move(headline), type, style, flags, ref1, ref2, std::move(data), advice_type);
925
926 /* Keep the number of stored news items to a manageable number */
927 if (std::size(_news) > MAX_NEWS_AMOUNT) {
928 DeleteNewsItem(std::prev(std::end(_news)));
929 }
930
932}
933
939uint32_t SerialiseNewsReference(const NewsReference &reference)
940{
941 struct visitor {
942 uint32_t operator()(const std::monostate &) { return 0; }
943 uint32_t operator()(const TileIndex &t) { return t.base(); }
944 uint32_t operator()(const VehicleID v) { return v.base(); }
945 uint32_t operator()(const StationID s) { return s.base(); }
946 uint32_t operator()(const IndustryID i) { return i.base(); }
947 uint32_t operator()(const TownID t) { return t.base(); }
948 uint32_t operator()(const EngineID e) { return e.base(); }
949 };
950
951 return std::visit(visitor{}, reference);
952}
953
963CommandCost CmdCustomNewsItem(DoCommandFlags flags, NewsType type, CompanyID company, NewsReference reference, const EncodedString &text)
964{
966
967 if (company != INVALID_OWNER && !Company::IsValidID(company)) return CMD_ERROR;
968 if (type >= NewsType::End) return CMD_ERROR;
969 if (text.empty()) return CMD_ERROR;
970
971 struct visitor {
972 bool operator()(const std::monostate &) { return true; }
973 bool operator()(const TileIndex t) { return IsValidTile(t); }
974 bool operator()(const VehicleID v) { return Vehicle::IsValidID(v); }
975 bool operator()(const StationID s) { return Station::IsValidID(s); }
976 bool operator()(const IndustryID i) { return Industry::IsValidID(i); }
977 bool operator()(const TownID t) { return Town::IsValidID(t); }
978 bool operator()(const EngineID e) { return Engine::IsValidID(e); }
979 };
980
981 if (!std::visit(visitor{}, reference)) return CMD_ERROR;
982
983 if (company != INVALID_OWNER && company != _local_company) return CommandCost();
984
985 if (flags.Test(DoCommandFlag::Execute)) {
986 AddNewsItem(EncodedString{text}, type, NewsStyle::Normal, {}, reference, {});
987 }
988
989 return CommandCost();
990}
991
998template <size_t Tmin = 0, class Tpredicate>
999void DeleteNews(Tpredicate predicate)
1000{
1001 bool dirty = false;
1002 for (auto it = std::rbegin(_news); it != std::rend(_news); /* nothing */) {
1003 if constexpr (Tmin > 0) {
1004 if (std::size(_news) <= Tmin) break;
1005 }
1006 if (predicate(*it)) {
1007 it = std::make_reverse_iterator(DeleteNewsItem(std::prev(it.base())));
1008 dirty = true;
1009 } else {
1010 ++it;
1011 }
1012 }
1014}
1015
1016template <typename T>
1017static bool IsReferenceObject(const NewsReference &reference, T id)
1018{
1019 return std::holds_alternative<T>(reference) && std::get<T>(reference) == id;
1020}
1021
1022template <typename T>
1023static bool HasReferenceObject(const NewsItem &ni, T id)
1024{
1025 return IsReferenceObject(ni.ref1, id) || IsReferenceObject(ni.ref2, id);
1026}
1027
1035{
1036 DeleteNews([&](const auto &ni) {
1037 return HasReferenceObject(ni, vid) && (advice_type == AdviceType::Invalid || ni.advice_type == advice_type);
1038 });
1039}
1040
1046void DeleteStationNews(StationID sid)
1047{
1048 DeleteNews([&](const auto &ni) {
1049 return HasReferenceObject(ni, sid);
1050 });
1051}
1052
1057void DeleteIndustryNews(IndustryID iid)
1058{
1059 DeleteNews([&](const auto &ni) {
1060 return HasReferenceObject(ni, iid);
1061 });
1062}
1063
1064bool IsInvalidEngineNews(const NewsReference &reference)
1065{
1066 if (!std::holds_alternative<EngineID>(reference)) return false;
1067
1068 EngineID eid = std::get<EngineID>(reference);
1069 return !Engine::IsValidID(eid) || !Engine::Get(eid)->IsEnabled();
1070}
1071
1076{
1077 DeleteNews([](const auto &ni) {
1078 return IsInvalidEngineNews(ni.ref1) || IsInvalidEngineNews(ni.ref2);
1079 });
1080}
1081
1082static void RemoveOldNewsItems()
1083{
1084 DeleteNews<MIN_NEWS_AMOUNT>([](const auto &ni) {
1085 return TimerGameEconomy::date - _news_type_data[to_underlying(ni.type)].age * _settings_client.gui.news_message_timeout > ni.economy_date;
1086 });
1087}
1088
1089template <typename T>
1090static void ChangeObject(NewsReference reference, T from, T to)
1091{
1092 if (!std::holds_alternative<T>(reference)) return;
1093 if (std::get<T>(reference) == from) reference = to;
1094}
1095
1102void ChangeVehicleNews(VehicleID from_index, VehicleID to_index)
1103{
1104 for (auto &ni : _news) {
1105 ChangeObject(ni.ref1, from_index, to_index);
1106 ChangeObject(ni.ref2, from_index, to_index);
1107 if (ni.flags.Test(NewsFlag::VehicleParam0) && IsReferenceObject(ni.ref1, to_index)) ni.headline = ni.headline.ReplaceParam(0, to_index.base());
1108 }
1109}
1110
1111void NewsLoop()
1112{
1113 /* no news item yet */
1114 if (std::empty(_news)) return;
1115
1116 static TimerGameEconomy::Month _last_clean_month = 0;
1117
1118 if (_last_clean_month != TimerGameEconomy::month) {
1119 RemoveOldNewsItems();
1120 _last_clean_month = TimerGameEconomy::month;
1121 }
1122
1125}
1126
1132{
1133 assert(!std::empty(_news));
1134
1135 /* Delete the news window */
1137
1138 /* setup forced news item */
1139 _forced_news = ni;
1140
1141 if (_forced_news != std::end(_news)) {
1143 ShowNewspaper(&*ni);
1144 }
1145}
1146
1152{
1153 NewsWindow *w = dynamic_cast<NewsWindow *>(FindWindowById(WC_NEWS_WINDOW, 0));
1154 if (w == nullptr) return false;
1155 w->Close();
1156 return true;
1157}
1158
1161{
1162 if (std::empty(_news)) return;
1163
1164 NewsIterator ni;
1165 if (_forced_news == std::end(_news)) {
1166 /* Not forced any news yet, show the current one, unless a news window is
1167 * open (which can only be the current one), then show the previous item */
1168 if (_current_news == std::end(_news)) {
1169 /* No news were shown yet resp. the last shown one was already deleted.
1170 * Treat this as if _forced_news reached the oldest news; so, wrap around and start anew with the latest. */
1171 ni = std::begin(_news);
1172 } else {
1173 const Window *w = FindWindowById(WC_NEWS_WINDOW, 0);
1174 ni = (w == nullptr || (std::next(_current_news) == std::end(_news))) ? _current_news : std::next(_current_news);
1175 }
1176 } else if (std::next(_forced_news) == std::end(_news)) {
1177 /* We have reached the oldest news, start anew with the latest */
1178 ni = std::begin(_news);
1179 } else {
1180 /* 'Scrolling' through news history show each one in turn */
1181 ni = std::next(_forced_news);
1182 }
1183 bool wrap = false;
1184 for (;;) {
1185 if (_news_type_data[to_underlying(ni->type)].GetDisplay() != NewsDisplay::Off) {
1186 ShowNewsMessage(ni);
1187 break;
1188 }
1189
1190 ++ni;
1191 if (ni == std::end(_news)) {
1192 if (wrap) break;
1193 /* We have reached the oldest news, start anew with the latest */
1194 ni = std::begin(_news);
1195 wrap = true;
1196 }
1197 }
1198}
1199
1200
1210static void DrawNewsString(uint left, uint right, int y, TextColour colour, const NewsItem &ni)
1211{
1212 /* Get the string, replaces newlines with spaces and remove control codes from the string. */
1213 std::string message = StrMakeValid(ni.GetStatusText(), StringValidationSetting::ReplaceTabCrNlWithSpace);
1214
1215 /* Truncate and show string; postfixed by '...' if necessary */
1216 DrawString(left, right, y, message, colour);
1217}
1218
1219struct MessageHistoryWindow : Window {
1220 int line_height = 0;
1221 int date_width = 0;
1222
1223 Scrollbar *vscroll = nullptr;
1224
1225 MessageHistoryWindow(WindowDesc &desc) : Window(desc)
1226 {
1227 this->CreateNestedTree();
1228 this->vscroll = this->GetScrollbar(WID_MH_SCROLLBAR);
1229 this->FinishInitNested(); // Initializes 'this->line_height' and 'this->date_width'.
1230 this->OnInvalidateData(0);
1231 }
1232
1233 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
1234 {
1235 if (widget == WID_MH_BACKGROUND) {
1236 this->line_height = GetCharacterHeight(FontSize::Normal) + WidgetDimensions::scaled.vsep_normal;
1237 fill.height = resize.height = this->line_height;
1238
1239 /* Months are off-by-one, so it's actually 8. Not using
1240 * month 12 because the 1 is usually less wide. */
1242
1243 size.height = 4 * resize.height + WidgetDimensions::scaled.framerect.Vertical(); // At least 4 lines are visible.
1244 size.width = std::max(200u, size.width); // At least 200 pixels wide.
1245 }
1246 }
1247
1248 void DrawWidget(const Rect &r, WidgetID widget) const override
1249 {
1250 if (widget != WID_MH_BACKGROUND || std::empty(_news)) return;
1251
1252 /* Fill the widget with news items. */
1253 bool rtl = _current_text_dir == TD_RTL;
1254 Rect news = r.Shrink(WidgetDimensions::scaled.framerect).Indent(this->date_width + WidgetDimensions::scaled.hsep_wide, rtl);
1255 Rect date = r.Shrink(WidgetDimensions::scaled.framerect).WithWidth(this->date_width, rtl);
1256 int y = news.top;
1257
1258 auto [first, last] = this->vscroll->GetVisibleRangeIterators(_news);
1259 for (auto ni = first; ni != last; ++ni) {
1260 DrawString(date.left, date.right, y, GetString(STR_JUST_DATE_TINY, ni->date), TC_WHITE);
1261
1262 DrawNewsString(news.left, news.right, y, TC_WHITE, *ni);
1263 y += this->line_height;
1264 }
1265 }
1266
1272 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
1273 {
1274 if (!gui_scope) return;
1275 this->vscroll->SetCount(std::size(_news));
1276 }
1277
1278 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
1279 {
1280 if (widget == WID_MH_BACKGROUND) {
1281 /* Scheduled window invalidations currently occur after the input loop, which means the scrollbar count
1282 * could be invalid, so ensure it's correct now. Potentially this means that item clicked on might be
1283 * different as well. */
1284 this->vscroll->SetCount(std::size(_news));
1285 auto ni = this->vscroll->GetScrolledItemFromWidget(_news, pt.y, this, widget, WidgetDimensions::scaled.framerect.top);
1286 if (ni == std::end(_news)) return;
1287
1288 ShowNewsMessage(ni);
1289 }
1290 }
1291
1292 void OnResize() override
1293 {
1294 this->vscroll->SetCapacityFromWidget(this, WID_MH_BACKGROUND, WidgetDimensions::scaled.framerect.Vertical());
1295 }
1296};
1297
1298static constexpr std::initializer_list<NWidgetPart> _nested_message_history = {
1301 NWidget(WWT_CAPTION, Colours::Brown), SetStringTip(STR_MESSAGE_HISTORY, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
1305 EndContainer(),
1306
1309 EndContainer(),
1313 EndContainer(),
1314 EndContainer(),
1315};
1316
1319 WindowPosition::Automatic, "list_news", 400, 140,
1321 {},
1322 _nested_message_history
1323);
1324
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr Timpl & Set()
Set all bits.
Common return value for all commands.
Container for an encoded string, created by GetEncodedString.
std::string GetDecodedString() const
Decode the encoded string.
Definition strings.cpp:207
EncodedString ReplaceParam(size_t param, StringParameter &&value) const
Replace a parameter of this EncodedString.
Definition strings.cpp:150
An interval timer will fire every interval, and will continue to fire until it is deleted.
Definition timer.h:76
uint current_x
Current horizontal size (after resizing).
Base class for a 'real' widget.
NWidgetDisplayFlags disp_flags
Flags that affect display and interaction with the widget.
void SetString(StringID string)
Set string of the nested widget.
Definition widget.cpp:1185
Leaf widget.
Base class for a resizable nested widget.
bool UpdateVerticalSize(uint min_y)
Set absolute (post-scaling) minimal size of the widget.
Definition widget.cpp:1151
Stacked widgets, widgets all occupying the same space in the window.
bool SetDisplayedPlane(int plane)
Select which plane to show (for NWID_SELECTION only).
Definition widget.cpp:1453
Nested widget to display a viewport in a window.
void UpdateViewportCoordinates(Window *w)
Update the position and size of the viewport (after eg a resize).
Definition widget.cpp:2435
void InitializeViewport(Window *w, std::variant< TileIndex, VehicleID > focus, ZoomLevel zoom)
Initialize the viewport of the window.
Definition widget.cpp:2426
Scrollbar data structure.
void SetCount(size_t num)
Sets the number of elements in the list.
auto GetScrolledItemFromWidget(Tcontainer &container, int clickpos, const Window *const w, WidgetID widget, int padding=0, int line_height=-1) const
Return an iterator pointing to the element of a scrolled widget that a user clicked in.
void SetCapacityFromWidget(Window *w, WidgetID widget, int padding=0)
Set capacity of visible elements from the size and resize properties of a widget.
Definition widget.cpp:2532
auto GetVisibleRangeIterators(Tcontainer &container) const
Get a pair of iterators for the range of visible elements in a container.
Timer that is increased every 27ms, and counts towards ticks / days / months / years.
static Date ConvertYMDToDate(Year year, Month month, Day day)
Converts a tuple of Year, Month and Day to a Date.
static Year year
Current year, starting at 0.
static constexpr TimerGame< struct Calendar >::Year ORIGINAL_MAX_YEAR
Timer that is increased every 27ms, and counts towards economy time units, expressed in days / months...
static Date date
Current date in days (day counter).
static Month month
Current month (0..11).
static WidgetDimensions scaled
Widget dimensions scaled for current zoom level.
Definition window_gui.h:30
static const WidgetDimensions unscaled
Unscaled widget dimensions.
Definition window_gui.h:93
Functions related to commands.
static const CommandCost CMD_ERROR
Define a default return value for a failed command.
@ Execute
execute the given command
Definition of stuff that is very close to a company, like the company struct itself.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
CompanyID _current_company
Company currently doing an action.
Functions related to companies.
void DrawCompanyManagerFace(const CompanyManagerFace &cmf, Colours colour, const Rect &r)
Draws the face of a company manager's face.
Functionality related to the company manager's face.
static constexpr Owner OWNER_DEITY
The object is owned by a superuser / goal script.
static constexpr Owner INVALID_OWNER
An invalid owner.
Base class for engines.
std::string GetEngineInfoString(EngineID engine)
Get a multi-line string with some technical data, describing the engine.
StringID GetEngineCategoryName(EngineID engine)
Return the category of an engine.
void DrawVehicleEngine(int left, int right, int preferred_x, int y, EngineID engine, PaletteID pal, EngineImageType image_type)
Draw an engine.
Engine GUI functions, used by build_vehicle_gui and autoreplace_gui.
PoolID< uint16_t, struct EngineIDTag, 64000, 0xFFFF > EngineID
Unique identification number of an engine.
Definition engine_type.h:26
uint64_t PackEngineNameDParam(EngineID engine_id, EngineNameContext context, uint32_t extra_data=0)
Combine an engine ID and a name context to an engine name StringParameter.
@ PreviewNews
Name is shown in exclusive preview or newspaper.
#define T
Climate temperate.
Definition engines.h:91
constexpr std::underlying_type_t< enum_type > to_underlying(enum_type e)
Implementation of std::to_underlying (from C++23).
Definition enum_type.hpp:21
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:88
Dimension maxdim(const Dimension &d1, const Dimension &d2)
Compute bounding box of both dimensions.
Geometry functions.
int CentreBounds(int min, int max, int size)
Determine where to position a centred object.
int GetStringHeight(std::string_view str, int maxw, FontSize fontsize)
Calculates height of string (in pixels).
Definition gfx.cpp:717
Dimension GetStringBoundingBox(std::string_view str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition gfx.cpp:900
int DrawString(int left, int right, int top, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly truncated to make it fit in its allocated space.
Definition gfx.cpp:669
bool _ctrl_pressed
Is Ctrl pressed?
Definition gfx.cpp:39
Dimension GetStringMultiLineBoundingBox(StringID str, const Dimension &suggestion)
Calculate string bounding box for multi-line strings.
Definition gfx.cpp:753
int DrawStringMultiLine(int left, int right, int top, int bottom, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly over multiple lines.
Definition gfx.cpp:788
void GfxFillRect(int left, int top, int right, int bottom, const std::variant< PixelColour, PaletteID > &colour, FillRectMode mode)
Applies a certain FillRectMode-operation to a rectangle [left, right] x [top, bottom] on the screen.
Definition gfx.cpp:116
Dimension GetScaledSpriteSize(SpriteID sprid)
Scale sprite size for GUI.
Definition widget.cpp:70
FontSize
Available font sizes.
Definition gfx_type.h:248
@ Small
Index of the small font in the font tables.
Definition gfx_type.h:250
@ Large
Index of the large font in the font tables.
Definition gfx_type.h:251
@ Normal
Index of the normal font in the font tables.
Definition gfx_type.h:249
@ SA_TOP
Top align the text.
Definition gfx_type.h:393
@ SA_RIGHT
Right align the text (must be a single bit).
Definition gfx_type.h:390
@ SA_CENTER
Center both horizontally and vertically.
Definition gfx_type.h:398
@ White
White.
Definition gfx_type.h:300
@ Invalid
Invalid marker.
Definition gfx_type.h:302
@ LightBlue
Light blue.
Definition gfx_type.h:290
@ Brown
Brown.
Definition gfx_type.h:298
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition gfx_type.h:307
@ Recolour
Apply a recolour sprite to the screen content.
Definition gfx_type.h:347
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetPIP(uint8_t pre, uint8_t inter, uint8_t post)
Widget part function for setting a pre/inter/post spaces.
constexpr NWidgetPart SetScrollbar(WidgetID index)
Attach a scrollbar to a widget.
constexpr NWidgetPart SetPadding(uint8_t top, uint8_t right, uint8_t bottom, uint8_t left)
Widget part function for setting additional space around a widget.
constexpr NWidgetPart SetStringTip(StringID string, StringID tip={})
Widget part function for setting the string and tooltip.
constexpr NWidgetPart SetAspect(float ratio, AspectFlags flags=AspectFlag::ResizeX)
Widget part function for setting the aspect ratio.
constexpr NWidgetPart SetMinimalTextLines(uint8_t lines, uint8_t spacing, FontSize size=FontSize::Normal)
Widget part function for setting the minimal text lines.
constexpr NWidgetPart SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart SetToolTip(StringID tip)
Widget part function for setting tooltip and clearing the widget data.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
constexpr NWidgetPart SetTextStyle(TextColour colour, FontSize size=FontSize::Normal)
Widget part function for setting the text style.
constexpr NWidgetPart NWidget(WidgetType tp, Colours col, WidgetID idx=INVALID_WIDGET)
Widget part function for starting a new 'real' widget.
constexpr NWidgetPart SetAlignment(StringAlignment align)
Widget part function for setting the alignment of text/images.
constexpr NWidgetPart SetResize(int16_t dx, int16_t dy)
Widget part function for setting the resize step.
constexpr NWidgetPart SetPIPRatio(uint8_t ratio_pre, uint8_t ratio_inter, uint8_t ratio_post)
Widget part function for setting a pre/inter/post ratio.
void AddDirtyBlock(int left, int top, int right, int bottom)
Extend the internal _invalid_rect rectangle to contain the rectangle defined by the given parameters.
Definition gfx.cpp:1521
void ShowCompanyGroupForVehicle(const Vehicle *v)
Show the group window for the given vehicle.
Functions/definitions that have something to do with groups.
GUI functions that shouldn't be here.
void ShowExtraViewportWindow(TileIndex tile=INVALID_TILE)
Show a new Extra Viewport window.
Base of all industries.
#define Rect
Macro that prevents name conflicts between included headers.
#define Point
Macro that prevents name conflicts between included headers.
TileIndexDiff TileDiffXY(int x, int y)
Calculates an offset for the given coordinate(-offset).
Definition map_func.h:392
Command definitions related to news messages.
Functions related to news.
static NewsContainer _news
List of news, with newest items at the start.
Definition news_gui.cpp:50
void AddNewsItem(EncodedString &&headline, NewsType type, NewsStyle style, NewsFlags flags, NewsReference ref1, NewsReference ref2, std::unique_ptr< NewsAllocatedData > &&data, AdviceType advice_type)
Add a new newsitem to be shown.
Definition news_gui.cpp:919
static void MoveToNextNewsItem()
Move to the next news item.
Definition news_gui.cpp:798
static WindowDesc _vehicle_news_desc(WindowPosition::Manual, {}, 0, 0, WC_NEWS_WINDOW, WC_NONE, {}, _nested_vehicle_news_widgets)
Window definition for the vehicle news window.
static void ShowTicker(NewsIterator ni)
Show news item in the ticker.
Definition news_gui.cpp:716
static constexpr std::initializer_list< NWidgetPart > _nested_normal_news_widgets
Normal news items.
Definition news_gui.cpp:105
void DeleteNews(Tpredicate predicate)
Delete news items by predicate, and invalidate the message history if necessary.
Definition news_gui.cpp:999
static void ShowNewspaper(const NewsItem *ni)
Open up an own newspaper window for the news item.
Definition news_gui.cpp:704
static const NewsTypeData _news_type_data[]
Per-NewsType data.
Definition news_gui.cpp:327
static const uint MIN_NEWS_AMOUNT
preferred minimum amount of news messages.
Definition news_gui.cpp:47
static WindowDesc _company_news_desc(WindowPosition::Manual, {}, 0, 0, WC_NEWS_WINDOW, WC_NONE, {}, _nested_company_news_widgets)
Window definition for the company news window.
CommandCost CmdCustomNewsItem(DoCommandFlags flags, NewsType type, CompanyID company, NewsReference reference, const EncodedString &text)
Create a new custom news item.
Definition news_gui.cpp:963
static constexpr std::initializer_list< NWidgetPart > _nested_vehicle_news_widgets
New vehicles news items.
Definition news_gui.cpp:138
static NewsIterator _forced_news
Forced news item.
Definition news_gui.cpp:58
void DeleteIndustryNews(IndustryID iid)
Remove news regarding given industry.
void DeleteStationNews(StationID sid)
Remove news regarding given station so there are no 'unknown station now accepts Mail' or 'First trai...
static TileIndex GetReferenceTile(const NewsReference &reference)
Get the position a news-reference is referencing.
Definition news_gui.cpp:89
static WindowDesc _message_history_desc(WindowPosition::Automatic, "list_news", 400, 140, WC_MESSAGE_HISTORY, WC_NONE, {}, _nested_message_history)
Window definition for the news message history window.
static void DrawNewsString(uint left, uint right, int y, TextColour colour, const NewsItem &ni)
Draw an unformatted news message truncated to a maximum length.
void ShowLastNewsMessage()
Show previous news item.
static const uint MAX_NEWS_AMOUNT
Do not exceed this number of news messages.
Definition news_gui.cpp:48
uint32_t SerialiseNewsReference(const NewsReference &reference)
Encode a NewsReference for serialisation, e.g.
Definition news_gui.cpp:939
void DeleteInvalidEngineNews()
Remove engine announcements for invalid engines.
static bool ReadyForNextNewsItem()
Are we ready to show another news item?
Definition news_gui.cpp:754
static std::list< NewsItem >::iterator DeleteNewsItem(std::list< NewsItem >::iterator ni)
Delete a news item from the queue.
Definition news_gui.cpp:839
bool HideActiveNewsMessage()
Close active news message window.
void ShowMessageHistory()
Display window with news messages history.
void ChangeVehicleNews(VehicleID from_index, VehicleID to_index)
Report a change in vehicle IDs (due to autoreplace) to affected vehicle news.
void InitNewsItemStructs()
Initialize the news-items data structures.
Definition news_gui.cpp:725
static void MoveToNextTickerItem()
Move to the next ticker item.
Definition news_gui.cpp:763
void DeleteVehicleNews(VehicleID vid, AdviceType advice_type)
Delete news with a given advice type about a vehicle.
static WindowDesc _normal_news_desc(WindowPosition::Manual, {}, 0, 0, WC_NEWS_WINDOW, WC_NONE, {}, _nested_normal_news_widgets)
Window definition for the normal news window.
const NewsContainer & GetNews()
Get read-only reference to all news items.
Definition news_gui.cpp:79
static void ShowNewsMessage(NewsIterator ni)
Do a forced show of a specific message.
static constexpr std::initializer_list< NWidgetPart > _nested_thin_news_widgets
Thin news items.
Definition news_gui.cpp:233
static NewsIterator _current_news
Current news item (last item shown regularly).
Definition news_gui.cpp:61
static WindowDesc _thin_news_desc(WindowPosition::Manual, {}, 0, 0, WC_NEWS_WINDOW, WC_NONE, {}, _nested_thin_news_widgets)
Window definition for the thin news window.
const NewsItem * GetStatusbarNews()
Get pointer to the current status bar news item.
Definition news_gui.cpp:70
static WindowDesc _small_news_desc(WindowPosition::Manual, {}, 0, 0, WC_NEWS_WINDOW, WC_NONE, {}, _nested_small_news_widgets)
Window definition for the small news window.
static constexpr std::initializer_list< NWidgetPart > _nested_company_news_widgets
Company news items.
Definition news_gui.cpp:187
static constexpr std::initializer_list< NWidgetPart > _nested_small_news_widgets
Small news items.
Definition news_gui.cpp:268
static bool ReadyForNextTickerItem()
Are we ready to show another ticker item?
Definition news_gui.cpp:739
static WindowDesc * _news_window_layout[]
Window layouts for news items.
Definition news_gui.cpp:309
static NewsIterator _statusbar_news
Current status bar news item.
Definition news_gui.cpp:64
NewsType
Type of news.
Definition news_type.h:29
@ End
end-of-array marker
Definition news_type.h:47
NewsContainer::const_iterator NewsIterator
Iterator type for news items.
Definition news_type.h:176
std::list< NewsItem > NewsContainer
Container type for storing news items.
Definition news_type.h:175
NewsStyle
News Window Styles.
Definition news_type.h:77
@ Normal
Normal news item. (Newspaper with text only).
Definition news_type.h:80
AdviceType
Sub type of the NewsType::Advice to be able to remove specific news items.
Definition news_type.h:51
@ Invalid
Invalid marker.
Definition news_type.h:62
std::variant< std::monostate, TileIndex, VehicleID, StationID, IndustryID, TownID, EngineID > NewsReference
References to objects in news.
Definition news_type.h:74
@ NoTransparency
News item disables transparency in the viewport.
Definition news_type.h:91
@ VehicleParam0
String param 0 contains a vehicle ID. (special autoreplace behaviour).
Definition news_type.h:93
@ Shaded
News item uses shaded colours.
Definition news_type.h:92
@ InColour
News item is shown in colour (otherwise it is shown in black & white).
Definition news_type.h:90
NewsDisplay
News display options.
Definition news_type.h:100
@ Summary
Show ticker.
Definition news_type.h:102
@ Full
Show newspaper.
Definition news_type.h:103
@ Off
Only show a reminder in the status bar.
Definition news_type.h:101
Types related to the news widgets.
@ WID_N_DATE
Date of the news item.
Definition news_widget.h:21
@ WID_N_PANEL
Panel of the window.
Definition news_widget.h:17
@ WID_N_CLOSEBOX
Close the window.
Definition news_widget.h:20
@ WID_N_SHOW_GROUP
Show vehicle's group.
Definition news_widget.h:34
@ WID_N_CAPTION
Title bar of the window. Only used in small news items.
Definition news_widget.h:22
@ WID_N_HEADLINE
The news headline.
Definition news_widget.h:19
@ WID_N_INSET
Inset around the viewport in the window. Only used in small news items.
Definition news_widget.h:23
@ WID_N_SHOW_GROUP_SEL
Selector for showing vehicle group, which can be hidden.
Definition news_widget.h:35
@ WID_N_VEH_TITLE
Vehicle new title.
Definition news_widget.h:29
@ WID_N_VEH_INFO
Some technical data of the new vehicle.
Definition news_widget.h:33
@ WID_N_TITLE
Title of the company news.
Definition news_widget.h:18
@ WID_N_VIEWPORT
Viewport in the window.
Definition news_widget.h:24
@ WID_N_MGR_FACE
Face of the manager.
Definition news_widget.h:27
@ WID_N_MESSAGE
Space for displaying the message. Only used in small news items.
Definition news_widget.h:26
@ WID_N_VEH_BKGND
Dark background of new vehicle news.
Definition news_widget.h:30
@ WID_N_VEH_SPR
Graphical display of the new vehicle.
Definition news_widget.h:32
@ WID_N_VEH_NAME
Name of the new vehicle.
Definition news_widget.h:31
@ WID_N_COMPANY_MSG
Message in company news items.
Definition news_widget.h:25
@ WID_N_MGR_NAME
Name of the manager.
Definition news_widget.h:28
@ WID_MH_SCROLLBAR
Scrollbar for the list.
Definition news_widget.h:42
@ WID_MH_BACKGROUND
Background of the window.
Definition news_widget.h:41
static constexpr PixelColour PC_GREY
Grey palette colour.
static constexpr PixelColour PC_BLACK
Black palette colour.
static constexpr PixelColour PC_WHITE
White palette colour.
Road vehicle states.
A number of safeguards to prevent using unsafe methods.
static const SettingDesc * GetSettingFromName(std::string_view name, const SettingTable &settings)
Given a name of setting, return a setting description from the table.
ClientSettings _settings_client
The current settings for this game.
Definition settings.cpp:60
Functions and types used internally for the settings configurations.
bool ScrollMainWindowTo(int x, int y, int z, bool instant)
Scrolls the main window to given coordinates.
Functions related to sound.
SoundFx
Sound effects from baseset.
Definition sound_type.h:46
@ SND_1D_APPLAUSE
27 == 0x1B News: first vehicle at station
Definition sound_type.h:75
@ SND_16_NEWS_TICKER
20 == 0x14 News ticker
Definition sound_type.h:68
@ SND_1E_NEW_ENGINE
28 == 0x1C News: new engine available
Definition sound_type.h:76
static const PaletteID PALETTE_NEWSPAPER
Recolour sprite for newspaper-greying.
Definition sprites.h:1618
Base classes/functions for stations.
bool IsNewsTickerShown()
Checks whether the news ticker is currently being used.
Functions, definitions and such used only by the GUI.
@ SBI_SHOW_REMINDER
show a reminder (dot on the right side of the statusbar)
@ SBI_SHOW_TICKER
start scrolling news
@ SBI_NEWS_DELETED
abort current news display (active news were deleted)
Definition of base types and functions in a cross-platform compatible way.
#define lengthof(array)
Return the length of an fixed size array.
Definition stdafx.h:271
static void StrMakeValid(Builder &builder, StringConsumer &consumer, StringValidationSettings settings)
Copies the valid (UTF-8) characters from consumer to the builder.
Definition string.cpp:119
Functions related to low-level strings.
@ ReplaceTabCrNlWithSpace
Replace tabs ('\t'), carriage returns ('\r') and newlines (' ') with spaces.
Definition string_type.h:53
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
Definition strings.cpp:424
TextDirection _current_text_dir
Text direction of the currently selected language.
Definition strings.cpp:56
Functions related to OTTD's strings.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
@ TD_RTL
Text is written right-to-left by default.
TileIndex xy
Base tile of the station.
VehicleType type
Type of vehicle.
Data that needs to be stored for company news messages.
Definition news_type.h:163
CompanyManagerFace face
The face of the president.
Definition news_type.h:169
Colours colour
The colour related to the company.
Definition news_type.h:170
std::string president_name
The name of the president.
Definition news_type.h:165
Dimensions (a width and height) of a rectangle in 2D.
int date_width
Width needed for the date part.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
int line_height
Height of a single line in the news history window including spacing.
void OnResize() override
Called after the window got resized.
Scrollbar * vscroll
Cache of the vertical scrollbar.
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Information about a single item of news.
Definition news_type.h:138
TimerGameCalendar::Date date
Calendar date to show for the news.
Definition news_type.h:140
std::unique_ptr< NewsAllocatedData > data
Custom data for the news item that will be deallocated (deleted) when the news item has reached its e...
Definition news_type.h:150
NewsType type
Type of the news.
Definition news_type.h:142
EncodedString headline
Headline of news.
Definition news_type.h:139
AdviceType advice_type
The type of advice, to be able to remove specific advices later on.
Definition news_type.h:143
TimerGameEconomy::Date economy_date
Economy date of the news item, never shown but used to calculate age.
Definition news_type.h:141
NewsItem(EncodedString &&headline, NewsType type, NewsStyle style, NewsFlags flags, NewsReference ref1, NewsReference ref2, std::unique_ptr< NewsAllocatedData > &&data, AdviceType advice_type)
Create a new newsitem to be shown.
Definition news_gui.cpp:888
NewsFlags flags
NewsFlags bits.
Definition news_type.h:145
NewsStyle style
Window style for the news.
Definition news_type.h:144
NewsReference ref2
Reference 2 to some object: Used for scrolling after clicking on the news, and for deleting the news ...
Definition news_type.h:148
NewsReference ref1
Reference 1 to some object: Used for a possible viewport, scrolling after clicking on the news,...
Definition news_type.h:147
Per-NewsType data.
Definition news_type.h:109
NewsDisplay GetDisplay() const
Return the news display option.
Definition news_gui.cpp:353
const std::string_view name
Name.
Definition news_type.h:110
Window class displaying a news item.
Definition news_gui.cpp:361
uint16_t chat_height
Height of the chat window.
Definition news_gui.cpp:362
void OnResize() override
Called after the window got resized.
Definition news_gui.cpp:614
static int duration
Remaining time for showing the current news message (may only be access while a news item is displaye...
Definition news_gui.cpp:365
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
Definition news_gui.cpp:514
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Definition news_gui.cpp:442
Point OnInitialPosition(int16_t sm_width, int16_t sm_height, int window_number) override
Compute the initial position of the window.
Definition news_gui.cpp:436
void OnRealtimeTick(uint delta_ms) override
Called periodically.
Definition news_gui.cpp:646
uint16_t status_height
Height of the status bar window.
Definition news_gui.cpp:363
const NewsItem * ni
News item to display.
Definition news_gui.cpp:364
void SetWindowTop(int newtop)
Moves the window to a new top coordinate.
Definition news_gui.cpp:668
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Definition news_gui.cpp:501
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
Definition news_gui.cpp:637
const IntervalTimer< TimerWindow > scroll_interval
Scroll the news message slowly up from the bottom.
Definition news_gui.cpp:658
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition news_gui.cpp:569
static Industry * Get(auto index)
Specification of a rectangle with absolute coordinates of all edges.
Rect WithWidth(int width, bool end) const
Copy Rect and set its width.
Rect Shrink(int s) const
Copy and shrink Rect by s pixels.
Rect Indent(int indent, bool end) const
Copy Rect and indent it from its position.
Rect Expand(int s) const
Copy and expand Rect by s pixels.
Properties of config file settings.
virtual bool IsIntSetting() const
Check whether this setting is an integer type setting.
const struct IntSettingDesc * AsIntSetting() const
Get the setting description of this setting as an integer setting.
Definition settings.cpp:922
static Station * Get(auto index)
static RoadVehicle * From(Vehicle *v)
Vehicle data structure.
int32_t z_pos
z coordinate.
int32_t y_pos
y coordinate.
int32_t x_pos
x coordinate.
High level window description.
Definition window_gui.h:168
Data structure for an opened window.
Definition window_gui.h:274
void ReInit(int rx=0, int ry=0, bool reposition=false)
Re-initialize a window, and optionally change its size.
Definition window.cpp:992
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1117
void FinishInitNested(WindowNumber window_number=0)
Perform the second part of the initialization of a nested widget tree.
Definition window.cpp:1822
std::unique_ptr< ViewportData > viewport
Pointer to viewport data, if present.
Definition window_gui.h:319
virtual std::string GetWidgetString(WidgetID widget, StringID stringid) const
Get the raw string for a widget.
Definition window.cpp:518
ResizeInfo resize
Resize information.
Definition window_gui.h:315
void CreateNestedTree()
Perform the first part of the initialization of a nested widget tree.
Definition window.cpp:1812
Owner owner
The owner of the content shown in this window. Company colour is acquired from this variable.
Definition window_gui.h:317
int left
x position of left edge of the window
Definition window_gui.h:310
int top
y position of top edge of the window
Definition window_gui.h:311
Window(WindowDesc &desc)
Empty constructor, initialization has been moved to InitNested() called from the constructor of the d...
Definition window.cpp:1846
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition window_gui.h:990
WindowFlags flags
Window flags.
Definition window_gui.h:301
const Scrollbar * GetScrollbar(WidgetID widnum) const
Return the Scrollbar to a widget index.
Definition window.cpp:327
int height
Height of the window (number of pixels down in y direction).
Definition window_gui.h:313
int width
width of the window (number of pixels to the right in x direction)
Definition window_gui.h:312
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:303
bool IsValidTile(Tile tile)
Checks if a tile is valid.
Definition tile_map.h:161
StrongType::Typedef< uint32_t, struct TileIndexTag, StrongType::Compare, StrongType::Integer, StrongType::Compatible< int32_t >, StrongType::Compatible< int64_t > > TileIndex
The index/ID of a Tile.
Definition tile_type.h:92
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:100
Definition of Interval and OneShot timers.
Definition of the game-calendar-timer.
Definition of the Window system.
Base of the town class.
PaletteID GetEnginePalette(EngineID engine_type, CompanyID company)
Get the colour map for an engine.
Definition vehicle.cpp:2160
Base class for all vehicles.
Functions related to vehicles.
void ShowVehicleViewWindow(const Vehicle *v)
Shows the vehicle view window of the given vehicle.
Functions related to the vehicle's GUIs.
@ EIT_PREVIEW
Vehicle drawn in preview window, news, ...
PoolID< uint32_t, struct VehicleIDTag, 0xFF000, 0xFFFFF > VehicleID
The type all our vehicle IDs have.
@ Ship
Ship vehicle type.
@ Aircraft
Aircraft vehicle type.
@ Road
Road vehicle type.
@ Train
Train vehicle type.
bool ScrollWindowToTile(TileIndex tile, Window *w, bool instant)
Scrolls the viewport in a window to a given location.
bool ScrollMainWindowToTile(TileIndex tile, bool instant)
Scrolls the viewport of the main window to a given location.
Functions related to (drawing on) viewports.
void DrawCaption(const Rect &r, Colours colour, Owner owner, TextColour text_colour, std::string_view str, StringAlignment align, FontSize fs)
Draw a caption bar.
Definition widget.cpp:738
@ WWT_INSET
Pressed (inset) panel, most commonly used as combo box text area.
Definition widget_type.h:40
@ WWT_LABEL
Centered label.
Definition widget_type.h:48
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:66
@ WWT_TEXTBTN
(Toggle) Button with text
Definition widget_type.h:44
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:39
@ WWT_STICKYBOX
Sticky box (at top-right of a window, after WWT_DEFSIZEBOX).
Definition widget_type.h:57
@ WWT_SHADEBOX
Shade box (at top-right of a window, between WWT_DEBUGBOX and WWT_DEFSIZEBOX).
Definition widget_type.h:55
@ WWT_CAPTION
Window caption (window title between closebox and stickybox).
Definition widget_type.h:52
@ NWID_VSCROLLBAR
Vertical scrollbar.
Definition widget_type.h:76
@ NWID_VERTICAL
Vertical container.
Definition widget_type.h:68
@ WWT_CLOSEBOX
Close box (at top-left of a window).
Definition widget_type.h:60
@ WWT_EMPTY
Empty widget, place holder to reserve space in widget tree.
Definition widget_type.h:37
@ WWT_RESIZEBOX
Resize box (normally at bottom-right of a window).
Definition widget_type.h:59
@ WWT_DEFSIZEBOX
Default window size box (at top-right of a window, between WWT_SHADEBOX and WWT_STICKYBOX).
Definition widget_type.h:56
@ NWID_VIEWPORT
Nested widget containing a viewport.
Definition widget_type.h:73
@ NWID_LAYER
Layered widgets, all visible together.
Definition widget_type.h:72
@ NWID_SELECTION
Stacked widgets, only one visible at a time (eg in a panel with tabs).
Definition widget_type.h:71
@ ShadeGrey
Shade viewport to grey-scale.
@ NoTransparency
Viewport is never transparent.
@ ShadeDimmed
Display dimmed colours in the viewport.
@ SZSP_NONE
Display plane with zero size in both directions (none filling and resizing).
void CloseWindowById(WindowClass cls, WindowNumber number, bool force, int data)
Close a window by its class and window number (if it is open).
Definition window.cpp:1209
Window * FindWindowByClass(WindowClass cls)
Find any window by its class.
Definition window.cpp:1181
int PositionNewsMessage(Window *w)
(Re)position news message window at the screen.
Definition window.cpp:3516
void InvalidateWindowData(WindowClass cls, WindowNumber number, int data, bool gui_scope)
Mark window data of the window of a given class and specific window number as invalid (in need of re-...
Definition window.cpp:3322
Window * FindWindowById(WindowClass cls, WindowNumber number)
Find a window by its class and window number.
Definition window.cpp:1166
Window functions not directly related to making/drawing windows.
@ DisableVpScroll
Window does not do autoscroll,.
Definition window_gui.h:234
@ Automatic
Find a place automatically.
Definition window_gui.h:144
@ Manual
Manually align the window (so no automatic location finding).
Definition window_gui.h:143
int WidgetID
Widget ID.
Definition window_type.h:21
@ WC_NEWS_WINDOW
News window; Window numbers:
@ WC_STATUS_BAR
Statusbar (at the bottom of your screen); Window numbers:
Definition window_type.h:70
@ WC_SEND_NETWORK_MSG
Chatbox; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:51
@ WC_MESSAGE_HISTORY
News history list; Window numbers:
Functions related to zooming.
ZoomLevel ScaleZoomGUI(ZoomLevel value)
Scale zoom level relative to GUI zoom.
Definition zoom_func.h:87
@ News
Default zoom level for the news messages.
Definition zoom_type.h:35