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_components.h"
22
29
34
35 #define IS_EMPTY(pkt) (!(pkt)->data && !(pkt)->side_data_elems)
36
38 {
40 }
41
47
49 {
51 }
52
54 {
57
58 if (!pctx || !*pctx)
59 return;
62
66 if (
ctx->filter->priv_class)
69 }
71
74
76 }
77
79 {
81 if (!prev &&
ctx->filter->priv_class)
84 }
85
87 {
89 }
90
98 };
99
101 {
103 }
104
106 {
110
112 if (!bsfi)
115
118
121 if (!
ctx->par_in || !
ctx->par_out) {
124 }
125 /* allocate priv data and init private options */
131 }
135 }
136 }
141 }
142
144 return 0;
148 }
149
151 {
153
154 /* check that the codec is supported */
155 if (
ctx->filter->codec_ids) {
157 if (
ctx->par_in->codec_id ==
ctx->filter->codec_ids[
i])
158 break;
162 "bitstream filter '%s'. Supported codecs are: ",
163 desc ?
desc->name :
"unknown",
ctx->par_in->codec_id,
ctx->filter->name);
168 }
171 }
172 }
173
174 /* initialize output parameters to be the same as input
175 * init below might overwrite that */
179
180 ctx->time_base_out =
ctx->time_base_in;
181
186 }
187
188 return 0;
189 }
190
192 {
194
196
198
201 }
202
204 {
207
212 return 0;
213 }
214
218 }
219
222
227
228 return 0;
229 }
230
232 {
234 }
235
237 {
240
243
246
248 if (!tmp_pkt)
250
253
254 return 0;
255 }
256
258 {
260
263
266
268
269 return 0;
270 }
271
274
277
278 unsigned idx;
// index of currently processed BSF
279
282
283
285 {
290
295
297
301
304 }
305
308
311 }
312
314 {
317
320
321 while (1) {
322 /* get a packet from the previous filter up the chain */
325 else
331 continue;
333 eof = 1;
336
337 /* send it to the next filter down the chain */
344 }
346 eof = 0;
347 } else if (eof) {
349 } else {
350 return 0;
351 }
352 }
353 }
354
356 {
358
362 }
363
365 {
368
373 }
374
376 {
377 static const char *null_filter_name = "null";
380
382 return null_filter_name;
383
386 AVBPrint bp;
388
393
395 }
396
398 }
399
404 };
405
407 .
p.
name =
"bsf_list",
414 };
415
419 };
420
422 {
424 }
425
427 {
429
430 if (!*lst)
431 return;
432
433 for (
i = 0;
i < (*lst)->nb_bsfs; ++
i)
437 }
438
440 {
442 }
443
445 {
449
453
457
460 const char * shorthand[2] = {
NULL};
461
462 if (opt)
463 shorthand[0] = opt->
name;
464
467 goto end;
468 }
469
470 if (options_dict) {
473 goto end;
474 }
475
477
478 end:
481
483 }
484
486 {
488 }
489
491 {
494
495 if ((*lst)->nb_bsfs == 1) {
496 *bsf = (*lst)->bsfs[0];
498 (*lst)->nb_bsfs = 0;
499 goto end;
500 }
501
505
507
508 ctx->bsfs = (*lst)->bsfs;
509 ctx->nb_bsfs = (*lst)->nb_bsfs;
510
511 end:
514 }
515
517 {
518 char *bsf_name, *bsf_options_str;
519
521 if (!bsf_name)
523
525 }
526
528 {
531
534
536 if (!lst)
538
539 do {
544 goto end;
546
548 end:
552 }
553
555 {
556 #if CONFIG_NULL_BSF
559 #else
561 #endif
562 }
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.
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_bsf_free(AVBSFContext **pctx)
Free a bitstream filter context and everything associated with it; write NULL into the supplied point...
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
The bitstream filter state.
static av_always_inline FFBSFContext * ffbsfcontext(AVBSFContext *ctx)
static void * bsf_child_next(void *obj, void *prev)
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.
void av_bsf_flush(AVBSFContext *ctx)
Reset the internal bitstream filter state.
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().
void av_bsf_list_free(AVBSFList **lst)
Free list of bitstream filters.
AVRational time_base_in
The timebase used for the timestamps of the input packets.
int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **pctx)
Allocate a context for a given bitstream filter.
#define LIBAVUTIL_VERSION_INT
int av_bsf_init(AVBSFContext *ctx)
Prepare the filter for use, after all the parameters and options have been set.
Describe the class of an AVClass context structure.
static void flush(AVCodecContext *avctx)
const AVClass * av_bsf_get_class(void)
Get the AVClass for AVBSFContext.
int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt)
Retrieve a filtered packet.
int(* init)(AVBSFContext *ctx)
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)
AVBitStreamFilter p
The public AVBitStreamFilter.
const OptionDef options[]
static const AVClass bsf_class
AVClassCategory category
Category used for visualization (like color) This is only set if the category is equal for all object...
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt)
Submit a packet for filtering.
void(* flush)(AVBSFContext *ctx)
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_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 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 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(* filter)(AVBSFContext *ctx, AVPacket *pkt)
#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.
AVBSFList * av_bsf_list_alloc(void)
Allocate empty list of bitstream filters.
static const FFBitStreamFilter list_bsf
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...
int av_bsf_get_null_filter(AVBSFContext **bsf)
Get null/pass-through bitstream filter.
const FFBitStreamFilter ff_null_bsf
const AVClass * av_class
A class for logging and AVOptions.
void av_bprintf(AVBPrint *buf, const char *fmt,...)
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.
void(* close)(AVBSFContext *ctx)
static void bsf_list_close(AVBSFContext *bsf)
static const av_always_inline FFBitStreamFilter * ff_bsf(const AVBitStreamFilter *bsf)
const struct AVBitStreamFilter * filter
The bitstream filter this context is an instance of.
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...
@ AV_CLASS_CATEGORY_BITSTREAM_FILTER
This structure stores compressed data.
int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf)
Finalize list of bitstream filters.
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_list_append(AVBSFList *lst, AVBSFContext *bsf)
Append bitstream filter to the list of bitstream filters.
const AVBitStreamFilter * av_bsf_get_by_name(const char *name)
Generated on Wed Aug 24 2022 21:41:19 for FFmpeg by
doxygen
1.8.17