1 /*****************************************************************************
2 * freetype.c : Put text on the video, using freetype2
3 *****************************************************************************
4 * Copyright (C) 2002, 2003 VideoLAN
7 * Authors: Sigmund Augdal <sigmunau@idi.ntnu.no>
8 * Gildas Bazin <gbazin@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
23 *****************************************************************************/
25 /*****************************************************************************
27 *****************************************************************************/
28 #include <stdlib.h> /* malloc(), free() */
31 #ifdef HAVE_LINUX_LIMITS_H
32 # include <linux/limits.h>
38 #include "vlc_block.h"
39 #include "vlc_filter.h"
48 #include FT_FREETYPE_H
52 #define DEFAULT_FONT "/System/Library/Fonts/LucidaGrande.dfont"
53 #elif defined( SYS_BEOS )
54 #define DEFAULT_FONT "/boot/beos/etc/fonts/ttfonts/Swiss721.ttf"
55 #elif defined( WIN32 )
56 #define DEFAULT_FONT "" /* Default font found at run-time */
58 #define DEFAULT_FONT "/usr/share/fonts/truetype/freefont/FreeSerifBold.ttf"
61 #if defined(HAVE_FRIBIDI)
62 #include <fribidi/fribidi.h>
65 typedef struct line_desc_t line_desc_t;
67 /*****************************************************************************
69 *****************************************************************************/
70 static int Create ( vlc_object_t * );
71 static void Destroy( vlc_object_t * );
73 static subpicture_t *RenderText( filter_t *, block_t * );
74 static line_desc_t *NewLine( byte_t * );
76 /*****************************************************************************
78 *****************************************************************************/
79 #define FONT_TEXT N_("Font")
80 #define FONT_LONGTEXT N_("Font filename")
81 #define FONTSIZE_TEXT N_("Font size in pixels")
82 #define FONTSIZE_LONGTEXT N_("The size of the fonts used by the osd module. " \
83 "If set to something different than 0 this option will override the " \
84 "relative font size " )
85 #define FONTSIZER_TEXT N_("Font size")
86 #define FONTSIZER_LONGTEXT N_("The size of the fonts used by the osd module" )
88 static int pi_sizes[] = { 20, 18, 16, 12, 6 };
89 static char *ppsz_sizes_text[] = { N_("Smaller"), N_("Small"), N_("Normal"),
90 N_("Large"), N_("Larger") };
93 set_description( _("freetype2 font renderer") );
95 add_file( "freetype-font", DEFAULT_FONT, NULL, FONT_TEXT, FONT_LONGTEXT,
97 add_integer( "freetype-fontsize", 0, NULL, FONTSIZE_TEXT,
98 FONTSIZE_LONGTEXT, VLC_TRUE );
99 add_integer( "freetype-rel-fontsize", 16, NULL, FONTSIZER_TEXT,
100 FONTSIZER_LONGTEXT, VLC_FALSE );
101 change_integer_list( pi_sizes, ppsz_sizes_text, 0 );
103 set_capability( "text renderer", 100 );
104 add_shortcut( "text" );
105 set_callbacks( Create, Destroy );
109 * Private data in a subpicture. Describes a string.
111 typedef struct subpicture_data_t
115 /** The string associated with this subpicture */
117 line_desc_t *p_lines;
123 /** NULL-terminated list of glyphs making the string */
124 FT_BitmapGlyph *pp_glyphs;
125 /** list of relative positions for the glyphs */
126 FT_Vector *p_glyph_pos;
132 static void Render ( filter_t *, subpicture_t *, subpicture_data_t * );
133 static void FreeString( subpicture_data_t * );
135 /*****************************************************************************
136 * filter_sys_t: freetype local data
137 *****************************************************************************
138 * This structure is part of the video output thread descriptor.
139 * It describes the freetype specific properties of an output thread.
140 *****************************************************************************/
143 FT_Library p_library; /* handle to library */
144 FT_Face p_face; /* handle to face object */
145 vlc_bool_t i_use_kerning;
146 uint8_t pi_gamma[256];
149 /*****************************************************************************
150 * Create: allocates osd-text video thread output method
151 *****************************************************************************
152 * This function allocates and initializes a Clone vout method.
153 *****************************************************************************/
154 static int Create( vlc_object_t *p_this )
156 filter_t *p_filter = (filter_t *)p_this;
158 char *psz_fontfile = NULL;
163 /* Allocate structure */
164 p_sys = malloc( sizeof( filter_sys_t ) );
167 msg_Err( p_filter, "out of memory" );
171 p_sys->p_library = 0;
173 for( i = 0; i < 256; i++ )
175 p_sys->pi_gamma[i] = (uint8_t)( pow( (double)i * 255.0f, 0.5f ) );
178 var_Create( p_filter, "freetype-font", VLC_VAR_STRING | VLC_VAR_DOINHERIT );
179 var_Create( p_filter, "freetype-fontsize",
180 VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
181 var_Create( p_filter, "freetype-rel-fontsize",
182 VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
184 /* Look what method was requested */
185 var_Get( p_filter, "freetype-font", &val );
186 psz_fontfile = val.psz_string;
187 if( !psz_fontfile || !*psz_fontfile )
189 if( psz_fontfile ) free( psz_fontfile );
190 psz_fontfile = (char *)malloc( PATH_MAX + 1 );
192 GetWindowsDirectory( psz_fontfile, PATH_MAX + 1 );
193 strcat( psz_fontfile, "\\fonts\\arial.ttf" );
195 strcpy( psz_fontfile, DEFAULT_FONT );
197 msg_Err( p_filter, "user didn't specify a font" );
202 i_error = FT_Init_FreeType( &p_sys->p_library );
205 msg_Err( p_filter, "couldn't initialize freetype" );
209 i_error = FT_New_Face( p_sys->p_library, psz_fontfile ? psz_fontfile : "",
211 if( i_error == FT_Err_Unknown_File_Format )
213 msg_Err( p_filter, "file %s have unknown format", psz_fontfile );
218 msg_Err( p_filter, "failed to load font file %s", psz_fontfile );
222 i_error = FT_Select_Charmap( p_sys->p_face, ft_encoding_unicode );
225 msg_Err( p_filter, "Font has no unicode translation table" );
229 p_sys->i_use_kerning = FT_HAS_KERNING( p_sys->p_face );
231 var_Get( p_filter, "freetype-fontsize", &val );
234 i_fontsize = val.i_int;
238 var_Get( p_filter, "freetype-rel-fontsize", &val );
239 i_fontsize = (int)p_filter->fmt_out.video.i_height / val.i_int;
241 if( i_fontsize <= 0 )
243 msg_Warn( p_filter, "Invalid fontsize, using 12" );
246 msg_Dbg( p_filter, "Using fontsize: %i", i_fontsize);
248 i_error = FT_Set_Pixel_Sizes( p_sys->p_face, 0, i_fontsize );
251 msg_Err( p_filter, "couldn't set font size to %d", i_fontsize );
255 if( psz_fontfile ) free( psz_fontfile );
256 p_filter->pf_render_string = RenderText;
257 p_filter->p_sys = p_sys;
261 if( p_sys->p_face ) FT_Done_Face( p_sys->p_face );
262 if( p_sys->p_library ) FT_Done_FreeType( p_sys->p_library );
263 if( psz_fontfile ) free( psz_fontfile );
268 /*****************************************************************************
269 * Destroy: destroy Clone video thread output method
270 *****************************************************************************
271 * Clean up all data and library connections
272 *****************************************************************************/
273 static void Destroy( vlc_object_t *p_this )
275 filter_t *p_filter = (filter_t *)p_this;
276 filter_sys_t *p_sys = p_filter->p_sys;
277 FT_Done_Face( p_sys->p_face );
278 FT_Done_FreeType( p_sys->p_library );
282 /*****************************************************************************
283 * Render: place string in picture
284 *****************************************************************************
285 * This function merges the previously rendered freetype glyphs into a picture
286 *****************************************************************************/
287 static void Render( filter_t *p_filter, subpicture_t *p_spu,
288 subpicture_data_t *p_string )
290 filter_sys_t *p_sys = p_filter->p_sys;
292 uint8_t *p_y, *p_u, *p_v, *p_a;
294 int i, x, y, i_pitch;
296 /* Create a new subpicture region */
297 memset( &fmt, 0, sizeof(video_format_t) );
298 fmt.i_chroma = VLC_FOURCC('Y','U','V','A');
299 fmt.i_aspect = VOUT_ASPECT_FACTOR;
300 fmt.i_width = fmt.i_visible_width = p_string->i_width + 2;
301 fmt.i_height = fmt.i_visible_height = p_string->i_height + 2;
302 fmt.i_x_offset = fmt.i_y_offset = 0;
303 p_spu->p_region = p_spu->pf_create_region( VLC_OBJECT(p_filter), &fmt );
304 if( !p_spu->p_region )
306 msg_Err( p_filter, "cannot allocate SPU region" );
310 p_spu->p_region->i_x = p_spu->p_region->i_y = 0;
311 p_y = p_spu->p_region->picture.Y_PIXELS;
312 p_u = p_spu->p_region->picture.U_PIXELS;
313 p_v = p_spu->p_region->picture.V_PIXELS;
314 p_a = p_spu->p_region->picture.A_PIXELS;
315 i_pitch = p_spu->p_region->picture.Y_PITCH;
317 /* Initialize the region pixels (only the alpha will be changed later) */
318 memset( p_y, 0x00, i_pitch * p_spu->p_region->fmt.i_height );
319 memset( p_u, 0x80, i_pitch * p_spu->p_region->fmt.i_height );
320 memset( p_v, 0x80, i_pitch * p_spu->p_region->fmt.i_height );
321 memset( p_a, 0x00, i_pitch * p_spu->p_region->fmt.i_height );
323 #define pi_gamma p_sys->pi_gamma
325 for( p_line = p_string->p_lines; p_line != NULL; p_line = p_line->p_next )
327 int i_glyph_tmax = 0;
328 int i_bitmap_offset, i_offset;
329 for( i = 0; p_line->pp_glyphs[i] != NULL; i++ )
331 FT_BitmapGlyph p_glyph = p_line->pp_glyphs[ i ];
332 i_glyph_tmax = __MAX( i_glyph_tmax, p_glyph->top );
335 for( i = 0; p_line->pp_glyphs[i] != NULL; i++ )
337 FT_BitmapGlyph p_glyph = p_line->pp_glyphs[ i ];
339 i_offset = ( p_line->p_glyph_pos[ i ].y +
340 i_glyph_tmax - p_glyph->top + 1 ) *
341 i_pitch + p_line->p_glyph_pos[ i ].x + p_glyph->left + 1;
343 for( y = 0, i_bitmap_offset = 0; y < p_glyph->bitmap.rows; y++ )
345 for( x = 0; x < p_glyph->bitmap.width; x++, i_bitmap_offset++ )
347 if( !pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]] )
351 p_a[i_offset + x] = ((uint16_t)p_a[i_offset + x] +
352 pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]])/2;
353 i_offset += i_pitch; x--;
354 p_a[i_offset + x] = ((uint16_t)p_a[i_offset + x] +
355 pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]])/2;
357 p_a[i_offset + x] = ((uint16_t)p_a[i_offset + x] +
358 pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]])/2;
359 i_offset += i_pitch; x--;
360 p_a[i_offset + x] = ((uint16_t)p_a[i_offset + x] +
361 pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]])/2;
367 i_offset = ( p_line->p_glyph_pos[ i ].y +
368 i_glyph_tmax - p_glyph->top ) *
369 i_pitch + p_line->p_glyph_pos[ i ].x + p_glyph->left + 1;
371 for( y = 0, i_bitmap_offset = 0; y < p_glyph->bitmap.rows; y++ )
373 for( x = 0; x < p_glyph->bitmap.width; x++, i_bitmap_offset++ )
376 pi_gamma[p_glyph->bitmap.buffer[i_bitmap_offset]];
387 * This function receives a string and creates a subpicture for it. It
388 * also calculates the size needed for this string, and renders the
389 * needed glyphs into memory. It is used as pf_add_string callback in
390 * the vout method by this module
392 static subpicture_t *RenderText( filter_t *p_filter, block_t *p_block )
394 filter_sys_t *p_sys = p_filter->p_sys;
395 subpicture_t *p_subpic = 0;
396 subpicture_data_t *p_string = 0;
397 line_desc_t *p_line = 0, *p_next = 0;
398 int i, i_pen_y, i_pen_x, i_error, i_glyph_index, i_previous;
399 uint32_t *p_unicode_string, i_char;
402 vlc_iconv_t iconv_handle = (vlc_iconv_t)(-1);
410 if( !p_block ) return NULL;
411 psz_string = p_block->p_buffer;
412 if( !psz_string || !*psz_string ) goto error;
421 /* Create and initialize a subpicture */
422 p_subpic = p_filter->pf_sub_buffer_new( p_filter );
423 if( !p_subpic ) goto error;
425 p_subpic->i_start = p_block->i_pts;
426 p_subpic->i_stop = p_block->i_pts + p_block->i_length;
427 p_subpic->b_ephemer = (p_block->i_length == 0);
428 p_subpic->b_absolute = VLC_FALSE;
430 /* Create and initialize private data for the subpicture */
431 p_string = malloc( sizeof(subpicture_data_t) );
434 msg_Err( p_filter, "Out of memory" );
437 p_string->p_lines = 0;
438 p_string->psz_text = strdup( psz_string );
440 p_unicode_string = malloc( ( strlen(psz_string) + 1 ) * sizeof(uint32_t) );
441 if( p_unicode_string == NULL )
443 msg_Err( p_filter, "Out of memory" );
446 #if defined(WORDS_BIGENDIAN)
447 iconv_handle = vlc_iconv_open( "UCS-4BE", "UTF-8" );
449 iconv_handle = vlc_iconv_open( "UCS-4LE", "UTF-8" );
451 if( iconv_handle == (vlc_iconv_t)-1 )
453 msg_Warn( p_filter, "Unable to do convertion" );
458 char *p_in_buffer, *p_out_buffer;
459 size_t i_in_bytes, i_out_bytes, i_out_bytes_left, i_ret;
460 i_in_bytes = strlen( psz_string );
461 i_out_bytes = i_in_bytes * sizeof( uint32_t );
462 i_out_bytes_left = i_out_bytes;
463 p_in_buffer = psz_string;
464 p_out_buffer = (char *)p_unicode_string;
465 i_ret = vlc_iconv( iconv_handle, &p_in_buffer, &i_in_bytes,
466 &p_out_buffer, &i_out_bytes_left );
468 vlc_iconv_close( iconv_handle );
472 msg_Warn( p_filter, "Failed to convert string to unicode (%s), "
473 "bytes left %d", strerror(errno), i_in_bytes );
476 *(uint32_t*)p_out_buffer = 0;
477 i_string_length = (i_out_bytes - i_out_bytes_left) / sizeof(uint32_t);
480 #if defined(HAVE_FRIBIDI)
482 uint32_t *p_fribidi_string;
483 FriBidiCharType base_dir = FRIBIDI_TYPE_ON;
484 p_fribidi_string = malloc( (i_string_length + 1) * sizeof(uint32_t) );
485 fribidi_log2vis( (FriBidiChar*)p_unicode_string, i_string_length,
486 &base_dir, (FriBidiChar*)p_fribidi_string, 0, 0, 0 );
487 free( p_unicode_string );
488 p_unicode_string = p_fribidi_string;
489 p_fribidi_string[ i_string_length ] = 0;
493 /* Calculate relative glyph positions and a bounding box for the
495 p_line = NewLine( psz_string );
498 msg_Err( p_filter, "Out of memory" );
501 p_string->p_lines = p_line;
507 #define face p_sys->p_face
508 #define glyph face->glyph
510 while( *p_unicode_string )
512 i_char = *p_unicode_string++;
513 if( i_char == '\r' ) /* ignore CR chars wherever they may be */
520 p_next = NewLine( psz_string );
523 msg_Err( p_filter, "Out of memory" );
526 p_line->p_next = p_next;
527 p_line->i_width = line.xMax;
528 p_line->i_height = face->size->metrics.height >> 6;
529 p_line->pp_glyphs[ i ] = NULL;
531 result.x = __MAX( result.x, line.xMax );
532 result.y += face->size->metrics.height >> 6;
538 i_pen_y += face->size->metrics.height >> 6;
540 msg_Dbg( p_filter, "Creating new line, i is %d", i );
546 i_glyph_index = FT_Get_Char_Index( face, i_char );
547 if( p_sys->i_use_kerning && i_glyph_index
551 FT_Get_Kerning( face, i_previous, i_glyph_index,
552 ft_kerning_default, &delta );
553 i_pen_x += delta.x >> 6;
556 p_line->p_glyph_pos[ i ].x = i_pen_x;
557 p_line->p_glyph_pos[ i ].y = i_pen_y;
558 i_error = FT_Load_Glyph( face, i_glyph_index, FT_LOAD_DEFAULT );
561 msg_Err( p_filter, "FT_Load_Glyph returned %d", i_error );
564 i_error = FT_Get_Glyph( glyph, &tmp_glyph );
567 msg_Err( p_filter, "FT_Get_Glyph returned %d", i_error );
570 FT_Glyph_Get_CBox( tmp_glyph, ft_glyph_bbox_pixels, &glyph_size );
571 i_error = FT_Glyph_To_Bitmap( &tmp_glyph, ft_render_mode_normal,
573 if( i_error ) continue;
574 p_line->pp_glyphs[ i ] = (FT_BitmapGlyph)tmp_glyph;
577 line.xMax = p_line->p_glyph_pos[i].x + glyph_size.xMax - glyph_size.xMin;
578 line.yMax = __MAX( line.yMax, glyph_size.yMax );
579 line.yMin = __MIN( line.yMin, glyph_size.yMin );
581 i_previous = i_glyph_index;
582 i_pen_x += glyph->advance.x >> 6;
586 p_line->i_width = line.xMax;
587 p_line->i_height = face->size->metrics.height >> 6;
588 p_line->pp_glyphs[ i ] = NULL;
589 result.x = __MAX( result.x, line.xMax );
590 result.y += line.yMax - line.yMin;
591 p_string->i_height = result.y;
592 p_string->i_width = result.x;
597 Render( p_filter, p_subpic, p_string );
598 FreeString( p_string );
599 block_Release( p_block );
603 FreeString( p_string );
604 if( p_subpic ) p_filter->pf_sub_buffer_del( p_filter, p_subpic );
605 block_Release( p_block );
609 static void FreeString( subpicture_data_t *p_string )
612 line_desc_t *p_line, *p_next;
614 if( !p_string ) return;
616 for( p_line = p_string->p_lines; p_line != NULL; p_line = p_next )
618 p_next = p_line->p_next;
619 for( i = 0; p_line->pp_glyphs[ i ] != NULL; i++ )
621 FT_Done_Glyph( (FT_Glyph)p_line->pp_glyphs[ i ] );
623 free( p_line->pp_glyphs );
624 free( p_line->p_glyph_pos );
628 free( p_string->psz_text );
632 static line_desc_t *NewLine( byte_t *psz_string )
635 line_desc_t *p_line = malloc( sizeof(line_desc_t) );
640 p_line->i_height = 0;
642 p_line->p_next = NULL;
644 /* We don't use CountUtf8Characters() here because we are not acutally
645 * sure the string is utf8. Better be safe than sorry. */
646 i_count = strlen( psz_string );
648 p_line->pp_glyphs = malloc( sizeof(FT_BitmapGlyph)
650 if( p_line->pp_glyphs == NULL )
655 p_line->p_glyph_pos = malloc( sizeof( FT_Vector )
657 if( p_line->p_glyph_pos == NULL )
659 free( p_line->pp_glyphs );