Freeciv-3.2
Loading...
Searching...
No Matches
helpdlg.c
Go to the documentation of this file.
1/***********************************************************************
2 Freeciv - Copyright (C) 1996 - A Kjeldberg, L Gregersen, P Unold
3 This program is free software; you can redistribute it and/or modify
4 it under the terms of the GNU General Public License as published by
5 the Free Software Foundation; either version 2, or (at your option)
6 any later version.
7
8 This program is distributed in the hope that it will be useful,
9 but WITHOUT ANY WARRANTY; without even the implied warranty of
10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 GNU General Public License for more details.
12***********************************************************************/
13
14#ifdef HAVE_CONFIG_H
15#include <fc_config.h>
16#endif
17
18#include <stdio.h>
19#include <stdlib.h>
20#include <string.h>
21#include <math.h> /* sqrt */
22
23#include <gtk/gtk.h>
24
25/* utility */
26#include "fcintl.h"
27#include "mem.h"
28#include "shared.h"
29#include "support.h"
30
31/* common */
32#include "city.h"
33#include "game.h"
34#include "government.h"
35#include "movement.h"
36#include "nation.h"
37#include "specialist.h"
38#include "tech.h"
39#include "unit.h"
40#include "map.h"
41#include "research.h"
42#include "version.h"
43
44/* client */
45#include "client_main.h"
46#include "climisc.h"
47#include "helpdata.h"
48#include "options.h"
49#include "tilespec.h"
50
51/* client/gui-gtk-3.22 */
52#include "colors.h"
53#include "graphics.h"
54#include "gui_main.h"
55#include "gui_stuff.h"
56
57#include "helpdlg.h"
58
59#define TECH_TREE_DEPTH 20
60
61/*
62 * Globals.
63 */
64static GtkWidget *help_dialog_shell;
65static GtkWidget *help_view_sw;
66
67static GtkWidget *help_view;
68
69static GtkWidget *help_frame;
70static int help_frame_width = 520, help_frame_height = 350;
71static GtkTextBuffer *help_text;
72static GtkWidget *help_text_sw;
73static GtkWidget *help_vbox;
74static GtkWidget *help_tile;
75static GtkWidget *help_box;
76static GtkWidget *help_itable;
77static GtkWidget *help_wtable;
78static GtkWidget *help_utable;
79static GtkWidget *help_ttable;
80static GtkWidget *help_etable;
81static GtkWidget *help_tree;
82static GtkTreeStore *tstore;
83
84static GtkWidget *help_tree_sw;
85static GtkWidget *help_tree_expand;
86static GtkWidget *help_tree_collapse;
87static GtkWidget *help_tree_buttons_hbox;
88static GtkWidget *help_ilabel[6];
89static GtkWidget *help_wlabel[6];
90static GtkWidget *help_ulabel[5][5];
91static GtkWidget *help_tlabel[2][5];
92static GtkWidget *help_elabel[6];
93
94static bool help_advances[A_LAST];
95
96static GPtrArray *help_history;
97static int help_history_pos;
98
99struct help_page_selection
100{
101 enum { HPAGE_SRC_ENUM, HPAGE_SRC_REQ } type;
102 union {
103 enum help_page_type page;
104 const struct requirement *req;
105 } u;
106};
107
108static const char *help_ilabel_name[6] =
109{ N_("Base Cost:"), NULL, N_("Upkeep:"), NULL, N_("Requirement:"), NULL };
110static struct help_page_selection help_impr_req;
111
112static const char *help_wlabel_name[6] =
113{ N_("Base Cost:"), NULL, N_("Requirement:"), NULL, N_("Obsolete by:"), NULL };
114static struct help_page_selection help_wndr_req;
115
116static struct help_page_selection page_selections[HELP_LAST];
117
118static const char *help_ulabel_name[5][5] =
119{
120 { N_("Cost:"), NULL, NULL, N_("Attack:"), NULL },
121 { N_("Defense:"), NULL, NULL, N_("Move:"), NULL },
122 { N_("Firepower:"), NULL, NULL, N_("Hitpoints:"), NULL },
123 { N_("Basic Upkeep:"), NULL, NULL, N_("Vision:"), NULL },
124 { N_("Requirement:"), NULL, NULL, N_("Obsolete by:"), NULL }
125};
126
127static const char *help_tlabel_name[2][5] =
128{
129 { N_("Move/Defense:"), NULL, NULL, N_("Food/Res/Trade:"), NULL },
130 { N_("Resources:"), NULL, NULL, NULL, NULL }
131};
132
133static const char *help_elabel_name[6] =
134/* TRANS: Label for build cost for extras in help. Will be followed by
135 * something like "3 MP" (where MP = Movement Points) */
136{ N_("Build:"), NULL,
137/* TRANS: Extra conflicts in help. Will be followed by a list of extras
138 * that can't be built on the same tile as this one. */
139 N_("Conflicts with:"), NULL,
140/* TRANS: Extra bonus in help. Will be followed by food/production/trade
141 * stats like "0/0/+1", "0/+50%/0" */
142 N_("Bonus (F/P/T):"), NULL };
143
144#define REQ_LABEL_NONE _("?tech:None")
145#define REQ_LABEL_NEVER _("(Never)")
146
147static void create_help_dialog(void);
148static void help_update_dialog(const struct help_item *pitem);
149
150static void select_help_item_string(const char *item,
151 enum help_page_type htype);
152static void help_command_update(void);
153static void help_command_callback(GtkWidget *w, gint response_id);
154
155/**********************************************************************/
170
171/**********************************************************************/
174static void set_title_topic(char *topic)
175{
176 if (strcmp(topic, _(HELP_ABOUT_ITEM)) == 0) {
177 gtk_frame_set_label(GTK_FRAME(help_frame), freeciv_name_version());
178 } else {
179 gtk_frame_set_label(GTK_FRAME(help_frame), topic);
180 }
181 return;
182}
183
184/**********************************************************************/
193
194/**********************************************************************/
208
209/**********************************************************************/
217
218/**********************************************************************/
227static void create_tech_tree(int tech, int levels, GtkTreeIter *parent)
228{
229 const struct research *presearch;
230 int bg;
231 int turns_to_tech;
232 bool original;
233 GtkTreeIter l;
234 GValue value = { 0, };
235 enum tech_state state;
236
237 if (advance_required(tech, AR_ONE) == A_LAST
238 && advance_required(tech, AR_TWO) == A_LAST) {
239 bg = COLOR_REQTREE_UNKNOWN;
240
241 gtk_tree_store_append(tstore, &l, parent);
242 help_advances[tech] = TRUE;
243
244 g_value_init(&value, G_TYPE_STRING);
245 g_value_set_static_string(&value, _("Removed"));
246 gtk_tree_store_set_value(tstore, &l, 0, &value);
247 g_value_unset(&value);
248
249 gtk_tree_store_set(tstore, &l,
250 1, -1,
251 2, tech,
252 3, &get_color(tileset, bg)->color
253 -1);
254 return;
255 }
256
257 presearch = research_get(client_player());
258
259 state = research_invention_state(presearch, tech);
260 if (tech_state_is_valid(state)) {
261 switch (state) {
262 case TECH_UNKNOWN:
263 bg = COLOR_REQTREE_UNKNOWN;
264 break;
265 case TECH_KNOWN:
266 bg = COLOR_REQTREE_KNOWN;
267 break;
268 case TECH_PREREQS_KNOWN:
269 bg = COLOR_REQTREE_PREREQS_KNOWN;
270 break;
271 }
272 } else {
273 bg = COLOR_REQTREE_BACKGROUND;
274 }
275 turns_to_tech = research_goal_unknown_techs(presearch, tech);
276
277 /* l is the original in the tree. */
278 original = !help_advances[tech];
279
280 gtk_tree_store_append(tstore, &l, parent);
281 help_advances[tech] = TRUE;
282
283 g_value_init(&value, G_TYPE_STRING);
284 g_value_set_static_string(&value,
285 research_advance_name_translation(presearch,
286 tech));
287 gtk_tree_store_set_value(tstore, &l, 0, &value);
288 g_value_unset(&value);
289
290 gtk_tree_store_set(tstore, &l,
291 1, turns_to_tech,
292 2, tech,
293 3, &get_color(tileset, bg)->color,
294 -1);
295
296 if (--levels <= 0) {
297 return;
298 }
299
300 if (original) {
301 /* only add children to orginals */
302 if (advance_required(tech, AR_ONE) != A_NONE)
303 create_tech_tree(advance_required(tech, AR_ONE), levels, &l);
304 if (advance_required(tech, AR_TWO) != A_NONE)
305 create_tech_tree(advance_required(tech, AR_TWO), levels, &l);
306 }
307 return;
308}
309
310/**********************************************************************/
326
327/**********************************************************************/
334
335/**********************************************************************/
342
343/**********************************************************************/
346static void help_hyperlink_callback(GtkWidget *w)
347{
348 const char *s;
349 struct help_page_selection *select;
350 enum help_page_type type = HELP_LAST;
351
352 s = gtk_label_get_text(GTK_LABEL(w));
353 select = (struct help_page_selection *)(g_object_get_data(G_OBJECT(w), "page_type"));
354
355 switch (select->type) {
356 case HPAGE_SRC_ENUM:
357 type = select->u.page;
358 break;
359 case HPAGE_SRC_REQ:
360 type = help_type_by_requirement(select->u.req);
361 break;
362 }
363
364 if (type == HELP_LAST) {
365 return;
366 }
367
368 /* FIXME: May be able to skip, or may need to modify, advances[A_NONE]
369 below, depending on which i18n is done elsewhere.
370 */
371 if (strcmp(s, REQ_LABEL_NEVER) != 0
372 && strcmp(s, skip_intl_qualifier_prefix(REQ_LABEL_NONE)) != 0
373 && strcmp(s, advance_name_translation(advance_by_number(A_NONE))) != 0) {
374 select_help_item_string(s, type);
375 }
376}
377
378/**********************************************************************/
381static GtkWidget *help_hyperlink_new(GtkWidget *label,
382 struct help_page_selection *select)
383{
384 GtkWidget *button;
385
386 button = gtk_button_new();
387 gtk_button_set_relief(GTK_BUTTON(button), GTK_RELIEF_NONE);
388 gtk_widget_set_halign(label, GTK_ALIGN_CENTER);
389 gtk_widget_set_valign(label, GTK_ALIGN_CENTER);
390 gtk_widget_set_name(label, "help_link");
391 gtk_container_add(GTK_CONTAINER(button), label);
392 gtk_widget_show(button);
393 g_signal_connect_swapped(button, "clicked",
394 G_CALLBACK(help_hyperlink_callback), label);
395 g_object_set_data(G_OBJECT(label), "page_type", select);
396
397 return button;
398}
399
400/**********************************************************************/
403static GtkWidget *help_hyperlink_new_page(GtkWidget *label,
404 enum help_page_type page)
405{
406 return help_hyperlink_new(label, &(page_selections[page]));
407}
408
409/**********************************************************************/
412static GtkWidget *help_slink_new(const gchar *txt,
413 struct help_page_selection *select)
414{
415 GtkWidget *button, *label;
416
417 label = gtk_label_new(txt);
418 gtk_widget_set_halign(label, GTK_ALIGN_CENTER);
419 gtk_widget_set_valign(label, GTK_ALIGN_CENTER);
420 button = help_hyperlink_new(label, select);
421
422 return button;
423}
424
425/**********************************************************************/
428static GtkWidget *help_slink_new_page(const gchar *txt,
429 enum help_page_type page)
430{
431 return help_slink_new(txt, &(page_selections[page]));
432}
433
434/**********************************************************************/
457
458/**********************************************************************/
466
467/**********************************************************************/
470static void activated_topic(GtkTreeView *view, gpointer data)
471{
472 GtkTreePath *path;
473 GtkTreeViewColumn *col;
474 GtkTreeModel *model;
475 GtkTreeIter it;
476 struct help_item *pitem;
477
478 model = gtk_tree_view_get_model(view);
479
480 gtk_tree_view_get_cursor(view, &path, &col);
481 gtk_tree_model_get_iter(model, &it, path);
482 gtk_tree_path_free(path);
483
484 if (!path) {
485 return;
486 }
487
488 gtk_tree_model_get(model, &it, 1, &pitem, -1);
489
490 if (help_history_pos >= 0
491 && g_ptr_array_index(help_history, help_history_pos) == (gpointer) pitem) {
492 return;
493 }
494
495 help_update_dialog(pitem);
496
497 /* add to history. */
498 if (help_history_pos < help_history->len - 1) {
499 g_ptr_array_set_size(help_history, help_history_pos + 1);
500 }
501 help_history_pos++;
502
503 g_ptr_array_add(help_history, (gpointer)pitem);
504 help_command_update();
505}
506
507/**********************************************************************/
510static void create_help_dialog(void)
511{
512 GtkWidget *hbox;
513 GtkWidget *button;
514 GtkWidget *text;
515 int i, j;
516 GtkCellRenderer *rend;
517 GtkTreeViewColumn *col;
518 GArray *array;
519 GtkTreeStore *store;
520 GtkTreeSelection *selection;
521
522 help_history = g_ptr_array_new();
523 help_history_pos = -1;
524
525 help_dialog_shell = gtk_dialog_new_with_buttons(_("Freeciv Help Browser"),
526 NULL,
527 0,
528 _("_Back"),
529 1,
530 _("_Forward"),
531 2,
532 _("_Close"),
533 GTK_RESPONSE_CLOSE,
534 NULL);
535 setup_dialog(help_dialog_shell, toplevel);
536 gtk_dialog_set_default_response(GTK_DIALOG(help_dialog_shell),
537 GTK_RESPONSE_CLOSE);
538 gtk_widget_set_name(help_dialog_shell, "Freeciv");
539
540 g_signal_connect(help_dialog_shell, "response",
541 G_CALLBACK(help_command_callback), NULL);
542 g_signal_connect(help_dialog_shell, "destroy",
543 G_CALLBACK(help_destroy_callback), NULL);
544
545 hbox = gtk_grid_new();
546 gtk_grid_set_column_spacing(GTK_GRID(hbox), 5);
547 gtk_container_add(GTK_CONTAINER(gtk_dialog_get_content_area(GTK_DIALOG(help_dialog_shell))), hbox);
548 gtk_widget_show(hbox);
549
550 /* build tree store. */
551 store = gtk_tree_store_new(2, G_TYPE_STRING, G_TYPE_POINTER);
552
553 array = g_array_new(FALSE, FALSE, sizeof(GtkTreeIter));
554 help_items_iterate(pitem) {
555 GtkTreeIter *it, *parent;
556 const char *s;
557 int depth;
558
559 for (s = pitem->topic; *s == ' '; s++) {
560 /* nothing */
561 }
562 depth = s - pitem->topic;
563
564 array = g_array_set_size(array, depth+1);
565
566 if (depth > 0) {
567 parent = &g_array_index(array, GtkTreeIter, depth-1);
568 } else {
569 parent = NULL;
570 }
571
572 it = &g_array_index(array, GtkTreeIter, depth);
573 gtk_tree_store_append(store, it, parent);
574
575 gtk_tree_store_set(store, it, 0, pitem->topic, 1, pitem, -1);
576 } help_items_iterate_end;
577
578
579 /* create tree view. */
580 help_view = gtk_tree_view_new_with_model(GTK_TREE_MODEL(store));
581 g_object_unref(store);
582 gtk_tree_view_columns_autosize(GTK_TREE_VIEW(help_view));
583 gtk_tree_view_set_headers_visible(GTK_TREE_VIEW(help_view), FALSE);
584
585 g_signal_connect(help_view, "cursor-changed",
586 G_CALLBACK(activated_topic), NULL);
587
588 selection = gtk_tree_view_get_selection(GTK_TREE_VIEW(help_view));
589 gtk_tree_selection_set_mode(selection, GTK_SELECTION_BROWSE);
590
591 rend = gtk_cell_renderer_text_new();
592 col = gtk_tree_view_column_new_with_attributes(NULL, rend, "text", 0, NULL);
593 gtk_tree_view_append_column(GTK_TREE_VIEW(help_view), col);
594
595 help_view_sw = gtk_scrolled_window_new(NULL, NULL);
596 gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(help_view_sw),
597 GTK_POLICY_AUTOMATIC, GTK_POLICY_AUTOMATIC);
598 gtk_widget_set_size_request(help_view_sw, 190, -1);
599 gtk_container_add(GTK_CONTAINER(help_view_sw), help_view);
600 gtk_widget_show(help_view);
601 gtk_container_add(GTK_CONTAINER(hbox), help_view_sw);
602 gtk_widget_show(help_view_sw);
603
604 help_frame = gtk_frame_new("");
605 gtk_container_add(GTK_CONTAINER(hbox), help_frame);
606 gtk_widget_set_size_request(help_frame, help_frame_width, help_frame_height);
607 gtk_widget_show(help_frame);
608
609 help_box = gtk_grid_new();
610 gtk_grid_set_row_spacing(GTK_GRID(help_box), 5);
611 gtk_orientable_set_orientation(GTK_ORIENTABLE(help_box),
612 GTK_ORIENTATION_VERTICAL);
613 gtk_container_add(GTK_CONTAINER(help_frame), help_box);
614
615 help_tile = gtk_image_new();
616 gtk_container_add(GTK_CONTAINER(help_box), help_tile);
617
618 help_itable = gtk_grid_new();
619 gtk_container_add(GTK_CONTAINER(help_box), help_itable);
620
621 for (i = 0; i < 6; i++) {
622 help_ilabel[i] =
623 gtk_label_new(help_ilabel_name[i] != NULL ? _(help_ilabel_name[i]) : "");
624 gtk_widget_set_hexpand(help_ilabel[i], TRUE);
625
626 if (i == 5) {
627 button = help_hyperlink_new(help_ilabel[i], &help_impr_req);
628 gtk_grid_attach(GTK_GRID(help_itable), button, i, 0, 1, 1);
629 } else {
630 gtk_grid_attach(GTK_GRID(help_itable), help_ilabel[i], i, 0, 1, 1);
631 gtk_widget_set_name(help_ilabel[i], "help_label");
632 }
633
634 gtk_widget_show(help_ilabel[i]);
635 }
636
637 help_wtable = gtk_grid_new();
638 gtk_container_add(GTK_CONTAINER(help_box), help_wtable);
639
640 for (i = 0; i < 6; i++) {
641 help_wlabel[i] =
642 gtk_label_new(help_wlabel_name[i] ? _(help_wlabel_name[i]) : "");
643 gtk_widget_set_hexpand(help_wlabel[i], TRUE);
644
645 if (i == 3 || i == 5) {
646 button = help_hyperlink_new(help_wlabel[i], &help_wndr_req);
647 gtk_grid_attach(GTK_GRID(help_wtable), button, i, 0, 1, 1);
648 } else {
649 gtk_grid_attach(GTK_GRID(help_wtable), help_wlabel[i], i, 0, 1, 1);
650 gtk_widget_set_name(help_wlabel[i], "help_label");
651 }
652
653 gtk_widget_show(help_wlabel[i]);
654 }
655
656 help_utable = gtk_grid_new();
657 gtk_container_add(GTK_CONTAINER(help_box), help_utable);
658
659 for (i = 0; i < 5; i++) {
660 for (j = 0; j < 5; j++) {
661 help_ulabel[j][i] =
662 gtk_label_new(help_ulabel_name[j][i] ? _(help_ulabel_name[j][i]) : "");
663 gtk_widget_set_hexpand(help_ulabel[j][i], TRUE);
664
665 if (j == 4 && (i == 1 || i == 4)) {
666 if (i == 1) {
667 button = help_hyperlink_new_page(help_ulabel[j][i], HELP_TECH);
668 } else {
669 button = help_hyperlink_new_page(help_ulabel[j][i], HELP_UNIT);
670 }
671
672 gtk_grid_attach(GTK_GRID(help_utable), button, i, j, 1, 1);
673 } else {
674 gtk_grid_attach(GTK_GRID(help_utable), help_ulabel[j][i],
675 i, j, 1, 1);
676 gtk_widget_set_name(help_ulabel[j][i], "help_label");
677 }
678 gtk_widget_show(help_ulabel[j][i]);
679 }
680 }
681
682 help_ttable = gtk_grid_new();
683 gtk_container_add(GTK_CONTAINER(help_box), help_ttable);
684
685 for (j = 0; j < 2; j++) {
686 for (i = 0; i < 5; i++) {
687 help_tlabel[j][i] =
688 gtk_label_new(help_tlabel_name[j][i] ? _(help_tlabel_name[j][i]) : "");
689 gtk_widget_set_hexpand(help_tlabel[j][i], TRUE);
690 gtk_widget_set_name(help_tlabel[j][i], "help_label");
691
692 /* Ugly (but these numbers are hardcoded in help_update_terrain() too) */
693 if (j == 1 && i == 1) {
694 /* Extra wide cell for terrain specials */
695 gtk_grid_attach(GTK_GRID(help_ttable), help_tlabel[j][i],
696 i, j, 4, 1);
697 gtk_widget_show(help_tlabel[j][i]);
698 break; /* skip rest of row */
699 } else {
700 gtk_grid_attach(GTK_GRID(help_ttable), help_tlabel[j][i],
701 i, j, 1, 1);
702 gtk_widget_show(help_tlabel[j][i]);
703 }
704 }
705 }
706
707 help_etable = gtk_grid_new();
708 gtk_container_add(GTK_CONTAINER(help_box), help_etable);
709
710 for (i = 0; i < 6; i++) {
711 help_elabel[i] =
712 gtk_label_new(help_elabel_name[i] ? _(help_elabel_name[i]) : "");
713 gtk_widget_set_hexpand(help_elabel[i], TRUE);
714 gtk_grid_attach(GTK_GRID(help_etable), help_elabel[i], i % 4, i / 4, 1, 1);
715 gtk_widget_set_name(help_elabel[i], "help_label");
716 gtk_widget_show(help_elabel[i]);
717 }
718
719 help_vbox = gtk_grid_new();
720 gtk_grid_set_row_spacing(GTK_GRID(help_vbox), 1);
721 gtk_orientable_set_orientation(GTK_ORIENTABLE(help_vbox),
722 GTK_ORIENTATION_VERTICAL);
723 gtk_container_set_border_width(GTK_CONTAINER(help_vbox), 5);
724 gtk_container_add(GTK_CONTAINER(help_box), help_vbox);
725
726 text = gtk_text_view_new();
727 gtk_widget_set_hexpand(text, TRUE);
728 gtk_widget_set_vexpand(text, TRUE);
729 gtk_text_view_set_cursor_visible(GTK_TEXT_VIEW(text), FALSE);
730 gtk_text_view_set_editable(GTK_TEXT_VIEW(text), FALSE);
731 gtk_container_set_border_width(GTK_CONTAINER(text), 5);
732 gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(text), GTK_WRAP_WORD);
733 gtk_widget_set_name(text, "help_text");
734 help_text = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text));
735 gtk_widget_show(text);
736
737 help_text_sw = gtk_scrolled_window_new(NULL, NULL);
738 gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(help_text_sw),
739 GTK_POLICY_AUTOMATIC, GTK_POLICY_ALWAYS);
740 gtk_container_add(GTK_CONTAINER(help_text_sw), text);
741 gtk_container_add(GTK_CONTAINER(help_box), help_text_sw);
742
743 /* build tech store. */
744 tstore = gtk_tree_store_new(4,
745 G_TYPE_STRING, /* tech name */
746 G_TYPE_INT, /* turns to tech */
747 G_TYPE_INT, /* tech id */
748 GDK_TYPE_RGBA); /* color */
749 help_tree = gtk_tree_view_new_with_model(GTK_TREE_MODEL(tstore));
750 gtk_widget_set_hexpand(help_tree, TRUE);
751 gtk_widget_set_vexpand(help_tree, TRUE);
752 g_object_unref(tstore);
753 gtk_tree_view_set_headers_visible(GTK_TREE_VIEW(help_tree), FALSE);
754
755 g_signal_connect(help_tree, "row_activated",
756 G_CALLBACK(help_tech_tree_activated_callback), NULL);
757
758
759 col = gtk_tree_view_column_new();
760
761 rend = gtk_cell_renderer_text_new();
762 g_object_set(rend, "weight", PANGO_WEIGHT_BOLD, NULL);
763 gtk_tree_view_column_pack_start(col, rend, TRUE);
764 gtk_tree_view_column_set_attributes(col, rend,
765 "text", 0,
766 "background-rgba", 3,
767 NULL);
768 rend = gtk_cell_renderer_text_new();
769 g_object_set(rend, "weight", PANGO_WEIGHT_BOLD, "xalign", 1.0, NULL);
770 gtk_tree_view_column_pack_start(col, rend, FALSE);
771 gtk_tree_view_column_set_attributes(col, rend,
772 "text", 1,
773 "background-rgba", 3,
774 NULL);
775
776 gtk_tree_view_append_column(GTK_TREE_VIEW(help_tree), col);
777
778
779 help_tree_sw = gtk_scrolled_window_new(NULL, NULL);
780 gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(help_tree_sw),
781 GTK_POLICY_AUTOMATIC, GTK_POLICY_AUTOMATIC);
782 gtk_container_add(GTK_CONTAINER(help_tree_sw), help_tree);
783 gtk_widget_show(help_tree);
784 gtk_container_add(GTK_CONTAINER(help_box), help_tree_sw);
785
786 help_tree_expand
787 = gtk_button_new_with_label(_("Expand All"));
788 help_tree_collapse = gtk_button_new_with_label(_("Collapse All"));
789
790 g_signal_connect(help_tree_expand, "clicked",
791 G_CALLBACK(help_tech_tree_expand_callback), help_tree);
792 g_signal_connect(help_tree_collapse, "clicked",
793 G_CALLBACK(help_tech_tree_collapse_callback), help_tree);
794
795 help_tree_buttons_hbox = gtk_button_box_new(GTK_ORIENTATION_HORIZONTAL);
796 gtk_container_add(GTK_CONTAINER(help_tree_buttons_hbox), help_tree_expand);
797 gtk_container_add(GTK_CONTAINER(help_tree_buttons_hbox), help_tree_collapse);
798 gtk_container_add(GTK_CONTAINER(help_box), help_tree_buttons_hbox);
799 gtk_widget_show_all(help_tree_buttons_hbox);
800}
801
802/**********************************************************************/
805static void set_help_tile_from_sprite(struct sprite *spr)
806{
807 if (spr == NULL) {
808 return;
809 }
810
811 gtk_image_set_from_surface(GTK_IMAGE(help_tile), spr->surface);
812 gtk_widget_show(help_tile);
813}
814
815/**********************************************************************/
845
846/**********************************************************************/
873
874/**********************************************************************/
877static void help_update_improvement(const struct help_item *pitem,
878 char *title)
879{
880 char buf[8192];
881 struct impr_type *imp = improvement_by_translated_name(title);
882
883 if (imp && !is_great_wonder(imp)) {
884 const char *req = skip_intl_qualifier_prefix(REQ_LABEL_NONE);
885 char req_buf[512];
886
887 sprintf(buf, "%d", impr_base_build_shield_cost(imp));
888 gtk_label_set_text(GTK_LABEL(help_ilabel[1]), buf);
889 sprintf(buf, "%d", imp->upkeep);
890 gtk_label_set_text(GTK_LABEL(help_ilabel[3]), buf);
891
892 /* FIXME: this should show ranges, negated reqs, and all the
893 * MAX_NUM_REQS reqs.
894 * Currently it's limited to 1 req but this code is partially prepared
895 * to be extended. Remember MAX_NUM_REQS is a compile-time
896 * definition. */
897 help_impr_req.u.req = NULL;
898 requirement_vector_iterate(&imp->reqs, preq) {
899 if (!preq->present) {
900 continue;
901 }
902 req = universal_name_translation(&preq->source, req_buf, sizeof(req_buf));
903 help_impr_req.u.req = preq;
904 break;
905 } requirement_vector_iterate_end;
906 gtk_label_set_text(GTK_LABEL(help_ilabel[5]), req);
907/* create_tech_tree(help_improvement_tree, 0, imp->tech_req, 3);*/
908 } else {
909 gtk_label_set_text(GTK_LABEL(help_ilabel[1]), "0");
910 gtk_label_set_text(GTK_LABEL(help_ilabel[3]), "0");
911 gtk_label_set_text(GTK_LABEL(help_ilabel[5]), REQ_LABEL_NEVER);
912/* create_tech_tree(help_improvement_tree, 0, advance_count(), 3);*/
913 }
914
915 set_help_tile_from_sprite(get_building_sprite(tileset, imp));
916
917 gtk_widget_show(help_itable);
918
919 helptext_building(buf, sizeof(buf), client.conn.playing, pitem->text, imp);
920 gtk_text_buffer_set_text(help_text, buf, -1);
921 gtk_widget_show(help_text_sw);
922}
923
924/**********************************************************************/
927static void help_update_wonder(const struct help_item *pitem,
928 char *title)
929{
930 char buf[8192];
931 struct impr_type *imp = improvement_by_translated_name(title);
932
933 if (imp && is_great_wonder(imp)) {
934 int i;
935 char req_buf[512];
936
937 sprintf(buf, "%d", impr_base_build_shield_cost(imp));
938 gtk_label_set_text(GTK_LABEL(help_wlabel[1]), buf);
939
940 /* FIXME: this should show ranges, negated reqs, and all the
941 * MAX_NUM_REQS reqs.
942 * Currently it's limited to 1 req but this code is partially prepared
943 * to be extended. Remember MAX_NUM_REQS is a compile-time
944 * definition. */
945 i = 0;
946 help_wndr_req.u.req = NULL;
947 requirement_vector_iterate(&imp->reqs, preq) {
948 if (!preq->present) {
949 continue;
950 }
951 gtk_label_set_text(GTK_LABEL(help_wlabel[3 + i]),
952 universal_name_translation(&preq->source,
953 req_buf, sizeof(req_buf)));
954 help_wndr_req.u.req = preq;
955 i++;
956 break;
957 } requirement_vector_iterate_end;
958
959 gtk_label_set_text(GTK_LABEL(help_wlabel[5]), REQ_LABEL_NEVER);
960 requirement_vector_iterate(&imp->obsolete_by, pobs) {
961 if (pobs->source.kind == VUT_ADVANCE && pobs->present) {
962 gtk_label_set_text(GTK_LABEL(help_wlabel[5]),
963 advance_name_translation
964 (pobs->source.value.advance));
965
966 break;
967 }
968 } requirement_vector_iterate_end;
969
970/* create_tech_tree(help_improvement_tree, 0, imp->tech_req, 3);*/
971 } else {
972 /* can't find wonder */
973 gtk_label_set_text(GTK_LABEL(help_wlabel[1]), "0");
974 gtk_label_set_text(GTK_LABEL(help_wlabel[3]), REQ_LABEL_NEVER);
975 gtk_label_set_text(GTK_LABEL(help_wlabel[5]), skip_intl_qualifier_prefix(REQ_LABEL_NONE));
976/* create_tech_tree(help_improvement_tree, 0, advance_count(), 3); */
977 }
978
979 set_help_tile_from_sprite(get_building_sprite(tileset, imp));
980
981 gtk_widget_show(help_wtable);
982
983 helptext_building(buf, sizeof(buf), client.conn.playing, pitem->text, imp);
984 gtk_text_buffer_set_text(help_text, buf, -1);
985 gtk_widget_show(help_text_sw);
986}
987
988/**********************************************************************/
991static void help_update_unit_type(const struct help_item *pitem,
992 char *title)
993{
994 char buf[8192];
995 struct unit_type *utype = unit_type_by_translated_name(title);
996
997 if (utype) {
998 sprintf(buf, "%d", utype_build_shield_cost_base(utype));
999 gtk_label_set_text(GTK_LABEL(help_ulabel[0][1]), buf);
1000 sprintf(buf, "%d", utype->attack_strength);
1001 gtk_label_set_text(GTK_LABEL(help_ulabel[0][4]), buf);
1002 sprintf(buf, "%d", utype->defense_strength);
1003 gtk_label_set_text(GTK_LABEL(help_ulabel[1][1]), buf);
1004 sprintf(buf, "%s", move_points_text(utype->move_rate, TRUE));
1005 gtk_label_set_text(GTK_LABEL(help_ulabel[1][4]), buf);
1006 sprintf(buf, "%d", utype->firepower);
1007 gtk_label_set_text(GTK_LABEL(help_ulabel[2][1]), buf);
1008 sprintf(buf, "%d", utype->hp);
1009 gtk_label_set_text(GTK_LABEL(help_ulabel[2][4]), buf);
1010 gtk_label_set_text(GTK_LABEL(help_ulabel[3][1]),
1011 helptext_unit_upkeep_str(utype));
1012 sprintf(buf, "%d", (int)sqrt((double)utype->vision_radius_sq));
1013 gtk_label_set_text(GTK_LABEL(help_ulabel[3][4]), buf);
1014 gtk_label_set_text(GTK_LABEL(help_ulabel[4][1]),
1015 advance_name_translation(utype_primary_tech_req(utype)));
1016/* create_tech_tree(help_improvement_tree, 0, advance_number(utype->require_advance), 3);*/
1017 if (U_NOT_OBSOLETED == utype->obsoleted_by) {
1018 gtk_label_set_text(GTK_LABEL(help_ulabel[4][4]), skip_intl_qualifier_prefix(REQ_LABEL_NONE));
1019 } else {
1020 gtk_label_set_text(GTK_LABEL(help_ulabel[4][4]),
1021 utype_name_translation(utype->obsoleted_by));
1022 }
1023
1024 helptext_unit(buf, sizeof(buf), client.conn.playing, pitem->text, utype,
1025 TRUE);
1026
1027 gtk_text_buffer_set_text(help_text, buf, -1);
1028 gtk_widget_show(help_text_sw);
1029
1030 set_help_tile_from_sprite(get_unittype_sprite(tileset, utype,
1031 ACTIVITY_LAST,
1032 direction8_invalid()));
1033 } else {
1034 gtk_label_set_text(GTK_LABEL(help_ulabel[0][1]), "0");
1035 gtk_label_set_text(GTK_LABEL(help_ulabel[0][4]), "0");
1036 gtk_label_set_text(GTK_LABEL(help_ulabel[1][1]), "0");
1037 gtk_label_set_text(GTK_LABEL(help_ulabel[1][4]), "0");
1038 gtk_label_set_text(GTK_LABEL(help_ulabel[2][1]), "0");
1039 gtk_label_set_text(GTK_LABEL(help_ulabel[2][4]), "0");
1040 gtk_label_set_text(GTK_LABEL(help_ulabel[3][1]), "0");
1041 gtk_label_set_text(GTK_LABEL(help_ulabel[3][4]), "0");
1042
1043 gtk_label_set_text(GTK_LABEL(help_ulabel[4][1]), REQ_LABEL_NEVER);
1044/* create_tech_tree(help_improvement_tree, 0, A_LAST, 3);*/
1045 gtk_label_set_text(GTK_LABEL(help_ulabel[4][4]), skip_intl_qualifier_prefix(REQ_LABEL_NONE));
1046
1047 gtk_text_buffer_set_text(help_text, buf, -1);
1048 gtk_widget_show(help_text_sw);
1049 }
1050 gtk_widget_show(help_utable);
1051}
1052
1053/**********************************************************************/
1056static char *fc_chomp(char *str, size_t len)
1057{
1058 gchar *i;
1059
1060 if (!str || !*str) {
1061 return str;
1062 }
1063
1064 i = str + len;
1065 for (i = g_utf8_find_prev_char(str, i);
1066 (i && g_unichar_isspace(g_utf8_get_char(i)));
1067 i = g_utf8_find_prev_char(str, i)) {
1068 *i = '\0';
1069 }
1070 return str;
1071}
1072
1073/**********************************************************************/
1076static void help_update_tech(const struct help_item *pitem, char *title)
1077{
1078 int i, j;
1079 GtkWidget *w, *hbox;
1080 char buf[8192];
1081 struct advance *padvance = advance_by_translated_name(title);
1082
1083 if (padvance && !is_future_tech(i = advance_number(padvance))) {
1084 GtkTextBuffer *txt;
1085 size_t len;
1086
1087 gtk_container_foreach(GTK_CONTAINER(help_vbox), (GtkCallback)gtk_widget_destroy, NULL);
1088
1089 for (j = 0; j < ARRAY_SIZE(help_advances); j++) {
1090 help_advances[j] = FALSE;
1091 }
1092 gtk_tree_store_clear(tstore);
1093 create_tech_tree(i, TECH_TREE_DEPTH, NULL);
1094 gtk_widget_show(help_tree_sw);
1095 gtk_widget_show(help_tree_buttons_hbox);
1096
1097 helptext_advance(buf, sizeof(buf), client.conn.playing, pitem->text, i);
1098 len = strlen(buf);
1099 fc_chomp(buf, len);
1100
1101 set_help_tile_from_sprite(get_tech_sprite(tileset, i));
1102
1103 w = gtk_text_view_new();
1104 gtk_widget_set_hexpand(w, TRUE);
1105 gtk_widget_set_vexpand(w, TRUE);
1106 gtk_text_view_set_cursor_visible(GTK_TEXT_VIEW(w), FALSE);
1107 gtk_text_view_set_wrap_mode(GTK_TEXT_VIEW(w), GTK_WRAP_WORD);
1108 gtk_widget_set_name(w, "help_text");
1109 gtk_container_set_border_width(GTK_CONTAINER(w), 5);
1110 gtk_text_view_set_editable(GTK_TEXT_VIEW(w), FALSE);
1111 gtk_container_add(GTK_CONTAINER(help_vbox), w);
1112 gtk_widget_show(w);
1113
1114 txt = gtk_text_view_get_buffer(GTK_TEXT_VIEW(w));
1115 if (txt) {
1116 gtk_text_buffer_set_text(txt, buf, -1);
1117 }
1118
1119 w = gtk_separator_new(GTK_ORIENTATION_HORIZONTAL);
1120 g_object_set(w, "margin", 5, NULL);
1121 gtk_widget_set_hexpand(w, TRUE);
1122 gtk_widget_set_vexpand(w, TRUE);
1123 gtk_container_add(GTK_CONTAINER(help_vbox), w);
1124 gtk_widget_show(w);
1125
1126 governments_iterate(pgov) {
1127 /* FIXME: need a more general mechanism for this, since this
1128 * helptext needs to be shown in all possible req source types. */
1129 requirement_vector_iterate(&pgov->reqs, preq) {
1130 if (VUT_ADVANCE == preq->source.kind
1131 && preq->source.value.advance == padvance) {
1132 hbox = gtk_grid_new();
1133 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1134 w = gtk_label_new(_("Allows"));
1135 gtk_container_add(GTK_CONTAINER(hbox), w);
1136 w = help_slink_new_page(government_name_translation(pgov),
1137 HELP_GOVERNMENT);
1138 gtk_container_add(GTK_CONTAINER(hbox), w);
1139 gtk_widget_show_all(hbox);
1140 }
1141 } requirement_vector_iterate_end;
1142 } governments_iterate_end;
1143
1144 improvement_iterate(pimprove) {
1145 if (valid_improvement(pimprove)) {
1146 requirement_vector_iterate(&pimprove->reqs, preq) {
1147 if (VUT_ADVANCE == preq->source.kind
1148 && preq->source.value.advance == padvance) {
1149 hbox = gtk_grid_new();
1150 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1151 w = gtk_label_new(_("Allows"));
1152 gtk_container_add(GTK_CONTAINER(hbox), w);
1153 w = help_slink_new_page(improvement_name_translation(pimprove),
1154 is_great_wonder(pimprove)
1155 ? HELP_WONDER
1156 : HELP_IMPROVEMENT);
1157 gtk_container_add(GTK_CONTAINER(hbox), w);
1158 gtk_widget_show_all(hbox);
1159 }
1160 } requirement_vector_iterate_end;
1161 requirement_vector_iterate(&pimprove->obsolete_by, pobs) {
1162 if (pobs->source.kind == VUT_ADVANCE
1163 && pobs->source.value.advance == padvance
1164 && pobs->present) {
1165 hbox = gtk_grid_new();
1166 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1167 w = gtk_label_new(_("Obsoletes"));
1168 gtk_container_add(GTK_CONTAINER(hbox), w);
1169 w = help_slink_new_page(improvement_name_translation(pimprove),
1170 is_great_wonder(pimprove)
1171 ? HELP_WONDER
1172 : HELP_IMPROVEMENT);
1173 gtk_container_add(GTK_CONTAINER(hbox), w);
1174 gtk_widget_show_all(hbox);
1175 }
1176 } requirement_vector_iterate_end;
1177 }
1178 } improvement_iterate_end;
1179
1180 unit_type_iterate(punittype) {
1181
1182 if (!is_tech_req_for_utype(punittype, padvance)) {
1183 continue;
1184 }
1185
1186 hbox = gtk_grid_new();
1187 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1188 w = gtk_label_new(_("Allows"));
1189 gtk_container_add(GTK_CONTAINER(hbox), w);
1190 w = help_slink_new_page(utype_name_translation(punittype), HELP_UNIT);
1191 gtk_container_add(GTK_CONTAINER(hbox), w);
1192 gtk_widget_show_all(hbox);
1193 } unit_type_iterate_end;
1194
1195 advance_iterate_all(ptest) {
1196 if (padvance == advance_requires(ptest, AR_ONE)) {
1197 if (advance_by_number(A_NONE) == advance_requires(ptest, AR_TWO)) {
1198 hbox = gtk_grid_new();
1199 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1200 w = gtk_label_new(_("Allows"));
1201 gtk_container_add(GTK_CONTAINER(hbox), w);
1202 w = help_slink_new_page(advance_name_translation(ptest), HELP_TECH);
1203 gtk_container_add(GTK_CONTAINER(hbox), w);
1204 gtk_widget_show_all(hbox);
1205 } else {
1206 hbox = gtk_grid_new();
1207 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1208 w = gtk_label_new(_("Allows"));
1209 gtk_container_add(GTK_CONTAINER(hbox), w);
1210 w = help_slink_new_page(advance_name_translation(ptest), HELP_TECH);
1211 gtk_container_add(GTK_CONTAINER(hbox), w);
1212 w = gtk_label_new(_("with"));
1213 gtk_container_add(GTK_CONTAINER(hbox), w);
1214 w = help_slink_new_page(advance_name_translation(advance_requires(ptest,
1215 AR_TWO)),
1216 HELP_TECH);
1217 gtk_container_add(GTK_CONTAINER(hbox), w);
1218 w = gtk_label_new(Q_("?techhelp:"));
1219 gtk_container_add(GTK_CONTAINER(hbox), w);
1220 gtk_widget_show_all(hbox);
1221 }
1222 }
1223 if (padvance == advance_requires(ptest, AR_TWO)) {
1224 hbox = gtk_grid_new();
1225 gtk_container_add(GTK_CONTAINER(help_vbox), hbox);
1226 w = gtk_label_new(_("Allows"));
1227 gtk_container_add(GTK_CONTAINER(hbox), w);
1228 w = help_slink_new_page(advance_name_translation(ptest), HELP_TECH);
1229 gtk_container_add(GTK_CONTAINER(hbox), w);
1230 w = gtk_label_new(_("with"));
1231 gtk_container_add(GTK_CONTAINER(hbox), w);
1232 w = help_slink_new_page(advance_name_translation(advance_requires(ptest, AR_ONE)),
1233 HELP_TECH);
1234 gtk_container_add(GTK_CONTAINER(hbox), w);
1235 w = gtk_label_new(Q_("?techhelp:"));
1236 gtk_container_add(GTK_CONTAINER(hbox), w);
1237 gtk_widget_show_all(hbox);
1238 }
1239 } advance_iterate_all_end;
1240 gtk_widget_show(help_vbox);
1241 }
1242}
1243
1244/**********************************************************************/
1266
1267/**********************************************************************/
1270static void help_extras_of_act_for_terrain(struct terrain *pterr,
1271 enum unit_activity act,
1272 char *label)
1273{
1274 enum extra_cause cause = activity_to_extra_cause(act);
1275
1276 extra_type_by_cause_iterate(cause, pextra) {
1277 if (pextra->buildable
1278 && requirement_fulfilled_by_terrain(pterr, &(pextra->reqs))) {
1279 add_act_help_for_terrain(label,
1280 extra_name_translation(pextra), HELP_EXTRA,
1281 helptext_extra_for_terrain_str(pextra, pterr,
1282 act));
1283 }
1284 } extra_type_by_cause_iterate_end;
1285}
1286
1287/**********************************************************************/
1290static void help_update_terrain(const struct help_item *pitem,
1291 char *title)
1292{
1293 char buf[8192];
1294 struct terrain *pterrain = terrain_by_translated_name(title);
1295
1296 if (pterrain) {
1297 struct universal for_terr = { .kind = VUT_TERRAIN, .value = { .terrain = pterrain }};
1298
1299 set_help_tile_from_terrain(pterrain);
1300
1301 {
1302 /* 25 => "1.25"; 50 => "1.5"; 100 => "2.0" */
1303 int defbonus = pterrain->defense_bonus + 100;
1304 int frac = defbonus % 100;
1305
1306 if ((frac % 10) == 0) {
1307 frac /= 10;
1308 }
1309 sprintf(buf, "%d/%d.%d",
1310 pterrain->movement_cost, defbonus / 100, frac);
1311 }
1312 gtk_label_set_text(GTK_LABEL(help_tlabel[0][1]), buf);
1313
1314 sprintf(buf, "%d/%d/%d",
1315 pterrain->output[O_FOOD],
1316 pterrain->output[O_SHIELD],
1317 pterrain->output[O_TRADE]);
1318 gtk_label_set_text(GTK_LABEL(help_tlabel[0][4]), buf);
1319
1320 buf[0] = '\0';
1321 if (*(pterrain->resources)) {
1322 struct extra_type **r;
1323
1324 /* TODO: include resource frequency information */
1325 for (r = pterrain->resources; *r; r++) {
1326 /* TRANS: " Whales (2/1/2)," */
1327 sprintf (buf + strlen (buf), " %s (%d/%d/%d),",
1328 extra_name_translation(*r),
1329 pterrain->output[O_FOOD] + (*r)->data.resource->output[O_FOOD],
1330 pterrain->output[O_SHIELD] + (*r)->data.resource->output[O_SHIELD],
1331 pterrain->output[O_TRADE] + (*r)->data.resource->output[O_TRADE]);
1332 }
1333 buf[strlen (buf) - 1] = '.';
1334 } else {
1335 /* TRANS: "Resources: (none)" */
1336 sprintf (buf + strlen (buf), _("(none)"));
1337 }
1338 gtk_label_set_text(GTK_LABEL(help_tlabel[1][1]), buf);
1339
1340 gtk_container_foreach(GTK_CONTAINER(help_vbox), (GtkCallback)gtk_widget_destroy, NULL);
1341
1342 if (pterrain->cultivate_result != T_NONE
1343 && action_id_univs_not_blocking(ACTION_CULTIVATE,
1344 NULL, &for_terr)) {
1345 fc_snprintf(buf, sizeof(buf),
1346 PL_("%d turn", "%d turns", pterrain->cultivate_time),
1347 pterrain->cultivate_time);
1348 add_act_help_for_terrain(_("Cultivate Rslt/Time"),
1349 terrain_name_translation(pterrain->cultivate_result),
1350 HELP_TERRAIN, buf);
1351 }
1352
1353 if (pterrain->plant_result != T_NONE
1354 && action_id_univs_not_blocking(ACTION_PLANT, NULL, &for_terr)) {
1355 fc_snprintf(buf, sizeof(buf),
1356 PL_("%d turn", "%d turns", pterrain->plant_time),
1357 pterrain->plant_time);
1358 add_act_help_for_terrain(_("Plant Rslt/Time"),
1359 terrain_name_translation(pterrain->plant_result),
1360 HELP_TERRAIN, buf);
1361 }
1362
1363 if (pterrain->transform_result != T_NONE
1364 && action_id_univs_not_blocking(ACTION_TRANSFORM_TERRAIN,
1365 NULL, &for_terr)) {
1366 fc_snprintf(buf, sizeof(buf),
1367 PL_("%d turn", "%d turns", pterrain->transform_time),
1368 pterrain->transform_time);
1369 add_act_help_for_terrain(_("Trans. Rslt/Time"),
1370 terrain_name_translation(pterrain->transform_result),
1371 HELP_TERRAIN, buf);
1372 }
1373
1374 if (action_id_univs_not_blocking(ACTION_IRRIGATE, NULL, &for_terr)) {
1375 help_extras_of_act_for_terrain(pterrain, ACTIVITY_IRRIGATE,
1376 _("Build as irrigation"));
1377 }
1378 if (action_id_univs_not_blocking(ACTION_MINE, NULL, &for_terr)) {
1379 help_extras_of_act_for_terrain(pterrain, ACTIVITY_MINE,
1380 _("Build as mine"));
1381 }
1382 if (action_id_univs_not_blocking(ACTION_ROAD, NULL, &for_terr)) {
1383 help_extras_of_act_for_terrain(pterrain, ACTIVITY_GEN_ROAD,
1384 _("Build as road"));
1385 }
1386 if (action_id_univs_not_blocking(ACTION_BASE, NULL, &for_terr)) {
1387 help_extras_of_act_for_terrain(pterrain, ACTIVITY_BASE,
1388 _("Build as base"));
1389 }
1390
1391 gtk_widget_show(help_vbox);
1392 }
1393
1394 helptext_terrain(buf, sizeof(buf), client.conn.playing, pitem->text, pterrain);
1395
1396 gtk_text_buffer_set_text(help_text, buf, -1);
1397 gtk_widget_show(help_text_sw);
1398
1399 gtk_widget_show(help_ttable);
1400}
1401
1402/**********************************************************************/
1405static void help_update_extra(const struct help_item *pitem, char *title)
1406{
1407 char buf[8192];
1408 struct extra_type *pextra = extra_type_by_translated_name(title);
1409
1410 buf[0] = '\0';
1411 if (pextra == NULL) {
1412 strcat(buf, pitem->text);
1413 } else {
1414 struct road_type *proad = extra_road_get(pextra);
1415 bool is_resource = is_extra_caused_by(pextra, EC_RESOURCE);
1416
1417 set_help_tile_from_extra(pextra);
1418
1419 /* Cost to build */
1420 if (pextra->buildable) {
1421 if (pextra->build_time != 0) {
1422 /* TRANS: "MP" = movement points */
1423 sprintf(buf, _("%d MP"), pextra->build_time);
1424 } else {
1425 /* TRANS: Build time depends on terrain. */
1426 sprintf(buf, _("Terrain specific"));
1427 }
1428 } else {
1429 sprintf(buf, "-");
1430 }
1431 gtk_label_set_text(GTK_LABEL(help_elabel[1]), buf);
1432 /* Conflicting extras */
1433 buf[0] = '\0';
1434 if (is_resource) {
1435 /* TRANS: (Resource extra) Conflicts with: */
1436 strcat(buf, _("Other Resources"));
1437 }
1438 extra_type_iterate(pextra2) {
1439 if (!can_extras_coexist(pextra, pextra2)
1440 && (!is_resource || !is_extra_caused_by(pextra2, EC_RESOURCE))) {
1441 if (buf[0] != '\0') {
1442 strcat(buf, "/");
1443 }
1444 strcat(buf, extra_name_translation(pextra2));
1445 }
1446 } extra_type_iterate_end;
1447 /* TRANS: "Conflicts with: (none)" (extras) */
1448 gtk_label_set_text(GTK_LABEL(help_elabel[3]), buf[0] ? buf : _("(none)"));
1449
1450 /* Bonus */
1451 if (proad != NULL) {
1452 const char *bonus = NULL;
1453
1454 output_type_iterate(o) {
1455 if (proad->tile_incr[o] > 0) {
1456 /* TRANS: Road bonus depends on terrain. */
1457 bonus = _("Terrain specific");
1458 break;
1459 }
1460 } output_type_iterate_end;
1461 if (!bonus) {
1462 bonus = helptext_road_bonus_str(NULL, proad);
1463 }
1464 if (!bonus) {
1465 /* TRANS: No output bonus from a road */
1466 bonus = Q_("?bonus:None");
1467 }
1468 gtk_label_set_text(GTK_LABEL(help_elabel[5]), bonus);
1469 } else {
1470 gtk_label_set_text(GTK_LABEL(help_elabel[5]), Q_("?bonus:None"));
1471 }
1472
1473 helptext_extra(buf, sizeof(buf), client.conn.playing, pitem->text, pextra);
1474 }
1475 gtk_widget_show(help_etable);
1476
1477 gtk_text_buffer_set_text(help_text, buf, -1);
1478 gtk_widget_show(help_text_sw);
1479}
1480
1481/**********************************************************************/
1484static void help_update_goods(const struct help_item *pitem,
1485 char *title)
1486{
1487 char buf[8192];
1488 struct goods_type *pgood = goods_by_translated_name(title);
1489
1490 if (!pgood) {
1491 strcat(buf, pitem->text);
1492 } else {
1493 helptext_goods(buf, sizeof(buf), client.conn.playing, pitem->text,
1494 pgood);
1495 }
1496
1497 gtk_text_buffer_set_text(help_text, buf, -1);
1498 gtk_widget_show(help_text_sw);
1499}
1500
1501/**********************************************************************/
1504static void help_update_specialist(const struct help_item *pitem,
1505 char *title)
1506{
1507 char buf[8192];
1508 struct specialist *pspec = specialist_by_translated_name(title);
1509
1510 if (!pspec) {
1511 strcat(buf, pitem->text);
1512 } else {
1513 helptext_specialist(buf, sizeof(buf), client.conn.playing, pitem->text,
1514 pspec);
1515 }
1516
1517 gtk_text_buffer_set_text(help_text, buf, -1);
1518 gtk_widget_show(help_text_sw);
1519}
1520
1521/**********************************************************************/
1524static void help_update_government(const struct help_item *pitem,
1525 char *title)
1526{
1527 char buf[8192];
1528 struct government *gov = government_by_translated_name(title);
1529
1530 if (!gov) {
1531 strcat(buf, pitem->text);
1532 } else {
1533 helptext_government(buf, sizeof(buf), client.conn.playing, pitem->text, gov);
1534 }
1535
1536 gtk_text_buffer_set_text(help_text, buf, -1);
1537 gtk_widget_show(help_text_sw);
1538}
1539
1540/**********************************************************************/
1543static void help_update_nation(const struct help_item *pitem, char *title,
1544 struct nation_type *pnation)
1545{
1546 char buf[4096];
1547
1548 if (!pnation) {
1549 strcat(buf, pitem->text);
1550 } else {
1551 helptext_nation(buf, sizeof(buf), pnation, pitem->text);
1552
1553 set_help_tile_from_sprite(get_nation_flag_sprite(tileset, pnation));
1554 }
1555
1556 gtk_text_buffer_set_text(help_text, buf, -1);
1557 gtk_widget_show(help_text_sw);
1558}
1559
1560/**********************************************************************/
1563static void help_update_dialog(const struct help_item *pitem)
1564{
1565 char *top;
1566
1567 /* figure out what kind of item is required for pitem ingo */
1568
1569 for (top = pitem->topic; *top == ' '; top++) {
1570 /* nothing */
1571 }
1572
1573 help_box_hide();
1574 gtk_text_buffer_set_text(help_text, "", -1);
1575
1576 switch (pitem->type) {
1577 case HELP_IMPROVEMENT:
1578 help_update_improvement(pitem, top);
1579 break;
1580 case HELP_WONDER:
1581 help_update_wonder(pitem, top);
1582 break;
1583 case HELP_UNIT:
1584 help_update_unit_type(pitem, top);
1585 break;
1586 case HELP_TECH:
1587 help_update_tech(pitem, top);
1588 break;
1589 case HELP_TERRAIN:
1590 help_update_terrain(pitem, top);
1591 break;
1592 case HELP_EXTRA:
1593 help_update_extra(pitem, top);
1594 break;
1595 case HELP_GOODS:
1596 help_update_goods(pitem, top);
1597 break;
1598 case HELP_SPECIALIST:
1599 help_update_specialist(pitem, top);
1600 break;
1601 case HELP_GOVERNMENT:
1602 help_update_government(pitem, top);
1603 break;
1604 case HELP_NATIONS:
1605 help_update_nation(pitem, top, nation_by_translated_plural(top));
1606 break;
1607 case HELP_TEXT:
1608 default:
1609 /* it was a pure text item */
1610 gtk_text_buffer_set_text(help_text, pitem->text, -1);
1611 gtk_widget_show(help_text_sw);
1612 break;
1613 }
1614 set_title_topic(pitem->topic);
1615
1616 gtk_widget_show(help_box);
1617}
1618
1619/**********************************************************************/
1622static void help_item_zoom(GtkTreePath *path)
1623{
1624 GtkTreeModel *model;
1625 GtkTreeIter it, child, item;
1626 GtkTreeSelection *selection;
1627
1628 model = gtk_tree_view_get_model(GTK_TREE_VIEW(help_view));
1629 gtk_tree_model_get_iter(model, &item, path);
1630
1631 for (child = item; gtk_tree_model_iter_parent(model, &it, &child); child=it) {
1632 GtkTreePath *it_path;
1633
1634 it_path = gtk_tree_model_get_path(model, &it);
1635 gtk_tree_view_expand_row(GTK_TREE_VIEW(help_view), it_path, TRUE);
1636 gtk_tree_path_free(it_path);
1637 }
1638
1639 selection = gtk_tree_view_get_selection(GTK_TREE_VIEW(help_view));
1640 gtk_tree_selection_select_iter(selection, &item);
1641 gtk_tree_view_scroll_to_cell(GTK_TREE_VIEW(help_view), path, NULL,
1642 TRUE, 0.0, 0.0);
1643}
1644
1645/**********************************************************************/
1648static GtkTreePath *help_item_path(const struct help_item *pitem)
1649{
1650 GtkTreePath *path;
1651 bool next;
1652
1653 path = gtk_tree_path_new_first();
1654 next = FALSE;
1655 help_items_iterate(pitem2) {
1656 const char *s;
1657 int depth;
1658
1659 for (s = pitem2->topic; *s == ' '; s++) {
1660 /* nothing */
1661 }
1662 depth = s - pitem2->topic + 1;
1663
1664 while (depth < gtk_tree_path_get_depth(path)) {
1665 gtk_tree_path_up(path);
1666 gtk_tree_path_next(path);
1667 next = FALSE;
1668 }
1669 while (depth > gtk_tree_path_get_depth(path)) {
1670 gtk_tree_path_down(path);
1671 next = FALSE;
1672 }
1673
1674 if (next) {
1675 gtk_tree_path_next(path);
1676 }
1677
1678 if (pitem == pitem2)
1679 break;
1680
1681 next = TRUE;
1682 } help_items_iterate_end;
1683
1684 return path;
1685}
1686
1687/**********************************************************************/
1690static void select_help_item_string(const char *item, enum help_page_type htype)
1691{
1692 const struct help_item *pitem;
1693 int idx;
1694 GtkTreePath *path;
1695 GtkTreeViewColumn *col;
1696
1697 if (!(pitem = get_help_item_spec(item, htype, &idx))) {
1698 return;
1699 }
1700
1701 path = help_item_path(pitem);
1702 help_item_zoom(path);
1703
1704 col = gtk_tree_view_get_column(GTK_TREE_VIEW(help_view), 0);
1705 gtk_tree_view_set_cursor(GTK_TREE_VIEW(help_view), path, col, FALSE);
1706 gtk_tree_path_free(path);
1707}
1708
1709/**********************************************************************/
1712static void help_command_update(void)
1713{
1714 GtkDialog *dialog = GTK_DIALOG(help_dialog_shell);
1715
1716 if (help_history_pos < 0) {
1717 gtk_dialog_set_response_sensitive(dialog, 1, FALSE);
1718 gtk_dialog_set_response_sensitive(dialog, 2, FALSE);
1719 } else {
1720 gtk_dialog_set_response_sensitive(dialog, 1, TRUE);
1721 gtk_dialog_set_response_sensitive(dialog, 2, TRUE);
1722
1723 if (help_history_pos == 0) {
1724 gtk_dialog_set_response_sensitive(dialog, 1, FALSE);
1725 }
1726 if (help_history_pos >= help_history->len - 1) {
1727 gtk_dialog_set_response_sensitive(dialog, 2, FALSE);
1728 }
1729 }
1730}
1731
1732/**********************************************************************/
1735static void help_command_callback(GtkWidget *w, gint response_id)
1736{
1737 GtkTreePath *path;
1738 const struct help_item *pitem;
1739
1740 if (response_id == 1) {
1741 if (help_history_pos > 0) {
1742 help_history_pos--;
1743
1744 pitem = g_ptr_array_index(help_history, help_history_pos);
1745 path = help_item_path(pitem);
1746 help_item_zoom(path);
1747 help_update_dialog(pitem);
1748 help_command_update();
1749 }
1750 } else if (response_id == 2) {
1751 if (help_history_pos < help_history->len - 1) {
1752 help_history_pos++;
1753
1754 pitem = g_ptr_array_index(help_history, help_history_pos);
1755 path = help_item_path(pitem);
1756 help_item_zoom(path);
1757 help_update_dialog(pitem);
1758 help_command_update();
1759 }
1760 } else {
1761 /* Save size of the dialog. */
1762 help_frame_width = gtk_widget_get_allocated_width(help_frame);
1763 help_frame_height = gtk_widget_get_allocated_height(help_frame);
1764 gtk_widget_destroy(help_dialog_shell);
1765 }
1766}
action_id_univs_not_blocking
#define action_id_univs_not_blocking(act_id, act_uni, tgt_uni)
Definition actions.h:945
str
#define str
Definition astring.c:76
output_type_iterate
#define output_type_iterate(output)
Definition city.h:845
output_type_iterate_end
#define output_type_iterate_end
Definition city.h:851
client
struct civclient client
Definition client_main.c:150
client_main.h
client_player
#define client_player()
Definition client_main.h:106
get_color
struct color * get_color(const struct tileset *t, enum color_std stdcolor)
Definition colors_common.c:100
incite_cost
char * incite_cost
Definition comments.c:75
extra_type_by_translated_name
struct extra_type * extra_type_by_translated_name(const char *name)
Definition extras.c:235
activity_to_extra_cause
enum extra_cause activity_to_extra_cause(enum unit_activity act)
Definition extras.c:1076
can_extras_coexist
bool can_extras_coexist(const struct extra_type *pextra1, const struct extra_type *pextra2)
Definition extras.c:1003
extra_name_translation
const char * extra_name_translation(const struct extra_type *pextra)
Definition extras.c:194
extra_type_iterate
#define extra_type_iterate(_p)
Definition extras.h:315
extra_type_iterate_end
#define extra_type_iterate_end
Definition extras.h:321
is_extra_caused_by
#define is_extra_caused_by(e, c)
Definition extras.h:203
extra_road_get
#define extra_road_get(_e_)
Definition extras.h:191
extra_type_by_cause_iterate_end
#define extra_type_by_cause_iterate_end
Definition extras.h:339
extra_type_by_cause_iterate
#define extra_type_by_cause_iterate(_cause, _extra)
Definition extras.h:333
O_SHIELD
@ O_SHIELD
Definition fc_types.h:101
O_FOOD
@ O_FOOD
Definition fc_types.h:101
O_TRADE
@ O_TRADE
Definition fc_types.h:101
skip_intl_qualifier_prefix
const char * skip_intl_qualifier_prefix(const char *str)
Definition fcintl.c:48
Q_
#define Q_(String)
Definition fcintl.h:70
PL_
#define PL_(String1, String2, n)
Definition fcintl.h:71
_
#define _(String)
Definition fcintl.h:67
N_
#define N_(String)
Definition fcintl.h:69
government_name_translation
const char * government_name_translation(const struct government *pgovern)
Definition government.c:143
government_by_translated_name
struct government * government_by_translated_name(const char *name)
Definition government.c:40
governments_iterate
#define governments_iterate(NAME_pgov)
Definition government.h:124
governments_iterate_end
#define governments_iterate_end
Definition government.h:127
FC_STATIC_CANVAS_INIT
#define FC_STATIC_CANVAS_INIT
Definition canvas.h:28
toplevel
GtkWidget * toplevel
Definition gui_main.c:125
set_relative_window_position
void set_relative_window_position(GtkWindow *ref, GtkWindow *w, int px, int py)
Definition gui_stuff.c:60
setup_dialog
void setup_dialog(GtkWidget *shell, GtkWidget *parent)
Definition gui_stuff.c:287
help_tree_sw
static GtkWidget * help_tree_sw
Definition helpdlg.c:84
set_title_topic
static void set_title_topic(char *topic)
Definition helpdlg.c:174
activated_topic
static void activated_topic(GtkTreeView *view, gpointer data)
Definition helpdlg.c:470
help_tree
static GtkWidget * help_tree
Definition helpdlg.c:81
help_tree_expand
static GtkWidget * help_tree_expand
Definition helpdlg.c:85
help_ulabel
static GtkWidget * help_ulabel[5][5]
Definition helpdlg.c:90
help_update_specialist
static void help_update_specialist(const struct help_item *pitem, char *title)
Definition helpdlg.c:1504
help_hyperlink_callback
static void help_hyperlink_callback(GtkWidget *w)
Definition helpdlg.c:346
help_elabel
static GtkWidget * help_elabel[6]
Definition helpdlg.c:92
help_etable
static GtkWidget * help_etable
Definition helpdlg.c:80
help_destroy_callback
static void help_destroy_callback(GtkWidget *w, gpointer data)
Definition helpdlg.c:461
set_help_tile_from_extra
static void set_help_tile_from_extra(const struct extra_type *pextra)
Definition helpdlg.c:849
help_frame
static GtkWidget * help_frame
Definition helpdlg.c:69
help_frame_width
static int help_frame_width
Definition helpdlg.c:70
help_tech_tree_activated_callback
static void help_tech_tree_activated_callback(GtkTreeView *view, GtkTreePath *path, GtkTreeViewColumn *col, gpointer data)
Definition helpdlg.c:313
help_update_tech
static void help_update_tech(const struct help_item *pitem, char *title)
Definition helpdlg.c:1076
help_item_zoom
static void help_item_zoom(GtkTreePath *path)
Definition helpdlg.c:1622
help_slink_new_page
static GtkWidget * help_slink_new_page(const gchar *txt, enum help_page_type page)
Definition helpdlg.c:428
help_tlabel
static GtkWidget * help_tlabel[2][5]
Definition helpdlg.c:91
help_item_path
static GtkTreePath * help_item_path(const struct help_item *pitem)
Definition helpdlg.c:1648
help_tree_collapse
static GtkWidget * help_tree_collapse
Definition helpdlg.c:86
help_update_nation
static void help_update_nation(const struct help_item *pitem, char *title, struct nation_type *pnation)
Definition helpdlg.c:1543
create_help_dialog
static void create_help_dialog(void)
Definition helpdlg.c:510
help_text
static GtkTextBuffer * help_text
Definition helpdlg.c:71
help_update_wonder
static void help_update_wonder(const struct help_item *pitem, char *title)
Definition helpdlg.c:927
help_hyperlink_new_page
static GtkWidget * help_hyperlink_new_page(GtkWidget *label, enum help_page_type page)
Definition helpdlg.c:403
help_dialog_shell
static GtkWidget * help_dialog_shell
Definition helpdlg.c:64
help_text_sw
static GtkWidget * help_text_sw
Definition helpdlg.c:72
help_history
static GPtrArray * help_history
Definition helpdlg.c:96
help_elabel_name
static const char * help_elabel_name[6]
Definition helpdlg.c:133
create_tech_tree
static void create_tech_tree(int tech, int levels, GtkTreeIter *parent)
Definition helpdlg.c:227
help_update_extra
static void help_update_extra(const struct help_item *pitem, char *title)
Definition helpdlg.c:1405
help_ilabel
static GtkWidget * help_ilabel[6]
Definition helpdlg.c:88
set_help_tile_from_sprite
static void set_help_tile_from_sprite(struct sprite *spr)
Definition helpdlg.c:805
help_wlabel_name
static const char * help_wlabel_name[6]
Definition helpdlg.c:112
help_ulabel_name
static const char * help_ulabel_name[5][5]
Definition helpdlg.c:118
help_tech_tree_collapse_callback
static void help_tech_tree_collapse_callback(GtkWidget *w, gpointer data)
Definition helpdlg.c:338
set_help_tile_from_terrain
static void set_help_tile_from_terrain(struct terrain *pterr)
Definition helpdlg.c:818
help_view
static GtkWidget * help_view
Definition helpdlg.c:67
help_update_goods
static void help_update_goods(const struct help_item *pitem, char *title)
Definition helpdlg.c:1484
help_system_init
void help_system_init(void)
Definition helpdlg.c:158
help_box_hide
static void help_box_hide(void)
Definition helpdlg.c:437
help_update_unit_type
static void help_update_unit_type(const struct help_item *pitem, char *title)
Definition helpdlg.c:991
popdown_help_dialog
void popdown_help_dialog(void)
Definition helpdlg.c:187
help_update_terrain
static void help_update_terrain(const struct help_item *pitem, char *title)
Definition helpdlg.c:1290
help_frame_height
static int help_frame_height
Definition helpdlg.c:70
help_update_dialog
static void help_update_dialog(const struct help_item *pitem)
Definition helpdlg.c:1563
fc_chomp
static char * fc_chomp(char *str, size_t len)
Definition helpdlg.c:1056
popup_help_dialog_string
void popup_help_dialog_string(const char *item)
Definition helpdlg.c:213
help_history_pos
static int help_history_pos
Definition helpdlg.c:97
help_wndr_req
static struct help_page_selection help_wndr_req
Definition helpdlg.c:114
help_wlabel
static GtkWidget * help_wlabel[6]
Definition helpdlg.c:89
help_box
static GtkWidget * help_box
Definition helpdlg.c:75
help_extras_of_act_for_terrain
static void help_extras_of_act_for_terrain(struct terrain *pterr, enum unit_activity act, char *label)
Definition helpdlg.c:1270
popup_help_dialog_typed
void popup_help_dialog_typed(const char *item, enum help_page_type htype)
Definition helpdlg.c:197
REQ_LABEL_NEVER
#define REQ_LABEL_NEVER
Definition helpdlg.c:145
help_command_update
static void help_command_update(void)
Definition helpdlg.c:1712
page_selections
static struct help_page_selection page_selections[HELP_LAST]
Definition helpdlg.c:116
TECH_TREE_DEPTH
#define TECH_TREE_DEPTH
Definition helpdlg.c:59
help_tlabel_name
static const char * help_tlabel_name[2][5]
Definition helpdlg.c:127
help_impr_req
static struct help_page_selection help_impr_req
Definition helpdlg.c:110
REQ_LABEL_NONE
#define REQ_LABEL_NONE
Definition helpdlg.c:144
help_wtable
static GtkWidget * help_wtable
Definition helpdlg.c:77
help_slink_new
static GtkWidget * help_slink_new(const gchar *txt, struct help_page_selection *select)
Definition helpdlg.c:412
help_vbox
static GtkWidget * help_vbox
Definition helpdlg.c:73
help_tech_tree_expand_callback
static void help_tech_tree_expand_callback(GtkWidget *w, gpointer data)
Definition helpdlg.c:330
help_tile
static GtkWidget * help_tile
Definition helpdlg.c:74
help_hyperlink_new
static GtkWidget * help_hyperlink_new(GtkWidget *label, struct help_page_selection *select)
Definition helpdlg.c:381
help_update_government
static void help_update_government(const struct help_item *pitem, char *title)
Definition helpdlg.c:1524
help_ttable
static GtkWidget * help_ttable
Definition helpdlg.c:79
help_update_improvement
static void help_update_improvement(const struct help_item *pitem, char *title)
Definition helpdlg.c:877
help_ilabel_name
static const char * help_ilabel_name[6]
Definition helpdlg.c:108
help_tree_buttons_hbox
static GtkWidget * help_tree_buttons_hbox
Definition helpdlg.c:87
help_view_sw
static GtkWidget * help_view_sw
Definition helpdlg.c:65
select_help_item_string
static void select_help_item_string(const char *item, enum help_page_type htype)
Definition helpdlg.c:1690
help_advances
static bool help_advances[A_LAST]
Definition helpdlg.c:94
help_utable
static GtkWidget * help_utable
Definition helpdlg.c:78
help_itable
static GtkWidget * help_itable
Definition helpdlg.c:76
tstore
static GtkTreeStore * tstore
Definition helpdlg.c:82
add_act_help_for_terrain
static void add_act_help_for_terrain(const char *act_label, const char *result_link_label, enum help_page_type result_link_type, const char *descr_label)
Definition helpdlg.c:1247
help_command_callback
static void help_command_callback(GtkWidget *w, gint response_id)
Definition helpdlg.c:1735
title
const char * title
Definition repodlgs.c:1314
type
GType type
Definition repodlgs.c:1313
gui_stuff.h
gui_main.h
helptext_government
void helptext_government(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, struct government *gov)
Definition helpdata.c:4400
helptext_advance
void helptext_advance(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, int i)
Definition helpdata.c:3359
help_type_by_requirement
enum help_page_type help_type_by_requirement(const struct requirement *req)
Definition helpdata.c:5265
helptext_unit
char * helptext_unit(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, const struct unit_type *utype, bool class_help)
Definition helpdata.c:1992
helptext_extra
void helptext_extra(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, struct extra_type *pextra)
Definition helpdata.c:3854
helptext_goods
void helptext_goods(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, struct goods_type *pgood)
Definition helpdata.c:4319
helptext_road_bonus_str
const char * helptext_road_bonus_str(const struct terrain *pterrain, const struct road_type *proad)
Definition helpdata.c:3690
helptext_unit_upkeep_str
char * helptext_unit_upkeep_str(const struct unit_type *utype)
Definition helpdata.c:5062
helptext_extra_for_terrain_str
const char * helptext_extra_for_terrain_str(struct extra_type *pextra, struct terrain *pterrain, enum unit_activity act)
Definition helpdata.c:3820
helptext_specialist
void helptext_specialist(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, struct specialist *pspec)
Definition helpdata.c:4365
get_help_item_spec
const struct help_item * get_help_item_spec(const char *name, enum help_page_type htype, int *pos)
Definition helpdata.c:1346
helptext_building
char * helptext_building(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, const struct impr_type *pimprove)
Definition helpdata.c:1439
helptext_terrain
void helptext_terrain(char *buf, size_t bufsz, struct player *pplayer, const char *user_text, struct terrain *pterrain)
Definition helpdata.c:3580
helptext_nation
void helptext_nation(char *buf, size_t bufsz, struct nation_type *pnation, const char *user_text)
Definition helpdata.c:5099
help_items_iterate
#define help_items_iterate(pitem)
Definition helpdata.h:72
help_items_iterate_end
#define help_items_iterate_end
Definition helpdata.h:76
HELP_ABOUT_ITEM
#define HELP_ABOUT_ITEM
help_page_type
help_page_type
Definition helpdlg_g.h:20
HELP_ANY
@ HELP_ANY
Definition helpdlg_g.h:20
HELP_TERRAIN
@ HELP_TERRAIN
Definition helpdlg_g.h:21
HELP_EXTRA
@ HELP_EXTRA
Definition helpdlg_g.h:21
HELP_NATIONS
@ HELP_NATIONS
Definition helpdlg_g.h:24
HELP_LAST
@ HELP_LAST
Definition helpdlg_g.h:25
HELP_IMPROVEMENT
@ HELP_IMPROVEMENT
Definition helpdlg_g.h:20
HELP_UNIT
@ HELP_UNIT
Definition helpdlg_g.h:20
HELP_SPECIALIST
@ HELP_SPECIALIST
Definition helpdlg_g.h:22
HELP_GOVERNMENT
@ HELP_GOVERNMENT
Definition helpdlg_g.h:22
HELP_GOODS
@ HELP_GOODS
Definition helpdlg_g.h:22
HELP_WONDER
@ HELP_WONDER
Definition helpdlg_g.h:21
HELP_TECH
@ HELP_TECH
Definition helpdlg_g.h:21
HELP_TEXT
@ HELP_TEXT
Definition helpdlg_g.h:20
valid_improvement
const struct impr_type * valid_improvement(const struct impr_type *pimprove)
Definition improvement.c:211
impr_base_build_shield_cost
int impr_base_build_shield_cost(const struct impr_type *pimprove)
Definition improvement.c:261
is_great_wonder
bool is_great_wonder(const struct impr_type *pimprove)
Definition improvement.c:776
improvement_by_translated_name
struct impr_type * improvement_by_translated_name(const char *name)
Definition improvement.c:352
improvement_name_translation
const char * improvement_name_translation(const struct impr_type *pimprove)
Definition improvement.c:243
improvement_iterate_end
#define improvement_iterate_end
Definition improvement.h:205
improvement_iterate
#define improvement_iterate(_p)
Definition improvement.h:199
put_drawn_sprites
void put_drawn_sprites(struct canvas *pcanvas, float zoom, int canvas_x, int canvas_y, int count, struct drawn_sprite *pdrawn, bool fog)
Definition mapview_common.c:1328
move_points_text
const char * move_points_text(int mp, bool reduce)
Definition movement.c:1047
nation_by_translated_plural
struct nation_type * nation_by_translated_plural(const char *name)
Definition nation.c:106
len
int len
Definition packhand.c:127
universal_name_translation
const char * universal_name_translation(const struct universal *psource, char *buf, size_t bufsz)
Definition requirements.c:6776
requirement_fulfilled_by_terrain
#define requirement_fulfilled_by_terrain(_ter_, _rqs_)
Definition requirements.h:419
requirement_vector_iterate_end
#define requirement_vector_iterate_end
Definition requirements.h:94
requirement_vector_iterate
#define requirement_vector_iterate(req_vec, preq)
Definition requirements.h:92
research_goal_unknown_techs
int research_goal_unknown_techs(const struct research *presearch, Tech_type_id goal)
Definition research.c:750
research_advance_name_translation
const char * research_advance_name_translation(const struct research *presearch, Tech_type_id tech)
Definition research.c:273
research_get
struct research * research_get(const struct player *pplayer)
Definition research.c:128
research_invention_state
enum tech_state research_invention_state(const struct research *presearch, Tech_type_id tech)
Definition research.c:619
ARRAY_SIZE
#define ARRAY_SIZE(x)
Definition shared.h:85
specialist_by_translated_name
struct specialist * specialist_by_translated_name(const char *name)
Definition specialist.c:130
canvas::surface
cairo_surface_t * surface
Definition canvas.h:23
civclient::conn
struct connection conn
Definition client_main.h:96
color
Definition colors.h:21
connection::playing
struct player * playing
Definition connection.h:151
drawn_sprite
Definition tilespec.h:110
extra_type
Definition extras.h:88
extra_type::buildable
bool buildable
Definition extras.h:116
extra_type::build_time
int build_time
Definition extras.h:118
goods_type
Definition traderoutes.h:183
help_item
Definition helpdata.h:25
help_item::text
char * text
Definition helpdata.h:26
help_page_selection
Definition helpdlg.c:100
help_page_selection::page
enum help_page_type page
Definition helpdlg.c:103
help_page_selection::req
const struct requirement * req
Definition helpdlg.c:104
help_page_selection::type
enum help_page_selection::@155 type
help_page_selection::u
union help_page_selection::@156 u
help_page_selection::HPAGE_SRC_REQ
@ HPAGE_SRC_REQ
Definition helpdlg.c:101
help_page_selection::HPAGE_SRC_ENUM
@ HPAGE_SRC_ENUM
Definition helpdlg.c:101
impr_type
Definition improvement.h:50
item
Definition climisc.h:82
nation_type
Definition nation.h:98
road_type
Definition road.h:71
terrain::cultivate_result
struct terrain * cultivate_result
Definition terrain.h:215
terrain::resources
struct extra_type ** resources
Definition terrain.h:204
terrain::plant_time
int plant_time
Definition terrain.h:219
terrain::plant_result
struct terrain * plant_result
Definition terrain.h:218
terrain::defense_bonus
int defense_bonus
Definition terrain.h:200
terrain::cultivate_time
int cultivate_time
Definition terrain.h:216
terrain::movement_cost
int movement_cost
Definition terrain.h:199
terrain::output
int output[O_LAST]
Definition terrain.h:202
terrain::transform_time
int transform_time
Definition terrain.h:231
terrain::transform_result
struct terrain * transform_result
Definition terrain.h:229
unit_type
Definition unittype.h:500
unit_type::defense_strength
int defense_strength
Definition unittype.h:516
unit_type::firepower
int firepower
Definition unittype.h:525
unit_type::obsoleted_by
const struct unit_type * obsoleted_by
Definition unittype.h:529
unit_type::vision_radius_sq
int vision_radius_sq
Definition unittype.h:522
unit_type::move_rate
int move_rate
Definition unittype.h:517
unit_type::hp
int hp
Definition unittype.h:524
unit_type::attack_strength
int attack_strength
Definition unittype.h:515
universal::kind
enum universals_n kind
Definition fc_types.h:902
fc_snprintf
int fc_snprintf(char *str, size_t n, const char *format,...)
Definition support.c:974
TRUE
#define TRUE
Definition support.h:46
FALSE
#define FALSE
Definition support.h:47
advance_by_number
struct advance * advance_by_number(const Tech_type_id atype)
Definition tech.c:107
is_future_tech
bool is_future_tech(Tech_type_id tech)
Definition tech.c:281
advance_by_translated_name
struct advance * advance_by_translated_name(const char *name)
Definition tech.c:185
advance_requires
struct advance * advance_requires(const struct advance *padvance, enum tech_req require)
Definition tech.c:136
advance_name_translation
const char * advance_name_translation(const struct advance *padvance)
Definition tech.c:290
advance_required
Tech_type_id advance_required(const Tech_type_id tech, enum tech_req require)
Definition tech.c:121
advance_number
Tech_type_id advance_number(const struct advance *padvance)
Definition tech.c:98
advance_iterate_all_end
#define advance_iterate_all_end
Definition tech.h:279
AR_TWO
@ AR_TWO
Definition tech.h:112
AR_ONE
@ AR_ONE
Definition tech.h:111
advance_iterate_all
#define advance_iterate_all(_p)
Definition tech.h:278
A_NONE
#define A_NONE
Definition tech.h:43
A_LAST
#define A_LAST
Definition tech.h:45
terrain_by_translated_name
struct terrain * terrain_by_translated_name(const char *name)
Definition terrain.c:202
terrain_name_translation
const char * terrain_name_translation(const struct terrain *pterrain)
Definition terrain.c:238
T_NONE
#define T_NONE
Definition terrain.h:56
get_building_sprite
struct sprite * get_building_sprite(const struct tileset *t, const struct impr_type *pimprove)
Definition tilespec.c:6784
fill_basic_extra_sprite_array
int fill_basic_extra_sprite_array(const struct tileset *t, struct drawn_sprite *sprs, const struct extra_type *pextra)
Definition tilespec.c:7201
fill_basic_terrain_layer_sprite_array
int fill_basic_terrain_layer_sprite_array(struct tileset *t, struct drawn_sprite *sprs, int layer, struct terrain *pterrain)
Definition tilespec.c:7168
tileset_tile_height
int tileset_tile_height(const struct tileset *t)
Definition tilespec.c:765
get_unittype_sprite
struct sprite * get_unittype_sprite(const struct tileset *t, const struct unit_type *punittype, enum unit_activity activity, enum direction8 facing)
Definition tilespec.c:6806
get_nation_flag_sprite
struct sprite * get_nation_flag_sprite(const struct tileset *t, const struct nation_type *pnation)
Definition tilespec.c:6757
tileset_tile_width
int tileset_tile_width(const struct tileset *t)
Definition tilespec.c:753
get_tech_sprite
struct sprite * get_tech_sprite(const struct tileset *t, Tech_type_id tech)
Definition tilespec.c:6775
goods_by_translated_name
struct goods_type * goods_by_translated_name(const char *name)
Definition traderoutes.c:654
is_tech_req_for_utype
bool is_tech_req_for_utype(const struct unit_type *ptype, struct advance *padv)
Definition unittype.c:2724
utype_build_shield_cost_base
int utype_build_shield_cost_base(const struct unit_type *punittype)
Definition unittype.c:1468
utype_primary_tech_req
struct advance * utype_primary_tech_req(const struct unit_type *ptype)
Definition unittype.c:2710
unit_type_by_translated_name
struct unit_type * unit_type_by_translated_name(const char *name)
Definition unittype.c:1752
utype_name_translation
const char * utype_name_translation(const struct unit_type *punittype)
Definition unittype.c:1560
unit_type_iterate
#define unit_type_iterate(_p)
Definition unittype.h:855
unit_type_iterate_end
#define unit_type_iterate_end
Definition unittype.h:862
U_NOT_OBSOLETED
#define U_NOT_OBSOLETED
Definition unittype.h:528
freeciv_name_version
const char * freeciv_name_version(void)
Definition version.c:35
Generated on Sun Aug 31 2025 23:00:34 for Freeciv-3.2 by doxygen 1.9.8