add FF_API_SET_STRING_OLD define to disable the deprecated av_set_string API
[ffmpeg.git] / libavcodec / opt.h
1 /*
2  * AVOptions
3  * copyright (c) 2005 Michael Niedermayer <michaelni@gmx.at>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21
22 #ifndef AVCODEC_OPT_H
23 #define AVCODEC_OPT_H
24
25 /**
26  * @file
27  * AVOptions
28  */
29
30 #include "libavutil/rational.h"
31 #include "avcodec.h"
32 #include "libavutil/opt.h"
33
34 #if FF_API_SET_STRING_OLD
35 /**
36  * @see av_set_string2()
37  */
38 attribute_deprecated const AVOption *av_set_string(void *obj, const char *name, const char *val);
39
40 /**
41  * @return a pointer to the AVOption corresponding to the field set or
42  * NULL if no matching AVOption exists, or if the value val is not
43  * valid
44  * @see av_set_string3()
45  */
46 attribute_deprecated const AVOption *av_set_string2(void *obj, const char *name, const char *val, int alloc);
47 #endif
48 #if FF_API_OPT_SHOW
49 /**
50  * @deprecated Use av_opt_show2() instead.
51  */
52 attribute_deprecated int av_opt_show(void *obj, void *av_log_obj);
53 #endif
54
55 #endif /* AVCODEC_OPT_H */