git.sesse.net Git - vlc/blob - include/common.h

   1 /*****************************************************************************
   2  * common.h: common definitions
   3  * Collection of useful common types and macros definitions
   4  *****************************************************************************
   5  * Copyright (C) 1998, 1999, 2000 VideoLAN
   6  * $Id: common.h,v 1.65 2002/01/05 02:22:02 sam Exp $
   7  *
   8  * Authors: Samuel Hocevar <sam@via.ecp.fr>
   9  *          Vincent Seguin <seguin@via.ecp.fr>
  10  *          Gildas Bazin <gbazin@netcourrier.com>
  11  *
  12  * This program is free software; you can redistribute it and/or modify
  13  * it under the terms of the GNU General Public License as published by
  14  * the Free Software Foundation; either version 2 of the License, or
  15  * (at your option) any later version.
  16  *
  17  * This program is distributed in the hope that it will be useful,
  18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20  * GNU General Public License for more details.
  21  *
  22  * You should have received a copy of the GNU General Public License
  23  * along with this program; if not, write to the Free Software
  24  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  25  *****************************************************************************/
  26
  27 /*****************************************************************************
  28  * Required system headers
  29  *****************************************************************************/
  30 #include <string.h>                                            /* strerror() */
  31
  32 /*****************************************************************************
  33  * Basic types definitions
  34  *****************************************************************************/
  35
  36 typedef u8                  byte_t;
  37
  38 /* Boolean type */
  39 #ifdef BOOLEAN_T_IN_SYS_TYPES_H
  40 #   include <sys/types.h>
  41 #elif defined(BOOLEAN_T_IN_PTHREAD_H)
  42 #   include <pthread.h>
  43 #elif defined(BOOLEAN_T_IN_CTHREADS_H)
  44 #   include <cthreads.h>
  45 #else
  46 typedef int                 boolean_t;
  47 #endif
  48 #ifdef SYS_GNU
  49 #   define _MACH_I386_BOOLEAN_H_
  50 #endif
  51
  52 /* ptrdiff_t definition */
  53 #ifdef HAVE_STDDEF_H
  54 #   include <stddef.h>
  55 #else
  56 #   include <malloc.h>
  57 #   ifndef _PTRDIFF_T
  58 #       define _PTRDIFF_T
  59 /* Not portable in a 64-bit environment. */
  60 typedef int                 ptrdiff_t;
  61 #   endif
  62 #endif
  63
  64 /* Counter for statistics and profiling */
  65 typedef unsigned long       count_t;
  66
  67 /* DCT elements types */
  68 typedef s16                 dctelem_t;
  69
  70 /* Video buffer types */
  71 typedef u8                  yuv_data_t;
  72
  73 /*****************************************************************************
  74  * mtime_t: high precision date or time interval
  75  *****************************************************************************
  76  * Store an high precision date or time interval. The maximum precision is the
  77  * micro-second, and a 64 bits integer is used to avoid any overflow (maximum
  78  * time interval is then 292271 years, which should be long enough for any
  79  * video). Date are stored as a time interval since a common date.
  80  * Note that date and time intervals can be manipulated using regular
  81  * arithmetic operators, and that no special functions are required.
  82  *****************************************************************************/
  83 typedef s64 mtime_t;
  84
  85 /*****************************************************************************
  86  * Classes declaration
  87  *****************************************************************************/
  88
  89 /* Plugins */
  90 struct plugin_bank_s;
  91 struct plugin_info_s;
  92
  93 typedef struct plugin_bank_s *          p_plugin_bank_t;
  94 typedef struct plugin_info_s *          p_plugin_info_t;
  95
  96 /* Plugins */
  97 struct playlist_s;
  98 struct playlist_item_s;
  99 struct module_s;
 100
 101 typedef struct playlist_s *             p_playlist_t;
 102 typedef struct playlist_item_s *        p_playlist_item_t;
 103
 104 /* Interface */
 105 struct intf_thread_s;
 106 struct intf_sys_s;
 107 struct intf_console_s;
 108 struct intf_msg_s;
 109 struct intf_channel_s;
 110
 111 typedef struct intf_thread_s *          p_intf_thread_t;
 112 typedef struct intf_sys_s *             p_intf_sys_t;
 113 typedef struct intf_console_s *         p_intf_console_t;
 114 typedef struct intf_msg_s *             p_intf_msg_t;
 115 typedef struct intf_channel_s *         p_intf_channel_t;
 116
 117 /* Input */
 118 struct input_thread_s;
 119 struct input_channel_s;
 120 struct input_cfg_s;
 121 struct input_area_s;
 122
 123 typedef struct input_thread_s *         p_input_thread_t;
 124 typedef struct input_channel_s *        p_input_channel_t;
 125 typedef struct input_cfg_s *            p_input_cfg_t;
 126 typedef struct input_area_s *           p_input_area_t;
 127
 128 /* Audio */
 129 struct aout_thread_s;
 130 struct aout_sys_s;
 131
 132 typedef struct aout_thread_s *          p_aout_thread_t;
 133 typedef struct aout_sys_s *             p_aout_sys_t;
 134
 135 /* Video */
 136 struct vout_thread_s;
 137 struct vout_font_s;
 138 struct vout_sys_s;
 139 struct chroma_sys_s;
 140 struct vdec_thread_s;
 141 struct vpar_thread_s;
 142 struct video_parser_s;
 143
 144 typedef struct vout_thread_s *          p_vout_thread_t;
 145 typedef struct vout_font_s *            p_vout_font_t;
 146 typedef struct vout_sys_s *             p_vout_sys_t;
 147 typedef struct chroma_sys_s *           p_chroma_sys_t;
 148 typedef struct vdec_thread_s *          p_vdec_thread_t;
 149 typedef struct vpar_thread_s *          p_vpar_thread_t;
 150 typedef struct video_parser_s *         p_video_parser_t;
 151
 152 /* Decoders */
 153 struct decoder_config_s;
 154 struct decoder_fifo_s;
 155
 156 /* Misc */
 157 struct macroblock_s;
 158 struct data_packet_s;
 159 struct imdct_s;
 160 struct complex_s;
 161 struct dm_par_s;
 162 struct picture_s;
 163 struct picture_sys_s;
 164 struct picture_heap_s;
 165 struct es_descriptor_s;
 166 struct pgrm_descriptor_s;
 167 struct pes_packet_s;
 168 struct input_area_s;
 169 struct bit_stream_s;
 170 struct probedata_s;
 171
 172 /*****************************************************************************
 173  * Macros and inline functions
 174  *****************************************************************************/
 175 #ifdef NTOHL_IN_SYS_PARAM_H
 176 #   include <sys/param.h>
 177
 178 #elif defined(WIN32)
 179 /* Swap bytes in 16 bit value.  */
 180 #   define __bswap_constant_16(x) \
 181      ((((x) >> 8) & 0xff) | (((x) & 0xff) << 8))
 182
 183 #   if defined __GNUC__ && __GNUC__ >= 2
 184 #       define __bswap_16(x) \
 185             (__extension__                                                    \
 186              ({ register unsigned short int __v;                              \
 187                 if (__builtin_constant_p (x))                                 \
 188                   __v = __bswap_constant_16 (x);                              \
 189                 else                                                          \
 190                   __asm__ __volatile__ ("rorw $8, %w0"                        \
 191                                         : "=r" (__v)                          \
 192                                         : "0" ((unsigned short int) (x))      \
 193                                         : "cc");                              \
 194                 __v; }))
 195 #   else
 196 /* This is better than nothing.  */
 197 #       define __bswap_16(x) __bswap_constant_16 (x)
 198 #   endif
 199
 200 /* Swap bytes in 32 bit value.  */
 201 #   define __bswap_constant_32(x) \
 202         ((((x) & 0xff000000) >> 24) | (((x) & 0x00ff0000) >>  8) |            \
 203          (((x) & 0x0000ff00) <<  8) | (((x) & 0x000000ff) << 24))
 204
 205 #   if defined __GNUC__ && __GNUC__ >= 2
 206 /* To swap the bytes in a word the i486 processors and up provide the
 207    `bswap' opcode.  On i386 we have to use three instructions.  */
 208 #       if !defined __i486__ && !defined __pentium__ && !defined __pentiumpro__
 209 #           define __bswap_32(x) \
 210                 (__extension__                                                \
 211                  ({ register unsigned int __v;                                \
 212                     if (__builtin_constant_p (x))                             \
 213                       __v = __bswap_constant_32 (x);                          \
 214                     else                                                      \
 215                       __asm__ __volatile__ ("rorw $8, %w0;"                   \
 216                                             "rorl $16, %0;"                   \
 217                                             "rorw $8, %w0"                    \
 218                                             : "=r" (__v)                      \
 219                                             : "0" ((unsigned int) (x))        \
 220                                             : "cc");                          \
 221                     __v; }))
 222 #       else
 223 #           define __bswap_32(x) \
 224                 (__extension__                                                \
 225                  ({ register unsigned int __v;                                \
 226                     if (__builtin_constant_p (x))                             \
 227                       __v = __bswap_constant_32 (x);                          \
 228                     else                                                      \
 229                       __asm__ __volatile__ ("bswap %0"                        \
 230                                             : "=r" (__v)                      \
 231                                             : "0" ((unsigned int) (x)));      \
 232                     __v; }))
 233 #       endif
 234 #   else
 235 #       define __bswap_32(x) __bswap_constant_32 (x)
 236 #   endif
 237
 238 #   if defined __GNUC__ && __GNUC__ >= 2
 239 /* Swap bytes in 64 bit value.  */
 240 #       define __bswap_constant_64(x) \
 241             ((((x) & 0xff00000000000000ull) >> 56)                            \
 242              | (((x) & 0x00ff000000000000ull) >> 40)                          \
 243              | (((x) & 0x0000ff0000000000ull) >> 24)                          \
 244              | (((x) & 0x000000ff00000000ull) >> 8)                           \
 245              | (((x) & 0x00000000ff000000ull) << 8)                           \
 246              | (((x) & 0x0000000000ff0000ull) << 24)                          \
 247              | (((x) & 0x000000000000ff00ull) << 40)                          \
 248              | (((x) & 0x00000000000000ffull) << 56))
 249
 250 #       define __bswap_64(x) \
 251             (__extension__                                                    \
 252              ({ union { __extension__ unsigned long long int __ll;            \
 253                         unsigned long int __l[2]; } __w, __r;                 \
 254                 if (__builtin_constant_p (x))                                 \
 255                   __r.__ll = __bswap_constant_64 (x);                         \
 256                 else                                                          \
 257                   {                                                           \
 258                     __w.__ll = (x);                                           \
 259                     __r.__l[0] = __bswap_32 (__w.__l[1]);                     \
 260                     __r.__l[1] = __bswap_32 (__w.__l[0]);                     \
 261                   }                                                           \
 262                 __r.__ll; }))
 263 #   endif
 264
 265 #else /* NTOHL_IN_SYS_PARAM_H || WIN32 */
 266 #   include <netinet/in.h>
 267
 268 #endif /* NTOHL_IN_SYS_PARAM_H || WIN32 */
 269
 270 /* CEIL: division with round to nearest greater integer */
 271 #define CEIL(n, d)  ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
 272
 273 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
 274 #define PAD(n, d)   ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
 275
 276 /* MAX and MIN: self explanatory */
 277 #ifndef MAX
 278 #   define MAX(a, b)   ( ((a) > (b)) ? (a) : (b) )
 279 #endif
 280 #ifndef MIN
 281 #   define MIN(a, b)   ( ((a) < (b)) ? (a) : (b) )
 282 #endif
 283
 284 /* MSB (big endian)/LSB (little endian) conversions - network order is always
 285  * MSB, and should be used for both network communications and files. Note that
 286  * byte orders other than little and big endians are not supported, but only
 287  * the VAX seems to have such exotic properties - note that these 'functions'
 288  * needs <netinet/in.h> or the local equivalent. */
 289 #if WORDS_BIGENDIAN
 290 #   define hton16      htons
 291 #   define hton32      htonl
 292 #   define hton64(i)   ( i )
 293 #   define ntoh16      ntohs
 294 #   define ntoh32      ntohl
 295 #   define ntoh64(i)   ( i )
 296 #else
 297 #   define hton16      htons
 298 #   define hton32      htonl
 299     static __inline__ u64 __hton64( u64 i )
 300     {
 301         return ((u64)(htonl((i) & 0xffffffff)) << 32)
 302                 | htonl(((i) >> 32) & 0xffffffff );
 303     }
 304 #   define hton64(i)   __hton64( i )
 305 #   define ntoh16      ntohs
 306 #   define ntoh32      ntohl
 307 #   define ntoh64      hton64
 308 #endif
 309
 310 /* Macros with automatic casts */
 311 #define U64_AT(p)   ( ntoh64 ( *( (u64 *)(p) ) ) )
 312 #define U32_AT(p)   ( ntoh32 ( *( (u32 *)(p) ) ) )
 313 #define U16_AT(p)   ( ntoh16 ( *( (u16 *)(p) ) ) )
 314
 315 /* Alignment of critical static data structures */
 316 #ifdef ATTRIBUTE_ALIGNED_MAX
 317 #   define ATTR_ALIGN(align) __attribute__ ((__aligned__ ((ATTRIBUTE_ALIGNED_MAX < align) ? ATTRIBUTE_ALIGNED_MAX : align)))
 318 #else
 319 #   define ATTR_ALIGN(align)
 320 #endif
 321
 322 /* Alignment of critical dynamic data structure */
 323 #ifdef HAVE_MEMALIGN
 324     /* Some systems have memalign() but no declaration for it */
 325     void * memalign( size_t align, size_t size );
 326 #else
 327 #   ifdef HAVE_VALLOC
 328         /* That's like using a hammer to kill a fly, but eh... */
 329 #       include <unistd.h>
 330 #       define memalign(align,size) valloc(size)
 331 #   else
 332         /* Assume malloc alignment is sufficient */
 333 #       define memalign(align,size) malloc(size)
 334 #   endif
 335 #endif
 336
 337 #define I64C(x)         x##LL
 338
 339
 340 #if defined( WIN32 )
 341 /* The ntoh* and hton* bytes swapping functions are provided by winsock
 342  * but for conveniency and speed reasons it is better to implement them
 343  * ourselves. ( several plugins use them and it is too much hassle to link
 344  * winsock with each of them ;-)
 345  */
 346 #   undef ntoh32(x)
 347 #   undef ntoh16(x)
 348 #   undef ntoh64(x)
 349 #   undef hton32(x)
 350 #   undef hton16(x)
 351 #   undef hton64(x)
 352
 353 #   ifdef WORDS_BIGENDIAN
 354 #       define ntoh32(x)       (x)
 355 #       define ntoh16(x)       (x)
 356 #       define ntoh64(x)       (x)
 357 #       define hton32(x)       (x)
 358 #       define hton16(x)       (x)
 359 #       define hton64(x)       (x)
 360 #   else
 361 #       define ntoh32(x)     __bswap_32 (x)
 362 #       define ntoh16(x)     __bswap_16 (x)
 363 #       define ntoh64(x)     __bswap_32 (x)
 364 #       define hton32(x)     __bswap_32 (x)
 365 #       define hton16(x)     __bswap_16 (x)
 366 #       define hton64(x)     __bswap_32 (x)
 367 #   endif
 368
 369 /* win32, cl and icl support */
 370 #   if defined( _MSC_VER )
 371 #       define __attribute__(x)
 372 #       define __inline__      __inline
 373 #       define strncasecmp     strnicmp
 374 #       define strcasecmp      stricmp
 375 #       define S_ISBLK(m)      (0)
 376 #       define S_ISCHR(m)      (0)
 377 #       define S_ISFIFO(m)     (((m)&_S_IFMT) == _S_IFIFO)
 378 #       define S_ISREG(m)      (((m)&_S_IFMT) == _S_IFREG)
 379 #       undef I64C(x)
 380 #       define I64C(x)         x##i64
 381 #   endif
 382
 383 /* several type definitions */
 384 #   if defined( __MINGW32__ )
 385 #       if !defined( _OFF_T_ )
 386 typedef long long _off_t;
 387 typedef _off_t off_t;
 388 #           define _OFF_T_
 389 #       else
 390 #           define off_t long long
 391 #       endif
 392 #   endif
 393
 394 #   if defined( _MSC_VER )
 395 #       if !defined( _OFF_T_DEFINED )
 396 typedef __int64 off_t;
 397 #           define _OFF_T_DEFINED
 398 #       else
 399 #           define off_t __int64
 400 #       endif
 401 #       define stat _stati64
 402 #   endif
 403
 404 #   ifndef snprintf
 405 #       define snprintf _snprintf  /* snprintf not defined in mingw32 (bug?) */
 406 #   endif
 407
 408 #endif
 409
 410 /*****************************************************************************
 411  * CPU capabilities
 412  *****************************************************************************/
 413 #define CPU_CAPABILITY_NONE    0
 414 #define CPU_CAPABILITY_486     (1<<0)
 415 #define CPU_CAPABILITY_586     (1<<1)
 416 #define CPU_CAPABILITY_PPRO    (1<<2)
 417 #define CPU_CAPABILITY_MMX     (1<<3)
 418 #define CPU_CAPABILITY_3DNOW   (1<<4)
 419 #define CPU_CAPABILITY_MMXEXT  (1<<5)
 420 #define CPU_CAPABILITY_SSE     (1<<6)
 421 #define CPU_CAPABILITY_ALTIVEC (1<<16)
 422 #define CPU_CAPABILITY_FPU     (1<<31)
 423
 424 /*****************************************************************************
 425  * I18n stuff
 426  *****************************************************************************/
 427 #if defined( ENABLE_NLS ) && defined ( HAVE_GETTEXT )
 428 #   include <libintl.h>
 429 #else
 430 #   define _(String) (String)
 431 #   define N_(String) (String)
 432 #   define textdomain(Domain)
 433 #   define bindtextdomain(Package, Directory) 1
 434 #endif
 435
 436 /*****************************************************************************
 437  * Plug-in stuff
 438  *****************************************************************************/
 439 typedef struct module_symbols_s
 440 {
 441     struct main_s* p_main;
 442     struct aout_bank_s* p_aout_bank;
 443     struct vout_bank_s* p_vout_bank;
 444
 445     int    ( * main_GetIntVariable ) ( char *, int );
 446     char * ( * main_GetPszVariable ) ( char *, char * );
 447     void   ( * main_PutIntVariable ) ( char *, int );
 448     void   ( * main_PutPszVariable ) ( char *, char * );
 449
 450     int  ( * intf_ProcessKey ) ( struct intf_thread_s *, int );
 451     void ( * intf_AssignKey )  ( struct intf_thread_s *, int, int, int );
 452
 453     void ( * intf_Msg )        ( char *, ... );
 454     void ( * intf_ErrMsg )     ( char *, ... );
 455     void ( * intf_StatMsg )    ( char *, ... );
 456     void ( * intf_WarnMsg )    ( int, char *, ... );
 457     void ( * intf_WarnMsgImm ) ( int, char *, ... );
 458 #ifdef TRACE
 459     void ( * intf_DbgMsg )     ( char *, char *, int, char *, ... );
 460     void ( * intf_DbgMsgImm )  ( char *, char *, int, char *, ... );
 461 #endif
 462
 463     int  ( * intf_PlaylistAdd )     ( struct playlist_s *, int, const char* );
 464     int  ( * intf_PlaylistDelete )  ( struct playlist_s *, int );
 465     void ( * intf_PlaylistNext )    ( struct playlist_s * );
 466     void ( * intf_PlaylistPrev )    ( struct playlist_s * );
 467     void ( * intf_PlaylistDestroy ) ( struct playlist_s * );
 468     void ( * intf_PlaylistJumpto )  ( struct playlist_s *, int );
 469     void ( * intf_UrlDecode )       ( char * );
 470
 471     void    ( * msleep )         ( mtime_t );
 472     mtime_t ( * mdate )          ( void );
 473
 474     int  ( * network_ChannelCreate )( void );
 475     int  ( * network_ChannelJoin )  ( int );
 476
 477     int  ( * input_SetProgram )     ( struct input_thread_s *,
 478                                       struct pgrm_descriptor_s * );
 479     void ( * input_SetStatus )      ( struct input_thread_s *, int );
 480     void ( * input_Seek )           ( struct input_thread_s *, off_t );
 481     void ( * input_DumpStream )     ( struct input_thread_s * );
 482     char * ( * input_OffsetToTime ) ( struct input_thread_s *, char *, off_t );
 483     int  ( * input_ChangeES )       ( struct input_thread_s *,
 484                                       struct es_descriptor_s *, u8 );
 485     int  ( * input_ToggleES )       ( struct input_thread_s *,
 486                                       struct es_descriptor_s *, boolean_t );
 487     int  ( * input_ChangeArea )     ( struct input_thread_s *,
 488                                       struct input_area_s * );
 489     struct es_descriptor_s * ( * input_FindES ) ( struct input_thread_s *,
 490                                                   u16 );
 491     struct es_descriptor_s * ( * input_AddES ) ( struct input_thread_s *,
 492                                       struct pgrm_descriptor_s *, u16, size_t );
 493     void ( * input_DelES )          ( struct input_thread_s *,
 494                                       struct es_descriptor_s * );
 495     int  ( * input_SelectES )       ( struct input_thread_s *,
 496                                       struct es_descriptor_s * );
 497     int  ( * input_UnselectES )     ( struct input_thread_s *,
 498                                       struct es_descriptor_s * );
 499     struct pgrm_descriptor_s* ( * input_AddProgram ) ( struct input_thread_s *,
 500                                                        u16, size_t );
 501     void ( * input_DelProgram )     ( struct input_thread_s *,
 502                                       struct pgrm_descriptor_s * );
 503     struct input_area_s * ( * input_AddArea ) ( struct input_thread_s * );
 504     void ( * input_DelArea )        ( struct input_thread_s *,
 505                                       struct input_area_s * );
 506
 507     void ( * InitBitstream )        ( struct bit_stream_s *,
 508                                       struct decoder_fifo_s *,
 509                                       void ( * ) ( struct bit_stream_s *,
 510                                                    boolean_t ),
 511                                       void * );
 512     void ( * DecoderError )         ( struct decoder_fifo_s * p_fifo );
 513     int  ( * input_InitStream )     ( struct input_thread_s *, size_t );
 514     void ( * input_EndStream )      ( struct input_thread_s * );
 515
 516     void ( * input_ParsePES )       ( struct input_thread_s *,
 517                                       struct es_descriptor_s * );
 518     void ( * input_GatherPES )      ( struct input_thread_s *,
 519                                       struct data_packet_s *,
 520                                       struct es_descriptor_s *,
 521                                       boolean_t, boolean_t );
 522     void ( * input_DecodePES )      ( struct decoder_fifo_s *,
 523                                       struct pes_packet_s * );
 524     struct es_descriptor_s * ( * input_ParsePS ) ( struct input_thread_s *,
 525                                                    struct data_packet_s * );
 526     void ( * input_DemuxPS )        ( struct input_thread_s *,
 527                                       struct data_packet_s * );
 528     void ( * input_DemuxTS )        ( struct input_thread_s *,
 529                                       struct data_packet_s * );
 530     void ( * input_DemuxPSI )       ( struct input_thread_s *,
 531                                       struct data_packet_s *,
 532                                       struct es_descriptor_s *,
 533                                       boolean_t, boolean_t );
 534
 535     int ( * input_ClockManageControl )   ( struct input_thread_s *,
 536                                            struct pgrm_descriptor_s *,
 537                                            mtime_t );
 538
 539     struct aout_fifo_s * ( * aout_CreateFifo )
 540                                        ( int, int, long, long, long, void * );
 541     void ( * aout_DestroyFifo )     ( struct aout_fifo_s * );
 542
 543     struct vout_thread_s * (* vout_CreateThread) ( int *, int, int, u32, int );
 544     void  ( * vout_DestroyThread )  ( struct vout_thread_s *, int * );
 545
 546     struct picture_s * ( * vout_CreatePicture )
 547                                     ( struct vout_thread_s *,
 548                                       boolean_t, boolean_t, boolean_t );
 549     void  ( * vout_AllocatePicture )( struct picture_s *, int, int, u32 );
 550     void  ( * vout_DisplayPicture ) ( struct vout_thread_s *,
 551                                       struct picture_s * );
 552     void  ( * vout_DestroyPicture ) ( struct vout_thread_s *,
 553                                       struct picture_s * );
 554     void  ( * vout_LinkPicture )    ( struct vout_thread_s *,
 555                                       struct picture_s * );
 556     void  ( * vout_UnlinkPicture )  ( struct vout_thread_s *,
 557                                       struct picture_s * );
 558     void  ( * vout_DatePicture )    ( struct vout_thread_s *,
 559                                       struct picture_s *, mtime_t );
 560     void  ( * vout_PlacePicture )   ( struct vout_thread_s *, int, int,
 561                                       int *, int *, int *, int * );
 562
 563     struct subpicture_s * (* vout_CreateSubPicture)
 564                                         ( struct vout_thread_s *, int, int );
 565     void  ( * vout_DestroySubPicture )  ( struct vout_thread_s *,
 566                                           struct subpicture_s * );
 567     void  ( * vout_DisplaySubPicture )  ( struct vout_thread_s *,
 568                                           struct subpicture_s * );
 569
 570     u32  ( * UnalignedShowBits )    ( struct bit_stream_s *, unsigned int );
 571     void ( * UnalignedRemoveBits )  ( struct bit_stream_s * );
 572     u32  ( * UnalignedGetBits )     ( struct bit_stream_s *, unsigned int );
 573
 574     char * ( * DecodeLanguage ) ( u16 );
 575
 576     struct module_s * ( * module_Need ) ( int, char *, struct probedata_s * );
 577     void ( * module_Unneed )            ( struct module_s * );
 578 } module_symbols_t;
 579
 580 #ifdef PLUGIN
 581 extern module_symbols_t* p_symbols;
 582 #endif
 583