OpenTTD
textfile_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 <http://www.gnu.org/licenses/>.
6  */
7 
10 #include "stdafx.h"
11 #include "fileio_func.h"
12 #include "fontcache.h"
13 #include "gfx_type.h"
14 #include "gfx_func.h"
15 #include "string_func.h"
16 #include "textfile_gui.h"
17 
18 #include "widgets/misc_widget.h"
19 
20 #include "table/strings.h"
21 
22 #if defined(WITH_ZLIB)
23 #include <zlib.h>
24 #endif
25 
26 #if defined(WITH_LIBLZMA)
27 #include <lzma.h>
28 #endif
29 
30 #include "safeguards.h"
31 
35  NWidget(WWT_CLOSEBOX, COLOUR_MAUVE),
36  NWidget(WWT_CAPTION, COLOUR_MAUVE, WID_TF_CAPTION), SetDataTip(STR_NULL, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
37  NWidget(WWT_TEXTBTN, COLOUR_MAUVE, WID_TF_WRAPTEXT), SetDataTip(STR_TEXTFILE_WRAP_TEXT, STR_TEXTFILE_WRAP_TEXT_TOOLTIP),
38  NWidget(WWT_DEFSIZEBOX, COLOUR_MAUVE),
39  EndContainer(),
42  EndContainer(),
45  EndContainer(),
46  EndContainer(),
49  NWidget(WWT_RESIZEBOX, COLOUR_MAUVE),
50  EndContainer(),
51 };
52 
55  WDP_CENTER, "textfile", 630, 460,
57  0,
58  _nested_textfile_widgets, lengthof(_nested_textfile_widgets)
59 );
60 
61 TextfileWindow::TextfileWindow(TextfileType file_type) : Window(&_textfile_desc), file_type(file_type)
62 {
63  this->CreateNestedTree();
64  this->vscroll = this->GetScrollbar(WID_TF_VSCROLLBAR);
65  this->hscroll = this->GetScrollbar(WID_TF_HSCROLLBAR);
66  this->FinishInitNested(file_type);
67  this->GetWidget<NWidgetCore>(WID_TF_CAPTION)->SetDataTip(STR_TEXTFILE_README_CAPTION + file_type, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS);
68 
69  this->hscroll->SetStepSize(10); // Speed up horizontal scrollbar
70  this->vscroll->SetStepSize(FONT_HEIGHT_MONO);
71 }
72 
73 /* virtual */ TextfileWindow::~TextfileWindow()
74 {
75  free(this->text);
76 }
77 
83 {
84  int max_width = this->GetWidget<NWidgetCore>(WID_TF_BACKGROUND)->current_x - WD_FRAMETEXT_LEFT - WD_FRAMERECT_RIGHT;
85 
86  uint height = 0;
87  for (uint i = 0; i < this->lines.size(); i++) {
88  height += GetStringHeight(this->lines[i], max_width, FS_MONO);
89  }
90 
91  return height;
92 }
93 
94 /* virtual */ void TextfileWindow::UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize)
95 {
96  switch (widget) {
97  case WID_TF_BACKGROUND:
98  resize->height = 1;
99 
100  size->height = 4 * resize->height + TOP_SPACING + BOTTOM_SPACING; // At least 4 lines are visible.
101  size->width = max(200u, size->width); // At least 200 pixels wide.
102  break;
103  }
104 }
105 
108 {
110  this->vscroll->SetCount(this->GetContentHeight());
111  this->hscroll->SetCount(0);
112  } else {
113  uint max_length = 0;
114  for (uint i = 0; i < this->lines.size(); i++) {
115  max_length = max(max_length, GetStringBoundingBox(this->lines[i], FS_MONO).width);
116  }
117  this->vscroll->SetCount((uint)this->lines.size() * FONT_HEIGHT_MONO);
118  this->hscroll->SetCount(max_length + WD_FRAMETEXT_LEFT + WD_FRAMETEXT_RIGHT);
119  }
120 
122 }
123 
124 /* virtual */ void TextfileWindow::OnClick(Point pt, int widget, int click_count)
125 {
126  switch (widget) {
127  case WID_TF_WRAPTEXT:
129  this->SetupScrollbars();
130  this->InvalidateData();
131  break;
132  }
133 }
134 
135 /* virtual */ void TextfileWindow::DrawWidget(const Rect &r, int widget) const
136 {
137  if (widget != WID_TF_BACKGROUND) return;
138 
139  const int x = r.left + WD_FRAMETEXT_LEFT;
140  const int y = r.top + WD_FRAMETEXT_TOP;
141  const int right = r.right - WD_FRAMETEXT_RIGHT;
142  const int bottom = r.bottom - WD_FRAMETEXT_BOTTOM;
143 
144  DrawPixelInfo new_dpi;
145  if (!FillDrawPixelInfo(&new_dpi, x, y, right - x + 1, bottom - y + 1)) return;
146  DrawPixelInfo *old_dpi = _cur_dpi;
147  _cur_dpi = &new_dpi;
148 
149  /* Draw content (now coordinates given to DrawString* are local to the new clipping region). */
150  int line_height = FONT_HEIGHT_MONO;
151  int y_offset = -this->vscroll->GetPosition();
152 
153  for (uint i = 0; i < this->lines.size(); i++) {
155  y_offset = DrawStringMultiLine(0, right - x, y_offset, bottom - y, this->lines[i], TC_WHITE, SA_TOP | SA_LEFT, false, FS_MONO);
156  } else {
157  DrawString(-this->hscroll->GetPosition(), right - x, y_offset, this->lines[i], TC_WHITE, SA_TOP | SA_LEFT, false, FS_MONO);
158  y_offset += line_height; // margin to previous element
159  }
160  }
161 
162  _cur_dpi = old_dpi;
163 }
164 
165 /* virtual */ void TextfileWindow::OnResize()
166 {
169 
170  this->SetupScrollbars();
171 }
172 
173 /* virtual */ void TextfileWindow::Reset()
174 {
175  this->search_iterator = 0;
176 }
177 
179 {
180  return FS_MONO;
181 }
182 
183 /* virtual */ const char *TextfileWindow::NextString()
184 {
185  if (this->search_iterator >= this->lines.size()) return nullptr;
186 
187  return this->lines[this->search_iterator++];
188 }
189 
190 /* virtual */ bool TextfileWindow::Monospace()
191 {
192  return true;
193 }
194 
195 /* virtual */ void TextfileWindow::SetFontNames(FreeTypeSettings *settings, const char *font_name, const void *os_data)
196 {
197 #if defined(WITH_FREETYPE) || defined(_WIN32)
198  strecpy(settings->mono.font, font_name, lastof(settings->mono.font));
199  free(settings->mono.os_handle);
200  settings->mono.os_handle = os_data;
201 #endif
202 }
203 
204 #if defined(WITH_ZLIB)
205 
220 static void Gunzip(byte **bufp, size_t *sizep)
221 {
222  static const int BLOCKSIZE = 8192;
223  byte *buf = nullptr;
224  size_t alloc_size = 0;
225  z_stream z;
226  int res;
227 
228  memset(&z, 0, sizeof(z));
229  z.next_in = *bufp;
230  z.avail_in = (uInt)*sizep;
231 
232  /* window size = 15, add 32 to enable gzip or zlib header processing */
233  res = inflateInit2(&z, 15 + 32);
234  /* Z_BUF_ERROR just means we need more space */
235  while (res == Z_OK || (res == Z_BUF_ERROR && z.avail_out == 0)) {
236  /* When we get here, we're either just starting, or
237  * inflate is out of output space - allocate more */
238  alloc_size += BLOCKSIZE;
239  z.avail_out += BLOCKSIZE;
240  buf = ReallocT(buf, alloc_size);
241  z.next_out = buf + alloc_size - z.avail_out;
242  res = inflate(&z, Z_FINISH);
243  }
244 
245  free(*bufp);
246  inflateEnd(&z);
247 
248  if (res == Z_STREAM_END) {
249  *bufp = buf;
250  *sizep = alloc_size - z.avail_out;
251  } else {
252  /* Something went wrong */
253  *bufp = nullptr;
254  *sizep = 0;
255  free(buf);
256  }
257 }
258 #endif
259 
260 #if defined(WITH_LIBLZMA)
261 
276 static void Xunzip(byte **bufp, size_t *sizep)
277 {
278  static const int BLOCKSIZE = 8192;
279  byte *buf = nullptr;
280  size_t alloc_size = 0;
281  lzma_stream z = LZMA_STREAM_INIT;
282  int res;
283 
284  z.next_in = *bufp;
285  z.avail_in = *sizep;
286 
287  res = lzma_auto_decoder(&z, UINT64_MAX, LZMA_CONCATENATED);
288  /* Z_BUF_ERROR just means we need more space */
289  while (res == LZMA_OK || (res == LZMA_BUF_ERROR && z.avail_out == 0)) {
290  /* When we get here, we're either just starting, or
291  * inflate is out of output space - allocate more */
292  alloc_size += BLOCKSIZE;
293  z.avail_out += BLOCKSIZE;
294  buf = ReallocT(buf, alloc_size);
295  z.next_out = buf + alloc_size - z.avail_out;
296  res = lzma_code(&z, LZMA_FINISH);
297  }
298 
299  free(*bufp);
300  lzma_end(&z);
301 
302  if (res == LZMA_STREAM_END) {
303  *bufp = buf;
304  *sizep = alloc_size - z.avail_out;
305  } else {
306  /* Something went wrong */
307  *bufp = nullptr;
308  *sizep = 0;
309  free(buf);
310  }
311 }
312 #endif
313 
314 
318 /* virtual */ void TextfileWindow::LoadTextfile(const char *textfile, Subdirectory dir)
319 {
320  if (textfile == nullptr) return;
321 
322  this->lines.clear();
323 
324  /* Get text from file */
325  size_t filesize;
326  FILE *handle = FioFOpenFile(textfile, "rb", dir, &filesize);
327  if (handle == nullptr) return;
328 
329  this->text = ReallocT(this->text, filesize);
330  size_t read = fread(this->text, 1, filesize, handle);
331  fclose(handle);
332 
333  if (read != filesize) return;
334 
335 #if defined(WITH_ZLIB) || defined(WITH_LIBLZMA)
336  const char *suffix = strrchr(textfile, '.');
337  if (suffix == nullptr) return;
338 #endif
339 
340 #if defined(WITH_ZLIB)
341  /* In-place gunzip */
342  if (strcmp(suffix, ".gz") == 0) Gunzip((byte**)&this->text, &filesize);
343 #endif
344 
345 #if defined(WITH_LIBLZMA)
346  /* In-place xunzip */
347  if (strcmp(suffix, ".xz") == 0) Xunzip((byte**)&this->text, &filesize);
348 #endif
349 
350  if (!this->text) return;
351 
352  /* Add space for trailing \0 */
353  this->text = ReallocT(this->text, filesize + 1);
354  this->text[filesize] = '\0';
355 
356  /* Replace tabs and line feeds with a space since str_validate removes those. */
357  for (char *p = this->text; *p != '\0'; p++) {
358  if (*p == '\t' || *p == '\r') *p = ' ';
359  }
360 
361  /* Check for the byte-order-mark, and skip it if needed. */
362  char *p = this->text + (strncmp("\xEF\xBB\xBF", this->text, 3) == 0 ? 3 : 0);
363 
364  /* Make sure the string is a valid UTF-8 sequence. */
366 
367  /* Split the string on newlines. */
368  this->lines.push_back(p);
369  for (; *p != '\0'; p++) {
370  if (*p == '\n') {
371  *p = '\0';
372  this->lines.push_back(p + 1);
373  }
374  }
375 
376  CheckForMissingGlyphs(true, this);
377 }
378 
386 const char *GetTextfile(TextfileType type, Subdirectory dir, const char *filename)
387 {
388  static const char * const prefixes[] = {
389  "readme",
390  "changelog",
391  "license",
392  };
393  assert_compile(lengthof(prefixes) == TFT_END);
394 
395  const char *prefix = prefixes[type];
396 
397  if (filename == nullptr) return nullptr;
398 
399  static char file_path[MAX_PATH];
400  strecpy(file_path, filename, lastof(file_path));
401 
402  char *slash = strrchr(file_path, PATHSEPCHAR);
403  if (slash == nullptr) return nullptr;
404 
405  static const char * const exts[] = {
406  "txt",
407 #if defined(WITH_ZLIB)
408  "txt.gz",
409 #endif
410 #if defined(WITH_LIBLZMA)
411  "txt.xz",
412 #endif
413  };
414 
415  for (size_t i = 0; i < lengthof(exts); i++) {
416  seprintf(slash + 1, lastof(file_path), "%s_%s.%s", prefix, GetCurrentLanguageIsoCode(), exts[i]);
417  if (FioCheckFileExists(file_path, dir)) return file_path;
418 
419  seprintf(slash + 1, lastof(file_path), "%s_%.2s.%s", prefix, GetCurrentLanguageIsoCode(), exts[i]);
420  if (FioCheckFileExists(file_path, dir)) return file_path;
421 
422  seprintf(slash + 1, lastof(file_path), "%s.%s", prefix, exts[i]);
423  if (FioCheckFileExists(file_path, dir)) return file_path;
424  }
425  return nullptr;
426 }
bool Monospace() override
Whether to search for a monospace font or not.
void CheckForMissingGlyphs(bool base_font, MissingGlyphSearcher *searcher)
Check whether the currently loaded language pack uses characters that the currently loaded font does ...
Definition: strings.cpp:2097
Data about how and where to blit pixels.
Definition: gfx_type.h:154
ResizeInfo resize
Resize information.
Definition: window_gui.h:322
static NWidgetPart SetResize(int16 dx, int16 dy)
Widget part function for setting the resize step.
Definition: widget_type.h:928
void SetWidgetDisabledState(byte widget_index, bool disab_stat)
Sets the enabled/disabled status of a widget.
Definition: window_gui.h:392
static void Xunzip(byte **bufp, size_t *sizep)
Do an in-memory xunzip operation.
Subdirectory
The different kinds of subdirectories OpenTTD uses.
Definition: fileio_type.h:108
High level window description.
Definition: window_gui.h:166
char * text
Lines of text from the NewGRF&#39;s textfile.
Definition: textfile_gui.h:25
static WindowDesc _textfile_desc(WDP_CENTER, "textfile", 630, 460, WC_TEXTFILE, WC_NONE, 0, _nested_textfile_widgets, lengthof(_nested_textfile_widgets))
Window definition for the textfile window.
int CDECL seprintf(char *str, const char *last, const char *format,...)
Safer implementation of snprintf; same as snprintf except:
Definition: string.cpp:407
textfile; Window numbers:
Definition: window_type.h:180
Horizontal container.
Definition: widget_type.h:73
#define FONT_HEIGHT_MONO
Height of characters in the large (FS_MONO) font.
Definition: gfx_func.h:182
Index of the monospaced font in the font tables.
Definition: gfx_type.h:205
static void Gunzip(byte **bufp, size_t *sizep)
Do an in-memory gunzip operation.
void OnClick(Point pt, int widget, int click_count) override
A click with the left mouse button has been made on the window.
fluid_settings_t * settings
FluidSynth settings handle.
Definition: fluidsynth.cpp:20
Resize box (normally at bottom-right of a window)
Definition: widget_type.h:66
Horizontal scrollbar to scroll through the textfile left-to-right.
Definition: misc_widget.h:53
void ToggleWidgetLoweredState(byte widget_index)
Invert the lowered/raised status of a widget.
Definition: window_gui.h:463
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
int GetStringHeight(const char *str, int maxw, FontSize fontsize)
Calculates height of string (in pixels).
Definition: gfx.cpp:547
Close box (at top-left of a window)
Definition: widget_type.h:67
Functions for Standard In/Out file operations.
#define lastof(x)
Get the last element of an fixed size array.
Definition: depend.cpp:48
static T max(const T a, const T b)
Returns the maximum of two values.
Definition: math_func.hpp:24
bool FillDrawPixelInfo(DrawPixelInfo *n, int left, int top, int width, int height)
Set up a clipping area for only drawing into a certain area.
Definition: gfx.cpp:1481
Settings for the freetype fonts.
Definition: fontcache.h:224
void SetCount(int num)
Sets the number of elements in the list.
Definition: widget_type.h:668
Partial widget specification to allow NWidgets to be written nested.
Definition: widget_type.h:908
Data structure for an opened window.
Definition: window_gui.h:276
Functions to read fonts from files and cache them.
Bottom offset of the text of the frame.
Definition: window_gui.h:73
uint GetContentHeight()
Get the total height of the content displayed in this window, if wrapping is disabled.
Functions related to low-level strings.
FontSize DefaultSize() override
Get the default (font) size of the string.
uint search_iterator
Iterator for the font check search.
Definition: textfile_gui.h:27
Default window size box (at top-right of a window, between WWT_SHADEBOX and WWT_STICKYBOX) ...
Definition: widget_type.h:63
bool IsWidgetLowered(byte widget_index) const
Gets the lowered state of a widget.
Definition: window_gui.h:493
void str_validate(char *str, const char *last, StringValidationSettings settings)
Scans the string for valid characters and if it finds invalid ones, replaces them with a question mar...
Definition: string.cpp:194
FreeTypeSubSetting mono
The mono space font used for license/readme viewers.
Definition: fontcache.h:228
const char * NextString() override
Get the next string to search through.
Whether or not to wrap the text.
Definition: misc_widget.h:50
void SetFontNames(FreeTypeSettings *settings, const char *font_name, const void *os_data) override
Set the right font names.
Types related to the misc widgets.
static NWidgetPart SetDataTip(uint32 data, StringID tip)
Widget part function for setting the data and tooltip.
Definition: widget_type.h:1012
Functions related to the gfx engine.
static NWidgetPart SetMinimalSize(int16 x, int16 y)
Widget part function for setting the minimal size.
Definition: widget_type.h:945
FILE * FioFOpenFile(const char *filename, const char *mode, Subdirectory subdir, size_t *filesize)
Opens a OpenTTD file somewhere in a personal or global directory.
Definition: fileio.cpp:463
Definition of base types and functions in a cross-platform compatible way.
static const int BOTTOM_SPACING
Additional spacing at the bottom of the WID_TF_BACKGROUND widget.
Definition: textfile_gui.h:30
Allow newlines.
Definition: string_type.h:51
Top align the text.
Definition: gfx_func.h:99
A number of safeguards to prevent using unsafe methods.
Simple depressed panel.
Definition: widget_type.h:48
Horizontal scrollbar.
Definition: widget_type.h:81
static T * ReallocT(T *t_ptr, size_t num_elements)
Simplified reallocation function that allocates the specified number of elements of the given type...
Definition: alloc_func.hpp:111
Center the window.
Definition: window_gui.h:155
virtual void LoadTextfile(const char *textfile, Subdirectory dir)
Loads the textfile text from file and setup lines.
static NWidgetPart NWidget(WidgetType tp, Colours col, int16 idx=-1)
Widget part function for starting a new &#39;real&#39; widget.
Definition: widget_type.h:1112
int DrawString(int left, int right, int top, const char *str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly truncated to make it fit in its allocated space.
Definition: gfx.cpp:498
Right offset of the text of the frame.
Definition: window_gui.h:71
#define lengthof(x)
Return the length of an fixed size array.
Definition: depend.cpp:40
TextfileType
Additional text files accompanying Tar archives.
Definition: textfile_type.h:14
Top offset of the text of the frame.
Definition: window_gui.h:72
Left offset of the text of the frame.
Definition: window_gui.h:70
bool FioCheckFileExists(const char *filename, Subdirectory subdir)
Check whether the given file exists.
Definition: fileio.cpp:310
static const int TOP_SPACING
Additional spacing at the top of the WID_TF_BACKGROUND widget.
Definition: textfile_gui.h:29
Scrollbar * hscroll
Horizontal scrollbar.
Definition: textfile_gui.h:24
void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
Update size and resize step of a widget in the window.
void SetupScrollbars()
Set scrollbars to the right lengths.
Dimension GetStringBoundingBox(const char *str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition: gfx.cpp:700
No window, redirects to WC_MAIN_WINDOW.
Definition: window_type.h:38
char font[MAX_PATH]
The name of the font, or path to the font.
Definition: fontcache.h:216
const char * GetCurrentLanguageIsoCode()
Get the ISO language code of the currently loaded language.
Definition: strings.cpp:1997
static const NWidgetPart _nested_textfile_widgets[]
Widgets for the textfile window.
const void * os_handle
Optional native OS font info.
Definition: fontcache.h:220
Window caption (window title between closebox and stickybox)
Definition: widget_type.h:59
Replace the unknown/bad bits with question marks.
Definition: string_type.h:50
void Reset() override
Reset the search, i.e.
Panel to draw the textfile on.
Definition: misc_widget.h:51
Vertical container.
Definition: widget_type.h:75
static NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME, WWT_INSET, or WWT_PANEL).
Definition: widget_type.h:997
FontSize
Available font sizes.
Definition: gfx_type.h:201
Scrollbar * vscroll
Vertical scrollbar.
Definition: textfile_gui.h:23
char * strecpy(char *dst, const char *src, const char *last)
Copies characters from one buffer to another.
Definition: depend.cpp:66
Coordinates of a point in 2D.
std::vector< const char * > lines
text, split into lines in a table with lines.
Definition: textfile_gui.h:26
static void free(const void *ptr)
Version of the standard free that accepts const pointers.
Definition: depend.cpp:129
Offset at right to draw the frame rectangular area.
Definition: window_gui.h:61
int width
width of the window (number of pixels to the right in x direction)
Definition: window_gui.h:319
The caption of the window.
Definition: misc_widget.h:49
void SetCapacityFromWidget(Window *w, int widget, int padding=0)
Set capacity of visible elements from the size and resize properties of a widget. ...
Definition: widget.cpp:1971
Specification of a rectangle with absolute coordinates of all edges.
Vertical scrollbar.
Definition: widget_type.h:82
Left align the text.
Definition: gfx_func.h:94
const char * GetTextfile(TextfileType type, Subdirectory dir, const char *filename)
Search a textfile file next to the given content.
Vertical scrollbar to scroll through the textfile up-and-down.
Definition: misc_widget.h:52
static NWidgetPart SetScrollbar(int index)
Attach a scrollbar to a widget.
Definition: widget_type.h:1093
Dimensions (a width and height) of a rectangle in 2D.
Types related to the graphics and/or input devices.
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window&#39;s data as invalid (in need of re-computing)
Definition: window.cpp:3256
int height
Height of the window (number of pixels down in y direction)
Definition: window_gui.h:320
GUI functions related to textfiles.
int DrawStringMultiLine(int left, int right, int top, int bottom, const char *str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly over multiple lines.
Definition: gfx.cpp:621
(Toggle) Button with text
Definition: widget_type.h:53
void OnResize() override
Called after the window got resized.
uint16 GetPosition() const
Gets the position of the first visible element in the list.
Definition: widget_type.h:629