src/libgame/text.c

   1 /***********************************************************
   2 * Artsoft Retro-Game Library                               *
   3 *----------------------------------------------------------*
   4 * (c) 1994-2002 Artsoft Entertainment                      *
   5 *               Holger Schemel                             *
   6 *               Detmolder Strasse 189                      *
   7 *               33604 Bielefeld                            *
   8 *               Germany                                    *
   9 *               e-mail: info@artsoft.org                   *
  10 *----------------------------------------------------------*
  11 * text.c                                                   *
  12 ***********************************************************/
  13
  14 #include <stdio.h>
  15 #include <stdarg.h>
  16
  17 #include "text.h"
  18 #include "misc.h"
  19
  20
  21 /* ========================================================================= */
  22 /* font functions                                                            */
  23 /* ========================================================================= */
  24
  25 #if defined(TARGET_X11_NATIVE_PERFORMANCE_WORKAROUND)
  26 static GC       font_clip_gc = None;
  27
  28 static void InitFontClipmasks()
  29 {
  30   XGCValues clip_gc_values;
  31   unsigned long clip_gc_valuemask;
  32   GC copy_clipmask_gc;
  33   int i, j;
  34
  35   /* This stuff is needed because X11 (XSetClipOrigin(), to be precise) is
  36      often very slow when preparing a masked XCopyArea() for big Pixmaps.
  37      To prevent this, create small (tile-sized) mask Pixmaps which will then
  38      be set much faster with XSetClipOrigin() and speed things up a lot. */
  39
  40   clip_gc_values.graphics_exposures = False;
  41   clip_gc_valuemask = GCGraphicsExposures;
  42   font_clip_gc = XCreateGC(display, window->drawable,
  43                            clip_gc_valuemask, &clip_gc_values);
  44
  45   /* create graphic context structures needed for clipping */
  46   clip_gc_values.graphics_exposures = False;
  47   clip_gc_valuemask = GCGraphicsExposures;
  48   copy_clipmask_gc = XCreateGC(display,
  49                                gfx.font_bitmap_info[0].bitmap->clip_mask,
  50                                clip_gc_valuemask, &clip_gc_values);
  51
  52   /* create only those clipping Pixmaps we really need */
  53   for (i = 0; i < gfx.num_fonts; i++)
  54   {
  55     if (gfx.font_bitmap_info[i].bitmap == NULL)
  56       continue;
  57
  58     gfx.font_bitmap_info[i].clip_mask =
  59       checked_calloc(gfx.font_bitmap_info[i].num_chars * sizeof(Pixmap));
  60
  61     for (j = 0; j < gfx.font_bitmap_info[i].num_chars; j++)
  62     {
  63       Bitmap *src_bitmap = gfx.font_bitmap_info[i].bitmap;
  64       Pixmap src_pixmap = src_bitmap->clip_mask;
  65       int xpos = j % gfx.font_bitmap_info[i].num_chars_per_line;
  66       int ypos = j / gfx.font_bitmap_info[i].num_chars_per_line;
  67       int width  = gfx.font_bitmap_info[i].width;
  68       int height = gfx.font_bitmap_info[i].height;
  69       int src_x = gfx.font_bitmap_info[i].src_x + xpos * width;
  70       int src_y = gfx.font_bitmap_info[i].src_y + ypos * height;
  71
  72       gfx.font_bitmap_info[i].clip_mask[j] =
  73         XCreatePixmap(display, window->drawable, width, height, 1);
  74
  75       XCopyArea(display, src_pixmap, gfx.font_bitmap_info[i].clip_mask[j],
  76                 copy_clipmask_gc, src_x, src_y, width, height, 0, 0);
  77     }
  78   }
  79
  80   XFreeGC(display, copy_clipmask_gc);
  81 }
  82
  83 static void FreeFontClipmasks()
  84 {
  85   int i, j;
  86
  87   if (gfx.num_fonts == 0 || gfx.font_bitmap_info[0].bitmap == NULL)
  88     return;
  89
  90   for (i = 0; i < gfx.num_fonts; i++)
  91   {
  92     if (gfx.font_bitmap_info[i].clip_mask)
  93     {
  94       for (j = 0; j < gfx.font_bitmap_info[i].num_chars; j++)
  95         XFreePixmap(display, gfx.font_bitmap_info[i].clip_mask[j]);
  96       free(gfx.font_bitmap_info[i].clip_mask);
  97     }
  98
  99     gfx.font_bitmap_info[i].clip_mask = NULL;
 100     gfx.font_bitmap_info[i].num_chars = 0;
 101   }
 102
 103   if (font_clip_gc)
 104     XFreeGC(display, font_clip_gc);
 105   font_clip_gc = None;
 106 }
 107 #endif /* TARGET_X11_NATIVE_PERFORMANCE_WORKAROUND */
 108
 109 void InitFontInfo(struct FontBitmapInfo *font_bitmap_info, int num_fonts,
 110                   int (*select_font_function)(int))
 111 {
 112   gfx.num_fonts = num_fonts;
 113   gfx.font_bitmap_info = font_bitmap_info;
 114   gfx.select_font_function = select_font_function;
 115
 116 #if defined(TARGET_X11_NATIVE_PERFORMANCE_WORKAROUND)
 117   InitFontClipmasks();
 118 #endif
 119 }
 120
 121 void FreeFontInfo(struct FontBitmapInfo *font_bitmap_info)
 122 {
 123   if (font_bitmap_info == NULL)
 124     return;
 125
 126 #if defined(TARGET_X11_NATIVE_PERFORMANCE_WORKAROUND)
 127   FreeFontClipmasks();
 128 #endif
 129
 130   free(font_bitmap_info);
 131 }
 132
 133 int getFontWidth(int font_nr)
 134 {
 135   int font_bitmap_id = gfx.select_font_function(font_nr);
 136
 137   return gfx.font_bitmap_info[font_bitmap_id].width;
 138 }
 139
 140 int getFontHeight(int font_nr)
 141 {
 142   int font_bitmap_id = gfx.select_font_function(font_nr);
 143
 144   return gfx.font_bitmap_info[font_bitmap_id].height;
 145 }
 146
 147 int getTextWidth(char *text, int font_nr)
 148 {
 149   return (text != NULL ? strlen(text) * getFontWidth(font_nr) : 0);
 150 }
 151
 152 static char getFontCharPosition(int font_nr, char c)
 153 {
 154   int font_bitmap_id = gfx.select_font_function(font_nr);
 155   struct FontBitmapInfo *font = &gfx.font_bitmap_info[font_bitmap_id];
 156   boolean default_font = (font->num_chars == DEFAULT_NUM_CHARS_PER_FONT);
 157   int font_pos = c - 32;
 158
 159   /* map some special characters to their ascii values in default font */
 160   if (default_font)
 161     font_pos = MAP_FONT_ASCII(c) - 32;
 162
 163   /* this allows dynamic special characters together with special font */
 164   if (font_pos < 0 || font_pos >= font->num_chars)
 165     font_pos = 0;
 166
 167   return font_pos;
 168 }
 169
 170 void getFontCharSource(int font_nr, char c, Bitmap **bitmap, int *x, int *y)
 171 {
 172   int font_bitmap_id = gfx.select_font_function(font_nr);
 173   struct FontBitmapInfo *font = &gfx.font_bitmap_info[font_bitmap_id];
 174   int font_pos = getFontCharPosition(font_nr, c);
 175
 176   *bitmap = font->bitmap;
 177   *x = font->src_x + (font_pos % font->num_chars_per_line) * font->width;
 178   *y = font->src_y + (font_pos / font->num_chars_per_line) * font->height;
 179 }
 180
 181 void DrawInitText(char *text, int ypos, int font_nr)
 182 {
 183   if (window &&
 184       gfx.num_fonts > 0 &&
 185       gfx.font_bitmap_info[font_nr].bitmap != NULL)
 186   {
 187     ClearRectangle(window, 0, ypos, video.width, getFontHeight(font_nr));
 188     DrawTextExt(window, (video.width - getTextWidth(text, font_nr)) / 2, ypos,
 189                 text, font_nr, BLIT_OPAQUE);
 190     FlushDisplay();
 191   }
 192 }
 193
 194 void DrawTextF(int x, int y, int font_nr, char *format, ...)
 195 {
 196   char buffer[MAX_OUTPUT_LINESIZE + 1];
 197   va_list ap;
 198
 199   va_start(ap, format);
 200   vsprintf(buffer, format, ap);
 201   va_end(ap);
 202
 203   if (strlen(buffer) > MAX_OUTPUT_LINESIZE)
 204     Error(ERR_EXIT, "string too long in DrawTextF() -- aborting");
 205
 206   DrawText(gfx.sx + x, gfx.sy + y, buffer, font_nr);
 207 }
 208
 209 void DrawTextFCentered(int y, int font_nr, char *format, ...)
 210 {
 211   char buffer[MAX_OUTPUT_LINESIZE + 1];
 212   va_list ap;
 213
 214   va_start(ap, format);
 215   vsprintf(buffer, format, ap);
 216   va_end(ap);
 217
 218   if (strlen(buffer) > MAX_OUTPUT_LINESIZE)
 219     Error(ERR_EXIT, "string too long in DrawTextFCentered() -- aborting");
 220
 221   DrawText(gfx.sx + (gfx.sxsize - getTextWidth(buffer, font_nr)) / 2,
 222            gfx.sy + y, buffer, font_nr);
 223 }
 224
 225 void DrawTextS(int x, int y, int font_nr, char *text)
 226 {
 227   DrawText(gfx.sx + x, gfx.sy + y, text, font_nr);
 228 }
 229
 230 void DrawTextSCentered(int y, int font_nr, char *text)
 231 {
 232   DrawText(gfx.sx + (gfx.sxsize - getTextWidth(text, font_nr)) / 2,
 233            gfx.sy + y, text, font_nr);
 234 }
 235
 236 void DrawText(int x, int y, char *text, int font_nr)
 237 {
 238   int mask_mode = BLIT_OPAQUE;
 239
 240   if (DrawingOnBackground(x, y))
 241     mask_mode = BLIT_ON_BACKGROUND;
 242
 243   DrawTextExt(drawto, x, y, text, font_nr, mask_mode);
 244
 245   if (x < gfx.dx)
 246     redraw_mask |= REDRAW_FIELD;
 247   else if (y < gfx.vy || gfx.vy == 0)
 248     redraw_mask |= REDRAW_DOOR_1;
 249 }
 250
 251 void DrawTextExt(DrawBuffer *dst_bitmap, int dst_x, int dst_y, char *text,
 252                  int font_nr, int mask_mode)
 253 {
 254   int font_bitmap_id = gfx.select_font_function(font_nr);
 255   struct FontBitmapInfo *font = &gfx.font_bitmap_info[font_bitmap_id];
 256   int font_width = getFontWidth(font_nr);
 257   int font_height = getFontHeight(font_nr);
 258   Bitmap *src_bitmap;
 259   int src_x, src_y;
 260   char *text_ptr = text;
 261
 262   if (font->bitmap == NULL)
 263     return;
 264
 265   /* add offset for drawing font characters */
 266   dst_x += font->draw_x;
 267   dst_y += font->draw_y;
 268
 269   while (*text_ptr)
 270   {
 271     char c = *text_ptr++;
 272
 273     if (c == '\n')
 274       c = ' ';          /* print space instaed of newline */
 275
 276     getFontCharSource(font_nr, c, &src_bitmap, &src_x, &src_y);
 277
 278     if (mask_mode == BLIT_INVERSE)      /* special mode for text gadgets */
 279     {
 280       /* first step: draw solid colored rectangle (use "cursor" character) */
 281       if (strlen(text) == 1)    /* only one char inverted => draw cursor */
 282       {
 283         Bitmap *cursor_bitmap;
 284         int cursor_x, cursor_y;
 285
 286         getFontCharSource(font_nr, FONT_ASCII_CURSOR, &cursor_bitmap,
 287                           &cursor_x, &cursor_y);
 288
 289         BlitBitmap(cursor_bitmap, dst_bitmap, cursor_x, cursor_y,
 290                    font_width, font_height, dst_x, dst_y);
 291       }
 292
 293 #if defined(TARGET_SDL)
 294       /* second step: draw masked inverted character */
 295       SDLCopyInverseMasked(src_bitmap, dst_bitmap, src_x, src_y,
 296                            font_width, font_height, dst_x, dst_y);
 297 #else
 298       /* second step: draw masked black rectangle (use "space" character) */
 299       SetClipOrigin(src_bitmap, src_bitmap->stored_clip_gc,
 300                     dst_x - src_x, dst_y - src_y);
 301       BlitBitmapMasked(src_bitmap, dst_bitmap, 0, 0,
 302                        font_width, font_height, dst_x, dst_y);
 303 #endif
 304     }
 305     else if (mask_mode == BLIT_MASKED || mask_mode == BLIT_ON_BACKGROUND)
 306     {
 307       if (mask_mode == BLIT_ON_BACKGROUND)
 308       {
 309         /* clear font character background */
 310         ClearRectangleOnBackground(dst_bitmap, dst_x, dst_y,
 311                                    font_width, font_height);
 312       }
 313
 314 #if defined(TARGET_X11_NATIVE_PERFORMANCE_WORKAROUND)
 315       /* use special font tile clipmasks */
 316       {
 317         int font_pos = getFontCharPosition(font_nr, c);
 318
 319         SetClipMask(src_bitmap, font_clip_gc, font->clip_mask[font_pos]);
 320         SetClipOrigin(src_bitmap, font_clip_gc, dst_x, dst_y);
 321       }
 322 #else
 323       SetClipOrigin(src_bitmap, src_bitmap->stored_clip_gc,
 324                     dst_x - src_x, dst_y - src_y);
 325 #endif
 326
 327       BlitBitmapMasked(src_bitmap, dst_bitmap, src_x, src_y,
 328                        font_width, font_height, dst_x, dst_y);
 329     }
 330     else        /* normal, non-masked font blitting */
 331     {
 332       BlitBitmap(src_bitmap, dst_bitmap, src_x, src_y,
 333                  font_width, font_height, dst_x, dst_y);
 334     }
 335
 336     dst_x += font_width;
 337   }
 338 }
 339
 340 void DrawTextToTextArea(int x, int y, char *text, int font_nr, int line_length,
 341                         int area_xsize, int area_ysize, int mask_mode)
 342 {
 343   int area_line = 0;
 344   int font_height = getFontHeight(font_nr);
 345
 346   if (text == NULL)
 347     return;
 348
 349   while (*text && area_line < area_ysize)
 350   {
 351     char buffer[MAX_OUTPUT_LINESIZE + 1];
 352     int i;
 353
 354     for (i = 0; i < line_length && *text; i++)
 355       if ((buffer[i] = *text++) == '\n')
 356         break;
 357     buffer[MIN(i, area_xsize)] = '\0';
 358
 359     DrawTextExt(drawto, x, y + area_line * font_height, buffer, font_nr,
 360                 mask_mode);
 361
 362     area_line++;
 363   }
 364
 365   redraw_mask |= REDRAW_FIELD;
 366 }
 367
 368 boolean RenderLineToBuffer(char **src_buffer_ptr, char *dst_buffer,
 369                            int *dst_buffer_len, boolean last_line_was_empty,
 370                            int line_length)
 371 {
 372   char *text_ptr = *src_buffer_ptr;
 373   char *buffer = dst_buffer;
 374   int buffer_len = *dst_buffer_len;
 375   boolean buffer_filled = FALSE;
 376
 377   while (*text_ptr)
 378   {
 379     char *word_ptr;
 380     int word_len;
 381
 382     /* skip leading whitespaces */
 383     while (*text_ptr == ' ' || *text_ptr == '\t')
 384       text_ptr++;
 385
 386     word_ptr = text_ptr;
 387     word_len = 0;
 388
 389     /* look for end of next word */
 390     while (*word_ptr != ' ' && *word_ptr != '\t' && *word_ptr != '\0')
 391     {
 392       word_ptr++;
 393       word_len++;
 394     }
 395
 396     if (word_len == 0)
 397     {
 398       continue;
 399     }
 400     else if (*text_ptr == '\n')         /* special case: force empty line */
 401     {
 402       if (buffer_len == 0)
 403         text_ptr++;
 404
 405       /* prevent printing of multiple empty lines */
 406       if (buffer_len > 0 || !last_line_was_empty)
 407         buffer_filled = TRUE;
 408     }
 409     else if (word_len < line_length - buffer_len)
 410     {
 411       /* word fits into text buffer -- add word */
 412
 413       if (buffer_len > 0)
 414         buffer[buffer_len++] = ' ';
 415
 416       strncpy(&buffer[buffer_len], text_ptr, word_len);
 417       buffer_len += word_len;
 418       buffer[buffer_len] = '\0';
 419       text_ptr += word_len;
 420     }
 421     else if (buffer_len > 0)
 422     {
 423       /* not enough space left for word in text buffer -- print buffer */
 424
 425       buffer_filled = TRUE;
 426     }
 427     else
 428     {
 429       /* word does not fit at all into empty text buffer -- cut word */
 430
 431       strncpy(buffer, text_ptr, line_length);
 432       buffer[line_length] = '\0';
 433       text_ptr += line_length;
 434       buffer_filled = TRUE;
 435     }
 436
 437     if (buffer_filled)
 438       break;
 439   }
 440
 441   *src_buffer_ptr = text_ptr;
 442   *dst_buffer_len = buffer_len;
 443
 444   return buffer_filled;
 445 }
 446
 447 void DrawTextWrapped(int x, int y, char *text, int font_nr, int line_length,
 448                      int max_lines)
 449 {
 450   char *text_ptr = text;
 451   char buffer[line_length + 1];
 452   int buffer_len;
 453   int current_line = 0;
 454   int font_height = getFontHeight(font_nr);
 455
 456   while (*text_ptr && current_line < max_lines)
 457   {
 458     buffer[0] = '\0';
 459     buffer_len = 0;
 460
 461     RenderLineToBuffer(&text_ptr, buffer, &buffer_len, TRUE, line_length);
 462
 463     DrawText(x, y + current_line * font_height, buffer, font_nr);
 464     current_line++;
 465   }
 466 }
 467
 468 int DrawTextFromFile(int x, int y, char *filename, int font_nr,
 469                      int line_length, int max_lines)
 470 {
 471   int font_height = getFontHeight(font_nr);
 472   char line[MAX_LINE_LEN];
 473   char buffer[line_length + 1];
 474   int buffer_len;
 475   int current_line = 0;
 476   FILE *file;
 477
 478   if (current_line >= max_lines)
 479     return 0;
 480
 481   if (filename == NULL)
 482     return 0;
 483
 484   if (!(file = fopen(filename, MODE_READ)))
 485     return 0;
 486
 487   buffer[0] = '\0';
 488   buffer_len = 0;
 489
 490   while (!feof(file) && current_line < max_lines)
 491   {
 492     char *line_ptr;
 493     boolean last_line_was_empty = TRUE;
 494
 495     /* read next line of input file */
 496     if (!fgets(line, MAX_LINE_LEN, file))
 497       break;
 498
 499     /* skip comments (lines directly beginning with '#') */
 500     if (line[0] == '#')
 501       continue;
 502
 503     /* cut trailing newline from input line */
 504     for (line_ptr = line; *line_ptr; line_ptr++)
 505     {
 506       if (*line_ptr == '\n' || *line_ptr == '\r')
 507       {
 508         *line_ptr = '\0';
 509         break;
 510       }
 511     }
 512
 513     if (strlen(line) == 0)              /* special case: force empty line */
 514       strcpy(line, "\n");
 515
 516     line_ptr = line;
 517
 518     while (*line_ptr && current_line < max_lines)
 519     {
 520       boolean buffer_filled = RenderLineToBuffer(&line_ptr,
 521                                                  buffer, &buffer_len,
 522                                                  last_line_was_empty,
 523                                                  line_length);
 524       if (buffer_filled)
 525       {
 526         DrawText(x, y + current_line * font_height, buffer, font_nr);
 527         current_line++;
 528
 529         last_line_was_empty = (buffer_len == 0);
 530
 531         buffer[0] = '\0';
 532         buffer_len = 0;
 533       }
 534     }
 535   }
 536
 537   fclose(file);
 538
 539   if (buffer_len > 0 && current_line < max_lines)
 540   {
 541     DrawText(x, y + current_line * font_height, buffer, font_nr);
 542     current_line++;
 543   }
 544
 545   return current_line;
 546 }