FFmpeg: libavcodec/bsf.c Source File
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 <string.h>
20
21 #include "config.h"
22
29
34
35 #define IS_EMPTY(pkt) (!(pkt)->data && !(pkt)->side_data_elems)
36
42
44 {
46 }
47
49 {
52
53 if (!pctx || !*pctx)
54 return;
57
59 if (
ctx->filter->close)
61 if (
ctx->filter->priv_class)
64 }
66
69
71 }
72
74 {
76 if (!prev &&
ctx->filter->priv_class)
79 }
80
82 {
84 }
85
93 };
94
96 {
98 }
99
101 {
105
107 if (!bsfi)
110
113
116 if (!
ctx->par_in || !
ctx->par_out) {
119 }
120 /* allocate priv data and init private options */
121 if (
filter->priv_data_size) {
126 }
130 }
131 }
136 }
137
139 return 0;
143 }
144
146 {
148
149 /* check that the codec is supported */
150 if (
ctx->filter->codec_ids) {
152 if (
ctx->par_in->codec_id ==
ctx->filter->codec_ids[
i])
153 break;
157 "bitstream filter '%s'. Supported codecs are: ",
158 desc ?
desc->name :
"unknown",
ctx->par_in->codec_id,
ctx->filter->name);
163 }
166 }
167 }
168
169 /* initialize output parameters to be the same as input
170 * init below might overwrite that */
174
175 ctx->time_base_out =
ctx->time_base_in;
176
177 if (
ctx->filter->init) {
181 }
182
183 return 0;
184 }
185
187 {
189
191
193
194 if (
ctx->filter->flush)
196 }
197
199 {
202
207 return 0;
208 }
209
213 }
214
217
222
223 return 0;
224 }
225
227 {
229 }
230
232 {
235
238
241
243 if (!tmp_pkt)
245
248
249 return 0;
250 }
251
253 {
255
258
261
263
264 return 0;
265 }
266
269
272
273 unsigned idx;
// index of currently processed BSF
274
277
278
280 {
285
290
292
296
299 }
300
303
306 }
307
309 {
312
315
316 while (1) {
317 /* get a packet from the previous filter up the chain */
320 else
326 continue;
328 eof = 1;
331
332 /* send it to the next filter down the chain */
339 }
341 eof = 0;
342 } else if (eof) {
344 } else {
345 return 0;
346 }
347 }
348 }
349
351 {
353
357 }
358
360 {
363
368 }
369
371 {
372 static const char *null_filter_name = "null";
375
377 return null_filter_name;
378
381 AVBPrint bp;
383
388
390 }
391
393 }
394
399 };
400
409 };
410
414 };
415
417 {
419 }
420
422 {
424
425 if (!*lst)
426 return;
427
428 for (
i = 0;
i < (*lst)->nb_bsfs; ++
i)
432 }
433
435 {
437 }
438
440 {
444
448
452
455 const char * shorthand[2] = {
NULL};
456
457 if (opt)
458 shorthand[0] = opt->
name;
459
462 goto end;
463 }
464
465 if (options_dict) {
468 goto end;
469 }
470
472
473 end:
476
478 }
479
481 {
483 }
484
486 {
489
490 if ((*lst)->nb_bsfs == 1) {
491 *bsf = (*lst)->bsfs[0];
493 (*lst)->nb_bsfs = 0;
494 goto end;
495 }
496
500
502
503 ctx->bsfs = (*lst)->bsfs;
504 ctx->nb_bsfs = (*lst)->nb_bsfs;
505
506 end:
509 }
510
512 {
513 char *bsf_name, *bsf_options_str;
514
516 if (!bsf_name)
518
520 }
521
523 {
526
529
531 if (!lst)
533
534 do {
539 goto end;
541
543 end:
547 }
548
550 {
551 #if CONFIG_NULL_BSF
554 #else
556 #endif
557 }
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
AVCodecParameters * par_in
Parameters of the input stream.
Filter the word "frame" indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
char * av_get_token(const char **buf, const char *term)
Unescape the given string until a non escaped terminating char, and return the token corresponding to...
This struct describes the properties of an encoded stream.
#define AVERROR_EOF
End of file.
int av_bsf_init(AVBSFContext *ctx)
Prepare the filter for use, after all the parameters and options have been set.
AVBSFList * av_bsf_list_alloc(void)
Allocate empty list of bitstream filters.
static int bsf_list_append_internal(AVBSFList *lst, const char *bsf_name, const char *options, AVDictionary **options_dict)
void avcodec_parameters_free(AVCodecParameters **ppar)
Free an AVCodecParameters instance and everything associated with it and write NULL to the supplied p...
filter_frame For filters that do not use the this method is called when a frame is pushed to the filter s input It can be called at any time except in a reentrant way If the input frame is enough to produce then the filter should push the output frames on the output link immediately As an exception to the previous rule if the input frame is enough to produce several output frames then the filter needs output only at least one per link The additional frames can be left buffered in the filter
int ff_bsf_get_packet(AVBSFContext *ctx, AVPacket **pkt)
Called by the bitstream filters to get the next packet for filtering.
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
The bitstream filter state.
const AVBitStreamFilter * av_bsf_get_by_name(const char *name)
static av_always_inline FFBSFContext * ffbsfcontext(AVBSFContext *ctx)
static void * bsf_child_next(void *obj, void *prev)
int av_bsf_get_null_filter(AVBSFContext **bsf)
Get null/pass-through bitstream filter.
AVCodecParameters * par_out
Parameters of the output stream.
static int bsf_list_filter(AVBSFContext *bsf, AVPacket *out)
static void bsf_list_flush(AVBSFContext *bsf)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
This struct describes the properties of a single codec described by an AVCodecID.
static const AVBitStreamFilter list_bsf
void av_bsf_list_free(AVBSFList **lst)
Free list of bitstream filters.
char * av_strtok(char *s, const char *delim, char **saveptr)
Split the string into several tokens which can be accessed by successive calls to av_strtok().
const AVClass * av_bsf_get_class(void)
Get the AVClass for AVBSFContext.
AVRational time_base_in
The timebase used for the timestamps of the input packets.
int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf)
Finalize list of bitstream filters.
#define LIBAVUTIL_VERSION_INT
Describe the class of an AVClass context structure.
static void flush(AVCodecContext *avctx)
int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf_lst)
Parse string describing list of bitstream filters and create single AVBSFContext describing the whole...
Rational number (pair of numerator and denominator).
int av_opt_set_from_string(void *ctx, const char *opts, const char *const *shorthand, const char *key_val_sep, const char *pairs_sep)
Parse the key-value pairs list in opts.
#define AVERROR_BSF_NOT_FOUND
Bitstream filter not found.
void av_opt_free(void *obj)
Free all allocated objects in obj.
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
Move every field in src to dst and reset src.
AVCodecID
Identify the syntax and semantics of the bitstream.
const AVClass * ff_bsf_child_class_iterate(void **opaque)
const OptionDef options[]
static const AVClass bsf_class
const AVBitStreamFilter ff_null_bsf
AVClassCategory category
Category used for visualization (like color) This is only set if the category is equal for all object...
static const char * bsf_list_item_name(void *ctx)
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
int av_opt_set_dict2(void *obj, AVDictionary **options, int search_flags)
Set all the options from a given dictionary on an object.
int av_packet_make_refcounted(AVPacket *pkt)
Ensure the data described by a given packet is reference counted.
AVPacket * av_packet_alloc(void)
Allocate an AVPacket and set its fields to default values.
static const AVClass bsf_list_class
static int bsf_parse_single(char *str, AVBSFList *bsf_lst)
int av_bsf_list_append2(AVBSFList *lst, const char *bsf_name, AVDictionary **options)
Construct new bitstream filter context given it's name and options and append it to the list of bitst...
int avcodec_parameters_copy(AVCodecParameters *dst, const AVCodecParameters *src)
Copy the contents of src to dst.
const char * avcodec_get_name(enum AVCodecID id)
Get the name of a codec.
static int bsf_list_init(AVBSFContext *bsf)
int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt)
Retrieve a filtered packet.
#define i(width, name, range_min, range_max)
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
AVCodecParameters * avcodec_parameters_alloc(void)
Allocate a new AVCodecParameters and set its fields to default values (unknown/invalid/0).
AVRational time_base_out
The timebase used for the timestamps of the output packets.
const AVOption * av_opt_next(const void *obj, const AVOption *last)
Iterate over all AVOptions belonging to obj.
void * priv_data
Opaque filter-specific private data.
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
const AVClass * av_class
A class for logging and AVOptions.
void av_bprintf(AVBPrint *buf, const char *fmt,...)
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt)
Submit a packet for filtering.
int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf)
Append bitstream filter to the list of bitstream filters.
void av_bsf_flush(AVBSFContext *ctx)
Reset the internal bitstream filter state.
int av_dynarray_add_nofree(void *tab_ptr, int *nb_ptr, void *elem)
Add an element to a dynamic array.
Structure for chain/list of bitstream filters.
static void bsf_list_close(AVBSFContext *bsf)
const struct AVBitStreamFilter * filter
The bitstream filter this context is an instance of.
@ AV_CLASS_CATEGORY_BITSTREAM_FILTER
This structure stores compressed data.
void av_bsf_free(AVBSFContext **pctx)
Free a bitstream filter context and everything associated with it; write NULL into the supplied point...
int ff_bsf_get_packet_ref(AVBSFContext *ctx, AVPacket *pkt)
Called by bitstream filters to get packet for filtering.
const AVCodecDescriptor * avcodec_descriptor_get(enum AVCodecID id)
static const char * bsf_to_name(void *bsf)
void * priv_data
Format private data.
int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **pctx)
Allocate a context for a given bitstream filter.
Generated on Wed Aug 24 2022 21:37:28 for FFmpeg by
doxygen
1.8.17