common/utils.h

   1 /*****************************************************************************
   2  * utils.h
   3  *****************************************************************************
   4  * Copyright (C) 2010-2014 L-SMASH project
   5  *
   6  * Authors: Yusuke Nakamura <muken.the.vfrmaniac@gmail.com>
   7  *
   8  * Permission to use, copy, modify, and/or distribute this software for any
   9  * purpose with or without fee is hereby granted, provided that the above
  10  * copyright notice and this permission notice appear in all copies.
  11  *
  12  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  13  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  14  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  15  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  16  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  17  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  18  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19  *****************************************************************************/
  20
  21 /* This file is available under an ISC license. */
  22
  23 #ifndef LSMASH_UTIL_H
  24 #define LSMASH_UTIL_H
  25
  26 #define debug_if(x) if(x)
  27
  28 #define LSMASH_MAX( a, b ) ((a) > (b) ? (a) : (b))
  29 #define LSMASH_MIN( a, b ) ((a) < (b) ? (a) : (b))
  30
  31 /* default arguments
  32  * Use only CALL_FUNC_DEFAULT_ARGS().
  33  * The defined macros can't be passed a macro argument requiring the empty parameter list.
  34  *
  35  * The following is an example.
  36  *   #define TEMPLATE_A( ... ) CALL_FUNC_DEFAULT_ARGS( TEMPLATE_A, __VA_ARGS__ )
  37  *   #define TEMPLATE_A_1( _1 )     _1( 1 )
  38  *   #define TEMPLATE_B( ... ) CALL_FUNC_DEFAULT_ARGS( TEMPLATE_B, __VA_ARGS__ )
  39  *   #define TEMPLATE_B_2( _1, _2 ) ((_1) + (_2))
  40  *   #define TEMPLATE_B_1( _1 )     TEMPLATE_B_2( _1, 0 )
  41  *   #define TEMPLATE_B_0()
  42  *   int main( void )
  43  *   {
  44  *      TEMPLATE_A( TEMPLATE_B_1 ); // OK
  45  *      TEMPLATE_A( TEMPLATE_B );   // NG
  46  *      TEMPLATE_B( 1, 2 );         // OK
  47  *      TEMPLATE_B();               // NG
  48  *      return 0;
  49  *   }
  50  * */
  51 #define NUM_ARGS( _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, ... ) _10
  52 #define COUNT_NUM_ARGS( ... ) NUM_ARGS( __VA_ARGS__, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0, 0 )
  53 #define GET_FUNC_BY_NUM_ARGS_EXN( func_name, N )   func_name ## _ ## N
  54 #define GET_FUNC_BY_NUM_ARGS_EX0( func_name, N )   GET_FUNC_BY_NUM_ARGS_EXN( func_name, N )
  55 #define GET_FUNC_BY_NUM_ARGS_EX1( func_name, ... ) GET_FUNC_BY_NUM_ARGS_EX0( func_name, COUNT_NUM_ARGS( __VA_ARGS__ ) )
  56 #define CALL_FUNC_DEFAULT_ARGS( func_name, ... )   GET_FUNC_BY_NUM_ARGS_EX1( func_name, __VA_ARGS__ ) ( __VA_ARGS__ )
  57
  58 /*---- class ----*/
  59 typedef struct
  60 {
  61     char  *name;
  62     size_t log_level_offset;    /* offset in the struct where 'log_level' is placed
  63                                  * If set to 0, 'log_level' is unavailable and implicitly set to LSMASH_LOG_INFO. */
  64 } lsmash_class_t;
  65
  66 /*---- type ----*/
  67 double lsmash_fixed2double( uint64_t value, int frac_width );
  68 float lsmash_int2float32( uint32_t value );
  69 double lsmash_int2float64( uint64_t value );
  70
  71 /*---- others ----*/
  72 typedef enum
  73 {
  74     LSMASH_LOG_QUIET = 0,
  75     LSMASH_LOG_ERROR,
  76     LSMASH_LOG_WARNING,
  77     LSMASH_LOG_INFO,
  78 } lsmash_log_level;
  79
  80 typedef struct
  81 {
  82     uint64_t n;
  83     uint64_t d;
  84 } lsmash_rational_u64_t;
  85
  86 typedef struct
  87 {
  88     int64_t  n;
  89     uint64_t d;
  90 } lsmash_rational_s64_t;
  91
  92 void lsmash_log
  93 (
  94     const void      *class,
  95     lsmash_log_level level,
  96     const char      *message,
  97     ...
  98 );
  99
 100 void lsmash_log_refresh_line
 101 (
 102     const void *class
 103 );
 104
 105 uint32_t lsmash_count_bits
 106 (
 107     uint32_t bits
 108 );
 109
 110 void lsmash_ifprintf
 111 (
 112     FILE       *fp,
 113     int         indent,
 114     const char *format, ...
 115 );
 116
 117 int lsmash_ceil_log2
 118 (
 119     uint64_t value
 120 );
 121
 122 int lsmash_compare_dts
 123 (
 124     const lsmash_media_ts_t *a,
 125     const lsmash_media_ts_t *b
 126 );
 127
 128 int lsmash_compare_cts
 129 (
 130     const lsmash_media_ts_t *a,
 131     const lsmash_media_ts_t *b
 132 );
 133
 134 static inline uint64_t lsmash_get_gcd
 135 (
 136     uint64_t a,
 137     uint64_t b
 138 )
 139 {
 140     if( !b )
 141         return a;
 142     while( 1 )
 143     {
 144         uint64_t c = a % b;
 145         if( !c )
 146             return b;
 147         a = b;
 148         b = c;
 149     }
 150 }
 151
 152 static inline uint64_t lsmash_get_lcm
 153 (
 154     uint64_t a,
 155     uint64_t b
 156 )
 157 {
 158     if( !a )
 159         return 0;
 160     return (a / lsmash_get_gcd( a, b )) * b;
 161 }
 162
 163 static inline void lsmash_reduce_fraction
 164 (
 165     uint64_t *a,
 166     uint64_t *b
 167 )
 168 {
 169     if( !a || !b )
 170         return;
 171     uint64_t gcd = lsmash_get_gcd( *a, *b );
 172     if( gcd )
 173     {
 174         *a /= gcd;
 175         *b /= gcd;
 176     }
 177 }
 178
 179 static inline void lsmash_reduce_fraction_su
 180 (
 181     int64_t  *a,
 182     uint64_t *b
 183 )
 184 {
 185     if( !a || !b )
 186         return;
 187     uint64_t c = *a > 0 ? *a : -(*a);
 188     uint64_t gcd = lsmash_get_gcd( c, *b );
 189     if( gcd )
 190     {
 191         c /= gcd;
 192         *b /= gcd;
 193         *a = *a > 0 ? c : -c;
 194     }
 195 }
 196
 197 #endif