git.sesse.net Git - vlc/blob - modules/video_filter/dynamicoverlay/dynamicoverlay.h

   1 /*****************************************************************************
   2  * dynamicoverlay.h : dynamic overlay plugin for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2008 the VideoLAN team
   5  * $Id$
   6  *
   7  * Author: Jean-Paul Saman <jpsaman@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #ifndef DYNAMIC_OVERLAY_H
  25 #define DYNAMIC_OVERLAY_H   1
  26
  27 #include <vlc_common.h>
  28 #include <vlc_filter.h>
  29
  30 /*****************************************************************************
  31  * buffer_t: Command and response buffer
  32  *****************************************************************************/
  33
  34 typedef struct buffer_t
  35 {
  36     size_t i_size;                         /**< Size of the allocated memory */
  37     size_t i_length;                          /**< Length of the stored data */
  38
  39     char *p_memory;                       /**< Start of the allocated memory */
  40     char *p_begin;                             /**< Start of the stored data */
  41 } buffer_t;
  42
  43 int BufferInit( buffer_t *p_buffer );
  44 int BufferDestroy( buffer_t *p_buffer );
  45 int BufferAdd( buffer_t *p_buffer, const char *p_data, size_t i_len );
  46 int BufferPrintf( buffer_t *p_buffer, const char *p_fmt, ... );
  47 int BufferDel( buffer_t *p_buffer, int i_len );
  48 char *BufferGetToken( buffer_t *p_buffer );
  49
  50 /*****************************************************************************
  51  * Command structures
  52  *****************************************************************************/
  53
  54 /** struct commandparams_t - command params structure */
  55 typedef struct commandparams_t
  56 {
  57     int32_t i_id;       /*< overlay id */
  58     int32_t i_shmid;    /*< shared memory identifier */
  59
  60     vlc_fourcc_t fourcc;/*< chroma */
  61
  62     int32_t i_x;        /*< x position of overlay */
  63     int32_t i_y;        /*< y position of overlay */
  64     int32_t i_width;    /*< width of overlay */
  65     int32_t i_height;   /*< height of overlay */
  66
  67     int32_t i_alpha;    /*< alpha value of overlay */
  68
  69     struct text_style_t fontstyle; /*< text style */
  70
  71     bool b_visible; /*< visibility flag of overlay */
  72 } commandparams_t;
  73
  74 typedef int (*parser_func_t)(char *psz_command, char *psz_end, commandparams_t *p_params );
  75 typedef int (*execute_func_t)( filter_t *p_filter, const commandparams_t *p_params, commandparams_t *p_results );
  76 typedef int (*unparse_func_t)( const commandparams_t *p_results, buffer_t *p_output );
  77
  78 typedef struct commanddesc_t
  79 {
  80     char *psz_command;
  81     bool b_atomic;
  82     parser_func_t pf_parser;
  83     execute_func_t pf_execute;
  84     unparse_func_t pf_unparse;
  85 } commanddesc_t;
  86
  87 typedef struct commanddesc_static_t
  88 {
  89     const char *psz_command;
  90     bool b_atomic;
  91     parser_func_t pf_parser;
  92     execute_func_t pf_execute;
  93     unparse_func_t pf_unparse;
  94 } commanddesc_static_t;
  95
  96
  97 typedef struct command_t
  98 {
  99     struct commanddesc_t *p_command;
 100     int i_status;
 101     commandparams_t params;
 102     commandparams_t results;
 103     struct command_t *p_next;
 104 } command_t;
 105
 106 void RegisterCommand( filter_t *p_filter );
 107 void UnregisterCommand( filter_t *p_filter );
 108
 109 /*****************************************************************************
 110  * queue_t: Command queue
 111  *****************************************************************************/
 112
 113 typedef struct queue_t
 114 {
 115     command_t *p_head;                  /**< Head (first entry) of the queue */
 116     command_t *p_tail;                   /**< Tail (last entry) of the queue */
 117 } queue_t;
 118
 119 int QueueInit( queue_t *p_queue );
 120 int QueueDestroy( queue_t *p_queue );
 121 int QueueEnqueue( queue_t *p_queue, command_t *p_cmd );
 122 command_t *QueueDequeue( queue_t *p_queue );
 123 int QueueTransfer( queue_t *p_sink, queue_t *p_source );
 124
 125 /*****************************************************************************
 126  * overlay_t: Overlay descriptor
 127  *****************************************************************************/
 128
 129 typedef struct overlay_t
 130 {
 131     int i_x, i_y;
 132     int i_alpha;
 133     bool b_active;
 134
 135     video_format_t format;
 136     struct text_style_t *p_fontstyle;
 137     union {
 138         picture_t *p_pic;
 139         char *p_text;
 140     } data;
 141 } overlay_t;
 142
 143 overlay_t *OverlayCreate( void );
 144 int OverlayDestroy( overlay_t *p_ovl );
 145
 146 /*****************************************************************************
 147  * list_t: Command queue
 148  *****************************************************************************/
 149
 150 typedef struct list_t
 151 {
 152     overlay_t **pp_head, **pp_tail;
 153 } list_t;
 154
 155 int ListInit( list_t *p_list );
 156 int ListDestroy( list_t *p_list );
 157 ssize_t ListAdd( list_t *p_list, overlay_t *p_new );
 158 int ListRemove( list_t *p_list, size_t i_idx );
 159 overlay_t *ListGet( list_t *p_list, size_t i_idx );
 160 overlay_t *ListWalk( list_t *p_list );
 161
 162 /*****************************************************************************
 163  * filter_sys_t: adjust filter method descriptor
 164  *****************************************************************************/
 165
 166 struct filter_sys_t
 167 {
 168     buffer_t input, output;
 169
 170     int i_inputfd, i_outputfd;
 171     char *psz_inputfile, *psz_outputfile;
 172
 173     commanddesc_t **pp_commands; /* array of commands */
 174     size_t i_commands;
 175
 176     bool b_updated, b_atomic;
 177     queue_t atomic, pending, processed;
 178     list_t overlays;
 179
 180     vlc_mutex_t lock;   /* lock to protect psz_inputfile and psz_outputfile */
 181 };
 182
 183 #endif