| OLD | NEW |
| 1 /* | 1 /* |
| 2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> | 2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at> |
| 3 * | 3 * |
| 4 * This file is part of FFmpeg. | 4 * This file is part of FFmpeg. |
| 5 * | 5 * |
| 6 * FFmpeg is free software; you can redistribute it and/or | 6 * FFmpeg is free software; you can redistribute it and/or |
| 7 * modify it under the terms of the GNU Lesser General Public | 7 * modify it under the terms of the GNU Lesser General Public |
| 8 * License as published by the Free Software Foundation; either | 8 * License as published by the Free Software Foundation; either |
| 9 * version 2.1 of the License, or (at your option) any later version. | 9 * version 2.1 of the License, or (at your option) any later version. |
| 10 * | 10 * |
| 11 * FFmpeg is distributed in the hope that it will be useful, | 11 * FFmpeg is distributed in the hope that it will be useful, |
| 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of | 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 14 * Lesser General Public License for more details. | 14 * Lesser General Public License for more details. |
| 15 * | 15 * |
| 16 * You should have received a copy of the GNU Lesser General Public | 16 * You should have received a copy of the GNU Lesser General Public |
| 17 * License along with FFmpeg; if not, write to the Free Software | 17 * License along with FFmpeg; if not, write to the Free Software |
| 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
| 19 */ | 19 */ |
| 20 | 20 |
| 21 #ifndef AVUTIL_LOG_H | 21 #ifndef AVUTIL_LOG_H |
| 22 #define AVUTIL_LOG_H | 22 #define AVUTIL_LOG_H |
| 23 | 23 |
| 24 #include <stdarg.h> | 24 #include <stdarg.h> |
| 25 #include "avutil.h" | 25 #include "avutil.h" |
| 26 | 26 |
| 27 /** | 27 /** |
| 28 * Describes the class of an AVClass context structure, that is an | 28 * Describes the class of an AVClass context structure. That is an |
| 29 * arbitrary struct of which the first field is a pointer to an | 29 * arbitrary struct of which the first field is a pointer to an |
| 30 * AVClass struct (e.g. AVCodecContext, AVFormatContext etc.). | 30 * AVClass struct (e.g. AVCodecContext, AVFormatContext etc.). |
| 31 */ | 31 */ |
| 32 typedef struct AVCLASS AVClass; | 32 typedef struct AVCLASS AVClass; |
| 33 struct AVCLASS { | 33 struct AVCLASS { |
| 34 /** | 34 /** |
| 35 * The name of the class; usually it is the same name as the | 35 * The name of the class; usually it is the same name as the |
| 36 * context structure type to which the AVClass is associated. | 36 * context structure type to which the AVClass is associated. |
| 37 */ | 37 */ |
| 38 const char* class_name; | 38 const char* class_name; |
| 39 | 39 |
| 40 /** | 40 /** |
| 41 * a pointer to a function which returns the name of a context | 41 * A pointer to a function which returns the name of a context |
| 42 * instance \p ctx associated with the class | 42 * instance \p ctx associated with the class. |
| 43 */ | 43 */ |
| 44 const char* (*item_name)(void* ctx); | 44 const char* (*item_name)(void* ctx); |
| 45 | 45 |
| 46 /** | 46 /** |
| 47 * a pointer to the first option specified in the class if any or NULL | 47 * a pointer to the first option specified in the class if any or NULL |
| 48 * | 48 * |
| 49 * @see av_set_default_options() | 49 * @see av_set_default_options() |
| 50 */ | 50 */ |
| 51 const struct AVOption *option; | 51 const struct AVOption *option; |
| 52 }; | 52 }; |
| 53 | 53 |
| 54 /* av_log API */ | 54 /* av_log API */ |
| 55 | 55 |
| 56 #if LIBAVUTIL_VERSION_INT < (50<<16) | |
| 57 #define AV_LOG_QUIET -1 | |
| 58 #define AV_LOG_FATAL 0 | |
| 59 #define AV_LOG_ERROR 0 | |
| 60 #define AV_LOG_WARNING 1 | |
| 61 #define AV_LOG_INFO 1 | |
| 62 #define AV_LOG_VERBOSE 1 | |
| 63 #define AV_LOG_DEBUG 2 | |
| 64 #else | |
| 65 #define AV_LOG_QUIET -8 | 56 #define AV_LOG_QUIET -8 |
| 66 | 57 |
| 67 /** | 58 /** |
| 68 * something went really wrong and we will crash now | 59 * Something went really wrong and we will crash now. |
| 69 */ | 60 */ |
| 70 #define AV_LOG_PANIC 0 | 61 #define AV_LOG_PANIC 0 |
| 71 | 62 |
| 72 /** | 63 /** |
| 73 * something went wrong and recovery is not possible | 64 * Something went wrong and recovery is not possible. |
| 74 * like no header in a format which depends on it or a combination | 65 * For example, no header was found for a format which depends |
| 75 * of parameters which are not allowed | 66 * on headers or an illegal combination of parameters is used. |
| 76 */ | 67 */ |
| 77 #define AV_LOG_FATAL 8 | 68 #define AV_LOG_FATAL 8 |
| 78 | 69 |
| 79 /** | 70 /** |
| 80 * something went wrong and cannot losslessly be recovered | 71 * Something went wrong and cannot losslessly be recovered. |
| 81 * but not all future data is affected | 72 * However, not all future data is affected. |
| 82 */ | 73 */ |
| 83 #define AV_LOG_ERROR 16 | 74 #define AV_LOG_ERROR 16 |
| 84 | 75 |
| 85 /** | 76 /** |
| 86 * something somehow does not look correct / something which may or may not | 77 * Something somehow does not look correct. This may or may not |
| 87 * lead to some problems like use of -vstrict -2 | 78 * lead to problems. An example would be the use of '-vstrict -2'. |
| 88 */ | 79 */ |
| 89 #define AV_LOG_WARNING 24 | 80 #define AV_LOG_WARNING 24 |
| 90 | 81 |
| 91 #define AV_LOG_INFO 32 | 82 #define AV_LOG_INFO 32 |
| 92 #define AV_LOG_VERBOSE 40 | 83 #define AV_LOG_VERBOSE 40 |
| 93 | 84 |
| 94 /** | 85 /** |
| 95 * stuff which is only useful for libav* developers | 86 * Stuff which is only useful for libav* developers. |
| 96 */ | 87 */ |
| 97 #define AV_LOG_DEBUG 48 | 88 #define AV_LOG_DEBUG 48 |
| 98 #endif | |
| 99 | |
| 100 #if LIBAVUTIL_VERSION_INT < (50<<16) | |
| 101 extern int av_log_level; | |
| 102 #endif | |
| 103 | 89 |
| 104 /** | 90 /** |
| 105 * Send the specified message to the log if the level is less than or equal to | 91 * Sends the specified message to the log if the level is less than or equal |
| 106 * the current av_log_level. By default, all logging messages are sent to | 92 * to the current av_log_level. By default, all logging messages are sent to |
| 107 * stderr. This behavior can be altered by setting a different av_vlog callback | 93 * stderr. This behavior can be altered by setting a different av_vlog callback |
| 108 * function. | 94 * function. |
| 109 * | 95 * |
| 110 * @param avcl A pointer to an arbitrary struct of which the first field is a | 96 * @param avcl A pointer to an arbitrary struct of which the first field is a |
| 111 * pointer to an AVClass struct. | 97 * pointer to an AVClass struct. |
| 112 * @param level The importance level of the message, lower values signifying | 98 * @param level The importance level of the message, lower values signifying |
| 113 * higher importance. | 99 * higher importance. |
| 114 * @param fmt The format string (printf-compatible) that specifies how | 100 * @param fmt The format string (printf-compatible) that specifies how |
| 115 * subsequent arguments are converted to output. | 101 * subsequent arguments are converted to output. |
| 116 * @see av_vlog | 102 * @see av_vlog |
| 117 */ | 103 */ |
| 118 #ifdef __GNUC__ | 104 #ifdef __GNUC__ |
| 119 void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (
__printf__, 3, 4))); | 105 void av_log(void*, int level, const char *fmt, ...) __attribute__ ((__format__ (
__printf__, 3, 4))); |
| 120 #else | 106 #else |
| 121 void av_log(void*, int level, const char *fmt, ...); | 107 void av_log(void*, int level, const char *fmt, ...); |
| 122 #endif | 108 #endif |
| 123 | 109 |
| 124 void av_vlog(void*, int level, const char *fmt, va_list); | 110 void av_vlog(void*, int level, const char *fmt, va_list); |
| 125 int av_log_get_level(void); | 111 int av_log_get_level(void); |
| 126 void av_log_set_level(int); | 112 void av_log_set_level(int); |
| 127 void av_log_set_callback(void (*)(void*, int, const char*, va_list)); | 113 void av_log_set_callback(void (*)(void*, int, const char*, va_list)); |
| 128 void av_log_default_callback(void* ptr, int level, const char* fmt, va_list vl); | 114 void av_log_default_callback(void* ptr, int level, const char* fmt, va_list vl); |
| 129 | 115 |
| 130 #endif /* AVUTIL_LOG_H */ | 116 #endif /* AVUTIL_LOG_H */ |
| OLD | NEW |