Option setting functions

Those functions set the field of obj with the given name to value. More...

Macros
#define	av_opt_set_int_list(obj, name, val, term, flags)
	Set a binary option to an integer list. More...

Functions
int	av_opt_set (void *obj, const char *name, const char *val, int search_flags)
int	av_opt_set_int (void *obj, const char *name, int64_t val, int search_flags)
int	av_opt_set_double (void *obj, const char *name, double val, int search_flags)
int	av_opt_set_q (void *obj, const char *name, AVRational val, int search_flags)
int	av_opt_set_bin (void *obj, const char *name, const uint8_t *val, int size, int search_flags)
int	av_opt_set_image_size (void *obj, const char *name, int w, int h, int search_flags)
int	av_opt_set_pixel_fmt (void *obj, const char *name, enum AVPixelFormat fmt, int search_flags)
int	av_opt_set_sample_fmt (void *obj, const char *name, enum AVSampleFormat fmt, int search_flags)
int	av_opt_set_video_rate (void *obj, const char *name, AVRational val, int search_flags)
int	av_opt_set_chlayout (void *obj, const char *name, const AVChannelLayout *layout, int search_flags)
int	av_opt_set_dict_val (void *obj, const char *name, const AVDictionary *val, int search_flags)

Detailed Description

Those functions set the field of obj with the given name to value.

Parameters

[in]	obj	A struct whose first element is a pointer to an AVClass.
[in]	name	the name of the field to set
[in]	val	The value to set. In case of av_opt_set() if the field is not of a string type, then the given string is parsed. SI postfixes and some named scalars are supported. If the field is of a numeric type, it has to be a numeric or named scalar. Behavior with more than one scalar and +- infix operators is undefined. If the field is of a flags type, it has to be a sequence of numeric scalars or named flags separated by '+' or '-'. Prefixing a flag with '+' causes it to be set without affecting the other flags; similarly, '-' unsets a flag. If the field is of a dictionary type, it has to be a ':' separated list of key=value parameters. Values containing ':' special characters must be escaped.
	search_flags	flags passed to av_opt_find2. I.e. if AV_OPT_SEARCH_CHILDREN is passed here, then the option may be set on a child of obj.

Returns

0 if the value has been set, or an AVERROR code in case of error: AVERROR_OPTION_NOT_FOUND if no matching option exists AVERROR(ERANGE) if the value is out of range AVERROR(EINVAL) if the value is not valid

Macro Definition Documentation

av_opt_set_int_list

#define av_opt_set_int_list	(		obj,
			name,
			val,
			term,
			flags
	)

Value:

    (av_int_list_length(val, term) > INT_MAX / sizeof(*(val)) ? \
     AVERROR(EINVAL) : \
     av_opt_set_bin(obj, name, (const uint8_t *)(val), \
                    av_int_list_length(val, term) * sizeof(*(val)), flags))

Set a binary option to an integer list.

Parameters

obj	AVClass object to set options on
name	name of the binary option
val	pointer to an integer list (must have the correct type with regard to the contents of the list)
term	list terminator (usually 0 or -1)
flags	search flags

Examples

decode_filter_audio.c, and decode_filter_video.c.

Definition at line 806 of file opt.h.

Function Documentation

av_opt_set()

int av_opt_set	(	void *	obj,
		const char *	name,
		const char *	val,
		int	search_flags
	)

Definition at line 738 of file opt.c.

Referenced by av_opt_set_dict2(), av_opt_set_from_string(), configure_audio_filters(), configure_filtergraph(), doTest(), dump_stream_format(), dump_stream_group(), ff_filter_process_command(), filter_frame(), filter_opt_apply(), hls_start(), hls_write_packet(), init(), init_context_defaults(), init_filter(), init_filter_graph(), init_filters(), ist_add(), LLVMFuzzerTestOneInput(), main(), mmsh_open_internal(), nppscale_init(), nppscale_parse_expr(), nppscale_scale(), open_track_resource_context(), parse_key_value_pair(), process_command(), rtmp_http_open(), scale_frame(), scale_parse_expr(), segment_start(), set_dispositions(), store_icy(), url_alloc_for_protocol(), and writer_open().

av_opt_set_int()

int av_opt_set_int	(	void *	obj,
		const char *	name,
		int64_t	val,
		int	search_flags
	)

Definition at line 789 of file opt.c.

Referenced by av1_decode_init(), avformat_find_stream_info(), config_audio_output(), config_input(), config_props(), configure_audio_filters(), configure_output_audio_filter(), doTest(), draw_qrcode(), estimate_timings_from_pts(), init(), init_filter_graph(), insert_trim(), lavfi_read_header(), LLVMFuzzerTestOneInput(), main(), open_audio(), opus_decode_init(), opus_init_resample(), output_single_frame(), preinit(), process_client(), query_formats(), swr_alloc_set_opts2(), swr_config_frame(), sws_getCachedContext(), and vaapi_encode_av1_init().

av_opt_set_double()

int av_opt_set_double	(	void *	obj,
		const char *	name,
		double	val,
		int	search_flags
	)

Definition at line 794 of file opt.c.

Referenced by init().

av_opt_set_q()

int av_opt_set_q	(	void *	obj,
		const char *	name,
		AVRational	val,
		int	search_flags
	)

Definition at line 799 of file opt.c.

Referenced by init_filter_graph().

av_opt_set_bin()

int av_opt_set_bin	(	void *	obj,
		const char *	name,
		const uint8_t *	val,
		int	size,
		int	search_flags
	)

Definition at line 804 of file opt.c.

Referenced by filter_opt_apply(), init_filter(), lavfi_read_header(), rtmp_calc_swfhash(), rtmp_http_open(), and rtmp_http_send_cmd().

av_opt_set_image_size()

int av_opt_set_image_size	(	void *	obj,
		const char *	name,
		int	w,
		int	h,
		int	search_flags
	)

Definition at line 834 of file opt.c.

av_opt_set_pixel_fmt()

int av_opt_set_pixel_fmt	(	void *	obj,
		const char *	name,
		enum AVPixelFormat	fmt,
		int	search_flags
	)

Definition at line 903 of file opt.c.

av_opt_set_sample_fmt()

int av_opt_set_sample_fmt	(	void *	obj,
		const char *	name,
		enum AVSampleFormat	fmt,
		int	search_flags
	)

Definition at line 908 of file opt.c.

Referenced by config_audio_output(), main(), and open_audio().

av_opt_set_video_rate()

int av_opt_set_video_rate	(	void *	obj,
		const char *	name,
		AVRational	val,
		int	search_flags
	)

Definition at line 856 of file opt.c.

av_opt_set_chlayout()

int av_opt_set_chlayout	(	void *	obj,
		const char *	name,
		const AVChannelLayout *	layout,
		int	search_flags
	)

Definition at line 932 of file opt.c.

Referenced by config_audio_output(), config_props(), main(), open_audio(), opus_decode_init(), swr_alloc_set_opts2(), and swr_config_frame().

av_opt_set_dict_val()

int av_opt_set_dict_val	(	void *	obj,
		const char *	name,
		const AVDictionary *	val,
		int	search_flags
	)

Note

Any old dictionary present is discarded and replaced with a copy of the new one. The caller still owns val is and responsible for freeing it.

Definition at line 913 of file opt.c.

Referenced by read_frame_internal().