1 // ============================================================================
2 // Artsoft Retro-Game Library
3 // ----------------------------------------------------------------------------
4 // (c) 1995-2014 by Artsoft Entertainment
7 // http://www.artsoft.org/
8 // ----------------------------------------------------------------------------
10 // ============================================================================
19 /* ========================================================================= */
21 /* ========================================================================= */
23 void InitFontInfo(struct FontBitmapInfo *font_bitmap_info, int num_fonts,
24 int (*select_font_function)(int),
25 int (*get_font_from_token_function)(char *))
27 gfx.num_fonts = num_fonts;
28 gfx.font_bitmap_info = font_bitmap_info;
29 gfx.select_font_function = select_font_function;
30 gfx.get_font_from_token_function = get_font_from_token_function;
33 void FreeFontInfo(struct FontBitmapInfo *font_bitmap_info)
35 if (font_bitmap_info == NULL)
38 free(font_bitmap_info);
41 struct FontBitmapInfo *getFontBitmapInfo(int font_nr)
43 int font_bitmap_id = gfx.select_font_function(font_nr);
45 return &gfx.font_bitmap_info[font_bitmap_id];
48 int getFontWidth(int font_nr)
50 int font_bitmap_id = gfx.select_font_function(font_nr);
52 return gfx.font_bitmap_info[font_bitmap_id].width;
55 int getFontHeight(int font_nr)
57 int font_bitmap_id = gfx.select_font_function(font_nr);
59 return gfx.font_bitmap_info[font_bitmap_id].height;
62 int getFontDrawOffsetX(int font_nr)
64 int font_bitmap_id = gfx.select_font_function(font_nr);
66 return gfx.font_bitmap_info[font_bitmap_id].draw_xoffset;
69 int getFontDrawOffsetY(int font_nr)
71 int font_bitmap_id = gfx.select_font_function(font_nr);
73 return gfx.font_bitmap_info[font_bitmap_id].draw_yoffset;
76 int getTextWidth(char *text, int font_nr)
78 return (text != NULL ? strlen(text) * getFontWidth(font_nr) : 0);
81 static int getFontCharPosition(int font_nr, char c)
83 int font_bitmap_id = gfx.select_font_function(font_nr);
84 struct FontBitmapInfo *font = &gfx.font_bitmap_info[font_bitmap_id];
85 boolean default_font = (font->num_chars == DEFAULT_NUM_CHARS_PER_FONT);
86 int font_pos = (unsigned char)c - 32;
88 /* map some special characters to their ascii values in default font */
90 font_pos = MAP_FONT_ASCII(c) - 32;
92 /* this allows dynamic special characters together with special font */
93 if (font_pos < 0 || font_pos >= font->num_chars)
99 void getFontCharSource(int font_nr, char c, Bitmap **bitmap, int *x, int *y)
101 int font_bitmap_id = gfx.select_font_function(font_nr);
102 struct FontBitmapInfo *font = &gfx.font_bitmap_info[font_bitmap_id];
103 int font_pos = getFontCharPosition(font_nr, c);
104 int offset_x = (font->offset_x != 0 ? font->offset_x : font->width);
105 int offset_y = (font->offset_y != 0 ? font->offset_y : font->height);
107 *bitmap = font->bitmap;
108 *x = font->src_x + (font_pos % font->num_chars_per_line) * offset_x;
109 *y = font->src_y + (font_pos / font->num_chars_per_line) * offset_y;
113 /* ========================================================================= */
114 /* text string helper functions */
115 /* ========================================================================= */
117 int maxWordLengthInString(char *text)
120 int word_len = 0, max_word_len = 0;
122 for (text_ptr = text; *text_ptr; text_ptr++)
124 word_len = (*text_ptr != ' ' ? word_len + 1 : 0);
126 max_word_len = MAX(word_len, max_word_len);
133 /* ========================================================================= */
134 /* simple text drawing functions */
135 /* ========================================================================= */
137 void DrawInitText(char *text, int ypos, int font_nr)
139 LimitScreenUpdates(TRUE);
143 if (window != NULL &&
144 gfx.draw_init_text &&
146 gfx.font_bitmap_info[font_nr].bitmap != NULL)
148 int x = (video.width - getTextWidth(text, font_nr)) / 2;
150 int width = video.width;
151 int height = getFontHeight(font_nr);
153 ClearRectangle(drawto, 0, y, width, height);
154 DrawTextExt(drawto, x, y, text, font_nr, BLIT_OPAQUE);
156 BlitBitmap(drawto, window, 0, 0, video.width, video.height, 0, 0);
160 void DrawTextF(int x, int y, int font_nr, char *format, ...)
162 char buffer[MAX_OUTPUT_LINESIZE + 1];
165 va_start(ap, format);
166 vsprintf(buffer, format, ap);
169 if (strlen(buffer) > MAX_OUTPUT_LINESIZE)
170 Error(ERR_EXIT, "string too long in DrawTextF() -- aborting");
172 DrawText(gfx.sx + x, gfx.sy + y, buffer, font_nr);
175 void DrawTextFCentered(int y, int font_nr, char *format, ...)
177 char buffer[MAX_OUTPUT_LINESIZE + 1];
180 va_start(ap, format);
181 vsprintf(buffer, format, ap);
184 if (strlen(buffer) > MAX_OUTPUT_LINESIZE)
185 Error(ERR_EXIT, "string too long in DrawTextFCentered() -- aborting");
187 DrawText(gfx.sx + (gfx.sxsize - getTextWidth(buffer, font_nr)) / 2,
188 gfx.sy + y, buffer, font_nr);
191 void DrawTextS(int x, int y, int font_nr, char *text)
193 DrawText(gfx.sx + x, gfx.sy + y, text, font_nr);
196 void DrawTextSCentered(int y, int font_nr, char *text)
198 DrawText(gfx.sx + (gfx.sxsize - getTextWidth(text, font_nr)) / 2,
199 gfx.sy + y, text, font_nr);
202 void DrawTextSAligned(int x, int y, char *text, int font_nr, int align)
204 DrawText(gfx.sx + ALIGNED_XPOS(x, getTextWidth(text, font_nr), align),
205 gfx.sx + y, text, font_nr);
208 void DrawTextAligned(int x, int y, char *text, int font_nr, int align)
210 DrawText(ALIGNED_XPOS(x, getTextWidth(text, font_nr), align),
214 void DrawText(int x, int y, char *text, int font_nr)
216 int mask_mode = BLIT_OPAQUE;
218 if (DrawingOnBackground(x, y))
219 mask_mode = BLIT_ON_BACKGROUND;
221 DrawTextExt(drawto, x, y, text, font_nr, mask_mode);
223 if (IN_GFX_FIELD_FULL(x, y))
224 redraw_mask |= REDRAW_FIELD;
225 else if (IN_GFX_DOOR_1(x, y))
226 redraw_mask |= REDRAW_DOOR_1;
227 else if (IN_GFX_DOOR_2(x, y))
228 redraw_mask |= REDRAW_DOOR_2;
229 else if (IN_GFX_DOOR_3(x, y))
230 redraw_mask |= REDRAW_DOOR_3;
232 redraw_mask |= REDRAW_ALL;
235 void DrawTextExt(DrawBuffer *dst_bitmap, int dst_x, int dst_y, char *text,
236 int font_nr, int mask_mode)
238 struct FontBitmapInfo *font = getFontBitmapInfo(font_nr);
239 int font_width = getFontWidth(font_nr);
240 int font_height = getFontHeight(font_nr);
243 char *text_ptr = text;
245 if (font->bitmap == NULL)
248 /* skip text to be printed outside the window (left/right will be clipped) */
249 if (dst_y < 0 || dst_y + font_height > video.height)
252 /* add offset for drawing font characters */
253 dst_x += font->draw_xoffset;
254 dst_y += font->draw_yoffset;
258 char c = *text_ptr++;
261 c = ' '; /* print space instead of newline */
263 getFontCharSource(font_nr, c, &src_bitmap, &src_x, &src_y);
265 /* clip text at the left side of the window */
273 /* clip text at the right side of the window */
274 if (dst_x + font_width > video.width)
277 if (mask_mode == BLIT_INVERSE) /* special mode for text gadgets */
279 /* first step: draw solid colored rectangle (use "cursor" character) */
280 if (strlen(text) == 1) /* only one char inverted => draw cursor */
282 Bitmap *cursor_bitmap;
283 int cursor_x, cursor_y;
285 getFontCharSource(font_nr, FONT_ASCII_CURSOR, &cursor_bitmap,
286 &cursor_x, &cursor_y);
288 BlitBitmap(cursor_bitmap, dst_bitmap, cursor_x, cursor_y,
289 font_width, font_height, dst_x, dst_y);
292 /* second step: draw masked inverted character */
293 SDLCopyInverseMasked(src_bitmap, dst_bitmap, src_x, src_y,
294 font_width, font_height, dst_x, dst_y);
296 else if (mask_mode == BLIT_MASKED || mask_mode == BLIT_ON_BACKGROUND)
298 if (mask_mode == BLIT_ON_BACKGROUND)
300 /* clear font character background */
301 ClearRectangleOnBackground(dst_bitmap, dst_x, dst_y,
302 font_width, font_height);
305 BlitBitmapMasked(src_bitmap, dst_bitmap, src_x, src_y,
306 font_width, font_height, dst_x, dst_y);
308 else /* normal, non-masked font blitting */
310 BlitBitmap(src_bitmap, dst_bitmap, src_x, src_y,
311 font_width, font_height, dst_x, dst_y);
319 /* ========================================================================= */
320 /* text buffer drawing functions */
321 /* ========================================================================= */
323 #define MAX_LINES_FROM_FILE 1024
325 char *GetTextBufferFromFile(char *filename, int max_lines)
331 if (filename == NULL)
334 if (!(file = openFile(filename, MODE_READ)))
337 buffer = checked_calloc(1); /* start with valid, but empty text buffer */
339 while (!checkEndOfFile(file) && num_lines < max_lines)
341 char line[MAX_LINE_LEN];
343 /* read next line of input file */
344 if (!getStringFromFile(file, line, MAX_LINE_LEN))
347 buffer = checked_realloc(buffer, strlen(buffer) + strlen(line) + 1);
349 strcat(buffer, line);
359 static boolean RenderLineToBuffer(char **src_buffer_ptr, char *dst_buffer,
360 int *dst_buffer_len, int line_length,
361 boolean last_line_was_empty)
363 char *text_ptr = *src_buffer_ptr;
364 char *buffer = dst_buffer;
365 int buffer_len = *dst_buffer_len;
366 boolean buffer_filled = FALSE;
373 /* skip leading whitespaces */
374 while (*text_ptr == ' ' || *text_ptr == '\t')
380 /* look for end of next word */
381 while (*word_ptr != ' ' && *word_ptr != '\t' && *word_ptr != '\0')
391 else if (*text_ptr == '\n') /* special case: force empty line */
396 /* prevent printing of multiple empty lines */
397 if (buffer_len > 0 || !last_line_was_empty)
398 buffer_filled = TRUE;
400 else if (word_len < line_length - buffer_len)
402 /* word fits into text buffer -- add word */
405 buffer[buffer_len++] = ' ';
407 strncpy(&buffer[buffer_len], text_ptr, word_len);
408 buffer_len += word_len;
409 buffer[buffer_len] = '\0';
410 text_ptr += word_len;
412 else if (buffer_len > 0)
414 /* not enough space left for word in text buffer -- print buffer */
416 buffer_filled = TRUE;
420 /* word does not fit at all into empty text buffer -- cut word */
422 strncpy(buffer, text_ptr, line_length);
423 buffer[line_length] = '\0';
424 text_ptr += line_length;
425 buffer_filled = TRUE;
432 *src_buffer_ptr = text_ptr;
433 *dst_buffer_len = buffer_len;
435 return buffer_filled;
438 static boolean getCheckedTokenValueFromString(char *string, char **token,
443 if (!getTokenValueFromString(string, token, value))
446 if (**token != '.') /* token should begin with dot */
449 for (ptr = *token; *ptr; ptr++) /* token should contain no whitespace */
450 if (*ptr == ' ' || *ptr == '\t')
453 for (ptr = *value; *ptr; ptr++) /* value should contain no whitespace */
454 if (*ptr == ' ' || *ptr == '\t')
460 static void DrawTextBuffer_Flush(int x, int y, char *buffer, int font_nr,
461 int line_length, int cut_length,
462 int mask_mode, boolean centered,
465 int buffer_len = strlen(buffer);
466 int font_width = getFontWidth(font_nr);
467 int offset_chars = (centered ? (line_length - buffer_len) / 2 : 0);
469 (centered ? font_width * (line_length - buffer_len) / 2 : 0);
470 int final_cut_length = MAX(0, cut_length - offset_chars);
471 int xx = x + offset_xsize;
472 int yy = y + current_ypos;
474 buffer[final_cut_length] = '\0';
477 DrawTextExt(drawto, xx, yy, buffer, font_nr, mask_mode);
479 DrawText(xx, yy, buffer, font_nr);
482 int DrawTextBuffer(int x, int y, char *text_buffer, int font_nr,
483 int line_length, int cut_length, int max_lines,
484 int line_spacing, int mask_mode, boolean autowrap,
485 boolean centered, boolean parse_comments)
487 char buffer[line_length + 1];
489 int font_height = getFontHeight(font_nr);
490 int line_height = font_height + line_spacing;
491 int current_line = 0;
492 int current_ypos = 0;
493 int max_ysize = max_lines * line_height;
495 if (text_buffer == NULL || *text_buffer == '\0')
498 if (current_line >= max_lines)
501 if (cut_length == -1)
502 cut_length = line_length;
507 while (*text_buffer && current_ypos < max_ysize)
509 char line[MAX_LINE_LEN + 1];
511 boolean last_line_was_empty = TRUE;
512 int num_line_chars = MAX_LINE_LEN;
515 /* copy next line from text buffer to line buffer (nearly fgets() style) */
516 for (i = 0; i < num_line_chars && *text_buffer; i++)
517 if ((line[i] = *text_buffer++) == '\n')
521 /* prevent 'num_line_chars' sized lines to cause additional empty line */
522 if (i == num_line_chars && *text_buffer == '\n')
525 /* skip comments (lines directly beginning with '#') */
526 if (line[0] == '#' && parse_comments)
530 /* try to read generic token/value pair definition after comment sign */
531 if (getCheckedTokenValueFromString(line + 1, &token, &value))
533 /* if found, flush the current buffer, if non-empty */
534 if (buffer_len > 0 && current_ypos < max_ysize)
536 DrawTextBuffer_Flush(x, y, buffer, font_nr, line_length, cut_length,
537 mask_mode, centered, current_ypos);
538 current_ypos += line_height;
545 if (strEqual(token, ".font"))
546 font_nr = gfx.get_font_from_token_function(value);
547 else if (strEqual(token, ".autowrap"))
548 autowrap = get_boolean_from_string(value);
549 else if (strEqual(token, ".centered"))
550 centered = get_boolean_from_string(value);
551 else if (strEqual(token, ".parse_comments"))
552 parse_comments = get_boolean_from_string(value);
554 // if font has changed, depending values need to be updated as well
555 font_height = getFontHeight(font_nr);
556 line_height = font_height + line_spacing;
562 /* cut trailing newline and carriage return from input line */
563 for (line_ptr = line; *line_ptr; line_ptr++)
565 if (*line_ptr == '\n' || *line_ptr == '\r')
572 if (strlen(line) == 0) /* special case: force empty line */
577 while (*line_ptr && current_ypos < max_ysize)
579 boolean buffer_filled;
583 buffer_filled = RenderLineToBuffer(&line_ptr, buffer, &buffer_len,
584 line_length, last_line_was_empty);
588 if (strlen(line_ptr) <= line_length)
590 buffer_len = strlen(line_ptr);
591 strcpy(buffer, line_ptr);
595 buffer_len = line_length;
596 strncpy(buffer, line_ptr, line_length);
599 buffer[buffer_len] = '\0';
600 line_ptr += buffer_len;
602 buffer_filled = TRUE;
607 DrawTextBuffer_Flush(x, y, buffer, font_nr, line_length, cut_length,
608 mask_mode, centered, current_ypos);
609 current_ypos += line_height;
612 last_line_was_empty = (buffer_len == 0);
620 if (buffer_len > 0 && current_ypos < max_ysize)
622 DrawTextBuffer_Flush(x, y, buffer, font_nr, line_length, cut_length,
623 mask_mode, centered, current_ypos);
624 current_ypos += line_height;
631 int DrawTextBufferVA(int x, int y, char *format, va_list ap, int font_nr,
632 int line_length, int cut_length, int max_lines,
633 int line_spacing, int mask_mode, boolean autowrap,
634 boolean centered, boolean parse_comments)
636 char text_buffer[MAX_OUTPUT_LINESIZE];
637 int text_length = vsnprintf(text_buffer, MAX_OUTPUT_LINESIZE, format, ap);
639 if (text_length >= MAX_OUTPUT_LINESIZE)
640 Error(ERR_WARN, "string too long in DrawTextBufferVA() -- truncated");
642 int num_lines_printed = DrawTextBuffer(x, y, text_buffer, font_nr,
643 line_length, cut_length, max_lines,
644 line_spacing, mask_mode, autowrap,
645 centered, parse_comments);
646 return num_lines_printed;
649 int DrawTextFile(int x, int y, char *filename, int font_nr,
650 int line_length, int cut_length, int max_lines,
651 int line_spacing, int mask_mode, boolean autowrap,
652 boolean centered, boolean parse_comments)
654 char *text_buffer = GetTextBufferFromFile(filename, MAX_LINES_FROM_FILE);
655 int num_lines_printed = DrawTextBuffer(x, y, text_buffer, font_nr,
656 line_length, cut_length, max_lines,
657 line_spacing, mask_mode, autowrap,
658 centered, parse_comments);
659 checked_free(text_buffer);
661 return num_lines_printed;