X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=include%2Fvlc_common.h;h=50997146f37a3612e2c08aef4397c724d63cd567;hb=bfeea8d61f8591f77a75a8c8a7a0c09c8681bda7;hp=ea71aff7fbc789ab81b97b64d32f516f1216c5eb;hpb=c3a40bca867d785bfa9cbd52ac97e993fe141362;p=vlc diff --git a/include/vlc_common.h b/include/vlc_common.h index ea71aff7fb..50997146f3 100644 --- a/include/vlc_common.h +++ b/include/vlc_common.h @@ -3,7 +3,7 @@ * Collection of useful common types and macros definitions ***************************************************************************** * Copyright (C) 1998, 1999, 2000 VideoLAN - * $Id: vlc_common.h,v 1.39 2002/11/20 08:58:20 sam Exp $ + * $Id: vlc_common.h,v 1.88 2003/11/21 15:32:08 fenrir Exp $ * * Authors: Samuel Hocevar * Vincent Seguin @@ -13,7 +13,7 @@ * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. - * + * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the @@ -24,6 +24,11 @@ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. *****************************************************************************/ +/** + * \file + * This file is a collection of common definitions and types + */ + /***************************************************************************** * Required vlc headers *****************************************************************************/ @@ -36,6 +41,8 @@ #if defined( __BORLANDC__ ) # undef HAVE_VARIADIC_MACROS # undef HAVE_STDINT_H +# undef HAVE_INTTYPES_H +# undef off_t #endif #include "vlc_config.h" @@ -44,6 +51,9 @@ /***************************************************************************** * Required system headers *****************************************************************************/ +#include +#include + #ifdef HAVE_STRING_H # include /* strerror() */ #endif @@ -99,7 +109,12 @@ typedef int ptrdiff_t; # endif #endif -#if defined( WIN32 ) || defined( UNDER_CE ) +#if defined( WIN32 ) +# include +#define PATH_MAX MAX_PATH +#endif + +#if (defined( WIN32 ) || defined( UNDER_CE )) && !defined( _SSIZE_T_ ) typedef int ssize_t; #endif @@ -115,21 +130,9 @@ typedef uint8_t yuv_data_t; /* Audio volume */ typedef uint16_t audio_volume_t; -/***************************************************************************** - * Old types definitions - ***************************************************************************** - * We still provide these types because most of the VLC code uses them - * instead of the C9x types. They should be removed when the transition is - * complete (probably in 10 years). - *****************************************************************************/ -typedef uint8_t u8; -typedef int8_t s8; -typedef uint16_t u16; -typedef int16_t s16; -typedef uint32_t u32; -typedef int32_t s32; -typedef uint64_t u64; -typedef int64_t s64; +#ifndef HAVE_SOCKLEN_T +typedef int socklen_t; +#endif /***************************************************************************** * mtime_t: high precision date or time interval @@ -173,8 +176,6 @@ typedef uint32_t vlc_fourcc_t; /* Internal types */ typedef struct libvlc_t libvlc_t; typedef struct vlc_t vlc_t; -typedef struct vlc_list_t vlc_list_t; -typedef struct vlc_object_t vlc_object_t; typedef struct variable_t variable_t; /* Messages */ @@ -184,6 +185,7 @@ typedef struct msg_subscription_t msg_subscription_t; /* Playlist */ typedef struct playlist_t playlist_t; typedef struct playlist_item_t playlist_item_t; +typedef struct playlist_group_t playlist_group_t; /* Modules */ typedef struct module_bank_t module_bank_t; @@ -200,7 +202,7 @@ typedef struct intf_channel_t intf_channel_t; /* Input */ typedef struct input_thread_t input_thread_t; -typedef struct input_channel_t input_channel_t; +typedef struct input_thread_sys_t input_thread_sys_t; typedef struct input_area_t input_area_t; typedef struct input_buffers_t input_buffers_t; typedef struct input_socket_t input_socket_t; @@ -215,32 +217,64 @@ typedef struct pgrm_sys_t pgrm_sys_t; typedef struct stream_descriptor_t stream_descriptor_t; typedef struct stream_sys_t stream_sys_t; +/* Format */ +typedef struct audio_format_t audio_format_t; +typedef struct video_format_t video_format_t; +typedef struct subs_format_t subs_format_t; +typedef struct es_format_t es_format_t; + +/* NInput */ +typedef struct stream_t stream_t; +typedef struct es_out_t es_out_t; +typedef struct es_out_id_t es_out_id_t; +typedef struct es_out_sys_t es_out_sys_t; + + /* Audio */ typedef struct aout_instance_t aout_instance_t; typedef struct aout_sys_t aout_sys_t; typedef struct aout_fifo_t aout_fifo_t; typedef struct aout_input_t aout_input_t; typedef struct aout_buffer_t aout_buffer_t; -typedef struct audio_sample_format_t audio_sample_format_t; +typedef audio_format_t audio_sample_format_t; typedef struct audio_date_t audio_date_t; +typedef struct aout_filter_t aout_filter_t; /* Video */ typedef struct vout_thread_t vout_thread_t; -typedef struct vout_font_t vout_font_t; typedef struct vout_sys_t vout_sys_t; typedef struct chroma_sys_t chroma_sys_t; +typedef video_format_t video_frame_format_t; typedef struct picture_t picture_t; typedef struct picture_sys_t picture_sys_t; typedef struct picture_heap_t picture_heap_t; typedef struct subpicture_t subpicture_t; typedef struct subpicture_sys_t subpicture_sys_t; +typedef struct vout_synchro_t vout_synchro_t; +typedef struct text_renderer_sys_t text_renderer_sys_t; +typedef struct text_style_t text_style_t; /* Stream output */ typedef struct sout_instance_t sout_instance_t; typedef struct sout_fifo_t sout_fifo_t; +typedef struct sout_input_t sout_input_t; +typedef struct sout_packetizer_input_t sout_packetizer_input_t; +typedef struct sout_buffer_t sout_buffer_t; +typedef struct sout_access_out_t sout_access_out_t; +typedef struct sout_mux_t sout_mux_t; +typedef struct sout_stream_t sout_stream_t; +typedef struct sout_cfg_t sout_cfg_t; +/*typedef struct sap_session_t sap_session_t; +typedef struct slp_session_t slp_session_t;*/ /* Decoders */ typedef struct decoder_fifo_t decoder_fifo_t; +typedef struct decoder_t decoder_t; +typedef struct decoder_sys_t decoder_sys_t; + +/* Encoders */ +typedef struct encoder_t encoder_t; +typedef struct encoder_sys_t encoder_sys_t; /* Misc */ typedef struct data_packet_t data_packet_t; @@ -252,6 +286,10 @@ typedef struct bit_stream_t bit_stream_t; typedef struct network_socket_t network_socket_t; typedef struct iso639_lang_t iso639_lang_t; +/* block */ +typedef struct block_t block_t; +typedef struct block_fifo_t block_fifo_t; + /***************************************************************************** * Variable callbacks *****************************************************************************/ @@ -277,6 +315,7 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ #if defined( WIN32 ) || defined( UNDER_CE ) # define WIN32_LEAN_AND_MEAN # include +# define IS_WINNT ( GetVersion() < 0x80000000 ) #endif #include "vlc_threads.h" @@ -287,6 +326,10 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ /* VLC_COMMON_MEMBERS : members common to all basic vlc objects */ #define VLC_COMMON_MEMBERS \ +/** \name VLC_COMMON_MEMBERS \ + * these members are common for all vlc objects \ + */ \ +/**@{*/ \ int i_object_id; \ int i_object_type; \ char *psz_object_type; \ @@ -301,10 +344,10 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ vlc_cond_t object_wait; \ \ /* Object properties */ \ - volatile vlc_bool_t b_error; /* set by the object */ \ - volatile vlc_bool_t b_die; /* set by the outside */ \ - volatile vlc_bool_t b_dead; /* set by the object */ \ - volatile vlc_bool_t b_attached; /* set by the object */ \ + volatile vlc_bool_t b_error; /**< set by the object */ \ + volatile vlc_bool_t b_die; /**< set by the outside */ \ + volatile vlc_bool_t b_dead; /**< set by the object */ \ + volatile vlc_bool_t b_attached; /**< set by the object */ \ \ /* Object variables */ \ vlc_mutex_t var_lock; \ @@ -312,19 +355,20 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ variable_t * p_vars; \ \ /* Stuff related to the libvlc structure */ \ - libvlc_t * p_libvlc; /* root of all evil */ \ - vlc_t * p_vlc; /* (root of all evil) - 1 */ \ + libvlc_t * p_libvlc; /**< root of all evil */ \ + vlc_t * p_vlc; /**< (root of all evil) - 1 */ \ \ - volatile int i_refcount; /* usage count */ \ - vlc_object_t * p_parent; /* our parent */ \ - vlc_object_t ** pp_children; /* our children */ \ + volatile int i_refcount; /**< usage count */ \ + vlc_object_t * p_parent; /**< our parent */ \ + vlc_object_t ** pp_children; /**< our children */ \ volatile int i_children; \ \ /* Private data */ \ void * p_private; \ \ - /* Just a reminder so that people don't cast garbage */ \ + /** Just a reminder so that people don't cast garbage */ \ int be_sure_to_add_VLC_COMMON_MEMBERS_to_struct; \ +/**@}*/ \ /* VLC_OBJECT: attempt at doing a clever cast */ #define VLC_OBJECT( x ) \ @@ -367,9 +411,12 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ { \ (p_ar) = malloc( ((i_oldsize) + 1) * sizeof( *(p_ar) ) ); \ } \ - memmove( (p_ar) + (i_pos) + 1, \ - (p_ar) + (i_pos), \ - ((i_oldsize) - (i_pos)) * sizeof( *(p_ar) ) ); \ + if( (i_oldsize) - (i_pos) ) \ + { \ + memmove( (p_ar) + (i_pos) + 1, \ + (p_ar) + (i_pos), \ + ((i_oldsize) - (i_pos)) * sizeof( *(p_ar) ) ); \ + } \ (p_ar)[i_pos] = elem; \ (i_oldsize)++; \ } \ @@ -378,9 +425,12 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ #define REMOVE_ELEM( p_ar, i_oldsize, i_pos ) \ do \ { \ - memmove( (p_ar) + (i_pos), \ - (p_ar) + (i_pos) + 1, \ - ((i_oldsize) - (i_pos) - 1) * sizeof( *(p_ar) ) ); \ + if( (i_oldsize) - (i_pos) - 1 ) \ + { \ + memmove( (p_ar) + (i_pos), \ + (p_ar) + (i_pos) + 1, \ + ((i_oldsize) - (i_pos) - 1) * sizeof( *(p_ar) ) ); \ + } \ if( i_oldsize > 1 ) \ { \ (p_ar) = realloc( p_ar, ((i_oldsize) - 1) * sizeof( *(p_ar) ) ); \ @@ -395,6 +445,53 @@ typedef int ( * vlc_callback_t ) ( vlc_object_t *, /* variable's object */ while( 0 ) +#define TAB_APPEND( count, tab, p ) \ + if( (count) > 0 ) \ + { \ + (tab) = realloc( (tab), sizeof( void ** ) * ( (count) + 1 ) ); \ + } \ + else \ + { \ + (tab) = malloc( sizeof( void ** ) ); \ + } \ + (void**)(tab)[(count)] = (void*)(p); \ + (count)++ + +#define TAB_FIND( count, tab, p, index ) \ + { \ + int _i_; \ + (index) = -1; \ + for( _i_ = 0; _i_ < (count); _i_++ ) \ + { \ + if((void**)(tab)[_i_]==(void*)(p)) \ + { \ + (index) = _i_; \ + break; \ + } \ + } \ + } + +#define TAB_REMOVE( count, tab, p ) \ + { \ + int _i_index_; \ + TAB_FIND( count, tab, p, _i_index_ ); \ + if( _i_index_ >= 0 ) \ + { \ + if( (count) > 1 ) \ + { \ + memmove( ((void**)(tab) + _i_index_), \ + ((void**)(tab) + _i_index_+1), \ + ( (count) - _i_index_ - 1 ) * sizeof( void* ) );\ + } \ + else \ + { \ + free( tab ); \ + (tab) = NULL; \ + } \ + (count)--; \ + } \ + } + /* MSB (big endian)/LSB (little endian) conversions - network order is always * MSB, and should be used for both network communications and files. Note that * byte orders other than little and big endians are not supported, but only @@ -418,6 +515,32 @@ static inline uint64_t U64_AT( void * _p ) | ((uint64_t)p[4] << 24) | ((uint64_t)p[5] << 16) | ((uint64_t)p[6] << 8) | p[7] ); } + +static inline uint16_t GetWLE( void * _p ) +{ + uint8_t * p = (uint8_t *)_p; + return ( ((uint16_t)p[1] << 8) | p[0] ); +} +static inline uint32_t GetDWLE( void * _p ) +{ + uint8_t * p = (uint8_t *)_p; + return ( ((uint32_t)p[3] << 24) | ((uint32_t)p[2] << 16) + | ((uint32_t)p[1] << 8) | p[0] ); +} +static inline uint64_t GetQWLE( void * _p ) +{ + uint8_t * p = (uint8_t *)_p; + return ( ((uint64_t)p[7] << 56) | ((uint64_t)p[6] << 48) + | ((uint64_t)p[5] << 40) | ((uint64_t)p[4] << 32) + | ((uint64_t)p[3] << 24) | ((uint64_t)p[2] << 16) + | ((uint64_t)p[1] << 8) | p[0] ); +} + +#define GetWBE( p ) U16_AT( p ) +#define GetDWBE( p ) U32_AT( p ) +#define GetQWBE( p ) U64_AT( p ) + + #if WORDS_BIGENDIAN # define hton16(i) ( i ) # define hton32(i) ( i ) @@ -434,6 +557,13 @@ static inline uint64_t U64_AT( void * _p ) # define ntoh64(i) U64_AT(&i) #endif +/* Format string sanity checks */ +#ifdef HAVE_ATTRIBUTE_FORMAT +# define ATTRIBUTE_FORMAT(x,y) __attribute__ ((format(printf,x,y))) +#else +# define ATTRIBUTE_FORMAT(x,y) +#endif + /* Alignment of critical static data structures */ #ifdef ATTRIBUTE_ALIGNED_MAX # define ATTR_ALIGN(align) __attribute__ ((__aligned__ ((ATTRIBUTE_ALIGNED_MAX < align) ? ATTRIBUTE_ALIGNED_MAX : align))) @@ -478,8 +608,14 @@ static inline uint64_t U64_AT( void * _p ) #endif #ifndef HAVE_STRNDUP -# define strndup vlc_strndup - VLC_EXPORT( char *, vlc_strndup, ( const char *s, size_t n ) ); +# if defined(STRNDUP_IN_GNOME_H) && \ + (defined(MODULE_NAME_IS_gnome)||defined(MODULE_NAME_IS_gnome_main)||\ + defined(MODULE_NAME_IS_gnome2)||defined(MODULE_NAME_IS_gnome2_main)) + /* Do nothing: gnome.h defines strndup for us */ +# else +# define strndup vlc_strndup + VLC_EXPORT( char *, vlc_strndup, ( const char *s, size_t n ) ); +# endif #elif !defined(__PLUGIN__) # define vlc_strndup NULL #endif @@ -491,6 +627,13 @@ static inline uint64_t U64_AT( void * _p ) # define vlc_atof NULL #endif +#ifndef HAVE_ATOLL +# define atoll vlc_atoll + VLC_EXPORT( int64_t, vlc_atoll, ( const char *nptr ) ); +#elif !defined(__PLUGIN__) +# define vlc_atoll NULL +#endif + #ifndef HAVE_GETENV # define getenv vlc_getenv VLC_EXPORT( char *, vlc_getenv, ( const char *name ) ); @@ -501,7 +644,9 @@ static inline uint64_t U64_AT( void * _p ) #ifndef HAVE_STRCASECMP # ifdef HAVE_STRICMP # define strcasecmp stricmp -# define vlc_strcasecmp NULL +# if !defined(__PLUGIN__) +# define vlc_strcasecmp NULL +# endif # elif !defined(__PLUGIN__) # define strcasecmp vlc_strcasecmp VLC_EXPORT( int, vlc_strcasecmp, ( const char *s1, const char *s2 ) ); @@ -513,7 +658,9 @@ static inline uint64_t U64_AT( void * _p ) #ifndef HAVE_STRNCASECMP # ifdef HAVE_STRNICMP # define strncasecmp strnicmp -# define vlc_strncasecmp NULL +# if !defined(__PLUGIN__) +# define vlc_strncasecmp NULL +# endif # elif !defined(__PLUGIN__) # define strncasecmp vlc_strncasecmp VLC_EXPORT( int, vlc_strncasecmp, ( const char *s1, const char *s2, size_t n ) ); @@ -540,7 +687,7 @@ static inline uint64_t U64_AT( void * _p ) #endif /* defined(WIN32)||defined(UNDER_CE) */ /* 64 bits integer constant suffix */ -#if !defined(WIN32) && !defined(UNDER_CE) +#if defined( __MINGW32__ ) || (!defined(WIN32) && !defined(UNDER_CE)) # define I64C(x) x##LL #else # define I64C(x) x##i64 @@ -565,6 +712,9 @@ typedef long long _off_t; typedef _off_t off_t; # define _OFF_T_ # else +# ifdef off_t +# undef off_t +# endif # define off_t long long # endif # endif @@ -585,6 +735,10 @@ typedef __int64 off_t; # ifndef O_NONBLOCK # define O_NONBLOCK 0 +# endif + +# ifndef alloca +# define alloca _alloca # endif /* These two are not defined in mingw32 (bug?) */ @@ -605,6 +759,10 @@ typedef __int64 off_t; # define vlc_lseek NULL #endif +/* vlc_wraptext (defined in src/extras/libc.c) */ +#define wraptext vlc_wraptext +VLC_EXPORT( char *, vlc_wraptext, ( const char *, int, vlc_bool_t ) ); + /***************************************************************************** * CPU capabilities *****************************************************************************/ @@ -622,19 +780,28 @@ typedef __int64 off_t; /***************************************************************************** * I18n stuff *****************************************************************************/ -#if defined( ENABLE_NLS ) \ - && ( defined(HAVE_GETTEXT) || defined(HAVE_INCLUDED_GETTEXT) ) +VLC_EXPORT( char *, vlc_dgettext, ( const char *package, const char *msgid ) ); + +#if defined( ENABLE_NLS ) && \ + (defined(MODULE_NAME_IS_gnome)||defined(MODULE_NAME_IS_gnome_main)||\ + defined(MODULE_NAME_IS_gnome2)||defined(MODULE_NAME_IS_gnome2_main)) + /* Declare nothing: gnome.h will do it for us */ +#elif defined( ENABLE_NLS ) +#if defined( HAVE_INCLUDED_GETTEXT ) +# include "libintl.h" +#else # include +#endif # undef _ -# define _(String) dgettext (PACKAGE, String) -# ifdef gettext_noop -# define N_(String) gettext_noop (String) -# else -# define N_(String) (String) -# endif -#elif !defined( NEED_GNOMESUPPORT_H ) -# define _(String) (String) -# define N_(String) (String) +#if defined( __BORLANDC__ ) +#define _(String) vlc_dgettext (PACKAGE_TARNAME, String) +#else +# define _(String) vlc_dgettext (PACKAGE, String) +#endif +# define N_(String) ((char*)(String)) +#else +# define _(String) ((char*)(String)) +# define N_(String) ((char*)(String)) #endif /*****************************************************************************