1 /*****************************************************************************
2 * logo.c : logo video plugin for vlc
3 *****************************************************************************
4 * Copyright (C) 2003-2006 the VideoLAN team
7 * Authors: Gildas Bazin <gbazin@videolan.org>
8 * Simon Latapie <garf@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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 /*****************************************************************************
27 *****************************************************************************/
34 #include <vlc_common.h>
35 #include <vlc_plugin.h>
36 #include <vlc_filter.h>
38 #include <vlc_image.h>
45 /*****************************************************************************
47 *****************************************************************************/
48 #define FILE_TEXT N_("Logo filenames")
49 #define FILE_LONGTEXT N_("Full path of the image files to use. Format is " \
50 "<image>[,<delay in ms>[,<alpha>]][;<image>[,<delay>[,<alpha>]]][;...]. " \
51 "If you only have one file, simply enter its filename.")
52 #define REPEAT_TEXT N_("Logo animation # of loops")
53 #define REPEAT_LONGTEXT N_("Number of loops for the logo animation." \
54 "-1 = continuous, 0 = disabled")
55 #define DELAY_TEXT N_("Logo individual image time in ms")
56 #define DELAY_LONGTEXT N_("Individual image display time of 0 - 60000 ms.")
58 #define POSX_TEXT N_("X coordinate")
59 #define POSX_LONGTEXT N_("X coordinate of the logo. You can move the logo " \
60 "by left-clicking it." )
61 #define POSY_TEXT N_("Y coordinate")
62 #define POSY_LONGTEXT N_("Y coordinate of the logo. You can move the logo " \
63 "by left-clicking it." )
64 #define TRANS_TEXT N_("Transparency of the logo")
65 #define TRANS_LONGTEXT N_("Logo transparency value " \
66 "(from 0 for full transparency to 255 for full opacity)." )
67 #define POS_TEXT N_("Logo position")
68 #define POS_LONGTEXT N_( \
69 "Enforce the logo position on the video " \
70 "(0=center, 1=left, 2=right, 4=top, 8=bottom, you can " \
71 "also use combinations of these values, eg 6 = top-right).")
73 #define CFG_PREFIX "logo-"
75 static const int pi_pos_values[] = { 0, 1, 2, 4, 8, 5, 6, 9, 10 };
76 static const char *const ppsz_pos_descriptions[] =
77 { N_("Center"), N_("Left"), N_("Right"), N_("Top"), N_("Bottom"),
78 N_("Top-Left"), N_("Top-Right"), N_("Bottom-Left"), N_("Bottom-Right") };
80 static int OpenSub ( vlc_object_t * );
81 static int OpenVideo( vlc_object_t * );
82 static void Close ( vlc_object_t * );
85 set_category( CAT_VIDEO )
86 set_subcategory( SUBCAT_VIDEO_SUBPIC )
88 set_capability( "sub filter", 0 )
89 set_callbacks( OpenSub, Close )
90 set_description( N_("Logo sub filter") )
91 set_shortname( N_("Logo overlay") )
92 add_shortcut( "logo" )
94 add_file( CFG_PREFIX "file", NULL, NULL, FILE_TEXT, FILE_LONGTEXT, false )
95 add_integer( CFG_PREFIX "x", 0, NULL, POSX_TEXT, POSX_LONGTEXT, true )
96 add_integer( CFG_PREFIX "y", 0, NULL, POSY_TEXT, POSY_LONGTEXT, true )
97 /* default to 1000 ms per image, continuously cycle through them */
98 add_integer( CFG_PREFIX "delay", 1000, NULL, DELAY_TEXT, DELAY_LONGTEXT, true )
99 add_integer( CFG_PREFIX "repeat", -1, NULL, REPEAT_TEXT, REPEAT_LONGTEXT, true )
100 add_integer_with_range( CFG_PREFIX "transparency", 255, 0, 255, NULL,
101 TRANS_TEXT, TRANS_LONGTEXT, false )
102 add_integer( CFG_PREFIX "position", -1, NULL, POS_TEXT, POS_LONGTEXT, false )
103 change_integer_list( pi_pos_values, ppsz_pos_descriptions, NULL )
105 /* video output filter submodule */
107 set_capability( "video filter2", 0 )
108 set_callbacks( OpenVideo, Close )
109 set_description( N_("Logo video filter") )
110 add_shortcut( "logo" )
114 /*****************************************************************************
116 *****************************************************************************/
119 * Structure to hold the set of individual logo image names, times,
124 char *psz_file; /* candidate for deletion -- not needed */
125 int i_delay; /* -1 means use default delay */
126 int i_alpha; /* -1 means use default alpha */
132 * Logo list structure.
136 logo_t *p_logo; /* the parsing's result */
137 unsigned int i_count; /* the number of logo images to be displayed */
139 int i_repeat; /* how often to repeat the images, image time in ms */
140 mtime_t i_next_pic; /* when to bring up a new logo image */
142 unsigned int i_counter; /* index into the list of logo images */
144 int i_delay; /* default delay (0 - 60000 ms) */
145 int i_alpha; /* default alpha */
150 * Private logo data holder
165 /* On the fly control variable */
172 static const char *const ppsz_filter_options[] = {
173 "file", "x", "y", "delay", "repeat", "transparency", "position", NULL
176 static const char *const ppsz_filter_callbacks[] = {
186 static int OpenCommon( vlc_object_t *, bool b_sub );
188 static subpicture_t *FilterSub( filter_t *, mtime_t );
189 static picture_t *FilterVideo( filter_t *, picture_t * );
191 static int Mouse( filter_t *, vlc_mouse_t *, const vlc_mouse_t *, const vlc_mouse_t * );
193 static int LogoCallback( vlc_object_t *, char const *,
194 vlc_value_t, vlc_value_t, void * );
196 static void LogoListLoad( vlc_object_t *, logo_list_t *, const char * );
197 static void LogoListUnload( logo_list_t * );
198 static logo_t *LogoListNext( logo_list_t *p_list, mtime_t i_date );
199 static logo_t *LogoListCurrent( logo_list_t *p_list );
202 * Open the sub filter
204 static int OpenSub( vlc_object_t *p_this )
206 return OpenCommon( p_this, true );
210 * Open the video filter
212 static int OpenVideo( vlc_object_t *p_this )
214 return OpenCommon( p_this, false );
218 * Common open function
220 static int OpenCommon( vlc_object_t *p_this, bool b_sub )
222 filter_t *p_filter = (filter_t *)p_this;
227 if( !b_sub && !es_format_IsSimilar( &p_filter->fmt_in, &p_filter->fmt_out ) )
229 msg_Err( p_filter, "Input and output format does not match" );
235 p_filter->p_sys = p_sys = malloc( sizeof( *p_sys ) );
240 p_sys->p_blend = NULL;
244 p_sys->p_blend = filter_NewBlend( VLC_OBJECT(p_filter),
245 &p_filter->fmt_in.video );
246 if( !p_sys->p_blend )
254 config_ChainParse( p_filter, CFG_PREFIX, ppsz_filter_options,
258 logo_list_t *p_list = &p_sys->list;
260 psz_filename = var_CreateGetStringCommand( p_filter, "logo-file" );
264 filter_DeleteBlend( p_sys->p_blend );
268 if( *psz_filename == '\0' )
269 msg_Warn( p_this, "no logo file specified" );
271 p_list->i_alpha = var_CreateGetIntegerCommand( p_filter,
272 "logo-transparency");
273 p_list->i_alpha = __MAX( __MIN( p_list->i_alpha, 255 ), 0 );
275 var_CreateGetIntegerCommand( p_filter, "logo-delay" );
277 var_CreateGetIntegerCommand( p_filter, "logo-repeat" );
279 p_sys->i_pos = var_CreateGetIntegerCommand( p_filter, "logo-position" );
280 p_sys->i_pos_x = var_CreateGetIntegerCommand( p_filter, "logo-x" );
281 p_sys->i_pos_y = var_CreateGetIntegerCommand( p_filter, "logo-y" );
283 /* Ignore aligment if a position is given for video filter */
284 if( !b_sub && p_sys->i_pos_x >= 0 && p_sys->i_pos_y >= 0 )
287 vlc_mutex_init( &p_sys->lock );
288 LogoListLoad( p_this, p_list, psz_filename );
289 p_sys->b_spu_update = true;
290 p_sys->b_mouse_grab = false;
292 for( int i = 0; ppsz_filter_callbacks[i]; i++ )
293 var_AddCallback( p_filter, ppsz_filter_callbacks[i],
294 LogoCallback, p_sys );
299 p_filter->pf_sub_filter = FilterSub;
303 p_filter->pf_video_filter = FilterVideo;
304 p_filter->pf_mouse = Mouse;
307 free( psz_filename );
312 * Common close function
314 static void Close( vlc_object_t *p_this )
316 filter_t *p_filter = (filter_t *)p_this;
317 filter_sys_t *p_sys = p_filter->p_sys;
319 for( int i = 0; ppsz_filter_callbacks[i]; i++ )
320 var_DelCallback( p_filter, ppsz_filter_callbacks[i],
321 LogoCallback, p_sys );
324 filter_DeleteBlend( p_sys->p_blend );
326 vlc_mutex_destroy( &p_sys->lock );
327 LogoListUnload( &p_sys->list );
334 static subpicture_t *FilterSub( filter_t *p_filter, mtime_t date )
336 filter_sys_t *p_sys = p_filter->p_sys;
337 logo_list_t *p_list = &p_sys->list;
340 subpicture_region_t *p_region;
345 vlc_mutex_lock( &p_sys->lock );
346 /* Basic test: b_spu_update occurs on a dynamic change,
347 & i_next_pic is the general timer, when to
348 look at updating the logo image */
350 if( ( !p_sys->b_spu_update && p_list->i_next_pic > date ) ||
353 vlc_mutex_unlock( &p_sys->lock );
357 /* adjust index to the next logo */
358 p_logo = LogoListNext( p_list, date );
359 p_sys->b_spu_update = false;
361 p_pic = p_logo->p_pic;
363 /* Allocate the subpicture internal data. */
364 p_spu = filter_NewSubpicture( p_filter );
368 p_spu->b_absolute = p_sys->b_absolute;
369 p_spu->i_start = date;
371 p_spu->b_ephemer = true;
373 /* Send an empty subpicture to clear the display when needed */
374 if( p_list->i_repeat != -1 && p_list->i_counter == 0 )
377 if( p_list->i_repeat == 0 )
380 if( !p_pic || !p_logo->i_alpha ||
381 ( p_logo->i_alpha == -1 && !p_list->i_alpha ) )
384 /* Create new SPU region */
385 memset( &fmt, 0, sizeof(video_format_t) );
386 fmt.i_chroma = VLC_CODEC_YUVA;
387 fmt.i_aspect = VOUT_ASPECT_FACTOR;
388 fmt.i_sar_num = fmt.i_sar_den = 1;
389 fmt.i_width = fmt.i_visible_width = p_pic->p[Y_PLANE].i_visible_pitch;
390 fmt.i_height = fmt.i_visible_height = p_pic->p[Y_PLANE].i_visible_lines;
391 fmt.i_x_offset = fmt.i_y_offset = 0;
392 p_region = subpicture_region_New( &fmt );
395 msg_Err( p_filter, "cannot allocate SPU region" );
396 p_filter->pf_sub_buffer_del( p_filter, p_spu );
402 picture_Copy( p_region->p_picture, p_pic );
404 /* where to locate the logo: */
405 if( p_sys->i_pos < 0 )
406 { /* set to an absolute xy */
407 p_region->i_align = OSD_ALIGN_RIGHT | OSD_ALIGN_TOP;
408 p_spu->b_absolute = true;
411 { /* set to one of the 9 relative locations */
412 p_region->i_align = p_sys->i_pos;
413 p_spu->b_absolute = false;
416 p_region->i_x = p_sys->i_pos_x;
417 p_region->i_y = p_sys->i_pos_y;
419 p_spu->p_region = p_region;
421 p_spu->i_alpha = ( p_logo->i_alpha != -1 ?
422 p_logo->i_alpha : p_list->i_alpha );
425 vlc_mutex_unlock( &p_sys->lock );
433 static picture_t *FilterVideo( filter_t *p_filter, picture_t *p_src )
435 filter_sys_t *p_sys = p_filter->p_sys;
436 logo_list_t *p_list = &p_sys->list;
438 picture_t *p_dst = filter_NewPicture( p_filter );
442 picture_Copy( p_dst, p_src );
445 vlc_mutex_lock( &p_sys->lock );
448 if( p_list->i_next_pic < p_src->date )
449 p_logo = LogoListNext( p_list, p_src->date );
451 p_logo = LogoListCurrent( p_list );
454 const picture_t *p_pic = p_logo->p_pic;
457 const video_format_t *p_fmt = &p_pic->format;
458 const int i_dst_w = p_filter->fmt_out.video.i_visible_width;
459 const int i_dst_h = p_filter->fmt_out.video.i_visible_height;
463 if( p_sys->i_pos & SUBPICTURE_ALIGN_BOTTOM )
465 p_sys->i_pos_y = i_dst_h - p_fmt->i_visible_height;
467 else if ( !(p_sys->i_pos & SUBPICTURE_ALIGN_TOP) )
469 p_sys->i_pos_y = ( i_dst_h - p_fmt->i_visible_height ) / 2;
476 if( p_sys->i_pos & SUBPICTURE_ALIGN_RIGHT )
478 p_sys->i_pos_x = i_dst_w - p_fmt->i_visible_width;
480 else if ( !(p_sys->i_pos & SUBPICTURE_ALIGN_LEFT) )
482 p_sys->i_pos_x = ( i_dst_w - p_fmt->i_visible_width ) / 2;
491 const int i_alpha = p_logo->i_alpha != -1 ? p_logo->i_alpha : p_list->i_alpha;
492 if( filter_ConfigureBlend( p_sys->p_blend, i_dst_w, i_dst_h, p_fmt ) ||
493 filter_Blend( p_sys->p_blend, p_dst, p_sys->i_pos_x, p_sys->i_pos_y,
496 msg_Err( p_filter, "failed to blend a picture" );
499 vlc_mutex_unlock( &p_sys->lock );
502 picture_Release( p_src );
506 static int Mouse( filter_t *p_filter, vlc_mouse_t *p_mouse,
507 const vlc_mouse_t *p_old, const vlc_mouse_t *p_new )
509 filter_sys_t *p_sys = p_filter->p_sys;
511 vlc_mutex_lock( &p_sys->lock );
512 logo_t *p_logo = LogoListCurrent( &p_sys->list );
513 const picture_t *p_pic = p_logo->p_pic;
517 const video_format_t *p_fmt = &p_pic->format;
518 const int i_logo_w = p_fmt->i_visible_width;
519 const int i_logo_h = p_fmt->i_visible_height;
521 /* Check if we are over the logo */
522 const bool b_over = p_new->i_x >= p_sys->i_pos_x &&
523 p_new->i_x < p_sys->i_pos_x + i_logo_w &&
524 p_new->i_y >= p_sys->i_pos_y &&
525 p_new->i_y < p_sys->i_pos_y + i_logo_h;
527 if( b_over && vlc_mouse_HasPressed( p_old, p_new, MOUSE_BUTTON_LEFT ) )
528 p_sys->b_mouse_grab = true;
529 else if( vlc_mouse_HasReleased( p_old, p_new, MOUSE_BUTTON_LEFT ) )
530 p_sys->b_mouse_grab = false;
532 if( p_sys->b_mouse_grab )
535 vlc_mouse_GetMotion( &i_dx, &i_dy, p_old, p_new );
536 p_sys->i_pos_x = __MIN( __MAX( p_sys->i_pos_x + i_dx, 0 ),
537 p_filter->fmt_in.video.i_width - i_logo_w );
538 p_sys->i_pos_y = __MIN( __MAX( p_sys->i_pos_y + i_dy, 0 ),
539 p_filter->fmt_in.video.i_height - i_logo_h );
542 if( p_sys->b_mouse_grab || b_over )
544 vlc_mutex_unlock( &p_sys->lock );
548 vlc_mutex_unlock( &p_sys->lock );
554 /*****************************************************************************
555 * Callback to update params on the fly
556 *****************************************************************************/
557 static int LogoCallback( vlc_object_t *p_this, char const *psz_var,
558 vlc_value_t oldval, vlc_value_t newval, void *p_data )
561 filter_sys_t *p_sys = (filter_sys_t *)p_data;
562 logo_list_t *p_list = &p_sys->list;
564 vlc_mutex_lock( &p_sys->lock );
565 if( !strcmp( psz_var, "logo-file" ) )
567 LogoListUnload( p_list );
568 LogoListLoad( p_this, p_list, newval.psz_string );
570 else if ( !strcmp( psz_var, "logo-x" ) )
572 p_sys->i_pos_x = newval.i_int;
574 else if ( !strcmp( psz_var, "logo-y" ) )
576 p_sys->i_pos_y = newval.i_int;
578 else if ( !strcmp( psz_var, "logo-position" ) )
580 p_sys->i_pos = newval.i_int;
582 else if ( !strcmp( psz_var, "logo-transparency" ) )
584 p_list->i_alpha = __MAX( __MIN( newval.i_int, 255 ), 0 );
586 else if ( !strcmp( psz_var, "logo-repeat" ) )
588 p_list->i_repeat = newval.i_int;
590 p_sys->b_spu_update = true;
591 vlc_mutex_unlock( &p_sys->lock );
597 * It loads the logo image into memory.
599 static picture_t *LoadImage( vlc_object_t *p_this, char *psz_filename )
604 video_format_t fmt_in;
605 video_format_Init( &fmt_in, 0 );
607 video_format_t fmt_out;
608 video_format_Init( &fmt_out, VLC_CODEC_YUVA );
610 image_handler_t *p_image = image_HandlerCreate( p_this );
614 picture_t *p_pic = image_ReadUrl( p_image, psz_filename, &fmt_in, &fmt_out );
615 image_HandlerDelete( p_image );
621 * It loads the logo images into memory.
623 * Read the logo-file input switch, obtaining a list of images and associated
624 * durations and transparencies. Store the image(s), and times. An image
625 * without a stated time or transparency will use the logo-delay and
626 * logo-transparency values.
628 static void LogoListLoad( vlc_object_t *p_this, logo_list_t *p_logo_list,
629 const char *psz_filename )
631 char *psz_list; /* the list: <logo>[,[<delay>[,[<alpha>]]]][;...] */
634 logo_t *p_logo; /* the parsing's result */
636 p_logo_list->i_counter = 0;
637 p_logo_list->i_next_pic = 0;
639 psz_original = psz_list = strdup( psz_filename );
643 /* Count the number logos == number of ';' + 1 */
644 p_logo_list->i_count = 1;
645 for( i = 0; i < strlen( psz_list ); i++ )
647 if( psz_list[i] == ';' )
648 p_logo_list->i_count++;
651 p_logo_list->p_logo =
652 p_logo = calloc( p_logo_list->i_count, sizeof(*p_logo) );
657 for( i = 0; i < p_logo_list->i_count; i++ )
659 char *p_c = strchr( psz_list, ';' );
660 char *p_c2 = strchr( psz_list, ',' );
662 p_logo[i].i_alpha = -1; /* use default settings */
663 p_logo[i].i_delay = -1; /* use default settings */
665 if( p_c2 && ( p_c2 < p_c || !p_c ) )
667 /* <logo>,<delay>[,<alpha>] type */
668 if( p_c2[1] != ',' && p_c2[1] != ';' && p_c2[1] != '\0' )
669 p_logo[i].i_delay = atoi( p_c2+1 );
671 if( ( p_c2 = strchr( p_c2+1, ',' ) )
672 && ( p_c2 < p_c || !p_c ) && p_c2[1] != ';' && p_c2[1] != '\0' )
673 p_logo[i].i_alpha = atoi( p_c2 + 1 );
682 p_logo[i].psz_file = strdup( psz_list );
683 p_logo[i].p_pic = LoadImage( p_this, p_logo[i].psz_file );
685 if( !p_logo[i].p_pic )
687 msg_Warn( p_this, "error while loading logo %s, will be skipped",
688 p_logo[i].psz_file );
695 for( i = 0; i < p_logo_list->i_count; i++ )
697 msg_Dbg( p_this, "logo file name %s, delay %d, alpha %d",
698 p_logo[i].psz_file, p_logo[i].i_delay, p_logo[i].i_alpha );
701 /* initialize so that on the first update it will wrap back to 0 */
702 p_logo_list->i_counter = p_logo_list->i_count - 1;
704 free( psz_original );
708 * Unload a list of logo and release associated ressources.
710 static void LogoListUnload( logo_list_t *p_list )
712 for( unsigned i = 0; i < p_list->i_count; i++ )
714 logo_t *p_logo = &p_list->p_logo[i];
716 free( p_logo->psz_file );
719 picture_Release( p_logo->p_pic );
720 p_logo->p_pic = NULL;
723 free( p_list->p_logo );
727 * Go to the next logo and return its pointer.
729 static logo_t *LogoListNext( logo_list_t *p_list, mtime_t i_date )
731 p_list->i_counter = ( p_list->i_counter + 1 ) % p_list->i_count;
733 logo_t *p_logo = LogoListCurrent( p_list );
735 p_list->i_next_pic = i_date + ( p_logo->i_delay != -1 ?
736 p_logo->i_delay : p_list->i_delay ) * 1000;
740 * Return the current logo pointer
742 static logo_t *LogoListCurrent( logo_list_t *p_list )
744 return &p_list->p_logo[p_list->i_counter];