FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
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 "thread.h"
31 
32 #define MAX_PICTURE_COUNT 36
33 #define EDGE_WIDTH 16
34 
35 typedef struct ScratchpadContext {
36  uint8_t *edge_emu_buffer; ///< temporary buffer for if MVs point to out-of-frame data
37  uint8_t *rd_scratchpad; ///< scratchpad for rate distortion mb decision
39  uint8_t *b_scratchpad; ///< scratchpad used for writing into write only buffers
41 
42 /**
43  * Picture.
44  */
45 typedef struct Picture {
46  struct AVFrame *f;
48 
50  int8_t *qscale_table;
51 
53  int16_t (*motion_val[2])[2];
54 
56  uint32_t *mb_type; ///< types and macros are defined in mpegutils.h
57 
60 
62  int8_t *ref_index[2];
63 
65  uint16_t *mb_var; ///< Table for MB variances
66 
68  uint16_t *mc_mb_var; ///< Table for motion compensated MB variances
69 
70  int alloc_mb_width; ///< mb_width used to allocate tables
71  int alloc_mb_height; ///< mb_height used to allocate tables
72 
74  uint8_t *mb_mean; ///< Table for MB luminance
75 
77  void *hwaccel_picture_private; ///< Hardware accelerator private data
78 
79  int field_picture; ///< whether or not the picture was encoded in separate fields
80 
81  int64_t mb_var_sum; ///< sum of MB variance for current frame
82  int64_t mc_mb_var_sum; ///< motion compensated MB variance for current frame
83 
85  int needs_realloc; ///< Picture needs to be reallocated (eg due to a frame size change)
86 
87  int reference;
88  int shared;
89 
91 } Picture;
92 
93 /**
94  * Allocate a Picture.
95  * The pixels are allocated/set by calling get_buffer() if shared = 0.
96  */
98  ScratchpadContext *sc, int shared, int encoding,
99  int chroma_x_shift, int chroma_y_shift, int out_format,
100  int mb_stride, int mb_width, int mb_height, int b8_stride,
101  ptrdiff_t *linesize, ptrdiff_t *uvlinesize);
102 
104  ScratchpadContext *sc, int linesize);
105 
107 void ff_mpeg_unref_picture(AVCodecContext *avctx, Picture *picture);
108 
111 
112 int ff_find_unused_picture(AVCodecContext *avctx, Picture *picture, int shared);
113 
114 #endif /* AVCODEC_MPEGPICTURE_H */
int ff_update_picture_tables(Picture *dst, Picture *src)
Definition: mpegpicture.c:316
int8_t * ref_index[2]
Definition: mpegpicture.h:62
#define AV_NUM_DATA_POINTERS
Definition: frame.h:219
AVBufferRef * mb_var_buf
Definition: mpegpicture.h:64
This structure describes decoded (raw) audio or video data.
Definition: frame.h:218
uint8_t * mb_mean
Table for MB luminance.
Definition: mpegpicture.h:74
uint8_t * edge_emu_buffer
temporary buffer for if MVs point to out-of-frame data
Definition: mpegpicture.h:36
uint16_t * mb_var
Table for MB variances.
Definition: mpegpicture.h:65
#define me
#define Picture
Definition: videotoolbox.h:34
int needs_realloc
Picture needs to be reallocated (eg due to a frame size change)
Definition: mpegpicture.h:85
int field_picture
whether or not the picture was encoded in separate fields
Definition: mpegpicture.h:79
#define src
Definition: vp8dsp.c:254
int b_frame_score
Definition: mpegpicture.h:84
int alloc_mb_width
mb_width used to allocate tables
Definition: mpegpicture.h:70
uint8_t
int ff_find_unused_picture(AVCodecContext *avctx, Picture *picture, int shared)
Definition: mpegpicture.c:446
Multithreading support functions.
Motion estimation context.
Definition: motion_est.h:47
AVBufferRef * mb_type_buf
Definition: mpegpicture.h:55
AVBufferRef * mb_mean_buf
Definition: mpegpicture.h:73
ThreadFrame tf
Definition: mpegpicture.h:47
uint8_t * mbskip_table
Definition: mpegpicture.h:59
int ff_mpeg_ref_picture(AVCodecContext *avctx, Picture *dst, Picture *src)
Definition: mpegpicture.c:361
uint8_t * rd_scratchpad
scratchpad for rate distortion mb decision
Definition: mpegpicture.h:37
uint64_t encoding_error[AV_NUM_DATA_POINTERS]
Definition: mpegpicture.h:90
void ff_free_picture_tables(Picture *pic)
Definition: mpegpicture.c:460
int reference
Definition: mpegpicture.h:87
reference-counted frame API
AVBufferRef * hwaccel_priv_buf
Definition: mpegpicture.h:76
AVBufferRef * motion_val_buf[2]
Definition: mpegpicture.h:52
int16_t(*[2] motion_val)[2]
Definition: mpegpicture.h:53
Picture.
Definition: mpegpicture.h:45
void * hwaccel_picture_private
Hardware accelerator private data.
Definition: mpegpicture.h:77
void ff_mpeg_unref_picture(AVCodecContext *avctx, Picture *picture)
Deallocate a picture.
Definition: mpegpicture.c:294
int ff_alloc_picture(AVCodecContext *avctx, Picture *pic, MotionEstContext *me, ScratchpadContext *sc, int shared, int encoding, int chroma_x_shift, int chroma_y_shift, int out_format, int mb_stride, int mb_width, int mb_height, int b8_stride, ptrdiff_t *linesize, ptrdiff_t *uvlinesize)
Allocate a Picture.
Definition: mpegpicture.c:231
uint16_t * mc_mb_var
Table for motion compensated MB variances.
Definition: mpegpicture.h:68
AVBufferRef * qscale_table_buf
Definition: mpegpicture.h:49
int alloc_mb_height
mb_height used to allocate tables
Definition: mpegpicture.h:71
Libavcodec external API header.
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:249
main external API structure.
Definition: avcodec.h:1518
int64_t mc_mb_var_sum
motion compensated MB variance for current frame
Definition: mpegpicture.h:82
struct AVFrame * f
Definition: mpegpicture.h:46
int ff_mpeg_framesize_alloc(AVCodecContext *avctx, MotionEstContext *me, ScratchpadContext *sc, int linesize)
Definition: mpegpicture.c:57
int8_t * qscale_table
Definition: mpegpicture.h:50
A reference to a data buffer.
Definition: buffer.h:81
AVBufferRef * mbskip_table_buf
Definition: mpegpicture.h:58
int shared
Definition: mpegpicture.h:88
uint8_t * b_scratchpad
scratchpad used for writing into write only buffers
Definition: mpegpicture.h:39
uint8_t * obmc_scratchpad
Definition: mpegpicture.h:38
AVBufferRef * mc_mb_var_buf
Definition: mpegpicture.h:67
uint32_t * mb_type
types and macros are defined in mpegutils.h
Definition: mpegpicture.h:56
int64_t mb_var_sum
sum of MB variance for current frame
Definition: mpegpicture.h:81
AVBufferRef * ref_index_buf[2]
Definition: mpegpicture.h:61