1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
/*
* ratiocodes.h -- database for all ratio/codes (asr, sar, dar, frc...)
* used in transcode
* (C) 2005-2010 - Francesco Romani <fromani -at- gmail -dot- com>
*
* This file is part of transcode, a video stream processing tool.
*
* transcode is free software; you can redistribute it and/or modify
* 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.
*
* transcode 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
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef RATIOCODES_H
#define RATIOCODES_H
/*
* same ratio codes (i.e.: code=3) have different meaning in
* different contexts, so we have this enum to let the
* tc_code_{from,to}_ratio functions distinguish operational
* context.
*/
typedef enum tccoderatio_ TCRatioCode;
enum tccoderatio_ {
TC_FRC_CODE = 1, /* frame ratio */
TC_ASR_CODE, /* (display?) aspect ratio */
TC_PAR_CODE, /* pixel aspect ratio */
};
typedef struct tcpair_ TCPair;
struct tcpair_ {
int a; /* numerator, width... */
int b; /* denominator, height... */
};
#define TC_FRC_FPS_TO_RATIO(fps, pn, pd) \
do { \
*(pn) = (int)((fps) * 1000.0); \
*(pd) = 1000; \
} while(0)
/*
* TCPair VS int/int dilemma:
*
* Why don't use out TCPair instead of int/int couples in
* functions interface below?
* this code (and the whole transcode in general) need to interact
* with a broad variety of foreign code with various conventions,
* interface, styles and so on. I've no *YET* found a clean way
* to use a custom struct (TCPair) for those situations without
* requiring to use a temporary variable, that looks quite
* clumsy to me. So I've chosen to fall back to minimum
* common denominator, that is a couple of int or pointer
* to ints.
*
* Of course this can change if a better and cleanest solution
* pops out :)
*
* BTW, TCPair is extensively used in internal processing and
* in private code.
*/
/*************************************************************************/
/*
* tc_asr_code_describe:
* provides a descriptive, human readable string of given ASR code.
*
* Parameters:
* asr_code: the ASR code.
* Return Value:
* A constant string describing the given ASR code.
* There is NO NEED (and it is WRONG to do so) to free() it.
* Returned string is guaranteed to be valid at least until
* the next call to this function.
*/
const char *tc_asr_code_describe(int asr_code);
/*
* tc_asr_code_from_value:
* detect the right aspect ratio code (asr) given an aspect ratio value
* as real number.
*
* Parameters:
* asr_code: pointer to integer where detected asr code will be stored.
* Can be NULL: if so, asr code will be detected but not
* stored.
* ratio: value of frame rate, as real number.
* Return Value:
* TC_NULL_MATCH if input value isn't known
* >= 0 otherwise
*/
int tc_asr_code_from_value(int *asr_code, double ratio);
/*
* tc_frc_code_from_value:
* detect the right frame ratio code (frc) given a frame rate value as
* real number.
*
* Parameters:
* frc_code: pointer to integer where detected frc code will be stored.
* Can be NULL: if so, frc code will be detected but not
* stored.
* fps: value of frame rate, as real number.
* Return Value:
* TC_NULL_MATCH if input value isn't known
* >= 0 otherwise
*/
int tc_frc_code_from_value(int *frc_code, double fps);
/*
* tc_frc_code_to_value:
* detect the right frame ratio value as real number given a frame rate
* code (frc).
*
* Parameters:
* frc_code: frame rate code.
* fps: pointer to double where detected frc value will be stored.
* Can be NULL: if so, frc value will be detected but not
* stored.
* Return Value:
* TC_NULL_MATCH if input value isn't known
* >= 0 otherwise
*/
int tc_frc_code_to_value(int frc_code, double *fps);
/*
* tc_code_from_ratio:
* detect the right code in a specificied domain given a fraction as
* pair of integers.
*
* Parameters:
* rc: select operational domain. See definition of
* TCRatioCode above to see avalaible domains.
* code: pointer to integer where detected code will be stored.
* Can be NULL: if so, code will be detected but not
* stored.
* n: numerator of given frame ratio fraction.
* d: denominator of given frame ratio fraction.
* Return Value:
* TC_NULL_MATCH if input value isn't known
* >= 0 otherwise
*/
int tc_code_from_ratio(TCRatioCode rc, int *out_code, int in_n, int in_d);
/*
* tc_frc_code_to_ratio:
* detect the right ratio fraction in a specified domain as pair of
* integers given a ratio code.
*
* Parameters:
* rc: select operational domain. See definition of
* TCRatioCode above to see avalaible domains.
* code: code to be converted in fraction.
* n: pointer to integer where numerator of rate fraction
* will ne stored. Can be NULL: if so, fraction will be
* detected but not stored.
* d: pointer to integer where denominator of frate fraction
* will ne stored. Can be NULL: if so, fraction will be
* detected but not stored.
* Return Value:
* TC_NULL_MATCH if input value isn't known
* >= 0 otherwise
*/
int tc_code_to_ratio(TCRatioCode rc, int in_code, int *out_n, int *out_d);
/* macro goodies */
#define tc_frc_code_from_ratio(frc, n, d) \
tc_code_from_ratio(TC_FRC_CODE, frc, n, d)
#define tc_frc_code_to_ratio(frc, n, d) \
tc_code_to_ratio(TC_FRC_CODE, frc, n, d)
#define tc_asr_code_from_ratio(asr, n, d) \
tc_code_from_ratio(TC_ASR_CODE, asr, n, d)
#define tc_asr_code_to_ratio(asr, n, d) \
tc_code_to_ratio(TC_ASR_CODE, asr, n, d)
#define tc_par_code_from_ratio(par, n, d) \
tc_code_from_ratio(TC_PAR_CODE, par, n, d)
#define tc_par_code_to_ratio(par, n, d) \
tc_code_to_ratio(TC_PAR_CODE, par, n, d)
#endif /* RATIOCODES_H */
|
