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.21 2001/01/06 07:23:32 sam Exp $
   7  *
   8  * Authors: Samuel Hocevar <sam@via.ecp.fr>
   9  *          Vincent Seguin <seguin@via.ecp.fr>
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with this program; if not, write to the Free Software
  23  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  24  *****************************************************************************/
  25
  26 /*****************************************************************************
  27  * required headers:
  28  *  config.h
  29  *****************************************************************************/
  30
  31 /*****************************************************************************
  32  * Basic types definitions
  33  *****************************************************************************/
  34
  35 #include "int_types.h"
  36
  37 typedef u8                  byte_t;
  38
  39 /* Boolean type */
  40 #ifdef BOOLEAN_T_IN_SYS_TYPES_H
  41 #   include <sys/types.h>
  42 #else
  43 typedef int                 boolean_t;
  44 #endif
  45 #ifdef SYS_GNU
  46 #   define _MACH_I386_BOOLEAN_H_
  47 #endif
  48
  49 /* ptrdiff_t definition */
  50 #ifdef HAVE_STDDEF_H
  51 #   include <stddef.h>
  52 #else
  53 #   include <malloc.h>
  54 #   ifndef _PTRDIFF_T
  55 #       define _PTRDIFF_T
  56 /* Not portable in a 64-bit environment. */
  57 typedef int                 ptrdiff_t;
  58 #   endif
  59 #endif
  60
  61 /* Counter for statistics and profiling */
  62 typedef unsigned long       count_t;
  63
  64 /*****************************************************************************
  65  * Classes declaration
  66  *****************************************************************************/
  67
  68 /* Plugins */
  69 struct plugin_bank_s;
  70 struct plugin_info_s;
  71
  72 typedef struct plugin_bank_s *          p_plugin_bank_t;
  73 typedef struct plugin_info_s *          p_plugin_info_t;
  74
  75 /* Playlist */
  76 struct playlist_s;
  77
  78 typedef struct playlist_s *             p_playlist_t;
  79
  80 /* Interface */
  81 struct intf_thread_s;
  82 struct intf_sys_s;
  83 struct intf_console_s;
  84 struct intf_msg_s;
  85 struct intf_channel_s;
  86
  87 typedef struct intf_thread_s *          p_intf_thread_t;
  88 typedef struct intf_sys_s *             p_intf_sys_t;
  89 typedef struct intf_console_s *         p_intf_console_t;
  90 typedef struct intf_msg_s *             p_intf_msg_t;
  91 typedef struct intf_channel_s *         p_intf_channel_t;
  92
  93 /* Input */
  94 struct input_thread_s;
  95 struct input_vlan_s;
  96 struct input_cfg_s;
  97
  98 typedef struct input_thread_s *         p_input_thread_t;
  99 typedef struct input_vlan_s *           p_input_vlan_t;
 100 typedef struct input_cfg_s *            p_input_cfg_t;
 101
 102 /* Audio */
 103 struct aout_thread_s;
 104 struct aout_sys_s;
 105
 106 typedef struct aout_thread_s *          p_aout_thread_t;
 107 typedef struct aout_sys_s *             p_aout_sys_t;
 108
 109 /* Video */
 110 struct vout_thread_s;
 111 struct vout_font_s;
 112 struct vout_sys_s;
 113 struct vdec_thread_s;
 114 struct vpar_thread_s;
 115 struct video_parser_s;
 116
 117 typedef struct vout_thread_s *          p_vout_thread_t;
 118 typedef struct vout_font_s *            p_vout_font_t;
 119 typedef struct vout_sys_s *             p_vout_sys_t;
 120 typedef struct vdec_thread_s *          p_vdec_thread_t;
 121 typedef struct vpar_thread_s *          p_vpar_thread_t;
 122 typedef struct video_parser_s *         p_video_parser_t;
 123
 124 /*****************************************************************************
 125  * Macros and inline functions
 126  *****************************************************************************/
 127
 128 #ifdef NTOHL_IN_SYS_PARAM_H
 129 #   include <sys/param.h>
 130 #else
 131 #   include <netinet/in.h>
 132 #endif
 133
 134 /* CEIL: division with round to nearest greater integer */
 135 #define CEIL(n, d)  ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
 136
 137 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
 138 #define PAD(n, d)   ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
 139
 140 /* MAX and MIN: self explanatory */
 141 #ifndef MAX
 142 #define MAX(a, b)   ( ((a) > (b)) ? (a) : (b) )
 143 #endif
 144 #ifndef MIN
 145 #define MIN(a, b)   ( ((a) < (b)) ? (a) : (b) )
 146 #endif
 147
 148 /* MSB (big endian)/LSB (little endian) conversions - network order is always
 149  * MSB, and should be used for both network communications and files. Note that
 150  * byte orders other than little and big endians are not supported, but only
 151  * the VAX seems to have such exotic properties - note that these 'functions'
 152  * needs <netinet/in.h> or the local equivalent. */
 153 /* FIXME??: hton64 should be declared as an extern inline function to avoid border
 154  * effects (see byteorder.h) */
 155 #if __BYTE_ORDER == __LITTLE_ENDIAN
 156 #define hton16      htons
 157 #define hton32      htonl
 158 #define hton64(i)   ( ((u64)(htonl((i) & 0xffffffff)) << 32) | htonl(((i) >> 32) & 0xffffffff ) )
 159 #define ntoh16      ntohs
 160 #define ntoh32      ntohl
 161 #define ntoh64      hton64
 162 #elif __BYTE_ORDER == __BIG_ENDIAN
 163 #define hton16      htons
 164 #define hton32      htonl
 165 #define hton64(i)   ( i )
 166 #define ntoh16      ntohs
 167 #define ntoh32      ntohl
 168 #define ntoh64(i)   ( i )
 169 #else
 170 /* XXX??: cause a compilation error */
 171 #endif
 172
 173 /* Macros with automatic casts */
 174 #define U32_AT(p)   ( ntohl ( *( (u32 *)(p) ) ) )
 175 #define U16_AT(p)   ( ntohs ( *( (u16 *)(p) ) ) )