FFmpeg
mpegpicture.h
Go to the documentation of this file.
1 /*
2  * Mpeg video formats-related defines and utility functions
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
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
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #ifndef AVCODEC_MPEGPICTURE_H
22 #define AVCODEC_MPEGPICTURE_H
23 
24 #include <stdint.h>
25 
26 #include "libavutil/frame.h"
27 
28 #include "avcodec.h"
29 #include "motion_est.h"
30 #include "threadframe.h"
31 
32 #define MPEGVIDEO_MAX_PLANES 4
33 #define MAX_PICTURE_COUNT 36
34 #define EDGE_WIDTH 16
35 
36 typedef struct ScratchpadContext {
37  uint8_t *edge_emu_buffer; ///< temporary buffer for if MVs point to out-of-frame data
38  uint8_t *rd_scratchpad; ///< scratchpad for rate distortion mb decision
39  uint8_t *obmc_scratchpad;
40  uint8_t *b_scratchpad; ///< scratchpad used for writing into write only buffers
42 
43 /**
44  * Picture.
45  */
46 typedef struct Picture {
47  struct AVFrame *f;
49 
51  int8_t *qscale_table;
52 
54  int16_t (*motion_val[2])[2];
55 
57  uint32_t *mb_type; ///< types and macros are defined in mpegutils.h
58 
60  uint8_t *mbskip_table;
61 
63  int8_t *ref_index[2];
64 
65  int alloc_mb_width; ///< mb_width used to allocate tables
66  int alloc_mb_height; ///< mb_height used to allocate tables
67  int alloc_mb_stride; ///< mb_stride used to allocate tables
68 
69  /// RefStruct reference for hardware accelerator private data
71 
72  int field_picture; ///< whether or not the picture was encoded in separate fields
73 
75  int needs_realloc; ///< Picture needs to be reallocated (eg due to a frame size change)
76 
77  int reference;
78  int shared;
79 
82 } Picture;
83 
84 /**
85  * Allocate a Picture's accessories, but not the AVFrame's buffer itself.
86  */
88  ScratchpadContext *sc, int encoding, int out_format,
89  int mb_stride, int mb_width, int mb_height, int b8_stride,
90  ptrdiff_t *linesize, ptrdiff_t *uvlinesize);
91 
93  ScratchpadContext *sc, int linesize);
94 
96 void ff_mpeg_unref_picture(Picture *picture);
97 
98 void ff_mpv_picture_free(Picture *pic);
100 
101 int ff_find_unused_picture(AVCodecContext *avctx, Picture *picture, int shared);
102 
103 #endif /* AVCODEC_MPEGPICTURE_H */
Picture
#define Picture
Definition: videotoolbox.h:43
Picture::ref_index_buf
AVBufferRef * ref_index_buf[2]
Definition: mpegpicture.h:62
ScratchpadContext::obmc_scratchpad
uint8_t * obmc_scratchpad
Definition: mpegpicture.h:39
ScratchpadContext::rd_scratchpad
uint8_t * rd_scratchpad
scratchpad for rate distortion mb decision
Definition: mpegpicture.h:38
ff_mpeg_framesize_alloc
int ff_mpeg_framesize_alloc(AVCodecContext *avctx, MotionEstContext *me, ScratchpadContext *sc, int linesize)
Definition: mpegpicture.c:87
MotionEstContext
Motion estimation context.
Definition: motion_est.h:47
Picture::alloc_mb_width
int alloc_mb_width
mb_width used to allocate tables
Definition: mpegpicture.h:65
Picture::field_picture
int field_picture
whether or not the picture was encoded in separate fields
Definition: mpegpicture.h:72
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:344
Picture::ref_index
int8_t * ref_index[2]
Definition: mpegpicture.h:63
Picture
Picture.
Definition: mpegpicture.h:46
ScratchpadContext
Definition: mpegpicture.h:36
Picture::needs_realloc
int needs_realloc
Picture needs to be reallocated (eg due to a frame size change)
Definition: mpegpicture.h:75
Picture::mbskip_table
uint8_t * mbskip_table
Definition: mpegpicture.h:60
motion_est.h
Picture::b_frame_score
int b_frame_score
Definition: mpegpicture.h:74
ff_mpeg_unref_picture
void ff_mpeg_unref_picture(Picture *picture)
Deallocate a picture; frees the picture tables in case they need to be reallocated anyway.
Definition: mpegpicture.c:253
ff_find_unused_picture
int ff_find_unused_picture(AVCodecContext *avctx, Picture *picture, int shared)
Definition: mpegpicture.c:380
Picture::hwaccel_picture_private
void * hwaccel_picture_private
RefStruct reference for hardware accelerator private data.
Definition: mpegpicture.h:70
Picture::reference
int reference
Definition: mpegpicture.h:77
Picture::mb_type_buf
AVBufferRef * mb_type_buf
Definition: mpegpicture.h:56
threadframe.h
ff_mpv_picture_free
void ff_mpv_picture_free(Picture *pic)
Definition: mpegpicture.c:392
me
#define me
Definition: vf_colormatrix.c:102
Picture::motion_val_buf
AVBufferRef * motion_val_buf[2]
Definition: mpegpicture.h:53
Picture::tf
ThreadFrame tf
Definition: mpegpicture.h:48
Picture::display_picture_number
int display_picture_number
Definition: mpegpicture.h:80
ff_alloc_picture
int ff_alloc_picture(AVCodecContext *avctx, Picture *pic, MotionEstContext *me, ScratchpadContext *sc, int encoding, int out_format, int mb_stride, int mb_width, int mb_height, int b8_stride, ptrdiff_t *linesize, ptrdiff_t *uvlinesize)
Allocate a Picture's accessories, but not the AVFrame's buffer itself.
Definition: mpegpicture.c:203
Picture::qscale_table_buf
AVBufferRef * qscale_table_buf
Definition: mpegpicture.h:50
ff_update_picture_tables
int ff_update_picture_tables(Picture *dst, const Picture *src)
Definition: mpegpicture.c:272
Picture::alloc_mb_height
int alloc_mb_height
mb_height used to allocate tables
Definition: mpegpicture.h:66
frame.h
Picture::motion_val
int16_t(*[2] motion_val)[2]
Definition: mpegpicture.h:54
ff_mpeg_ref_picture
int ff_mpeg_ref_picture(Picture *dst, Picture *src)
Definition: mpegpicture.c:304
avcodec.h
Picture::qscale_table
int8_t * qscale_table
Definition: mpegpicture.h:51
Picture::coded_picture_number
int coded_picture_number
Definition: mpegpicture.h:81
AVCodecContext
main external API structure.
Definition: avcodec.h:445
Picture::shared
int shared
Definition: mpegpicture.h:78
ScratchpadContext::edge_emu_buffer
uint8_t * edge_emu_buffer
temporary buffer for if MVs point to out-of-frame data
Definition: mpegpicture.h:37
Picture::mb_type
uint32_t * mb_type
types and macros are defined in mpegutils.h
Definition: mpegpicture.h:57
ThreadFrame
Definition: threadframe.h:27
Picture::f
struct AVFrame * f
Definition: mpegpicture.h:47
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
Definition: frame.h:389
Picture::mbskip_table_buf
AVBufferRef * mbskip_table_buf
Definition: mpegpicture.h:59
ScratchpadContext::b_scratchpad
uint8_t * b_scratchpad
scratchpad used for writing into write only buffers
Definition: mpegpicture.h:40
Picture::alloc_mb_stride
int alloc_mb_stride
mb_stride used to allocate tables
Definition: mpegpicture.h:67