OpenTTD Source 20260421-master-gc2fbc6fdeb
network_content_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 "../strings_func.h"
12#include "../gfx_func.h"
13#include "../window_func.h"
14#include "../error.h"
15#include "../ai/ai.hpp"
16#include "../game/game.hpp"
17#include "../base_media_base.h"
19#include "../base_media_music.h"
21#include "../openttd.h"
22#include "../sortlist_type.h"
24#include "../querystring_gui.h"
26#include "../textfile_gui.h"
27#include "../fios.h"
28#include "network_content_gui.h"
29
30
31#include "table/strings.h"
32#include "../table/sprites.h"
33
34#include "../safeguards.h"
35
36
38static bool _accepted_external_search = false;
39
46{
47 switch (type) {
48 case ContentType::NewGRF: return STR_CONTENT_TYPE_NEWGRF;
49 case ContentType::BaseGraphics: return STR_CONTENT_TYPE_BASE_GRAPHICS;
50 case ContentType::BaseSounds: return STR_CONTENT_TYPE_BASE_SOUNDS;
51 case ContentType::BaseMusic: return STR_CONTENT_TYPE_BASE_MUSIC;
52 case ContentType::Ai: return STR_CONTENT_TYPE_AI;
53 case ContentType::AiLibrary: return STR_CONTENT_TYPE_AI_LIBRARY;
54 case ContentType::Gs: return STR_CONTENT_TYPE_GAME_SCRIPT;
55 case ContentType::GsLibrary: return STR_CONTENT_TYPE_GS_LIBRARY;
56 case ContentType::Scenario: return STR_CONTENT_TYPE_SCENARIO;
57 case ContentType::Heightmap: return STR_CONTENT_TYPE_HEIGHTMAP;
58 default: NOT_REACHED();
59 }
60}
61
63struct ContentTextfileWindow : public TextfileWindow {
64 const ContentInfo *ci = nullptr;
65
73 {
74 this->ConstructWindow();
75
76 auto textfile = this->ci->GetTextfile(file_type);
77 this->LoadTextfile(textfile.value(), GetContentInfoSubDir(this->ci->type));
78 }
79
80 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
81 {
82 if (widget == WID_TF_CAPTION) {
83 return GetString(stringid, GetContentTypeString(this->ci->type), this->ci->name);
84 }
85
86 return this->Window::GetWidgetString(widget, stringid);
87 }
88};
89
96static void ShowContentTextfileWindow(Window *parent, TextfileType file_type, const ContentInfo *ci)
97{
98 parent->CloseChildWindowById(WC_TEXTFILE, file_type);
99 new ContentTextfileWindow(parent, file_type, ci);
100}
101
103static constexpr std::initializer_list<NWidgetPart> _nested_network_content_download_status_window_widgets = {
104 NWidget(WWT_CAPTION, Colours::Grey), SetStringTip(STR_CONTENT_DOWNLOAD_TITLE, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
110 EndContainer(),
111 EndContainer(),
112};
113
116 WDP_CENTER, {}, 0, 0,
120);
121
129
131{
132 _network_content_client.RemoveCallback(this);
133 this->Window::Close();
134}
135
136void BaseNetworkContentDownloadStatusWindow::UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize)
137{
138 switch (widget) {
140 auto max_value = GetParamMaxDigits(8);
141 size = GetStringBoundingBox(GetString(STR_CONTENT_DOWNLOAD_PROGRESS_SIZE, max_value, max_value, max_value));
142 /* We need some spacing for the 'border' */
143 size.height += WidgetDimensions::scaled.frametext.Horizontal();
144 size.width += WidgetDimensions::scaled.frametext.Vertical();
145 break;
146 }
147
149 size.height = GetCharacterHeight(FontSize::Normal) * 2 + WidgetDimensions::scaled.vsep_normal;
150 break;
151 }
152}
153
155{
156 switch (widget) {
158 /* Draw the % complete with a bar and a text */
161 DrawFrameRect(ir.WithWidth((uint64_t)ir.Width() * this->downloaded_bytes / this->total_bytes, _current_text_dir == TD_RTL), Colours::Mauve, {});
162 DrawString(ir.left, ir.right, CentreBounds(ir.top, ir.bottom, GetCharacterHeight(FontSize::Normal)),
163 GetString(STR_CONTENT_DOWNLOAD_PROGRESS_SIZE, this->downloaded_bytes, this->total_bytes, this->downloaded_bytes * 100LL / this->total_bytes),
164 TC_FROMSTRING, SA_HOR_CENTER);
165 break;
166 }
167
169 if (this->downloaded_bytes == this->total_bytes) {
170 DrawStringMultiLine(r, STR_CONTENT_DOWNLOAD_COMPLETE, TC_FROMSTRING, SA_CENTER);
171 } else if (!this->name.empty()) {
173 GetString(STR_CONTENT_DOWNLOAD_FILE, this->name, this->downloaded_files, this->total_files),
174 TC_FROMSTRING, SA_CENTER);
175 } else {
176 DrawStringMultiLine(r, STR_CONTENT_DOWNLOAD_INITIALISE, TC_FROMSTRING, SA_CENTER);
177 }
178 break;
179 }
180}
181
183{
184 if (ci.id != this->cur_id) {
185 this->name = ci.filename;
186 this->cur_id = ci.id;
187 this->downloaded_files++;
188 }
189
190 /* A negative value means we are resetting; for example, when retrying or using a fallback. */
191 if (bytes < 0) {
192 this->downloaded_bytes = 0;
193 } else {
194 this->downloaded_bytes += bytes;
195 }
196
197 this->SetDirty();
198}
199
200
203private:
205
206public:
215
216 void Close([[maybe_unused]] int data = 0) override
217 {
218 TarScanner::Modes modes{};
219 for (auto ctype : this->received_types) {
220 switch (ctype) {
221 case ContentType::Ai:
223 /* AI::Rescan calls the scanner. */
224 break;
225 case ContentType::Gs:
227 /* Game::Rescan calls the scanner. */
228 break;
229
234 break;
235
237 /* ScanNewGRFFiles calls the scanner. */
238 break;
239
243 break;
244
245 default:
246 break;
247 }
248 }
249
250 TarScanner::DoScan(modes);
251
252 /* Tell all the backends about what we've downloaded */
253 for (auto ctype : this->received_types) {
254 switch (ctype) {
255 case ContentType::Ai:
257 AI::Rescan();
258 break;
259
260 case ContentType::Gs:
262 Game::Rescan();
263 break;
264
268 break;
269
273 break;
274
278 break;
279
282 break;
283
288 break;
289
290 default:
291 break;
292 }
293 }
294
295 /* Always invalidate the download window; tell it we are going to be gone */
297
299 }
300
301 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
302 {
303 if (widget == WID_NCDS_CANCELOK) {
304 if (this->downloaded_bytes != this->total_bytes) {
306 this->Close();
307 } else {
308 /* If downloading succeeded, close the online content window. This will close
309 * the current window as well. */
311 }
312 }
313 }
314
315 void OnDownloadProgress(const ContentInfo &ci, int bytes) override
316 {
318 this->received_types.Set(ci.type);
319
320 /* When downloading is finished change cancel in ok */
321 if (this->downloaded_bytes == this->total_bytes) {
322 this->GetWidget<NWidgetCore>(WID_NCDS_CANCELOK)->SetString(STR_BUTTON_OK);
323 }
324 }
325};
326
332
338
343
344 static const uint EDITBOX_MAX_SIZE = 50;
345
346 static Listing last_sorting;
348 static const std::initializer_list<GUIContentList::SortFunction * const> sorter_funcs;
349 static const std::initializer_list<GUIContentList::FilterFunction * const> filter_funcs;
351 bool auto_select = false;
355
356 const ContentInfo *selected = nullptr;
357 int list_pos = 0;
358 uint filesize_sum = 0;
359 Scrollbar *vscroll = nullptr;
360
361 static std::array<std::string, to_underlying(ContentType::End)> content_type_strs;
362
365 {
366 std::string url;
367 url.reserve(1024);
368
369 url += "https://grfsearch.openttd.org/?";
370
371 if (this->auto_select) {
372 url += "do=searchgrfid&q=";
373
374 bool first = true;
375 for (const ContentInfo *ci : this->content) {
376 if (ci->state != ContentInfo::State::DoesNotExist) continue;
377
378 if (!first) url.push_back(',');
379 first = false;
380
381 format_append(url, "{:08X}:{}", ci->unique_id, FormatArrayAsHex(ci->md5sum));
382 }
383 } else {
384 url += "do=searchtext&q=";
385
386 /* Escape search term */
387 for (char search : this->filter_editbox.text.GetText()) {
388 /* Remove quotes */
389 if (search == '\'' || search == '"') continue;
390
391 /* Escape special chars, such as &%,= */
392 if (static_cast<unsigned char>(search) < 0x30) {
393 format_append(url, "%{:02X}", search);
394 } else {
395 url.push_back(search);
396 }
397 }
398 }
399
400 OpenBrowser(url);
401 }
402
408 static void ExternalSearchDisclaimerCallback(Window *w, bool accepted)
409 {
410 if (accepted) {
412 ((NetworkContentListWindow*)w)->OpenExternalSearch();
413 }
414 }
415
421 {
422 if (!this->content.NeedRebuild()) return;
423
424 /* Create temporary array of games to use for listing */
425 this->content.clear();
426
427 bool all_available = true;
428
429 for (const ContentInfo &ci : _network_content_client.Info()) {
430 if (ci.state == ContentInfo::State::DoesNotExist) all_available = false;
431 this->content.push_back(&ci);
432 }
433
434 this->SetWidgetDisabledState(WID_NCL_SEARCH_EXTERNAL, this->auto_select && all_available);
435
436 this->FilterContentList();
437 this->content.RebuildDone();
438 this->SortContentList();
439
440 this->vscroll->SetCount(this->content.size()); // Update the scrollbar
441 this->ScrollToSelected();
442 }
443
445 static bool NameSorter(const ContentInfo * const &a, const ContentInfo * const &b)
446 {
447 int r = StrNaturalCompare(a->name, b->name, true); // Sort by name (natural sorting).
448 if (r == 0) r = StrNaturalCompare(a->version, b->version, true);
449 return r < 0;
450 }
451
453 static bool TypeSorter(const ContentInfo * const &a, const ContentInfo * const &b)
454 {
455 int r = 0;
456 if (a->type != b->type) {
458 }
459 if (r == 0) return NameSorter(a, b);
460 return r < 0;
461 }
462
464 static bool StateSorter(const ContentInfo * const &a, const ContentInfo * const &b)
465 {
466 int r = to_underlying(a->state) - to_underlying(b->state);
467 if (r == 0) return TypeSorter(a, b);
468 return r < 0;
469 }
470
473 {
474 if (!this->content.Sort()) return;
475
476 int idx = find_index(this->content, this->selected);
477 if (idx >= 0) this->list_pos = idx;
478 }
479
481 static bool TagNameFilter(const ContentInfo * const *item, ContentListFilterData &filter)
482 {
483 if ((*item)->state == ContentInfo::State::Selected || (*item)->state == ContentInfo::State::Autoselected) return true;
484
485 filter.string_filter.ResetState();
486 for (auto &tag : (*item)->tags) filter.string_filter.AddLine(tag);
487
488 filter.string_filter.AddLine((*item)->name);
489 return filter.string_filter.GetState();
490 }
491
493 static bool TypeOrSelectedFilter(const ContentInfo * const *item, ContentListFilterData &filter)
494 {
495 if (filter.types.None()) return true;
496 if (filter.types.Test((*item)->type)) return true;
497 return ((*item)->state == ContentInfo::State::Selected || (*item)->state == ContentInfo::State::Autoselected);
498 }
499
502 {
503 /* Apply filters. */
504 bool changed = false;
505 if (!this->filter_data.string_filter.IsEmpty()) {
506 this->content.SetFilterType(CONTENT_FILTER_TEXT);
507 changed |= this->content.Filter(this->filter_data);
508 }
509 if (this->filter_data.types.Any()) {
511 changed |= this->content.Filter(this->filter_data);
512 }
513 if (!changed) return;
514
515 /* update list position */
516 int idx = find_index(this->content, this->selected);
517 if (idx >= 0) {
518 this->list_pos = idx;
519 return;
520 }
521
522 /* previously selected item not in list anymore */
523 this->selected = nullptr;
524 this->list_pos = 0;
525 }
526
532 {
533 Filtering old_params = this->content.GetFiltering();
534 bool new_state = !this->filter_data.string_filter.IsEmpty() || this->filter_data.types.Any();
535 if (new_state != old_params.state) {
536 this->content.SetFilterState(new_state);
537 }
538 return new_state != old_params.state;
539 }
540
543 {
544 if (this->selected == nullptr) return;
545
546 this->vscroll->ScrollTowards(this->list_pos);
547 }
548
550public:
560 NetworkContentListWindow(WindowDesc &desc, bool select_all, ContentTypes types) :
561 Window(desc),
562 auto_select(select_all),
564 {
565 this->CreateNestedTree();
566 this->vscroll = this->GetScrollbar(WID_NCL_SCROLLBAR);
568
569 this->GetWidget<NWidgetStacked>(WID_NCL_SEL_ALL_UPDATE)->SetDisplayedPlane(select_all);
570
571 this->querystrings[WID_NCL_FILTER] = &this->filter_editbox;
572 this->filter_editbox.cancel_button = QueryString::ACTION_CLEAR;
574 this->SetWidgetDisabledState(WID_NCL_SEARCH_EXTERNAL, this->auto_select);
575 this->filter_data.types = types;
576
577 _network_content_client.AddCallback(this);
578 this->content.SetListing(this->last_sorting);
579 this->content.SetFiltering(this->last_filtering);
580 this->content.SetSortFuncs(this->sorter_funcs);
581 this->content.SetFilterFuncs(this->filter_funcs);
582 this->UpdateFilterState();
583 this->content.ForceRebuild();
584 this->FilterContentList();
585 this->SortContentList();
586 this->InvalidateData();
587 }
588
589 void Close([[maybe_unused]] int data = 0) override
590 {
591 _network_content_client.RemoveCallback(this);
592 this->Window::Close();
593 }
594
595 void OnInit() override
596 {
597 this->checkbox_size = maxdim(maxdim(GetScaledSpriteSize(SPR_BOX_EMPTY), GetScaledSpriteSize(SPR_BOX_CHECKED)), GetScaledSpriteSize(SPR_BLOT));
598 }
599
600 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
601 {
602 switch (widget) {
603 case WID_NCL_CHECKBOX:
604 size.width = std::max<uint>(this->checkbox_size.width, Window::SortButtonWidth()) + padding.width;
605 break;
606
607 case WID_NCL_TYPE: {
608 /* Width must be enough for header label and sort buttons.*/
609 size.width += Window::SortButtonWidth() * 2;
610 /* And also enough for the width of each type of content. */
611 Dimension d = size;
612 for (ContentType ct = ContentType::Begin; ct != ContentType::End; ++ct) {
614 }
615 size.width = std::max(size.width, d.width + padding.width);
616 break;
617 }
618
619 case WID_NCL_NAME:
620 size.width += Window::SortButtonWidth() * 2;
621 break;
622
623 case WID_NCL_MATRIX:
624 fill.height = resize.height = std::max<uint>(std::max<uint>(this->checkbox_size.height, GetCharacterHeight(FontSize::Normal)), GetCharacterHeight(FontSize::Small)) + padding.height;
625 size.height = 10 * resize.height;
626 break;
627 }
628 }
629
630
631 void DrawWidget(const Rect &r, WidgetID widget) const override
632 {
633 switch (widget) {
634 case WID_NCL_DETAILS:
635 this->DrawDetails(r);
636 break;
637
638 case WID_NCL_MATRIX:
639 this->DrawMatrix(r);
640 break;
641 }
642 }
643
644 void OnPaint() override
645 {
646 const SortButtonState arrow = this->content.IsDescSortOrder() ? SBS_DOWN : SBS_UP;
647
648 if (this->content.NeedRebuild()) {
649 this->BuildContentList();
650 }
651
652 this->DrawWidgets();
653
654 switch (this->content.SortType()) {
658 }
659 }
660
665 void DrawMatrix(const Rect &r) const
666 {
667 bool rtl = _current_text_dir == TD_RTL;
668 const Rect checkbox = this->GetWidget<NWidgetBase>(WID_NCL_CHECKBOX)->GetCurrentRect();
669 const Rect name = this->GetWidget<NWidgetBase>(WID_NCL_NAME)->GetCurrentRect().Shrink(WidgetDimensions::scaled.framerect);
670 const Rect type = this->GetWidget<NWidgetBase>(WID_NCL_TYPE)->GetCurrentRect().Shrink(WidgetDimensions::scaled.framerect);
671
672 /* Fill the matrix with the information */
673 const uint step_height = this->GetWidget<NWidgetBase>(WID_NCL_MATRIX)->resize_y;
674 const int text_y_offset = WidgetDimensions::scaled.matrix.top + (step_height - WidgetDimensions::scaled.matrix.Vertical() - GetCharacterHeight(FontSize::Normal)) / 2;
675 const int version_y_offset = WidgetDimensions::scaled.matrix.top + (step_height - WidgetDimensions::scaled.matrix.Vertical() - GetCharacterHeight(FontSize::Small)) / 2;
676
677 Rect mr = r.WithHeight(step_height);
678 auto [first, last] = this->vscroll->GetVisibleRangeIterators(this->content);
679 for (auto iter = first; iter != last; iter++) {
680 const ContentInfo *ci = *iter;
681
682 if (ci == this->selected) GfxFillRect(mr.Shrink(WidgetDimensions::scaled.bevel), PC_GREY);
683
684 SpriteID sprite;
685 SpriteID pal = PAL_NONE;
686 switch (ci->state) {
687 case ContentInfo::State::Unselected: sprite = SPR_BOX_EMPTY; break;
688 case ContentInfo::State::Selected: sprite = SPR_BOX_CHECKED; break;
689 case ContentInfo::State::Autoselected: sprite = SPR_BOX_CHECKED; break;
690 case ContentInfo::State::AlreadyHere: sprite = SPR_BLOT; pal = PALETTE_TO_GREEN; break;
691 case ContentInfo::State::DoesNotExist: sprite = SPR_BLOT; pal = PALETTE_TO_RED; break;
692 default: NOT_REACHED();
693 }
694 DrawSpriteIgnorePadding(sprite, pal, checkbox.WithY(mr), SA_CENTER);
695
697 DrawString(type.left, type.right, mr.top + text_y_offset, str, TC_BLACK, SA_HOR_CENTER);
698
699 int x = DrawString(name.left, name.right, mr.top + version_y_offset, ci->version, TC_BLACK, SA_RIGHT, false, FontSize::Small);
700 x += rtl ? WidgetDimensions::scaled.hsep_wide : -WidgetDimensions::scaled.hsep_wide;
701
702 DrawString(rtl ? x : name.left, rtl ? name.right : x, mr.top + text_y_offset, ci->name, TC_BLACK);
703 mr = mr.Translate(0, step_height);
704 }
705 }
706
711 void DrawDetails(const Rect &r) const
712 {
713 /* Height for the title banner */
714 int HEADER_HEIGHT = 3 * GetCharacterHeight(FontSize::Normal) + WidgetDimensions::scaled.frametext.Vertical();
715
716 Rect hr = r.WithHeight(HEADER_HEIGHT).Shrink(WidgetDimensions::scaled.frametext);
717 Rect tr = r.Shrink(WidgetDimensions::scaled.frametext);
718 tr.top += HEADER_HEIGHT;
719
720 /* Create the nice darker rectangle at the details top */
722 DrawString(hr.left, hr.right, hr.top, STR_CONTENT_DETAIL_TITLE, TC_FROMSTRING, SA_HOR_CENTER);
723
724 /* Draw the total download size */
725 DrawString(tr.left, tr.right, tr.bottom - GetCharacterHeight(FontSize::Normal) + 1, GetString(STR_CONTENT_TOTAL_DOWNLOAD_SIZE, this->filesize_sum));
726
727 if (this->selected == nullptr) return;
728
729 /* And fill the rest of the details when there's information to place there */
730 DrawStringMultiLine(hr.left, hr.right, hr.top + GetCharacterHeight(FontSize::Normal), hr.bottom, STR_CONTENT_DETAIL_SUBTITLE_UNSELECTED + to_underlying(this->selected->state), TC_FROMSTRING, SA_CENTER);
731
732 /* Also show the total download size, so keep some space from the bottom */
734
735 if (this->selected->upgrade) {
736 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_UPDATE, GetContentTypeString(this->selected->type)));
737 tr.top += WidgetDimensions::scaled.vsep_wide;
738 }
739
740 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_NAME, this->selected->name));
741
742 if (!this->selected->version.empty()) {
743 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_VERSION, this->selected->version));
744 }
745
746 if (!this->selected->description.empty()) {
747 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_DESCRIPTION, this->selected->description));
748 }
749
750 if (!this->selected->url.empty()) {
751 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_URL, this->selected->url));
752 }
753
754 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_TYPE, GetContentTypeString(this->selected->type)));
755
756 tr.top += WidgetDimensions::scaled.vsep_wide;
757 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_FILESIZE, this->selected->filesize));
758
759 std::string_view list_separator = GetListSeparator();
760 if (!this->selected->dependencies.empty()) {
761 /* List dependencies */
762 std::string buf;
763 for (auto &cid : this->selected->dependencies) {
764 /* Try to find the dependency */
765 for (const ContentInfo &ci : _network_content_client.Info()) {
766 if (ci.id != cid) continue;
767
768 if (!buf.empty()) buf += list_separator;
769 buf += ci.name;
770 break;
771 }
772 }
773 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_DEPENDENCIES, std::move(buf)));
774 }
775
776 if (!this->selected->tags.empty()) {
777 /* List all tags */
778 std::string buf;
779 for (auto &tag : this->selected->tags) {
780 if (!buf.empty()) buf += list_separator;
781 buf += tag;
782 }
783 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_TAGS, std::move(buf)));
784 }
785
786 if (this->selected->IsSelected()) {
787 /* When selected show all manually selected content that depends on this */
789 _network_content_client.ReverseLookupTreeDependency(tree, this->selected);
790
791 std::string buf;
792 for (const ContentInfo *ci : tree) {
793 if (ci == this->selected || ci->state != ContentInfo::State::Selected) continue;
794
795 if (!buf.empty()) buf += list_separator;
796 buf += ci->name;
797 }
798 if (!buf.empty()) {
799 tr.top = DrawStringMultiLine(tr, GetString(STR_CONTENT_DETAIL_SELECTED_BECAUSE_OF, std::move(buf)));
800 }
801 }
802 }
803
804 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
805 {
806 if (widget >= WID_NCL_TEXTFILE && widget < WID_NCL_TEXTFILE + TFT_CONTENT_END) {
807 if (this->selected == nullptr || this->selected->state != ContentInfo::State::AlreadyHere) return;
808
809 ShowContentTextfileWindow(this, (TextfileType)(widget - WID_NCL_TEXTFILE), this->selected);
810 return;
811 }
812
813 switch (widget) {
814 case WID_NCL_MATRIX: {
815 auto it = this->vscroll->GetScrolledItemFromWidget(this->content, pt.y, this, WID_NCL_MATRIX);
816 if (it == this->content.end()) return; // click out of bounds
817
818 const NWidgetBase *checkbox = this->GetWidget<NWidgetBase>(WID_NCL_CHECKBOX);
819 if (click_count > 1 || IsInsideBS(pt.x, checkbox->pos_x, checkbox->current_x)) {
820 _network_content_client.ToggleSelectedState(**it);
821 this->content.ForceResort();
822 this->content.ForceRebuild();
823 } else {
824 this->selected = *it;
825 this->list_pos = it - this->content.begin();
826 }
827
828 if (this->filter_data.types.Any()) {
829 this->content.ForceRebuild();
830 }
831
832 this->InvalidateData();
833 break;
834 }
835
836 case WID_NCL_CHECKBOX:
837 case WID_NCL_TYPE:
838 case WID_NCL_NAME:
839 if (this->content.SortType() == widget - WID_NCL_CHECKBOX) {
840 this->content.ToggleSortOrder();
841 if (!this->content.empty()) this->list_pos = (int)this->content.size() - this->list_pos - 1;
842 } else {
843 this->content.SetSortType(widget - WID_NCL_CHECKBOX);
844 this->content.ForceResort();
845 this->SortContentList();
846 }
847 this->ScrollToSelected();
848 this->InvalidateData();
849 break;
850
852 _network_content_client.SelectAll();
853 this->InvalidateData();
854 break;
855
857 _network_content_client.SelectUpgrade();
858 this->InvalidateData();
859 break;
860
861 case WID_NCL_UNSELECT:
862 _network_content_client.UnselectAll();
863 this->InvalidateData();
864 break;
865
866 case WID_NCL_OPEN_URL:
867 if (this->selected != nullptr) {
868 OpenBrowser(this->selected->url);
869 }
870 break;
871
872 case WID_NCL_DOWNLOAD:
874 break;
875
878 this->OpenExternalSearch();
879 } else {
880 ShowQuery(
881 GetEncodedString(STR_CONTENT_SEARCH_EXTERNAL_DISCLAIMER_CAPTION),
882 GetEncodedString(STR_CONTENT_SEARCH_EXTERNAL_DISCLAIMER),
884 }
885 break;
886 }
887 }
888
889 EventState OnKeyPress([[maybe_unused]] char32_t key, uint16_t keycode) override
890 {
891 if (this->vscroll->UpdateListPositionOnKeyPress(this->list_pos, keycode) == ES_NOT_HANDLED) {
892 switch (keycode) {
893 case WKC_SPACE:
894 case WKC_RETURN:
895 if (keycode == WKC_RETURN || !IsWidgetFocused(WID_NCL_FILTER)) {
896 if (this->selected != nullptr) {
897 _network_content_client.ToggleSelectedState(*this->selected);
898 this->content.ForceResort();
899 this->InvalidateData();
900 }
901 if (this->filter_data.types.Any()) {
902 this->content.ForceRebuild();
903 this->InvalidateData();
904 }
905 return ES_HANDLED;
906 }
907 /* space is pressed and filter is focused. */
908 [[fallthrough]];
909
910 default:
911 return ES_NOT_HANDLED;
912 }
913 }
914
915 if (this->content.empty()) {
916 if (this->UpdateFilterState()) {
917 this->content.ForceRebuild();
918 this->InvalidateData();
919 }
920 return ES_HANDLED;
921 }
922
923 this->selected = this->content[this->list_pos];
924
925 if (this->UpdateFilterState()) {
926 this->content.ForceRebuild();
927 } else {
928 /* Scroll to the new content if it is outside the current range. */
929 this->ScrollToSelected();
930 }
931
932 /* redraw window */
933 this->InvalidateData();
934 return ES_HANDLED;
935 }
936
937 void OnEditboxChanged(WidgetID wid) override
938 {
939 if (wid == WID_NCL_FILTER) {
940 this->filter_data.string_filter.SetFilterTerm(this->filter_editbox.text.GetText());
941 this->UpdateFilterState();
942 this->content.ForceRebuild();
943 this->InvalidateData();
944 }
945 }
946
947 void OnResize() override
948 {
949 this->vscroll->SetCapacityFromWidget(this, WID_NCL_MATRIX);
950 }
951
952 void OnReceiveContentInfo(const ContentInfo &rci) override
953 {
954 if (this->auto_select && !rci.IsSelected()) _network_content_client.ToggleSelectedState(rci);
955 this->content.ForceRebuild();
956 this->InvalidateData(0, false);
957 }
958
960 {
961 this->content.ForceResort();
962 this->InvalidateData();
963 }
964
965 void OnConnect(bool success) override
966 {
967 if (!success) {
968 ShowErrorMessage(GetEncodedString(STR_CONTENT_ERROR_COULD_NOT_CONNECT), {}, WL_ERROR);
969 this->Close();
970 return;
971 }
972
973 this->InvalidateData();
974 }
975
981 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
982 {
983 if (!gui_scope) return;
984 if (this->content.NeedRebuild()) this->BuildContentList();
985
986 /* To sum all the bytes we intend to download */
987 this->filesize_sum = 0;
988 bool show_select_all = false;
989 bool show_select_upgrade = false;
990 for (const ContentInfo *ci : this->content) {
991 switch (ci->state) {
994 this->filesize_sum += ci->filesize;
995 break;
996
998 show_select_all = true;
999 show_select_upgrade |= ci->upgrade;
1000 break;
1001
1002 default:
1003 break;
1004 }
1005 }
1006
1007 /* If data == 2 then the status window caused this OnInvalidate */
1009 this->SetWidgetDisabledState(WID_NCL_UNSELECT, this->filesize_sum == 0);
1010 this->SetWidgetDisabledState(WID_NCL_SELECT_ALL, !show_select_all);
1011 this->SetWidgetDisabledState(WID_NCL_SELECT_UPDATE, !show_select_upgrade || !this->filter_data.string_filter.IsEmpty());
1012 this->SetWidgetDisabledState(WID_NCL_OPEN_URL, this->selected == nullptr || this->selected->url.empty());
1013 for (TextfileType tft = TFT_CONTENT_BEGIN; tft < TFT_CONTENT_END; tft++) {
1014 this->SetWidgetDisabledState(WID_NCL_TEXTFILE + tft, this->selected == nullptr || this->selected->state != ContentInfo::State::AlreadyHere || !this->selected->GetTextfile(tft).has_value());
1015 }
1016 }
1017};
1018
1021
1022const std::initializer_list<NetworkContentListWindow::GUIContentList::SortFunction * const> NetworkContentListWindow::sorter_funcs = {
1023 &StateSorter,
1024 &TypeSorter,
1025 &NameSorter,
1026};
1027
1028const std::initializer_list<NetworkContentListWindow::GUIContentList::FilterFunction * const> NetworkContentListWindow::filter_funcs = {
1031};
1032
1034
1044
1046static constexpr std::initializer_list<NWidgetPart> _nested_network_content_list_widgets = {
1049 NWidget(WWT_CAPTION, Colours::LightBlue), SetStringTip(STR_CONTENT_TITLE),
1051 EndContainer(),
1054 /* Top */
1058 SetStringTip(STR_LIST_FILTER_OSKTITLE, STR_LIST_FILTER_TOOLTIP),
1059 EndContainer(),
1060 /* Lists and info. */
1062 /* Left side. */
1069 SetStringTip(STR_CONTENT_TYPE_CAPTION, STR_CONTENT_TYPE_CAPTION_TOOLTIP),
1071 SetStringTip(STR_CONTENT_NAME_CAPTION, STR_CONTENT_NAME_CAPTION_TOOLTIP),
1072 EndContainer(),
1074 EndContainer(),
1076 EndContainer(),
1080 SetStringTip(STR_CONTENT_SELECT_UPDATES_CAPTION, STR_CONTENT_SELECT_UPDATES_CAPTION_TOOLTIP),
1082 SetStringTip(STR_CONTENT_SELECT_ALL_CAPTION, STR_CONTENT_SELECT_ALL_CAPTION_TOOLTIP),
1083 EndContainer(),
1085 SetStringTip(STR_CONTENT_UNSELECT_ALL_CAPTION, STR_CONTENT_UNSELECT_ALL_CAPTION_TOOLTIP),
1086 EndContainer(),
1087 EndContainer(),
1088 /* Right side. */
1091 EndContainer(),
1094 NWidget(WWT_PUSHTXTBTN, Colours::White, WID_NCL_OPEN_URL), SetResize(1, 0), SetFill(1, 0), SetStringTip(STR_CONTENT_OPEN_URL, STR_CONTENT_OPEN_URL_TOOLTIP),
1095 NWidget(WWT_PUSHTXTBTN, Colours::White, WID_NCL_TEXTFILE + TFT_README), SetFill(1, 0), SetResize(1, 0), SetStringTip(STR_TEXTFILE_VIEW_README, STR_TEXTFILE_VIEW_README_TOOLTIP),
1096 EndContainer(),
1098 NWidget(WWT_PUSHTXTBTN, Colours::White, WID_NCL_TEXTFILE + TFT_CHANGELOG), SetFill(1, 0), SetResize(1, 0), SetStringTip(STR_TEXTFILE_VIEW_CHANGELOG, STR_TEXTFILE_VIEW_CHANGELOG_TOOLTIP),
1099 NWidget(WWT_PUSHTXTBTN, Colours::White, WID_NCL_TEXTFILE + TFT_LICENSE), SetFill(1, 0), SetResize(1, 0), SetStringTip(STR_TEXTFILE_VIEW_LICENCE, STR_TEXTFILE_VIEW_LICENCE_TOOLTIP),
1100 EndContainer(),
1101 EndContainer(),
1102 EndContainer(),
1103 EndContainer(),
1104 /* Bottom. */
1107 SetStringTip(STR_CONTENT_SEARCH_EXTERNAL, STR_CONTENT_SEARCH_EXTERNAL_TOOLTIP),
1109 SetStringTip(STR_CONTENT_DOWNLOAD_CAPTION, STR_CONTENT_DOWNLOAD_CAPTION_TOOLTIP),
1110 EndContainer(),
1111 EndContainer(),
1112 /* Resize button. */
1114 NWidget(NWID_SPACER), SetFill(1, 0), SetResize(1, 0),
1116 EndContainer(),
1117 EndContainer(),
1118};
1119
1122 WDP_CENTER, "list_content", 630, 460,
1124 {},
1126);
1127
1136{
1137#if defined(WITH_ZLIB)
1138 ContentTypes types{};
1140 if (cv == nullptr) {
1141 assert(type1 != ContentType::End || type2 == ContentType::End);
1142 assert(type1 == ContentType::End || type1 != type2);
1143 _network_content_client.RequestContentList(type1);
1144 if (type2 != ContentType::End) _network_content_client.RequestContentList(type2);
1145
1146 if (type1 != ContentType::End) types.Set(type1);
1147 if (type2 != ContentType::End) types.Set(type2);
1148 } else {
1149 _network_content_client.RequestContentList(cv, true);
1150 }
1151
1153 new NetworkContentListWindow(_network_content_list_desc, cv != nullptr, types);
1154#else
1156 GetEncodedString(STR_CONTENT_NO_ZLIB),
1157 GetEncodedString(STR_CONTENT_NO_ZLIB_SUB),
1158 WL_ERROR);
1159#endif /* WITH_ZLIB */
1160}
Base functions for all AIs.
Generic functions for replacing base data (graphics, sounds).
Generic functions for replacing base graphics data.
Generic functions for replacing base music data.
Generic functions for replacing base sounds data.
static void Rescan()
Rescans all searchpaths for available AIs.
Definition ai_core.cpp:318
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr bool None() const
Test if none of the values are set.
constexpr Timpl & Set()
Set all bits.
constexpr bool Any(const Timpl &other) const
Test if any of the given values are set.
uint32_t cur_id
The current ID of the downloaded file.
BaseNetworkContentDownloadStatusWindow(WindowDesc &desc)
Create the window with the given description.
uint downloaded_bytes
Number of bytes downloaded.
uint total_files
Number of files to download.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
void OnDownloadProgress(const ContentInfo &ci, int bytes) override
We have progress in the download of a file.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
std::string name
The current name of the downloaded file.
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.
uint downloaded_files
Number of files downloaded.
uint total_bytes
Number of bytes to download.
List template of 'things' T to sort in a GUI.
bool Filter(FilterFunction *decide, F filter_data)
Filter the list.
void RebuildDone()
Notify the sortlist that the rebuild is done.
void SetFiltering(Filtering f)
Import filter conditions.
void SetListing(Listing l)
Import sort conditions.
void SetFilterState(bool state)
Enable or disable the filter.
bool IsDescSortOrder() const
Check if the sort order is descending.
void ToggleSortOrder()
Toggle the sort order Since that is the worst condition for the sort function reverse the list here.
void SetFilterFuncs(std::span< FilterFunction *const > n_funcs)
Hand the filter function pointers to the GUIList.
Filtering GetFiltering() const
Export current filter conditions.
bool NeedRebuild() const
Check if a rebuild is needed.
void SetFilterType(uint8_t n_type)
Set the filtertype of the list.
void ForceRebuild()
Force that a rebuild is needed.
bool Sort(Comp compare)
Sort the list.
void ForceResort()
Force a resort next Sort call Reset the resort timer if used too.
uint8_t SortType() const
Get the sorttype of the list.
void SetSortFuncs(std::span< SortFunction *const > n_funcs)
Hand the sort function pointers to the GUIList.
void SetSortType(uint8_t n_type)
Set the sorttype of the list.
static void Rescan()
Rescans all searchpaths for available Game scripts.
Baseclass for nested widgets.
uint current_x
Current horizontal size (after resizing).
int pos_x
Horizontal position of top-left corner of the widget in the window.
Window that lists the content that's at the content server.
EventState OnKeyPress(char32_t key, uint16_t keycode) override
A key has been pressed.
static bool NameSorter(const ContentInfo *const &a, const ContentInfo *const &b)
Sort content by name.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
void DrawDetails(const Rect &r) const
Helper function to draw the details part of this window.
void OpenExternalSearch()
Search external websites for content.
void DrawMatrix(const Rect &r) const
Draw/fill the matrix with the list of content to download.
void OnResize() override
Called after the window got resized.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
void OnReceiveContentInfo(const ContentInfo &rci) override
We received a content info.
GUIContentList content
List with content.
uint filesize_sum
The sum of all selected file sizes.
bool auto_select
Automatically select all content when the meta-data becomes available.
ContentListFilterData filter_data
Filter for content list.
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.
static Filtering last_filtering
The last filtering setting.
QueryString filter_editbox
Filter editbox;.
static const std::initializer_list< GUIContentList::SortFunction *const > sorter_funcs
Sorter functions.
static Listing last_sorting
The last sorting setting.
int list_pos
Our position in the list.
const ContentInfo * selected
The selected content info.
void OnInit() override
Notification that the nested widget tree gets initialized.
static const std::initializer_list< GUIContentList::FilterFunction *const > filter_funcs
Filter functions.
static bool TypeSorter(const ContentInfo *const &a, const ContentInfo *const &b)
Sort content by type.
void SortContentList()
Sort the content list.
static void ExternalSearchDisclaimerCallback(Window *w, bool accepted)
Callback function for disclaimer about entering external websites.
static bool TypeOrSelectedFilter(const ContentInfo *const *item, ContentListFilterData &filter)
Filter content by type, but still show content selected for download.
bool UpdateFilterState()
Update filter state based on current window state.
void OnPaint() override
The window must be repainted.
NetworkContentListWindow(WindowDesc &desc, bool select_all, ContentTypes types)
Create the content list window.
GUIList< const ContentInfo *, std::nullptr_t, ContentListFilterData & > GUIContentList
List with content infos.
static const uint EDITBOX_MAX_SIZE
Maximum size of the editbox in characters.
void OnEditboxChanged(WidgetID wid) override
The text in an editbox has been edited.
static std::array< std::string, to_underlying(ContentType::End)> content_type_strs
Cached strings for all content types.
static bool TagNameFilter(const ContentInfo *const *item, ContentListFilterData &filter)
Filter content by tags/name.
void OnDownloadComplete(ContentID) override
We have finished downloading a file.
void BuildContentList()
(Re)build the network game list as its amount has changed because an item has been added or deleted f...
void OnConnect(bool success) override
Callback for when the connection has finished.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
Scrollbar * vscroll
Cache of the vertical scrollbar.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
friend void BuildContentTypeStringList()
Build array of all strings corresponding to the content types.
void FilterContentList()
Filter the content list.
Dimension checkbox_size
Size of checkbox/"blot" sprite.
void ScrollToSelected()
Make sure that the currently selected content info is within the visible part of the matrix.
static bool StateSorter(const ContentInfo *const &a, const ContentInfo *const &b)
Sort content by state.
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
EventState UpdateListPositionOnKeyPress(int &list_position, uint16_t keycode) const
Update the given list position as if it were on this scroll bar when the given keycode was pressed.
Definition widget.cpp:2479
void ScrollTowards(size_type position)
Scroll towards the given position; if the item is visible nothing happens, otherwise it will be shown...
auto GetVisibleRangeIterators(Tcontainer &container) const
Get a pair of iterators for the range of visible elements in a container.
@ Scenario
Scan for scenarios and heightmaps.
Definition fileio_func.h:67
@ Baseset
Scan for base sets.
Definition fileio_func.h:64
uint DoScan(Subdirectory sd)
Perform the scanning of a particular subdirectory.
Definition fileio.cpp:380
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
int find_index(Container const &container, typename Container::const_reference item)
Helper function to get the index of an item Consider using std::set, std::unordered_set or std::flat_...
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
Functions related to errors.
@ WL_ERROR
Errors (eg. saving/loading failed).
Definition error.h:26
void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, CommandCost &cc)
Display an error message in a window.
void ScanScenarios()
Force a (re)scan of the scenarios.
Definition fios.cpp:681
Declarations for savegames operations.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:88
Base functions for all Games.
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.
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
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
Functions related to the gfx engine.
Dimension GetScaledSpriteSize(SpriteID sprid)
Scale sprite size for GUI.
Definition widget.cpp:70
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition gfx_type.h:17
@ Small
Index of the small font in the font tables.
Definition gfx_type.h:250
@ Normal
Index of the normal font in the font tables.
Definition gfx_type.h:249
@ SA_RIGHT
Right align the text (must be a single bit).
Definition gfx_type.h:390
@ SA_HOR_CENTER
Horizontally center the text.
Definition gfx_type.h:389
@ SA_CENTER
Center both horizontally and vertically.
Definition gfx_type.h:398
@ SA_VERT_CENTER
Vertically center the text.
Definition gfx_type.h:394
@ White
White.
Definition gfx_type.h:300
@ Mauve
Mauve.
Definition gfx_type.h:295
@ Invalid
Invalid marker.
Definition gfx_type.h:302
@ LightBlue
Light blue.
Definition gfx_type.h:290
@ Grey
Grey.
Definition gfx_type.h:299
constexpr NWidgetPart SetMatrixDataTip(uint32_t cols, uint32_t rows, StringID tip={})
Widget part function for setting the data and tooltip of WWT_MATRIX widgets.
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetResizeWidgetTypeTip(ResizeWidgetType widget_type, StringID tip)
Widget part function for setting the resize widget type and tooltip.
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 SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
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.
void SetDirty() const
Mark entire window as dirty (in need of re-paint).
Definition window.cpp:980
#define Point
Macro that prevents name conflicts between included headers.
constexpr bool IsInsideBS(const T x, const size_t base, const size_t size)
Checks if a value is between a window started at some base point.
void ShowQuery(EncodedString &&caption, EncodedString &&message, Window *parent, QueryCallbackProc *callback, bool focus)
Show a confirmation window with standard 'yes' and 'no' buttons The window is aligned to the centre o...
@ WID_TF_CAPTION
The caption of the window.
Definition misc_widget.h:53
ClientNetworkContentSocketHandler _network_content_client
The client we use to connect to the server.
std::vector< std::unique_ptr< ContentInfo > > ContentVector
Vector with content info.
std::vector< const ContentInfo * > ConstContentVector
Vector with constant content info.
static bool _accepted_external_search
Whether the user accepted to enter external websites during this session.
static void ShowContentTextfileWindow(Window *parent, TextfileType file_type, const ContentInfo *ci)
Open the window with one of the text files associated with content.
static constexpr std::initializer_list< NWidgetPart > _nested_network_content_list_widgets
The widgets for the content list.
static StringID GetContentTypeString(ContentType type)
Get the string associated with a ContentType.
void ShowNetworkContentListWindow(ContentVector *cv, ContentType type1, ContentType type2)
Show the content list window with a given set of content.
static constexpr std::initializer_list< NWidgetPart > _nested_network_content_download_status_window_widgets
Nested widgets for the download window.
ContentListFilterCriteria
Filter criteria for NetworkContentListWindow.
@ CONTENT_FILTER_TYPE_OR_SELECTED
Filter by being of displayed type or selected for download.
@ CONTENT_FILTER_TEXT
Filter by query string.
static WindowDesc _network_content_download_status_window_desc(WDP_CENTER, {}, 0, 0, WC_NETWORK_STATUS_WINDOW, WC_NONE, WindowDefaultFlag::Modal, _nested_network_content_download_status_window_widgets)
Window description for the download window.
static WindowDesc _network_content_list_desc(WDP_CENTER, "list_content", 630, 460, WC_NETWORK_WINDOW, WC_NONE, {}, _nested_network_content_list_widgets)
Window description of the content list.
void BuildContentTypeStringList()
Build array of all strings corresponding to the content types.
User interface for downloading files.
@ WID_NCL_CHECKBOX
Button above checkboxes.
@ WID_NCL_NAME
'Name' button.
@ WID_NCL_TYPE
'Type' button.
@ WID_NCL_SEARCH_EXTERNAL
Search external sites for missing NewGRF.
@ WID_NCL_DETAILS
Panel with content details.
@ WID_NCL_SEL_ALL_UPDATE
NWID_SELECTION widget for select all/update buttons..
@ WID_NCL_SELECT_ALL
'Select all' button.
@ WID_NCL_FILTER
Filter editbox.
@ WID_NCL_FILTER_CAPT
Caption for the filter editbox.
@ WID_NCL_DOWNLOAD
'Download' button.
@ WID_NCL_SCROLLBAR
Scrollbar of matrix.
@ WID_NCL_SELECT_UPDATE
'Select updates' button.
@ WID_NCL_TEXTFILE
Open readme, changelog (+1) or license (+2) of a file in the content window.
@ WID_NCL_MATRIX
Panel with list of content.
@ WID_NCL_BACKGROUND
Resize button.
@ WID_NCL_UNSELECT
'Unselect all' button.
@ WID_NCL_OPEN_URL
'Open url' button.
@ WID_NCDS_CANCELOK
(Optional) Cancel/OK button.
@ WID_NCDS_PROGRESS_TEXT
Text explaining what is happening.
@ WID_NCDS_PROGRESS_BAR
Simple progress bar.
bool RequestNewGRFScan(NewGRFScanCallback *callback)
Request a new NewGRF scan.
Definition openttd.cpp:1325
Some generic types.
PixelColour GetColourGradient(Colours colour, ColourShade shade)
Get colour gradient palette index.
Definition palette.cpp:393
static constexpr PixelColour PC_GREY
Grey palette colour.
Base for the GUIs that have an edit box in them.
A number of safeguards to prevent using unsafe methods.
Base types for having sorted lists in GUIs.
This file contains all sprite-related enums and defines.
Definition of base types and functions in a cross-platform compatible way.
std::string FormatArrayAsHex(std::span< const uint8_t > data)
Format a byte array into a continuous hex string.
Definition string.cpp:77
int StrNaturalCompare(std::string_view s1, std::string_view s2, bool ignore_garbage_at_front)
Compares two strings using case insensitive natural sort.
Definition string.cpp:429
Searching and filtering using a stringterm.
std::string_view GetListSeparator()
Get the list separator string for the current language.
Definition strings.cpp:299
EncodedString GetEncodedString(StringID str)
Encode a string with no parameters into an encoded string.
Definition strings.cpp:90
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
uint64_t GetParamMaxDigits(uint count, FontSize size)
Get some number that is suitable for string size computations.
Definition strings.cpp:218
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.
Callbacks for notifying others about incoming data.
Container for all important information about a piece of content.
uint32_t filesize
Size of the file.
std::string url
URL related to the content.
State state
Whether the content info is selected (for download).
std::string name
Name of the content.
std::string description
Description of the content.
std::optional< std::string > GetTextfile(TextfileType type) const
Search a textfile file next to this file in the content list.
std::string version
Version of the content.
ContentID id
Unique (server side) ID for the content.
std::string filename
Filename (for the .tar.gz; only valid on download).
bool IsSelected() const
Is the state either selected or autoselected?
ContentType type
Type of content.
std::vector< ContentID > dependencies
The dependencies (unique server side ids).
@ Unselected
The content has not been selected.
@ AlreadyHere
The content is already at the client side.
@ Selected
The content has been manually selected.
@ Autoselected
The content has been selected as dependency.
@ DoesNotExist
The content does not exist in the content system.
StringList tags
Tags associated with the content.
bool upgrade
This item is an upgrade.
Filter data for NetworkContentListWindow.
StringFilter string_filter
Text filter of content list.
ContentTypes types
Content types displayed.
Window for displaying the textfile of an item in the content list.
ContentTextfileWindow(Window *parent, TextfileType file_type, const ContentInfo *ci)
Create the window with one of the text files associated with content.
const ContentInfo * ci
View the textfile of this ContentInfo.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Dimensions (a width and height) of a rectangle in 2D.
Data structure describing what to show in the list (filter criteria).
bool state
Filter on/off.
Data structure describing how to show the list (what sort direction and criteria).
Window for showing the download status of content.
void OnDownloadProgress(const ContentInfo &ci, int bytes) override
We have progress in the download of a file.
ContentTypes received_types
Types we received so we can update their cache.
NetworkContentDownloadStatusWindow()
Create a new download window based on a list of content information with flags whether to download th...
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
Data stored about a string that can be modified in the GUI.
int cancel_button
Widget button of parent window to simulate when pressing CANCEL in OSK.
static const int ACTION_CLEAR
Clear editbox.
Specification of a rectangle with absolute coordinates of all edges.
Rect Shrink(int s) const
Copy and shrink Rect by s pixels.
Rect WithHeight(int height, bool end=false) const
Copy Rect and set its height.
Rect WithY(int new_top, int new_bottom) const
Create a new Rect, replacing the top and bottom coordiates.
Rect Translate(int x, int y) const
Copy and translate Rect by x,y pixels.
String filter and state.
bool IsEmpty() const
Check whether any filter words were entered.
void SetFilterTerm(std::string_view str)
Set the term to filter on.
void ResetState()
Reset the matching state to process a new item.
bool GetState() const
Get the matching state of the current item.
std::string_view GetText() const
Get the current text.
Definition textbuf.cpp:284
TextfileType file_type
Type of textfile to view.
virtual void LoadTextfile(const std::string &textfile, Subdirectory dir)
Loads the textfile text from file and setup lines.
High level window description.
Definition window_gui.h:168
Data structure for an opened window.
Definition window_gui.h:274
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
static int SortButtonWidth()
Get width of up/down arrow of sort button state.
Definition widget.cpp:835
void FinishInitNested(WindowNumber window_number=0)
Perform the second part of the initialization of a nested widget tree.
Definition window.cpp:1822
std::map< WidgetID, QueryString * > querystrings
QueryString associated to WWT_EDITBOX widgets.
Definition window_gui.h:321
void DrawWidgets() const
Paint all widgets of a window.
Definition widget.cpp:786
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window's data as invalid (in need of re-computing).
Definition window.cpp:3262
Window * parent
Parent window.
Definition window_gui.h:329
virtual std::string GetWidgetString(WidgetID widget, StringID stringid) const
Get the raw string for a widget.
Definition window.cpp:518
void DrawSortButtonState(WidgetID widget, SortButtonState state) const
Draw a sort button's up or down arrow symbol.
Definition widget.cpp:818
ResizeInfo resize
Resize information.
Definition window_gui.h:315
bool IsWidgetFocused(WidgetID widget_index) const
Check if given widget is focused within this window.
Definition window_gui.h:421
void CreateNestedTree()
Perform the first part of the initialization of a nested widget tree.
Definition window.cpp:1812
void CloseChildWindowById(WindowClass wc, WindowNumber number) const
Close all children a window might have in a head-recursive manner.
Definition window.cpp:1104
bool SetFocusedWidget(WidgetID widget_index)
Set focus within this window to the given widget.
Definition window.cpp:499
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
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition window.cpp:1836
const Scrollbar * GetScrollbar(WidgetID widnum) const
Return the Scrollbar to a widget index.
Definition window.cpp:327
void SetWidgetDisabledState(WidgetID widget_index, bool disab_stat)
Sets the enabled/disabled status of a widget.
Definition window_gui.h:382
Subdirectory GetContentInfoSubDir(ContentType type)
Helper to get the subdirectory a ContentInfo is located in.
uint32_t ContentID
Unique identifier for the content.
ContentType
The values in the enum are important; they are received over the network from the content servers.
@ BaseSounds
The content consists of base sounds.
@ Begin
Helper to mark the begin of the types.
@ GsLibrary
The content consists of a GS library.
@ Scenario
The content consists of a scenario.
@ Heightmap
The content consists of a heightmap.
@ BaseGraphics
The content consists of base graphics.
@ Ai
The content consists of an AI.
@ End
Helper to mark the end of the types.
@ BaseMusic
The content consists of base music.
@ Gs
The content consists of a game script.
@ NewGRF
The content consists of a NewGRF.
@ AiLibrary
The content consists of an AI library.
EnumBitSet< ContentType, uint16_t, ContentType::End > ContentTypes
Bitset of chosen content types.
GUI functions related to textfiles.
TextfileType
Additional text files accompanying Tar archives.
@ TFT_LICENSE
Content license.
@ TFT_README
Content readme.
@ TFT_CONTENT_END
This marker is used to generate the above three buttons in sequence by various of places in the code.
@ TFT_CHANGELOG
Content changelog.
void DrawFrameRect(int left, int top, int right, int bottom, Colours colour, FrameFlags flags)
Draw frame rectangle.
Definition widget.cpp:309
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
@ NWID_SPACER
Invisible widget that takes some space.
Definition widget_type.h:70
@ WWT_EDITBOX
a textbox for typing
Definition widget_type.h:62
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:66
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:39
@ WWT_MATRIX
Grid of rows and columns.
Definition widget_type.h:50
@ 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
@ WWT_TEXT
Pure simple text.
Definition widget_type.h:49
@ NWID_SELECTION
Stacked widgets, only one visible at a time (eg in a panel with tabs).
Definition widget_type.h:71
@ EqualSize
Containers should keep all their (resizing) children equally large.
@ HideBevel
Bevel of resize box is hidden.
Definition widget_type.h:29
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
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 * BringWindowToFrontById(WindowClass cls, WindowNumber number)
Find a window and make it the relative top-window on the screen.
Definition window.cpp:1293
Window * FindWindowById(WindowClass cls, WindowNumber number)
Find a window by its class and window number.
Definition window.cpp:1166
void SetWindowDirty(WindowClass cls, WindowNumber number)
Mark window as dirty (in need of repainting).
Definition window.cpp:3200
Window functions not directly related to making/drawing windows.
@ Modal
The window is a modal child of some other window, meaning the parent is 'inactive'.
Definition window_gui.h:154
@ BorderOnly
Draw border only, no background.
Definition window_gui.h:26
@ Lowered
If set the frame is lowered and the background colour brighter (ie. buttons when pressed).
Definition window_gui.h:27
SortButtonState
State of a sort direction button.
Definition window_gui.h:217
@ SBS_DOWN
Sort ascending.
Definition window_gui.h:219
@ SBS_UP
Sort descending.
Definition window_gui.h:220
@ WDP_CENTER
Center the window.
Definition window_gui.h:145
int WidgetID
Widget ID.
Definition window_type.h:21
@ WN_NETWORK_WINDOW_CONTENT_LIST
Network content list.
Definition window_type.h:42
@ WN_NETWORK_STATUS_WINDOW_CONTENT_DOWNLOAD
Network content download status.
Definition window_type.h:46
@ WN_GAME_OPTIONS_GAME_OPTIONS
Game options.
Definition window_type.h:32
EventState
State of handling an event.
@ ES_HANDLED
The passed event is handled.
@ ES_NOT_HANDLED
The passed event is not handled.
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:51
@ WC_GAME_OPTIONS
Game options window; Window numbers:
@ WC_NETWORK_WINDOW
Network window; Window numbers:
@ WC_TEXTFILE
textfile; Window numbers:
@ WC_SAVELOAD
Saveload window; Window numbers:
@ WC_NETWORK_STATUS_WINDOW
Network status window; Window numbers: