FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
utils.c
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #include "config.h"
20 #include "avutil.h"
21 #include "avassert.h"
22 #include "samplefmt.h"
23 #include "internal.h"
24 
25 /**
26  * @file
27  * various utility functions
28  */
29 
30 #include "libavutil/ffversion.h"
31 const char av_util_ffversion[] = "FFmpeg version " FFMPEG_VERSION;
32 
33 const char *av_version_info(void)
34 {
35  return FFMPEG_VERSION;
36 }
37 
38 unsigned avutil_version(void)
39 {
40  static int checks_done;
41  if (checks_done)
42  return LIBAVUTIL_VERSION_INT;
43 
44 #if FF_API_VDPAU
45  av_assert0(AV_PIX_FMT_VDA_VLD == 81); //check if the pix fmt enum has not had anything inserted or removed by mistake
46 #endif
51  av_assert0(HAVE_MMX2 == HAVE_MMXEXT);
52 
53  av_assert0(((size_t)-1) > 0); // C guarantees this but if false on a platform we care about revert at least b284e1ffe343d6697fb950d1ee517bafda8a9844
54 
55  if (av_sat_dadd32(1, 2) != 5) {
56  av_log(NULL, AV_LOG_FATAL, "Libavutil has been built with a broken binutils, please upgrade binutils and rebuild\n");
57  abort();
58  }
59 
60  if (llrint(1LL<<60) != 1LL<<60) {
61  av_log(NULL, AV_LOG_ERROR, "Libavutil has been linked to a broken llrint()\n");
62  }
63 
64  checks_done = 1;
65  return LIBAVUTIL_VERSION_INT;
66 }
67 
68 const char *avutil_configuration(void)
69 {
70  return FFMPEG_CONFIGURATION;
71 }
72 
73 const char *avutil_license(void)
74 {
75 #define LICENSE_PREFIX "libavutil license: "
76  return LICENSE_PREFIX FFMPEG_LICENSE + sizeof(LICENSE_PREFIX) - 1;
77 }
78 
79 const char *av_get_media_type_string(enum AVMediaType media_type)
80 {
81  switch (media_type) {
82  case AVMEDIA_TYPE_VIDEO: return "video";
83  case AVMEDIA_TYPE_AUDIO: return "audio";
84  case AVMEDIA_TYPE_DATA: return "data";
85  case AVMEDIA_TYPE_SUBTITLE: return "subtitle";
86  case AVMEDIA_TYPE_ATTACHMENT: return "attachment";
87  default: return NULL;
88  }
89 }
90 
92 {
93  switch (pict_type) {
94  case AV_PICTURE_TYPE_I: return 'I';
95  case AV_PICTURE_TYPE_P: return 'P';
96  case AV_PICTURE_TYPE_B: return 'B';
97  case AV_PICTURE_TYPE_S: return 'S';
98  case AV_PICTURE_TYPE_SI: return 'i';
99  case AV_PICTURE_TYPE_SP: return 'p';
100  case AV_PICTURE_TYPE_BI: return 'b';
101  default: return '?';
102  }
103 }
104 
105 unsigned av_int_list_length_for_size(unsigned elsize,
106  const void *list, uint64_t term)
107 {
108  unsigned i;
109 
110  if (!list)
111  return 0;
112 #define LIST_LENGTH(type) \
113  { type t = term, *l = (type *)list; for (i = 0; l[i] != t; i++); }
114  switch (elsize) {
115  case 1: LIST_LENGTH(uint8_t); break;
116  case 2: LIST_LENGTH(uint16_t); break;
117  case 4: LIST_LENGTH(uint32_t); break;
118  case 8: LIST_LENGTH(uint64_t); break;
119  default: av_assert0(!"valid element size");
120  }
121  return i;
122 }
123 
124 char *av_fourcc_make_string(char *buf, uint32_t fourcc)
125 {
126  int i;
127  char *orig_buf = buf;
128  size_t buf_size = AV_FOURCC_MAX_STRING_SIZE;
129 
130  for (i = 0; i < 4; i++) {
131  const int c = fourcc & 0xff;
132  const int print_chr = (c >= '0' && c <= '9') ||
133  (c >= 'a' && c <= 'z') ||
134  (c >= 'A' && c <= 'Z') ||
135  (c && strchr(". -_", c));
136  const int len = snprintf(buf, buf_size, print_chr ? "%c" : "[%d]", c);
137  if (len < 0)
138  break;
139  buf += len;
140  buf_size = buf_size > len ? buf_size - len : 0;
141  fourcc >>= 8;
142  }
143 
144  return orig_buf;
145 }
146 
148 {
149  return (AVRational){1, AV_TIME_BASE};
150 }
151 
152 void av_assert0_fpu(void) {
153 #if HAVE_MMX_INLINE
154  uint16_t state[14];
155  __asm__ volatile (
156  "fstenv %0 \n\t"
157  : "+m" (state)
158  :
159  : "memory"
160  );
161  av_assert0((state[4] & 3) == 3);
162 #endif
163 }
#define NULL
Definition: coverity.c:32
BI type.
Definition: avutil.h:280
uint32_t fourcc
Definition: hwcontext_qsv.c:90
S(GMC)-VOP MPEG-4.
Definition: avutil.h:277
const char * avutil_configuration(void)
Return the libavutil build-time configuration.
Definition: utils.c:68
static struct @260 state
#define LIBAVUTIL_VERSION_INT
Definition: version.h:86
const char av_util_ffversion[]
Definition: utils.c:31
double, planar
Definition: samplefmt.h:70
Convenience header that includes libavutil's core.
#define LICENSE_PREFIX
Switching Intra.
Definition: avutil.h:278
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
uint8_t
Opaque data information usually continuous.
Definition: avutil.h:203
void av_assert0_fpu(void)
Assert that floating point opperations can be executed.
Definition: utils.c:152
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
Definition: utils.c:91
#define av_log(a,...)
unsigned avutil_version(void)
Return the LIBAVUTIL_VERSION_INT constant.
Definition: utils.c:38
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
unsigned av_int_list_length_for_size(unsigned elsize, const void *list, uint64_t term)
Compute the length of an integer list.
Definition: utils.c:105
#define LIBAVUTIL_VERSION_MICRO
Definition: version.h:84
#define AV_FOURCC_MAX_STRING_SIZE
Definition: avutil.h:346
simple assert() macros that are a bit more flexible than ISO C assert().
common internal API header
#define AV_TIME_BASE
Internal time base represented as integer.
Definition: avutil.h:254
const char * av_version_info(void)
Return an informative version string.
Definition: utils.c:33
Opaque data information usually sparse.
Definition: avutil.h:205
char * av_fourcc_make_string(char *buf, uint32_t fourcc)
Fill the provided buffer with a string containing a FourCC (four-character code) representation.
Definition: utils.c:124
const char * avutil_license(void)
Return the libavutil license.
Definition: utils.c:73
#define LIST_LENGTH(type)
void * buf
Definition: avisynth_c.h:690
#define llrint(x)
Definition: libm.h:394
Switching Predicted.
Definition: avutil.h:279
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AVMediaType
Definition: avutil.h:199
AVPictureType
Definition: avutil.h:272
#define snprintf
Definition: snprintf.h:34
AVRational av_get_time_base_q(void)
Return the fractional representation of the internal time base.
Definition: utils.c:147
const char * av_get_media_type_string(enum AVMediaType media_type)
Return a string describing the media_type enum, NULL if media_type is unknown.
Definition: utils.c:79
hardware decoding through VDA
Definition: pixfmt.h:179
static double c[64]
Bi-dir predicted.
Definition: avutil.h:276
int len
#define AV_LOG_FATAL
Something went wrong and recovery is not possible.
Definition: log.h:170
Predicted.
Definition: avutil.h:275