1 /* FreeType 2 and UTF-8 encoding support for
11 ================================================================================
12 Function definitions. Taken from the freetype2 headers.
13 ================================================================================
18 (*qFT_Init_FreeType)( FT_Library *alibrary );
20 (*qFT_Done_FreeType)( FT_Library library );
22 (*qFT_New_Face)( FT_Library library,
23 const char* filepathname,
27 (*qFT_New_Memory_Face)( FT_Library library,
28 const FT_Byte* file_base,
33 (*qFT_Done_Face)( FT_Face face );
35 (*qFT_Select_Size)( FT_Face face,
36 FT_Int strike_index );
38 (*qFT_Request_Size)( FT_Face face,
39 FT_Size_Request req );
41 (*qFT_Set_Char_Size)( FT_Face face,
42 FT_F26Dot6 char_width,
43 FT_F26Dot6 char_height,
44 FT_UInt horz_resolution,
45 FT_UInt vert_resolution );
47 (*qFT_Set_Pixel_Sizes)( FT_Face face,
49 FT_UInt pixel_height );
51 (*qFT_Load_Glyph)( FT_Face face,
53 FT_Int32 load_flags );
55 (*qFT_Load_Char)( FT_Face face,
57 FT_Int32 load_flags );
59 (*qFT_Get_Char_Index)( FT_Face face,
62 (*qFT_Render_Glyph)( FT_GlyphSlot slot,
63 FT_Render_Mode render_mode );
65 (*qFT_Get_Kerning)( FT_Face face,
69 FT_Vector *akerning );
72 ================================================================================
73 Support for dynamically loading the FreeType2 library
74 ================================================================================
77 static dllfunction_t ft2funcs[] =
79 {"FT_Init_FreeType", (void **) &qFT_Init_FreeType},
80 {"FT_Done_FreeType", (void **) &qFT_Done_FreeType},
81 {"FT_New_Face", (void **) &qFT_New_Face},
82 {"FT_New_Memory_Face", (void **) &qFT_New_Memory_Face},
83 {"FT_Done_Face", (void **) &qFT_Done_Face},
84 {"FT_Select_Size", (void **) &qFT_Select_Size},
85 {"FT_Request_Size", (void **) &qFT_Request_Size},
86 {"FT_Set_Char_Size", (void **) &qFT_Set_Char_Size},
87 {"FT_Set_Pixel_Sizes", (void **) &qFT_Set_Pixel_Sizes},
88 {"FT_Load_Glyph", (void **) &qFT_Load_Glyph},
89 {"FT_Load_Char", (void **) &qFT_Load_Char},
90 {"FT_Get_Char_Index", (void **) &qFT_Get_Char_Index},
91 {"FT_Render_Glyph", (void **) &qFT_Render_Glyph},
92 {"FT_Get_Kerning", (void **) &qFT_Get_Kerning},
96 /// Handle for FreeType2 DLL
97 static dllhandle_t ft2_dll = NULL;
99 /// Memory pool for fonts
100 static mempool_t *font_mempool= NULL;
101 static rtexturepool_t *font_texturepool = NULL;
103 /// FreeType library handle
104 static FT_Library font_ft2lib = NULL;
110 Unload the FreeType2 DLL
113 void Font_CloseLibrary (void)
116 Mem_FreePool(&font_mempool);
117 if (font_texturepool)
118 R_FreeTexturePool(&font_texturepool);
119 if (font_ft2lib && qFT_Done_FreeType)
121 qFT_Done_FreeType(font_ft2lib);
124 Sys_UnloadLibrary (&ft2_dll);
131 Try to load the FreeType2 DLL
134 qboolean Font_OpenLibrary (void)
136 const char* dllnames [] =
139 #error path for freetype 2 dll
141 #error path for freetype 2 dll
142 #elif defined(MACOSX)
156 if (!Sys_LoadLibrary (dllnames, &ft2_dll, ft2funcs))
165 Initialize the freetype2 font subsystem
169 static font_t test_font;
171 static void font_start(void)
173 if (!Font_OpenLibrary())
176 if (qFT_Init_FreeType(&font_ft2lib))
178 Con_Print("ERROR: Failed to initialize the FreeType2 library!\n");
183 font_mempool = Mem_AllocPool("FONT", 0, NULL);
186 Con_Print("ERROR: Failed to allocate FONT memory pool!\n");
191 font_texturepool = R_AllocTexturePool();
192 if (!font_texturepool)
194 Con_Print("ERROR: Failed to allocate FONT texture pool!\n");
199 if (!Font_LoadFont("gfx/test", 16, &test_font))
201 Con_Print("ERROR: Failed to load test font!\n");
207 static void font_shutdown(void)
212 static void font_newmap(void)
218 R_RegisterModule("Font_FreeType2", font_start, font_shutdown, font_newmap);
222 ================================================================================
223 UTF-8 encoding and decoding functions follow.
224 ================================================================================
227 /** Get the number of characters in in an UTF-8 string.
228 * @param _s An utf-8 encoded null-terminated string.
229 * @return The number of unicode characters in the string.
231 size_t u8_strlen(const char *_s)
234 unsigned char *s = (unsigned char*)_s;
245 // start of a wide character
249 for (++s; *s >= 0x80 && *s <= 0xC0; ++s);
253 // part of a wide character, we ignore that one
254 if (*s <= 0xBF) // 10111111
263 /** Fetch a character from an utf-8 encoded string.
264 * @param _s The start of an utf-8 encoded multi-byte character.
265 * @param _end Will point to after the first multi-byte character.
266 * @return The 32-bit integer representation of the first multi-byte character.
268 Uchar u8_getchar(const char *_s, const char **_end)
270 const unsigned char *s = (unsigned char*)_s;
284 // starting within a wide character - skip it and retrieve the one after it
285 for (++s; *s >= 0x80 && *s < 0xC0; ++s);
286 // or we could return '?' here?
292 for (mask >>= 1; v > (*s & mask); mask >>= 1)
294 u = (Uchar)(*s & mask);
295 for (++s; *s >= 0x80 && *s < 0xC0; ++s)
296 u = (u << 6) | (*s & 0x3F);
299 *_end = (const char*)s;
304 /** Encode a wide-character into utf-8.
305 * @param w The wide character to encode.
306 * @param to The target buffer the utf-8 encoded string is stored to.
307 * @param maxlen The maximum number of bytes that fit into the target buffer.
308 * @return Number of bytes written to the buffer, or less or equal to 0 if the buffer is too small.
310 int u8_fromchar(Uchar w, char *to, size_t maxlen)
328 // check how much space we need and store data into a
329 // temp buffer - this is faster than recalculating again
334 tmp[i++] = 0x80 | (w & 0x3F);
335 bt = (bt >> 1) | 0x80;
337 // see if we still fit into the target buffer
338 if (i+1 >= maxlen) // +1 for the \0
341 // there are no characters which take up that much space yet
342 // and there won't be for the next many many years, still... let's be safe
343 if (i >= sizeof(tmp))
347 for (j = 0; j < i; ++j)
356 /** Convert a utf-8 multibyte string to a wide character string.
357 * @param wcs The target wide-character buffer.
358 * @param mb The utf-8 encoded multibyte string to convert.
359 * @param maxlen The maximum number of wide-characters that fit into the target buffer.
360 * @return The number of characters written to the target buffer.
362 size_t u8_mbstowcs(Uchar *wcs, const char *mb, size_t maxlen)
365 for (i = 0; *mb && i < maxlen; ++i)
366 *wcs++ = u8_getchar(mb, &mb);
372 /** Convert a wide-character string to a utf-8 multibyte string.
373 * @param mb The target buffer the utf-8 string is written to.
374 * @param wcs The wide-character string to convert.
375 * @param maxlen The number bytes that fit into the multibyte target buffer.
376 * @return The number of bytes written, not including the terminating \0
378 size_t u8_wcstombs(char *mb, const Uchar *wcs, size_t maxlen)
381 const char *start = mb;
382 for (i = 0; *wcs && i < maxlen; ++i)
385 if ( (len = u8_fromchar(*wcs++, mb, maxlen - i)) < 0)
395 ================================================================================
396 Implementation of a more or less lazy font loading and rendering code.
397 ================================================================================
400 #define FONT_CHARS_PER_LINE 16
401 #define FONT_CHAR_LINES 16
402 #define FONT_CHARS_PER_MAP (FONT_CHARS_PER_LINE * FONT_CHAR_LINES)
404 typedef struct glyph_slot_s
406 // we keep the quad coords here only currently
407 // if you need other info, make Font_LoadMapForIndex fill it into this slot
408 float xmin; // texture coordinate in [0,1]
419 struct font_map_s *next;
422 glyph_slot_t glyphs[FONT_CHARS_PER_MAP];
425 static qboolean Font_LoadMapForIndex(font_t *font, Uchar _ch, font_map_t **outmap);
426 qboolean Font_LoadFont(const char *name, int size, font_t *font)
429 char filename[PATH_MAX];
432 memset(font, 0, sizeof(*font));
434 if (!Font_OpenLibrary())
436 Con_Printf("WARNING: can't open load font %s\n"
437 "You need the FreeType2 DLL to load font files\n",
442 namelen = strlen(name);
444 memcpy(filename, name, namelen);
445 memcpy(filename + namelen, ".ttf", 5);
447 font->data = FS_LoadFile(filename, font_mempool, false, &font->datasize);
450 // FS_LoadFile being not-quiet should print an error :)
455 status = qFT_New_Memory_Face(font_ft2lib, (FT_Bytes)font->data, font->datasize, 0, (FT_Face*)&font->face);
458 Con_Printf("ERROR: can't create face for %s\n"
459 "Error %i\n", // TODO: error strings
461 Mem_Free(font->data);
465 memcpy(font->name, name, namelen+1);
467 font->glyphSize = font->size * 2;
468 font->has_kerning = !!(((FT_Face)(font->face))->face_flags & FT_FACE_FLAG_KERNING);
470 status = qFT_Set_Pixel_Sizes((FT_Face)font->face, size, size);
473 Con_Printf("ERROR: can't size pixel sizes for face of font %s\n"
474 "Error %i\n", // TODO: error strings
476 Mem_Free(font->data);
480 if (!Font_LoadMapForIndex(font, 0, NULL))
482 Con_Printf("ERROR: can't load the first character map for %s\n"
485 Mem_Free(font->data);
492 void Font_UnloadFont(font_t *font)
495 Mem_Free(font->data);
500 qFT_Done_Face((FT_Face)font->face);
506 static qboolean Font_LoadMapForIndex(font_t *font, Uchar _ch, font_map_t **outmap)
508 char map_identifier[PATH_MAX];
509 unsigned long mapidx = _ch / FONT_CHARS_PER_MAP;
514 FT_Face face = font->face;
516 int pitch = font->glyphSize * FONT_CHARS_PER_LINE;
517 int gR, gC; // glyph position: row and column
524 map = Mem_Alloc(font_mempool, sizeof(font_map_t));
527 Con_Printf("ERROR: Out of memory when loading fontmap for %s\n", font->name);
531 data = Mem_Alloc(font_mempool, FONT_CHARS_PER_MAP * (font->glyphSize * font->glyphSize));
535 Con_Printf("ERROR: Failed to allocate memory for glyph data for font %s\n", font->name);
539 memset(data, 0, sizeof(data));
541 map->start = mapidx * FONT_CHARS_PER_MAP;
543 font->font_map = map;
546 // insert the map at the right place
547 font_map_t *next = font->font_map;
548 while(next->next && next->next->start < map->start)
550 map->next = next->next;
555 for (ch = map->start;
556 ch < (FT_ULong)map->start + FONT_CHARS_PER_MAP;
563 unsigned char *imagedata, *dst, *src;
564 glyph_slot_t *mapglyph;
567 if (gC >= FONT_CHARS_PER_LINE)
569 gC -= FONT_CHARS_PER_LINE;
573 imagedata = data + gR * pitch + gC * font->glyphSize;
574 glyphIndex = qFT_Get_Char_Index(face, ch);
576 status = qFT_Load_Glyph(face, glyphIndex, FT_LOAD_DEFAULT);
579 Con_Printf("failed to load glyph %lu for %s\n", glyphIndex, font->name);
583 status = qFT_Render_Glyph(face->glyph, FT_RENDER_MODE_NORMAL);
586 Con_Printf("failed to render glyph %lu for %s\n", glyphIndex, font->name);
591 bmp = &glyph->bitmap;
596 if (w > font->glyphSize || h > font->glyphSize)
597 Con_Printf("WARNING: Glyph %lu is too big in font %s\n", ch, font->name);
599 for (y = 0; y < h; ++y)
601 dst = imagedata + y * pitch;
602 src = bmp->buffer + y * bmp->pitch;
604 switch (bmp->pixel_mode)
606 case FT_PIXEL_MODE_MONO:
607 for (x = 0; x < bmp->width; x += 8)
609 unsigned char ch = *src++;
610 *dst++ = 255 * ((ch & 0x80) >> 7);
611 *dst++ = 255 * ((ch & 0x40) >> 6);
612 *dst++ = 255 * ((ch & 0x20) >> 5);
613 *dst++ = 255 * ((ch & 0x10) >> 4);
614 *dst++ = 255 * ((ch & 0x08) >> 3);
615 *dst++ = 255 * ((ch & 0x04) >> 2);
616 *dst++ = 255 * ((ch & 0x02) >> 1);
617 *dst++ = 255 * ((ch & 0x01) >> 0);
620 case FT_PIXEL_MODE_GRAY2:
621 for (x = 0; x < bmp->width; x += 4)
623 unsigned char ch = *src++;
624 *dst++ = ( ((ch & 0xA0) >> 6) * 0x55 ); ch <<= 2;
625 *dst++ = ( ((ch & 0xA0) >> 6) * 0x55 ); ch <<= 2;
626 *dst++ = ( ((ch & 0xA0) >> 6) * 0x55 ); ch <<= 2;
627 *dst++ = ( ((ch & 0xA0) >> 6) * 0x55 ); ch <<= 2;
630 case FT_PIXEL_MODE_GRAY4:
631 for (x = 0; x < bmp->width; x += 2)
633 unsigned char ch = *src++;
634 *dst++ = ( ((ch & 0xF0) >> 4) * 0x24);
635 *dst++ = ( ((ch & 0x0F) ) * 0x24);
639 memcpy((void*)dst, (void*)src, bmp->pitch);
645 // now fill map->glyphs[ch - map->start]
646 mapch = ch - map->start;
647 mapglyph = &map->glyphs[mapch];
648 // xmin is the left start of the character within the texture
649 mapglyph->xmin = ( (double)(gC * font->glyphSize) ) / ( (double)(font->glyphSize * FONT_CHARS_PER_LINE) );
650 mapglyph->xmax = mapglyph->xmin + glyph->metrics.width * (1.0/64.0) / (double)font->size;
651 mapglyph->ymin = ( (double)(gR * font->glyphSize) ) / ( (double)(font->glyphSize * FONT_CHAR_LINES) );
652 mapglyph->ymax = mapglyph->ymin + glyph->metrics.height * (1.0/64.0) / (double)font->size;
653 // TODO: support vertical fonts maybe?
654 mapglyph->advance_x = glyph->metrics.horiAdvance * (1.0/64.0) / (double)font->size;
655 mapglyph->advance_y = 0;
658 // create a texture from the data now
659 dpsnprintf(map_identifier, sizeof(map_identifier), "%s_%u", font->name, (unsigned)map->start);
660 map->texture = R_LoadTexture2D(font_texturepool, map_identifier,
661 font->glyphSize * FONT_CHARS_PER_LINE,
662 font->glyphSize * FONT_CHAR_LINES,
663 data, TEXTYPE_RGBA, TEXF_ALPHA | TEXF_PRECACHE, NULL);
667 // if the first try isn't successful, keep it with a broken texture
668 // otherwise we retry to load it every single frame where ft2 rendering is used
669 // this would be bad...
670 // only `data' must be freed
678 extern void _DrawQ_Setup(void);
680 // TODO: If no additional stuff ends up in the following static functions
681 // use the DrawQ ones!
682 static void _Font_ProcessDrawFlag(int flags)
686 if(flags == DRAWFLAG_ADDITIVE)
687 GL_BlendFunc(GL_SRC_ALPHA, GL_ONE);
688 else if(flags == DRAWFLAG_MODULATE)
689 GL_BlendFunc(GL_DST_COLOR, GL_ZERO);
690 else if(flags == DRAWFLAG_2XMODULATE)
691 GL_BlendFunc(GL_DST_COLOR,GL_SRC_COLOR);
692 else if(flags == DRAWFLAG_SCREEN)
693 GL_BlendFunc(GL_ONE_MINUS_DST_COLOR,GL_ONE);
695 GL_BlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
698 static void Font_GetTextColor(float color[4], int colorindex, float r, float g, float b, float a, qboolean shadow)
700 float C = r_textcontrast.value;
701 float B = r_textbrightness.value;
702 if (colorindex & 0x10000) // that bit means RGB color
704 color[0] = ((colorindex >> 12) & 0xf) / 15.0;
705 color[1] = ((colorindex >> 8) & 0xf) / 15.0;
706 color[2] = ((colorindex >> 4) & 0xf) / 15.0;
707 color[3] = (colorindex & 0xf) / 15.0;
710 Vector4Copy(string_colors[colorindex], color);
711 Vector4Set(color, color[0] * r * C + B, color[1] * g * C + B, color[2] * b * C + B, color[3] * a);
714 float shadowalpha = (color[0]+color[1]+color[2]) * 0.8;
715 Vector4Set(color, 0, 0, 0, color[3] * bound(0, shadowalpha, 1));
719 float Font_DrawString(float startx, float starty,
720 const char *mbs, size_t maxlen,
721 float basered, float basegreen, float baseblue, float basealpha,
722 int flags, int *outcolor, qboolean ignorecolorcodes,
725 int num, shadow, colorindex = STRING_COLOR_DEFAULT;
726 float x = startx, y, s, t, u, v, thisw;
730 float vertex3f[QUADELEMENTS_MAXQUADS*4*3];
731 float texcoord2f[QUADELEMENTS_MAXQUADS*4*2];
732 float color4f[QUADELEMENTS_MAXQUADS*4*4];
735 const char *text_start;
740 tw = R_TextureWidth(fnt->tex);
741 th = R_TextureHeight(fnt->tex);
747 _DrawQ_ProcessDrawFlag(flags);
749 R_Mesh_ColorPointer(color4f, 0, 0);
750 R_Mesh_ResetTextureState();
751 R_Mesh_TexBind(0, R_GetTexture(fnt->tex));
752 R_Mesh_TexCoordPointer(0, 2, texcoord2f, 0, 0);
753 R_Mesh_VertexPointer(vertex3f, 0, 0);
754 R_SetupGenericShader(true);
761 for (shadow = r_textshadow.value != 0 && basealpha > 0;shadow >= 0;shadow--)
764 if (!outcolor || *outcolor == -1)
765 colorindex = STRING_COLOR_DEFAULT;
767 colorindex = *outcolor;
769 Font_GetTextColor(color, colorindex, basered, basegreen, baseblue, basealpha, shadow);
775 x += r_textshadow.value;
776 y += r_textshadow.value;
778 for (i = 0;i < maxlen && *text;i++)
780 if (*text == STRING_COLOR_TAG && !ignorecolorcodes && i + 1 < maxlen)
785 ch = *text; // the color tag is an ASCII character!
786 if (ch == STRING_COLOR_RGB_TAG_CHAR)
788 // we need some preparation here
791 if (*text) chx[0] = u8_getchar(text, &text);
792 if (*text) chx[1] = u8_getchar(text, &text);
793 if (*text) chx[2] = u8_getchar(text, &text);
794 if ( ( (chx[0] >= 'A' && chx[0] <= 'F') && (chx[0] >= 'a' && chx[0] <= 'f') || (chx[0] >= '0' && chx[0] <= '9') ) &&
795 ( (chx[1] >= 'A' && chx[1] <= 'F') && (chx[1] >= 'a' && chx[1] <= 'f') || (chx[1] >= '0' && chx[1] <= '9') ) &&
796 ( (chx[2] >= 'A' && chx[2] <= 'F') && (chx[2] >= 'a' && chx[2] <= 'f') || (chx[2] >= '0' && chx[2] <= '9') ) )
801 text = before; // start from the first hex character
803 if (ch <= '9' && ch >= '0') // ^[0-9] found
805 colorindex = ch - '0';
806 DrawQ_GetTextColor(color, colorindex, basered, basegreen, baseblue, basealpha, shadow);
809 else if (ch == STRING_COLOR_RGB_TAG_CHAR && i + 3 < maxlen && chx[2]) // ^x found
811 // building colorindex...
812 ch = tolower(text[i+1]);
813 tempcolorindex = 0x10000; // binary: 1,0000,0000,0000,0000
814 if (ch <= '9' && ch >= '0') tempcolorindex |= (ch - '0') << 12;
815 else if (ch >= 'a' && ch <= 'f') tempcolorindex |= (ch - 87) << 12;
816 else tempcolorindex = 0;
819 ch = tolower(text[i+2]);
820 if (ch <= '9' && ch >= '0') tempcolorindex |= (ch - '0') << 8;
821 else if (ch >= 'a' && ch <= 'f') tempcolorindex |= (ch - 87) << 8;
822 else tempcolorindex = 0;
825 ch = tolower(text[i+3]);
826 if (ch <= '9' && ch >= '0') tempcolorindex |= (ch - '0') << 4;
827 else if (ch >= 'a' && ch <= 'f') tempcolorindex |= (ch - 87) << 4;
828 else tempcolorindex = 0;
831 colorindex = tempcolorindex | 0xf;
832 // ...done! now colorindex has rgba codes (1,rrrr,gggg,bbbb,aaaa)
833 //Con_Printf("^1colorindex:^7 %x\n", colorindex);
834 DrawQ_GetTextColor(color, colorindex, basered, basegreen, baseblue, basealpha, shadow);
841 else if (ch == STRING_COLOR_TAG)
845 ch = u8_getchar(text, &text);
847 font_map_t *map = fnt->font_map;
848 while(map && map->start + FONT_CHARS_PER_MAP < ch)
852 if (!Font_LoadMapForIndex(fnt, ch, &map))
859 // this shouldn't happen
865 tw = R_TextureWidth(map->texture);
866 th = R_TextureHeight(map->texture);
868 thisw = map->glyphslot[ch].advance_x;
870 ac[ 0] = color[0];ac[ 1] = color[1];ac[ 2] = color[2];ac[ 3] = color[3];
871 ac[ 4] = color[0];ac[ 5] = color[1];ac[ 6] = color[2];ac[ 7] = color[3];
872 ac[ 8] = color[0];ac[ 9] = color[1];ac[10] = color[2];ac[11] = color[3];
873 ac[12] = color[0];ac[13] = color[1];ac[14] = color[2];ac[15] = color[3];
874 at[0] = map->glyphslot[ch].xmin; at[1] = map->glyphslot[ch].ymin;
875 at[2] = map->glyphslot[ch].xmax; at[3] = map->glyphslot[ch].ymin;
876 at[4] = map->glyphslot[ch].xmax; at[5] = map->glyphslot[ch].ymax;
877 at[7] = map->glyphslot[ch].xmin; at[7] = map->glyphslot[ch].ymax;
878 av[ 0] = x; av[ 1] = y; av[ 2] = 10;
879 av[ 3] = x + w*thisw; av[ 4] = y; av[ 5] = 10;
880 av[ 6] = x + w*thisw; av[ 7] = y + h; av[ 8] = 10;
881 av[ 9] = x; av[10] = y + h; av[11] = 10;
886 R_Mesh_Draw(0, 4, 0, 2, NULL, quadelements, 0, 0);
893 *outcolor = colorindex;
895 // note: this relies on the proper text (not shadow) being drawn last