1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
/* File: help.c */
/* Purpose: ingame help */
/*
* Copyright (c) 2001 DarkGod
* Copyright (c) 2012 Bardur Arantsson
*
* This software may be copied and distributed for educational, research, and
* not for profit purposes provided that this copyright and statement are
* included in all such copies.
*/
#include "angband.h"
#define DESC_MAX 10
#define TRIGGERED_HELP_MAX 2
#define HELP_VOID_JUMPGATE 0
#define HELP_FOUNTAIN 1
/**
* Struct for help triggered by a boolean condition
*/
typedef struct triggered_help_type triggered_help_type;
struct triggered_help_type
{
/* Help item index; see HELP_* constants above */
int help_index;
/* Hook type */
int hook_type;
/* Trigger function */
bool_ (*trigger_func)(void *in, void *out);
/* Description; NULL terminated */
cptr desc[DESC_MAX];
};
/**
* Trigger functions
*/
static bool_ trigger_void_jumpgate(void *in, void *out) {
hook_move_in *p = (hook_move_in *) in;
return cave[p->y][p->x].feat == FEAT_BETWEEN;
}
static bool_ trigger_fountain(void *in, void *out) {
hook_move_in *p = (hook_move_in *) in;
return cave[p->y][p->x].feat == FEAT_FOUNTAIN;
}
/**
* Trigger-based help items
*/
static triggered_help_type triggered_help[TRIGGERED_HELP_MAX] =
{
{ HELP_VOID_JUMPGATE,
HOOK_MOVE,
trigger_void_jumpgate,
{ "Void Jumpgates can be entered by pressing the > key. They will transport",
"you to another jumpgate, but beware of the cold damage that might kill you.",
NULL }
},
{ HELP_FOUNTAIN,
HOOK_MOVE,
trigger_fountain,
{ "Fountains are always magical. You can quaff from them by pressing H.",
"Beware that unlike potions they cannot be identified.",
NULL }
}
};
static bool_ triggered_help_hook(void *data, void *in, void *out)
{
triggered_help_type *triggered_help = (triggered_help_type *) data;
/* Not triggered before and trigger now? */
if ((option_ingame_help) &&
(!p_ptr->help.activated[triggered_help->help_index]) &&
triggered_help->trigger_func(in,out))
{
int i;
/* Triggered */
p_ptr->help.activated[triggered_help->help_index] = TRUE;
/* Show the description */
for (i = 0; (i < DESC_MAX) && (triggered_help->desc[i] != NULL); i++)
{
cmsg_print(TERM_YELLOW, triggered_help->desc[i]);
}
}
/* Don't stop processing */
return FALSE;
}
static void setup_triggered_help_hook(int i)
{
static int counter = 0;
char name[40];
triggered_help_type *h = &triggered_help[i];
/* Build name */
sprintf(name, "help_trigger_%d", counter);
counter++;
/* Add the hook */
add_hook_new(h->hook_type,
triggered_help_hook,
name,
h);
}
static void setup_triggered_help_hooks()
{
int i;
for (i = 0; i < TRIGGERED_HELP_MAX; i++)
{
setup_triggered_help_hook(i);
}
}
/*
* Driver for the context-sensitive help system
*/
void init_hooks_help()
{
setup_triggered_help_hooks();
}
|