5ff85f1d |
/* |
89c9ff50 |
* rational numbers |
5ff85f1d |
* Copyright (c) 2003 Michael Niedermayer <michaelni@gmx.at>
* |
b78e7197 |
* This file is part of FFmpeg.
*
* FFmpeg is free software; you can redistribute it and/or |
5ff85f1d |
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either |
b78e7197 |
* version 2.1 of the License, or (at your option) any later version. |
5ff85f1d |
* |
b78e7197 |
* FFmpeg is distributed in the hope that it will be useful, |
5ff85f1d |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public |
b78e7197 |
* License along with FFmpeg; if not, write to the Free Software |
5509bffa |
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
5ff85f1d |
*/ |
115329f1 |
|
5ff85f1d |
/** |
ba87f080 |
* @file |
89c9ff50 |
* rational numbers |
5ff85f1d |
* @author Michael Niedermayer <michaelni@gmx.at>
*/
|
98790382 |
#ifndef AVUTIL_RATIONAL_H
#define AVUTIL_RATIONAL_H |
5ff85f1d |
|
99545457 |
#include <stdint.h> |
dec11269 |
#include <limits.h> |
2ed6f399 |
#include "attributes.h" |
99545457 |
|
5c07b9e9 |
/** |
757cd8d8 |
* @addtogroup lavu_math
* @{
*/
/** |
89c9ff50 |
* rational number numerator/denominator |
5c07b9e9 |
*/ |
5ff85f1d |
typedef struct AVRational{ |
5c07b9e9 |
int num; ///< numerator
int den; ///< denominator |
5ff85f1d |
} AVRational;
|
5c07b9e9 |
/** |
3532dd52 |
* Create a rational.
* Useful for compilers that do not support compound literals.
* @note The return value is not reduced.
*/
static inline AVRational av_make_q(int num, int den)
{
AVRational r = { num, den };
return r;
}
/** |
49bd8e4b |
* Compare two rationals. |
1c95ef8b |
* @param a first rational
* @param b second rational |
3a1429ec |
* @return 0 if a==b, 1 if a>b, -1 if a<b, and INT_MIN if one of the
* values is of the form 0/0 |
5c07b9e9 |
*/ |
5ff85f1d |
static inline int av_cmp_q(AVRational a, AVRational b){
const int64_t tmp= a.num * (int64_t)b.den - b.num * (int64_t)a.den;
|
16c3ed58 |
if(tmp) return (int)((tmp ^ a.den ^ b.den)>>63)|1; |
dec11269 |
else if(b.den && a.den) return 0;
else if(a.num && b.num) return (a.num>>31) - (b.num>>31);
else return INT_MIN; |
5ff85f1d |
}
|
5c07b9e9 |
/** |
49bd8e4b |
* Convert rational to double. |
1c95ef8b |
* @param a rational to convert
* @return (double) a |
5c07b9e9 |
*/ |
5ff85f1d |
static inline double av_q2d(AVRational a){
return a.num / (double) a.den;
}
|
c11c2bc2 |
/** |
49bd8e4b |
* Reduce a fraction. |
804de96a |
* This is useful for framerate calculations. |
674bd4f6 |
* @param dst_num destination numerator |
1c95ef8b |
* @param dst_den destination denominator |
674bd4f6 |
* @param num source numerator |
1c95ef8b |
* @param den source denominator |
674bd4f6 |
* @param max the maximum allowed for dst_num & dst_den |
c11c2bc2 |
* @return 1 if exact, 0 otherwise
*/ |
674bd4f6 |
int av_reduce(int *dst_num, int *dst_den, int64_t num, int64_t den, int64_t max); |
c11c2bc2 |
|
0b006599 |
/** |
49bd8e4b |
* Multiply two rationals. |
89c9ff50 |
* @param b first rational
* @param c second rational
* @return b*c |
0b006599 |
*/ |
85074d3c |
AVRational av_mul_q(AVRational b, AVRational c) av_const; |
0b006599 |
/** |
49bd8e4b |
* Divide one rational by another. |
89c9ff50 |
* @param b first rational
* @param c second rational
* @return b/c |
0b006599 |
*/ |
85074d3c |
AVRational av_div_q(AVRational b, AVRational c) av_const; |
0b006599 |
/** |
49bd8e4b |
* Add two rationals. |
89c9ff50 |
* @param b first rational
* @param c second rational
* @return b+c |
0b006599 |
*/ |
85074d3c |
AVRational av_add_q(AVRational b, AVRational c) av_const; |
0b006599 |
/** |
49bd8e4b |
* Subtract one rational from another. |
89c9ff50 |
* @param b first rational
* @param c second rational
* @return b-c |
0b006599 |
*/ |
85074d3c |
AVRational av_sub_q(AVRational b, AVRational c) av_const; |
0b006599 |
/** |
82494835 |
* Invert a rational.
* @param q value
* @return 1 / q
*/
static av_always_inline AVRational av_inv_q(AVRational q)
{
AVRational r = { q.den, q.num };
return r;
}
/** |
49bd8e4b |
* Convert a double precision floating point number to a rational. |
6b4ed22f |
* inf is expressed as {1,0} or {-1,0} depending on the sign.
* |
0b006599 |
* @param d double to convert
* @param max the maximum allowed numerator and denominator |
89c9ff50 |
* @return (AVRational) d |
0b006599 |
*/ |
85074d3c |
AVRational av_d2q(double d, int max) av_const; |
5ff85f1d |
|
05b90fc0 |
/** |
bf7e799c |
* @return 1 if q1 is nearer to q than q2, -1 if q2 is nearer
* than q1, 0 if they have the same distance. |
05b90fc0 |
*/
int av_nearer_q(AVRational q, AVRational q1, AVRational q2);
/** |
49bd8e4b |
* Find the nearest value in q_list to q. |
05b90fc0 |
* @param q_list an array of rationals terminated by {0, 0}
* @return the index of the nearest value found in the array
*/
int av_find_nearest_q_idx(AVRational q, const AVRational* q_list);
|
757cd8d8 |
/**
* @}
*/
|
98790382 |
#endif /* AVUTIL_RATIONAL_H */ |