1 /*****************************************************************************
2 * vlc_common.h: common definitions
3 * Collection of useful common types and macros definitions
4 *****************************************************************************
5 * Copyright (C) 1998-2011 VLC authors and VideoLAN
7 * Authors: Samuel Hocevar <sam@via.ecp.fr>
8 * Vincent Seguin <seguin@via.ecp.fr>
9 * Gildas Bazin <gbazin@videolan.org>
10 * RĂ©mi Denis-Courmont
12 * This program is free software; you can redistribute it and/or modify it
13 * under the terms of the GNU Lesser General Public License as published by
14 * the Free Software Foundation; either version 2.1 of the License, or
15 * (at your option) any later version.
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 Lesser General Public License for more details.
22 * You should have received a copy of the GNU Lesser General Public License
23 * along with this program; if not, write to the Free Software Foundation,
24 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25 *****************************************************************************/
29 * This file is a collection of common definitions and types
33 # define VLC_COMMON_H 1
35 /*****************************************************************************
36 * Required vlc headers
37 *****************************************************************************/
38 #include "vlc_config.h"
40 /*****************************************************************************
41 * Required system headers
42 *****************************************************************************/
55 /*****************************************************************************
56 * Compilers definitions
57 *****************************************************************************/
58 /* Helper for GCC version checks */
60 # define VLC_GCC_VERSION(maj,min) \
61 ((__GNUC__ > (maj)) || (__GNUC__ == (maj) && __GNUC_MINOR__ >= (min)))
63 # define VLC_GCC_VERSION(maj,min) (0)
66 /* Try to fix format strings for all versions of mingw and mingw64 */
67 #if defined( _WIN32 ) && defined( __USE_MINGW_ANSI_STDIO )
78 #define snprintf __mingw_snprintf
79 #define vsnprintf __mingw_vsnprintf
82 /* Function attributes for compiler warnings */
84 # define VLC_DEPRECATED __attribute__((deprecated))
86 # if defined( _WIN32 ) && VLC_GCC_VERSION(4,4)
87 # define VLC_FORMAT(x,y) __attribute__ ((format(gnu_printf,x,y)))
89 # define VLC_FORMAT(x,y) __attribute__ ((format(printf,x,y)))
91 # define VLC_FORMAT_ARG(x) __attribute__ ((format_arg(x)))
93 # define VLC_MALLOC __attribute__ ((malloc))
94 # define VLC_NORETURN __attribute__ ((noreturn))
96 # if VLC_GCC_VERSION(3,4)
97 # define VLC_USED __attribute__ ((warn_unused_result))
103 # define VLC_DEPRECATED
104 # define VLC_FORMAT(x,y)
105 # define VLC_FORMAT_ARG(x)
107 # define VLC_NORETURN
112 /* Branch prediction */
114 # define likely(p) __builtin_expect(!!(p), 1)
115 # define unlikely(p) __builtin_expect(!!(p), 0)
117 # define likely(p) (!!(p))
118 # define unlikely(p) (!!(p))
123 # define VLC_EXTERN extern "C"
128 #if defined (WIN32) && defined (DLL_EXPORT)
129 # define VLC_EXPORT __declspec(dllexport)
130 #elif VLC_GCC_VERSION(4,0)
131 # define VLC_EXPORT __attribute__((visibility("default")))
136 #define VLC_API VLC_EXTERN VLC_EXPORT
139 /*****************************************************************************
140 * Basic types definitions
141 *****************************************************************************/
143 * High precision date or time interval
145 * Store a high precision date or time interval. The maximum precision is the
146 * microsecond, and a 64 bits integer is used to avoid overflows (maximum
147 * time interval is then 292271 years, which should be long enough for any
148 * video). Dates are stored as microseconds since a common date (usually the
149 * epoch). Note that date and time intervals can be manipulated using regular
150 * arithmetic operators, and that no special functions are required.
152 typedef int64_t mtime_t;
155 * The vlc_fourcc_t type.
157 * See http://www.webartz.com/fourcc/ for a very detailed list.
159 typedef uint32_t vlc_fourcc_t;
161 #ifdef WORDS_BIGENDIAN
162 # define VLC_FOURCC( a, b, c, d ) \
163 ( ((uint32_t)d) | ( ((uint32_t)c) << 8 ) \
164 | ( ((uint32_t)b) << 16 ) | ( ((uint32_t)a) << 24 ) )
165 # define VLC_TWOCC( a, b ) \
166 ( (uint16_t)(b) | ( (uint16_t)(a) << 8 ) )
169 # define VLC_FOURCC( a, b, c, d ) \
170 ( ((uint32_t)a) | ( ((uint32_t)b) << 8 ) \
171 | ( ((uint32_t)c) << 16 ) | ( ((uint32_t)d) << 24 ) )
172 # define VLC_TWOCC( a, b ) \
173 ( (uint16_t)(a) | ( (uint16_t)(b) << 8 ) )
178 * Translate a vlc_fourcc into its string representation. This function
179 * assumes there is enough room in psz_fourcc to store 4 characters in.
181 * \param fcc a vlc_fourcc_t
182 * \param psz_fourcc string to store string representation of vlc_fourcc in
184 static inline void vlc_fourcc_to_char( vlc_fourcc_t fcc, char *psz_fourcc )
186 memcpy( psz_fourcc, &fcc, 4 );
189 #define vlc_fourcc_to_char( a, b ) \
190 vlc_fourcc_to_char( (vlc_fourcc_t)(a), (char *)(b) )
192 /*****************************************************************************
193 * Classes declaration
194 *****************************************************************************/
197 typedef struct vlc_list_t vlc_list_t;
198 typedef struct vlc_object_t vlc_object_t;
199 typedef struct libvlc_int_t libvlc_int_t;
200 typedef struct date_t date_t;
209 PLAYLIST_PLAY, /**< No arg. res=can fail*/
210 PLAYLIST_VIEWPLAY, /**< arg1= playlist_item_t*,*/
211 /** arg2 = playlist_item_t* , res=can fail */
212 PLAYLIST_PAUSE, /**< No arg res=can fail*/
213 PLAYLIST_STOP, /**< No arg res=can fail*/
214 PLAYLIST_SKIP, /**< arg1=int, res=can fail*/
215 } playlist_command_t;
218 typedef struct playlist_t playlist_t;
219 typedef struct playlist_item_t playlist_item_t;
220 typedef struct playlist_view_t playlist_view_t;
221 typedef struct services_discovery_t services_discovery_t;
222 typedef struct services_discovery_sys_t services_discovery_sys_t;
223 typedef struct playlist_add_t playlist_add_t;
226 typedef struct module_t module_t;
227 typedef struct module_config_t module_config_t;
229 typedef struct config_category_t config_category_t;
232 typedef struct input_thread_t input_thread_t;
233 typedef struct input_item_t input_item_t;
234 typedef struct input_item_node_t input_item_node_t;
235 typedef struct access_t access_t;
236 typedef struct access_sys_t access_sys_t;
237 typedef struct stream_t stream_t;
238 typedef struct stream_sys_t stream_sys_t;
239 typedef struct demux_t demux_t;
240 typedef struct demux_sys_t demux_sys_t;
241 typedef struct es_out_t es_out_t;
242 typedef struct es_out_id_t es_out_id_t;
243 typedef struct es_out_sys_t es_out_sys_t;
244 typedef struct seekpoint_t seekpoint_t;
245 typedef struct info_t info_t;
246 typedef struct info_category_t info_category_t;
247 typedef struct input_attachment_t input_attachment_t;
250 typedef struct audio_format_t audio_format_t;
251 typedef struct video_format_t video_format_t;
252 typedef struct subs_format_t subs_format_t;
253 typedef struct es_format_t es_format_t;
254 typedef struct video_palette_t video_palette_t;
257 typedef struct audio_output audio_output_t;
258 typedef struct aout_sys_t aout_sys_t;
259 typedef struct aout_fifo_t aout_fifo_t;
260 typedef struct aout_input_t aout_input_t;
261 typedef audio_format_t audio_sample_format_t;
264 typedef struct vout_thread_t vout_thread_t;
266 typedef video_format_t video_frame_format_t;
267 typedef struct picture_t picture_t;
268 typedef struct picture_sys_t picture_sys_t;
271 typedef struct spu_t spu_t;
272 typedef struct subpicture_t subpicture_t;
273 typedef struct subpicture_sys_t subpicture_sys_t;
274 typedef struct subpicture_region_t subpicture_region_t;
276 typedef struct image_handler_t image_handler_t;
279 typedef struct sout_instance_t sout_instance_t;
280 typedef struct sout_instance_sys_t sout_instance_sys_t;
282 typedef struct sout_input_t sout_input_t;
283 typedef struct sout_packetizer_input_t sout_packetizer_input_t;
285 typedef struct sout_access_out_t sout_access_out_t;
286 typedef struct sout_access_out_sys_t sout_access_out_sys_t;
288 typedef struct sout_mux_t sout_mux_t;
289 typedef struct sout_mux_sys_t sout_mux_sys_t;
291 typedef struct sout_stream_t sout_stream_t;
292 typedef struct sout_stream_sys_t sout_stream_sys_t;
294 typedef struct config_chain_t config_chain_t;
295 typedef struct session_descriptor_t session_descriptor_t;
298 typedef struct decoder_t decoder_t;
299 typedef struct decoder_sys_t decoder_sys_t;
300 typedef struct decoder_synchro_t decoder_synchro_t;
303 typedef struct encoder_t encoder_t;
304 typedef struct encoder_sys_t encoder_sys_t;
307 typedef struct filter_t filter_t;
308 typedef struct filter_sys_t filter_sys_t;
311 typedef struct virtual_socket_t v_socket_t;
312 typedef struct vlc_url_t vlc_url_t;
315 typedef struct iso639_lang_t iso639_lang_t;
318 typedef struct block_t block_t;
319 typedef struct block_fifo_t block_fifo_t;
322 typedef struct md5_s md5_t;
325 typedef struct xml_t xml_t;
326 typedef struct xml_sys_t xml_sys_t;
327 typedef struct xml_reader_t xml_reader_t;
328 typedef struct xml_reader_sys_t xml_reader_sys_t;
331 typedef struct vod_t vod_t;
332 typedef struct vod_sys_t vod_sys_t;
333 typedef struct vod_media_t vod_media_t;
336 typedef struct osd_menu_t osd_menu_t;
337 typedef struct osd_state_t osd_state_t;
338 typedef struct osd_event_t osd_event_t;
339 typedef struct osd_button_t osd_button_t;
340 typedef struct osd_menu_state_t osd_menu_state_t;
343 typedef struct vlm_t vlm_t;
344 typedef struct vlm_message_t vlm_message_t;
347 typedef struct vlc_meta_t vlc_meta_t;
348 typedef struct input_stats_t input_stats_t;
351 typedef struct update_t update_t;
352 typedef struct update_iterator_t update_iterator_t;
355 typedef struct meta_engine_t meta_engine_t;
358 * VLC value structure
367 vlc_object_t * p_object;
370 struct { int32_t x; int32_t y; } coords;
380 vlc_value_t * p_values;
385 /*****************************************************************************
386 * Error values (shouldn't be exposed)
387 *****************************************************************************/
388 #define VLC_SUCCESS (-0) /**< No error */
389 #define VLC_EGENERIC (-1) /**< Unspecified error */
390 #define VLC_ENOMEM (-2) /**< Not enough memory */
391 #define VLC_ETIMEOUT (-3) /**< Timeout */
392 #define VLC_ENOMOD (-4) /**< Module not found */
393 #define VLC_ENOOBJ (-5) /**< Object not found */
394 #define VLC_ENOVAR (-6) /**< Variable not found */
395 #define VLC_EBADVAR (-7) /**< Bad variable value */
396 #define VLC_ENOITEM (-8) /**< Item not found */
398 /*****************************************************************************
400 *****************************************************************************/
401 typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */
402 char const *, /* variable name */
403 vlc_value_t, /* old value */
404 vlc_value_t, /* new value */
405 void * ); /* callback data */
407 /*****************************************************************************
408 * OS-specific headers and thread types
409 *****************************************************************************/
413 # define PATH_MAX MAX_PATH
415 # include <windows.h>
419 #include <sys/syslimits.h>
423 # define OS2EMX_PLAIN_CHAR
429 #include "vlc_mtime.h"
430 #include "vlc_threads.h"
432 /*****************************************************************************
433 * Common structure members
434 *****************************************************************************/
436 /* VLC_COMMON_MEMBERS : members common to all basic vlc objects */
437 #define VLC_COMMON_MEMBERS \
438 /** \name VLC_COMMON_MEMBERS \
439 * these members are common for all vlc objects \
442 const char *psz_object_type; \
444 /* Messages header */ \
448 /* Object properties */ \
449 bool b_force; /**< set by the outside (eg. module_need()) */ \
451 /* Stuff related to the libvlc structure */ \
452 libvlc_int_t *p_libvlc; /**< (root of all evil) - 1 */ \
454 vlc_object_t * p_parent; /**< our parent */ \
458 /* VLC_OBJECT: attempt at doing a clever cast */
459 #if VLC_GCC_VERSION(4,0)
461 # define VLC_OBJECT( x ) \
462 __builtin_choose_expr( \
463 __builtin_offsetof(__typeof__(*(x)), psz_object_type), \
464 (void)0 /* screw you */, \
467 # define VLC_OBJECT( x ) \
468 ((vlc_object_t *)(x) \
469 + 0 * __builtin_offsetof(__typeof__(*(x)), psz_object_type))
472 # define VLC_OBJECT( x ) ((vlc_object_t *)(x))
475 /*****************************************************************************
476 * Macros and inline functions
477 *****************************************************************************/
479 /* CEIL: division with round to nearest greater integer */
480 #define CEIL(n, d) ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
482 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
483 #define PAD(n, d) ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
485 /* __MAX and __MIN: self explanatory */
487 # define __MAX(a, b) ( ((a) > (b)) ? (a) : (b) )
490 # define __MIN(a, b) ( ((a) < (b)) ? (a) : (b) )
493 /* clip v in [min, max] */
494 #define VLC_CLIP(v, min, max) __MIN(__MAX((v), (min)), (max))
497 static inline int64_t GCD ( int64_t a, int64_t b )
508 /* function imported from libavutil/common.h */
510 static inline uint8_t clip_uint8_vlc( int32_t a )
512 if( a&(~255) ) return (-a)>>31;
516 /** Count leading zeroes */
518 static inline unsigned clz (unsigned x)
520 #if VLC_GCC_VERSION(3,4)
521 return __builtin_clz (x);
523 unsigned i = sizeof (x) * 8;
534 #define clz8( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint8_t)) * 8))
535 #define clz16( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint16_t)) * 8))
536 /* XXX: this assumes that int is 32-bits or more */
537 #define clz32( x ) (clz(x) - ((sizeof(unsigned) - sizeof (uint32_t)) * 8))
541 static inline unsigned popcount (unsigned x)
543 #if VLC_GCC_VERSION(3,4)
544 return __builtin_popcount (x);
557 static inline unsigned parity (unsigned x)
559 #if VLC_GCC_VERSION(3,4)
560 return __builtin_parity (x);
562 for (unsigned i = 4 * sizeof (x); i > 0; i /= 2)
574 /** Byte swap (16 bits) */
576 static inline uint16_t bswap16 (uint16_t x)
578 return (x << 8) | (x >> 8);
581 /** Byte swap (32 bits) */
583 static inline uint32_t bswap32 (uint32_t x)
585 #if VLC_GCC_VERSION(4,3) || defined(__clang__)
586 return __builtin_bswap32 (x);
588 return ((x & 0x000000FF) << 24)
589 | ((x & 0x0000FF00) << 8)
590 | ((x & 0x00FF0000) >> 8)
591 | ((x & 0xFF000000) >> 24);
595 /** Byte swap (64 bits) */
597 static inline uint64_t bswap64 (uint64_t x)
599 #if VLC_GCC_VERSION(4,3) || defined(__clang__)
600 return __builtin_bswap64 (x);
601 #elif !defined (__cplusplus)
602 return ((x & 0x00000000000000FF) << 56)
603 | ((x & 0x000000000000FF00) << 40)
604 | ((x & 0x0000000000FF0000) << 24)
605 | ((x & 0x00000000FF000000) << 8)
606 | ((x & 0x000000FF00000000) >> 8)
607 | ((x & 0x0000FF0000000000) >> 24)
608 | ((x & 0x00FF000000000000) >> 40)
609 | ((x & 0xFF00000000000000) >> 56);
611 return ((x & 0x00000000000000FFLLU) << 56)
612 | ((x & 0x000000000000FF00LLU) << 40)
613 | ((x & 0x0000000000FF0000LLU) << 24)
614 | ((x & 0x00000000FF000000LLU) << 8)
615 | ((x & 0x000000FF00000000LLU) >> 8)
616 | ((x & 0x0000FF0000000000LLU) >> 24)
617 | ((x & 0x00FF000000000000LLU) >> 40)
618 | ((x & 0xFF00000000000000LLU) >> 56);
623 /* Free and set set the variable to NULL */
624 #define FREENULL(a) do { free( a ); a = NULL; } while(0)
626 #define EMPTY_STR(str) (!str || !*str)
628 VLC_API char const * vlc_error( int ) VLC_USED;
630 #include <vlc_arrays.h>
632 /* MSB (big endian)/LSB (little endian) conversions - network order is always
633 * MSB, and should be used for both network communications and files. */
635 #ifdef WORDS_BIGENDIAN
636 # define hton16(i) ((uint16_t)(i))
637 # define hton32(i) ((uint32_t)(i))
638 # define hton64(i) ((uint64_t)(i))
640 # define hton16(i) bswap16(i)
641 # define hton32(i) bswap32(i)
642 # define hton64(i) bswap64(i)
644 #define ntoh16(i) hton16(i)
645 #define ntoh32(i) hton32(i)
646 #define ntoh64(i) hton64(i)
648 /** Reads 16 bits in network byte order */
650 static inline uint16_t U16_AT (const void *p)
654 memcpy (&x, p, sizeof (x));
658 /** Reads 32 bits in network byte order */
660 static inline uint32_t U32_AT (const void *p)
664 memcpy (&x, p, sizeof (x));
668 /** Reads 64 bits in network byte order */
670 static inline uint64_t U64_AT (const void *p)
674 memcpy (&x, p, sizeof (x));
678 #define GetWBE(p) U16_AT(p)
679 #define GetDWBE(p) U32_AT(p)
680 #define GetQWBE(p) U64_AT(p)
682 /** Reads 16 bits in little-endian order */
684 static inline uint16_t GetWLE (const void *p)
688 memcpy (&x, p, sizeof (x));
689 #ifdef WORDS_BIGENDIAN
695 /** Reads 32 bits in little-endian order */
697 static inline uint32_t GetDWLE (const void *p)
701 memcpy (&x, p, sizeof (x));
702 #ifdef WORDS_BIGENDIAN
708 /** Reads 64 bits in little-endian order */
710 static inline uint64_t GetQWLE (const void *p)
714 memcpy (&x, p, sizeof (x));
715 #ifdef WORDS_BIGENDIAN
721 /** Writes 16 bits in network byte order */
722 static inline void SetWBE (void *p, uint16_t w)
725 memcpy (p, &w, sizeof (w));
728 /** Writes 32 bits in network byte order */
729 static inline void SetDWBE (void *p, uint32_t dw)
732 memcpy (p, &dw, sizeof (dw));
735 /** Writes 64 bits in network byte order */
736 static inline void SetQWBE (void *p, uint64_t qw)
739 memcpy (p, &qw, sizeof (qw));
742 /** Writes 16 bits in little endian order */
743 static inline void SetWLE (void *p, uint16_t w)
745 #ifdef WORDS_BIGENDIAN
748 memcpy (p, &w, sizeof (w));
751 /** Writes 32 bits in little endian order */
752 static inline void SetDWLE (void *p, uint32_t dw)
754 #ifdef WORDS_BIGENDIAN
757 memcpy (p, &dw, sizeof (dw));
760 /** Writes 64 bits in little endian order */
761 static inline void SetQWLE (void *p, uint64_t qw)
763 #ifdef WORDS_BIGENDIAN
766 memcpy (p, &qw, sizeof (qw));
770 #define VLC_UNUSED(x) (void)(x)
772 /* Stuff defined in src/extras/libc.c */
775 /* several type definitions */
776 # if defined( __MINGW32__ )
777 # if !defined( _OFF_T_ )
778 typedef long long _off_t;
779 typedef _off_t off_t;
785 # define off_t long long
790 # define O_NONBLOCK 0
796 VLC_API bool vlc_ureduce( unsigned *, unsigned *, uint64_t, uint64_t, uint64_t );
798 /* Aligned memory allocator */
800 #include <AvailabilityMacros.h>
804 # define vlc_memalign(align, size) (__mingw_aligned_malloc(size, align))
805 # define vlc_free(base) (__mingw_aligned_free(base))
806 #elif defined(__APPLE__) && !defined(MAC_OS_X_VERSION_10_6)
807 static inline void *vlc_memalign(size_t align, size_t size)
812 ptr = malloc(size+align);
815 diff = ((-(long)ptr - 1)&(align-1)) + 1;
816 ptr = (char*)ptr + diff;
817 ((char*)ptr)[-1]= diff;
821 static void vlc_free(void *ptr)
824 free((char*)ptr - ((char*)ptr)[-1]);
827 static inline void *vlc_memalign(size_t align, size_t size)
830 if (unlikely(posix_memalign(&base, align, size)))
834 # define vlc_free(base) free(base)
837 VLC_API void vlc_tdestroy( void *, void (*)(void *) );
839 /*****************************************************************************
841 *****************************************************************************/
842 VLC_API char *vlc_gettext( const char *msgid ) VLC_FORMAT_ARG(1);
843 VLC_API char *vlc_ngettext( const char *s, const char *p, unsigned long n ) VLC_FORMAT_ARG(1) VLC_FORMAT_ARG(2);
845 #define vlc_pgettext( ctx, id ) \
846 vlc_pgettext_aux( ctx "\004" id, id )
849 static inline const char *vlc_pgettext_aux( const char *ctx, const char *id )
851 const char *tr = vlc_gettext( ctx );
852 return (tr == ctx) ? id : tr;
855 /*****************************************************************************
856 * Loosy memory allocation functions. Do not use in new code.
857 *****************************************************************************/
858 static inline void *xmalloc (size_t len)
860 void *ptr = malloc (len);
861 if (unlikely (ptr == NULL))
866 static inline void *xrealloc (void *ptr, size_t len)
868 void *nptr = realloc (ptr, len);
869 if (unlikely (nptr == NULL))
874 static inline void *xcalloc (size_t n, size_t size)
876 void *ptr = calloc (n, size);
877 if (unlikely (ptr == NULL))
882 static inline char *xstrdup (const char *str)
884 char *ptr = strdup (str);
885 if (unlikely(ptr == NULL))
890 /*****************************************************************************
892 *****************************************************************************/
893 VLC_API const char * VLC_CompileBy( void ) VLC_USED;
894 VLC_API const char * VLC_CompileHost( void ) VLC_USED;
895 VLC_API const char * VLC_Compiler( void ) VLC_USED;
897 /*****************************************************************************
898 * Additional vlc stuff
899 *****************************************************************************/
900 #include "vlc_messages.h"
901 #include "vlc_objects.h"
902 #include "vlc_variables.h"
903 #include "vlc_main.h"
904 #include "vlc_configuration.h"
906 #if defined( WIN32 ) || defined( __SYMBIAN32__ ) || defined( __OS2__ )
907 # define DIR_SEP_CHAR '\\'
908 # define DIR_SEP "\\"
909 # define PATH_SEP_CHAR ';'
910 # define PATH_SEP ";"
912 # define DIR_SEP_CHAR '/'
914 # define PATH_SEP_CHAR ':'
915 # define PATH_SEP ":"
918 #define LICENSE_MSG \
919 _("This program comes with NO WARRANTY, to the extent permitted by " \
920 "law.\nYou may redistribute it under the terms of the GNU General " \
921 "Public License;\nsee the file named COPYING for details.\n" \
922 "Written by the VideoLAN team; see the AUTHORS file.\n")
924 #endif /* !VLC_COMMON_H */