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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
/*
* SPDX-License-Identifier: GPL-2.0-or-later
*
* Copyright (C) 2021-2022 The DOSBox Staging Team
* Copyright (C) 2002-2021 The DOSBox Team
*
* This program 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; either version 2 of the License, or
* (at your option) any later version.
*
* This program 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. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#include "program_intro.h"
#include "mapper.h"
#include "program_more_output.h"
void INTRO::WriteOutProgramIntroSpecial()
{
WriteOut(MSG_Get("PROGRAM_INTRO_SPECIAL"),
MMOD2_NAME, // Alt, for fullscreen toggle
MMOD2_NAME, // Alt, for pause/unpause
PRIMARY_MOD_NAME, // Ctrl/Cmd, for keymapper
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for swap disk image
PRIMARY_MOD_PAD,
MMOD2_NAME, // Alt, to screenshot the rendered output
PRIMARY_MOD_NAME, // Ctrl/Cmd, to screenshot the image source
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for sound recording
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for video recording
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for mute/unmute
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for shutdown
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for mouse capture
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for slow down
PRIMARY_MOD_PAD,
PRIMARY_MOD_NAME, // Ctrl/Cmd, for speed up
PRIMARY_MOD_PAD,
MMOD2_NAME); // Alt, for turbo
}
void INTRO::DisplayMount(void) {
/* Basic mounting has a version for each operating system.
* This is done this way so both messages appear in the language file*/
WriteOut(MSG_Get("PROGRAM_INTRO_MOUNT_START"));
#if (WIN32)
WriteOut(MSG_Get("PROGRAM_INTRO_MOUNT_WINDOWS"));
#else
WriteOut(MSG_Get("PROGRAM_INTRO_MOUNT_OTHER"));
#endif
WriteOut(MSG_Get("PROGRAM_INTRO_MOUNT_END"));
}
void INTRO::Run(void) {
// Usage
if (HelpRequested()) {
MoreOutputStrings output(*this);
output.AddString(MSG_Get("PROGRAM_INTRO_HELP"));
output.AddString("\n");
output.AddString(MSG_Get("PROGRAM_INTRO_HELP_LONG"));
output.Display();
return;
}
/* Only run if called from the first shell (Xcom TFTD runs any intro file in the path) */
if (DOS_PSP(dos.psp()).GetParent() != DOS_PSP(DOS_PSP(dos.psp()).GetParent()).GetParent()) return;
if (cmd->FindExist("cdrom",false)) {
#ifdef WIN32
WriteOut(MSG_Get("PROGRAM_INTRO_CDROM_WINDOWS"));
#else
WriteOut(MSG_Get("PROGRAM_INTRO_CDROM_OTHER"));
#endif
return;
}
if (cmd->FindExist("mount",false)) {
WriteOut("\033[2J");//Clear screen before printing
DisplayMount();
return;
}
if (cmd->FindExist("special",false)) {
WriteOutProgramIntroSpecial();
return;
}
/* Default action is to show all pages */
WriteOut(MSG_Get("PROGRAM_INTRO"));
uint8_t c;uint16_t n=1;
DOS_ReadFile (STDIN,&c,&n);
DisplayMount();
DOS_ReadFile (STDIN,&c,&n);
#ifdef WIN32
WriteOut(MSG_Get("PROGRAM_INTRO_CDROM_WINDOWS"));
#else
WriteOut(MSG_Get("PROGRAM_INTRO_CDROM_OTHER"));
#endif
DOS_ReadFile(STDIN, &c, &n);
WriteOutProgramIntroSpecial();
}
void INTRO::AddMessages() {
MSG_Add("PROGRAM_INTRO_HELP",
"Displays a full-screen introduction to DOSBox Staging.\n");
MSG_Add("PROGRAM_INTRO_HELP_LONG",
"Usage:\n"
" [color=green]intro[reset]\n"
" [color=green]intro[reset] [color=white]PAGE[reset]\n"
"\n"
"Where:\n"
" [color=white]PAGE[reset] is the page name to display, including [color=white]cdrom[reset], [color=white]mount[reset], and [color=white]special[reset].\n"
"\n"
"Notes:\n"
" Running [color=green]intro[reset] without an argument displays one information page at a time;\n"
" press any key to move to the next page. If a page name is provided, then the\n"
" specified page will be displayed directly.\n"
"\n"
"Examples:\n"
" [color=green]intro[reset]\n"
" [color=green]intro[reset] [color=white]cdrom[reset]\n");
MSG_Add("PROGRAM_INTRO",
"[erases=entire][color=green]Welcome to DOSBox Staging[reset], an x86 emulator with sound and graphics.\n"
"DOSBox creates a shell for you which looks like old plain DOS.\n"
"\n"
"For information about basic mount type [color=blue]intro mount[reset]\n"
"For information about CD-ROM support type [color=blue]intro cdrom[reset]\n"
"For information about special keys type [color=blue]intro special[reset]\n"
"For more information, visit DOSBox Staging wiki:[color=blue]\n" WIKI_URL
"[reset]\n"
"\n"
"[color=red]DOSBox will stop/exit without a warning if an error occurred![reset]\n");
MSG_Add("PROGRAM_INTRO_MOUNT_START",
"[erases=entire][color=green]Here are some commands to get you started:[reset]\n"
"Before you can use the files located on your own filesystem,\n"
"You have to mount the directory containing the files.\n"
"\n"
);
MSG_Add("PROGRAM_INTRO_MOUNT_WINDOWS",
"[bgcolor=blue][color=white]╔═════════════════════════════════════════════════════════════════════════╗\n"
"║ [color=green]mount c c:\\dosgames\\ [color=white]will create a C drive with c:\\dosgames as contents.║\n"
"║ ║\n"
"║ [color=green]c:\\dosgames\\ [color=white]is an example. Replace it with your own games directory. ║\n"
"╚═════════════════════════════════════════════════════════════════════════╝[reset]\n"
);
MSG_Add("PROGRAM_INTRO_MOUNT_OTHER",
"[bgcolor=blue][color=white]╔══════════════════════════════════════════════════════════════════════╗\n"
"║ [color=green]mount c ~/dosgames[color=white] will create a C drive with ~/dosgames as contents.║\n"
"║ ║\n"
"║ [color=green]~/dosgames[color=white] is an example. Replace it with your own games directory. ║\n"
"╚══════════════════════════════════════════════════════════════════════╝[reset]\n"
);
MSG_Add("PROGRAM_INTRO_MOUNT_END",
"After successfully mounting the disk you can type [color=blue]c:[reset] to go to your freshly\n"
"mounted C-drive. Typing [color=blue]dir[reset] there will show its contents."
" [color=blue]cd[reset] will allow you to\n"
"enter a directory (recognised by the [color=yellow][][reset] in a directory listing).\n"
"You can run programs/files with extensions [color=light-red].exe .bat[reset] and [color=light-red].com[reset].\n"
);
MSG_Add("PROGRAM_INTRO_CDROM_WINDOWS",
"[erases=entire][color=green]How to mount a real/virtual CD-ROM Drive in DOSBox:[reset]\n"
"DOSBox provides CD-ROM emulation on two levels.\n"
"\n"
"The [color=light-yellow]basic[reset] level works on all normal directories, which installs MSCDEX\n"
"and marks the files read-only. Usually this is enough for most games:\n"
"[color=blue]mount D C:\\example -t cdrom[reset]\n"
"If it doesn't work you might have to tell DOSBox the label of the CD-ROM:\n"
"[color=blue]mount D C:\\example -t cdrom -label CDLABEL[reset]\n"
"\n"
"The [color=light-yellow]next[reset] level adds some low-level support.\n"
"Therefore only works on CD-ROM drives:\n"
"[color=blue]mount d[reset] [color=light-red]D:\\ [color=blue]-t cdrom -usecd [color=yellow]0[reset]\n"
"Replace [color=light-red]D:\\ [reset]with the location of your CD-ROM.\n"
"Replace the [color=yellow]0[reset] in [color=blue]-usecd [color=yellow]0[reset] with the number reported for your CD-ROM if you type:\n"
"[color=blue]mount -listcd[reset]\n"
"\n"
"Additionally, you can use imgmount to mount iso or cue/bin images:\n"
"[color=blue]imgmount D C:\\cd.iso -t cdrom[reset]\n"
"[color=blue]imgmount D C:\\cd.cue -t cdrom[reset]\n");
MSG_Add("PROGRAM_INTRO_CDROM_OTHER",
"[erases=entire][color=green]How to mount a real/virtual CD-ROM Drive in DOSBox:[reset]\n"
"DOSBox provides CD-ROM emulation on two levels.\n"
"\n"
"The [color=light-yellow]basic[reset] level works on all normal directories, which installs MSCDEX\n"
"and marks the files read-only. Usually this is enough for most games:\n"
"[color=blue]mount D ~/example -t cdrom[reset]\n"
"If it doesn't work you might have to tell DOSBox the label of the CD-ROM:\n"
"[color=blue]mount D ~/example -t cdrom -label CDLABEL[reset]\n"
"\n"
"The [color=light-yellow]next[reset] level adds some low-level support.\n"
"Therefore only works on CD-ROM drives:\n"
"[color=blue]mount d[reset] [color=light-red]~/example[color=blue] -t cdrom -usecd [color=yellow]0[reset]\n"
"\n"
"Replace [color=light-red]~/example[reset] with the location of your CD-ROM.\n"
"Replace the [color=yellow]0[reset] in [color=blue]-usecd [color=yellow]0[reset] with the number reported for your CD-ROM if you type:\n"
"[color=blue]mount -listcd[reset]\n"
"\n"
"Additionally, you can use imgmount to mount iso or cue/bin images:\n"
"[color=blue]imgmount D ~/cd.iso -t cdrom[reset]\n"
"[color=blue]imgmount D ~/cd.cue -t cdrom[reset]\n");
MSG_Add("PROGRAM_INTRO_SPECIAL",
"[erases=entire][color=green]Special keys:[reset]\n"
"These are the default keybindings.\n"
"They can be changed in the [color=light-yellow]keymapper[reset].\n"
"\n"
"[color=yellow]%s+Enter[reset] Switch between fullscreen and window mode.\n"
"[color=yellow]%s+Pause[reset] Pause/Unpause emulator.\n"
"[color=yellow]%s+F1[reset] %s Start the [color=light-yellow]keymapper[reset].\n"
"[color=yellow]%s+F4[reset] %s Swap mounted disk image, scan for changes on all drives.\n"
"[color=yellow]%s+F5[reset] Screenshot the video's rendered output.\n"
"[color=yellow]%s+F5[reset] %s Screenshot the video's source image.\n"
"[color=yellow]%s+F6[reset] %s Start/Stop recording sound output to a wave file.\n"
"[color=yellow]%s+F7[reset] %s Start/Stop recording video output to a zmbv file.\n"
"[color=yellow]%s+F8[reset] %s Mute/Unmute the audio.\n"
"[color=yellow]%s+F9[reset] %s Shutdown emulator.\n"
"[color=yellow]%s+F10[reset] %s Capture/Release the mouse.\n"
"[color=yellow]%s+F11[reset] %s Slow down emulation.\n"
"[color=yellow]%s+F12[reset] %s Speed up emulation.\n"
"[color=yellow]%s+F12[reset] Unlock speed (turbo button/fast forward).\n");
}
|
