Mercurial > libavutil.hg
annotate log.h @ 913:de7b577403bc libavutil
Fix typo.
author | jai_menon |
---|---|
date | Wed, 28 Apr 2010 20:08:02 +0000 |
parents | 5ffcf744a157 |
children | 3ab411c447c4 |
rev | line source |
---|---|
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
1 /* |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
3 * |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
4 * This file is part of FFmpeg. |
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
5 * |
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
6 * FFmpeg is free software; you can redistribute it and/or |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
7 * modify it under the terms of the GNU Lesser General Public |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
8 * License as published by the Free Software Foundation; either |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
9 * version 2.1 of the License, or (at your option) any later version. |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
10 * |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
11 * FFmpeg is distributed in the hope that it will be useful, |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
14 * Lesser General Public License for more details. |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
15 * |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
16 * You should have received a copy of the GNU Lesser General Public |
116
d76a36742464
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
108
diff
changeset
|
17 * License along with FFmpeg; if not, write to the Free Software |
108
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
19 */ |
11be8e0d1344
Add official LGPL license headers to the files that were missing them.
diego
parents:
88
diff
changeset
|
20 |
567 | 21 #ifndef AVUTIL_LOG_H |
22 #define AVUTIL_LOG_H | |
81 | 23 |
24 #include <stdarg.h> | |
602 | 25 #include "avutil.h" |
81 | 26 |
27 /** | |
636 | 28 * Describes the class of an AVClass context structure. That is an |
499 | 29 * arbitrary struct of which the first field is a pointer to an |
30 * AVClass struct (e.g. AVCodecContext, AVFormatContext etc.). | |
81 | 31 */ |
754 | 32 typedef struct { |
499 | 33 /** |
504 | 34 * The name of the class; usually it is the same name as the |
503 | 35 * context structure type to which the AVClass is associated. |
499 | 36 */ |
81 | 37 const char* class_name; |
499 | 38 |
39 /** | |
636 | 40 * A pointer to a function which returns the name of a context |
738
4f98a323598c
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
689
diff
changeset
|
41 * instance ctx associated with the class. |
499 | 42 */ |
43 const char* (*item_name)(void* ctx); | |
44 | |
45 /** | |
46 * a pointer to the first option specified in the class if any or NULL | |
47 * | |
48 * @see av_set_default_options() | |
49 */ | |
144 | 50 const struct AVOption *option; |
912
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
51 |
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
52 /** |
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
53 * LIBAVUTIL_VERSION with which this structure was created. |
913 | 54 * This is used to allow fields to be added without requiring major |
912
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
55 * version bumps everywhere. |
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
56 */ |
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
57 |
5ffcf744a157
Add version to AVClass so we can add to and use fields of AVClass without ABI issues.
michael
parents:
754
diff
changeset
|
58 int version; |
754 | 59 } AVClass; |
81 | 60 |
61 /* av_log API */ | |
62 | |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
63 #define AV_LOG_QUIET -8 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
64 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
65 /** |
636 | 66 * Something went really wrong and we will crash now. |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
67 */ |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
68 #define AV_LOG_PANIC 0 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
69 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
70 /** |
637 | 71 * Something went wrong and recovery is not possible. |
72 * For example, no header was found for a format which depends | |
73 * on headers or an illegal combination of parameters is used. | |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
74 */ |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
75 #define AV_LOG_FATAL 8 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
76 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
77 /** |
637 | 78 * Something went wrong and cannot losslessly be recovered. |
79 * However, not all future data is affected. | |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
80 */ |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
81 #define AV_LOG_ERROR 16 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
82 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
83 /** |
637 | 84 * Something somehow does not look correct. This may or may not |
85 * lead to problems. An example would be the use of '-vstrict -2'. | |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
86 */ |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
87 #define AV_LOG_WARNING 24 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
88 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
89 #define AV_LOG_INFO 32 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
90 #define AV_LOG_VERBOSE 40 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
91 |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
92 /** |
636 | 93 * Stuff which is only useful for libav* developers. |
233
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
94 */ |
0e59652783b7
Increase the av_log() levels, and add some documentation for them
lucabe
parents:
163
diff
changeset
|
95 #define AV_LOG_DEBUG 48 |
81 | 96 |
270
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
97 /** |
636 | 98 * Sends the specified message to the log if the level is less than or equal |
99 * to the current av_log_level. By default, all logging messages are sent to | |
270
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
100 * stderr. This behavior can be altered by setting a different av_vlog callback |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
101 * function. |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
102 * |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
103 * @param avcl A pointer to an arbitrary struct of which the first field is a |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
104 * pointer to an AVClass struct. |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
105 * @param level The importance level of the message, lower values signifying |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
106 * higher importance. |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
107 * @param fmt The format string (printf-compatible) that specifies how |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
108 * subsequent arguments are converted to output. |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
109 * @see av_vlog |
55cd41bc50bf
Move the unaltered Doxygen docs from the log source code to the accompanying
takis
parents:
233
diff
changeset
|
110 */ |
81 | 111 #ifdef __GNUC__ |
494 | 112 void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4))); |
81 | 113 #else |
494 | 114 void av_log(void*, int level, const char *fmt, ...); |
81 | 115 #endif |
116 | |
494 | 117 void av_vlog(void*, int level, const char *fmt, va_list); |
118 int av_log_get_level(void); | |
119 void av_log_set_level(int); | |
120 void av_log_set_callback(void (*)(void*, int, const char*, va_list)); | |
121 void av_log_default_callback(void* ptr, int level, const char* fmt, va_list vl); | |
81 | 122 |
567 | 123 #endif /* AVUTIL_LOG_H */ |