FFmpeg
me_cmp.h
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 #ifndef AVCODEC_ME_CMP_H
20 #define AVCODEC_ME_CMP_H
21 
22 #include <stdint.h>
23 
25 
26 #include "avcodec.h"
27 
28 extern const uint32_t attribute_visibility_hidden ff_square_tab[512];
29 
30 
31 /* minimum alignment rules ;)
32  * If you notice errors in the align stuff, need more alignment for some ASM code
33  * for some CPU or need to use a function with less aligned data then send a mail
34  * to the ffmpeg-devel mailing list, ...
35  *
36  * !warning These alignments might not match reality, (missing attribute((align))
37  * stuff somewhere possible).
38  * I (Michael) did not check them, these are just the alignments which I think
39  * could be reached easily ...
40  *
41  * !future video codecs might need functions with less strict alignment
42  */
43 
44 struct MpegEncContext;
45 /* Motion estimation:
46  * h is limited to { width / 2, width, 2 * width },
47  * but never larger than 16 and never smaller than 2.
48  * Although currently h < 4 is not used as functions with
49  * width < 8 are neither used nor implemented. */
50 typedef int (*me_cmp_func)(struct MpegEncContext *c,
51  const uint8_t *blk1 /* align width (8 or 16) */,
52  const uint8_t *blk2 /* align 1 */, ptrdiff_t stride,
53  int h);
54 
55 typedef struct MECmpContext {
56  int (*sum_abs_dctelem)(const int16_t *block /* align 16 */);
57 
58  me_cmp_func sad[6]; /* identical to pix_absAxA except additional void * */
72 
75 } MECmpContext;
76 
85 
86 /**
87  * Fill the function pointer array cmp[6] with me_cmp_funcs from
88  * c based upon type. If mpvenc is not set, an error is returned
89  * if the type of comparison functions requires an initialized
90  * MpegEncContext.
91  */
93  int type, int mpvenc);
94 
96 
97 #endif /* AVCODEC_ME_CMP_H */
MECmpContext::w53
me_cmp_func w53[6]
Definition: me_cmp.h:68
MECmpContext::hadamard8_diff
me_cmp_func hadamard8_diff[6]
Definition: me_cmp.h:60
ff_me_cmp_init_x86
void ff_me_cmp_init_x86(MECmpContext *c, AVCodecContext *avctx)
attribute_visibility_hidden
#define attribute_visibility_hidden
Definition: attributes_internal.h:29
MECmpContext::sum_abs_dctelem
int(* sum_abs_dctelem)(const int16_t *block)
Definition: me_cmp.h:56
ff_me_cmp_init_ppc
void ff_me_cmp_init_ppc(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp.c:726
MECmpContext::bit
me_cmp_func bit[6]
Definition: me_cmp.h:63
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
MECmpContext::vsad
me_cmp_func vsad[6]
Definition: me_cmp.h:65
attributes_internal.h
cmp
static av_always_inline int cmp(MpegEncContext *s, const int x, const int y, const int subx, const int suby, const int size, const int h, int ref_index, int src_index, me_cmp_func cmp_func, me_cmp_func chroma_cmp_func, const int flags)
compares a block (either a full macroblock or a partition thereof) against a proposed motion-compensa...
Definition: motion_est.c:262
ff_me_cmp_init_alpha
void ff_me_cmp_init_alpha(MECmpContext *c, AVCodecContext *avctx)
MECmpContext
Definition: me_cmp.h:55
ff_me_cmp_init_aarch64
void ff_me_cmp_init_aarch64(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp_init_aarch64.c:87
MECmpContext::median_sad
me_cmp_func median_sad[6]
Definition: me_cmp.h:74
MECmpContext::sad
me_cmp_func sad[6]
Definition: me_cmp.h:58
c
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
ff_me_cmp_init_mips
void ff_me_cmp_init_mips(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp_init_mips.c:25
MECmpContext::sse
me_cmp_func sse[6]
Definition: me_cmp.h:59
MECmpContext::dct_sad
me_cmp_func dct_sad[6]
Definition: me_cmp.h:61
MECmpContext::w97
me_cmp_func w97[6]
Definition: me_cmp.h:69
MECmpContext::nsse
me_cmp_func nsse[6]
Definition: me_cmp.h:67
ff_me_cmp_init_arm
void ff_me_cmp_init_arm(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp_init_arm.c:41
MECmpContext::pix_abs
me_cmp_func pix_abs[2][4]
Definition: me_cmp.h:73
MECmpContext::rd
me_cmp_func rd[6]
Definition: me_cmp.h:64
ff_me_cmp_init
void ff_me_cmp_init(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp.c:996
MECmpContext::vsse
me_cmp_func vsse[6]
Definition: me_cmp.h:66
MECmpContext::dct_max
me_cmp_func dct_max[6]
Definition: me_cmp.h:70
ff_set_cmp
int ff_set_cmp(const MECmpContext *c, me_cmp_func *cmp, int type, int mpvenc)
Fill the function pointer array cmp[6] with me_cmp_funcs from c based upon type.
Definition: me_cmp.c:478
ff_square_tab
const uint32_t attribute_visibility_hidden ff_square_tab[512]
Definition: me_cmp.c:37
avcodec.h
stride
#define stride
Definition: h264pred_template.c:537
me_cmp_func
int(* me_cmp_func)(struct MpegEncContext *c, const uint8_t *blk1, const uint8_t *blk2, ptrdiff_t stride, int h)
Definition: me_cmp.h:50
MECmpContext::dct264_sad
me_cmp_func dct264_sad[6]
Definition: me_cmp.h:71
AVCodecContext
main external API structure.
Definition: avcodec.h:451
ff_me_cmp_init_riscv
void ff_me_cmp_init_riscv(MECmpContext *c, AVCodecContext *avctx)
Definition: me_cmp_init.c:80
MECmpContext::quant_psnr
me_cmp_func quant_psnr[6]
Definition: me_cmp.h:62
ff_dsputil_init_dwt
void ff_dsputil_init_dwt(MECmpContext *c)
Definition: snow_dwt.c:843
block
The exact code depends on how similar the blocks are and how related they are to the block
Definition: filter_design.txt:207
h
h
Definition: vp9dsp_template.c:2070
MpegEncContext
MpegEncContext.
Definition: mpegvideo.h:73