xref: /third_party/ffmpeg/libavcodec/videodsp.h (revision cabdff1a)
1/*
2 * Copyright (C) 2012 Ronald S. Bultje
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/**
22 * @file
23 * Core video DSP helper functions
24 */
25
26#ifndef AVCODEC_VIDEODSP_H
27#define AVCODEC_VIDEODSP_H
28
29#include <stddef.h>
30#include <stdint.h>
31
32#define EMULATED_EDGE(depth) \
33void ff_emulated_edge_mc_ ## depth(uint8_t *dst, const uint8_t *src, \
34                                   ptrdiff_t dst_stride, ptrdiff_t src_stride, \
35                                   int block_w, int block_h,\
36                                   int src_x, int src_y, int w, int h);
37
38EMULATED_EDGE(8)
39
40typedef struct VideoDSPContext {
41    /**
42     * Copy a rectangular area of samples to a temporary buffer and replicate
43     * the border samples.
44     *
45     * @param dst destination buffer
46     * @param dst_stride number of bytes between 2 vertically adjacent samples
47     *                   in destination buffer
48     * @param src source buffer
49     * @param dst_linesize number of bytes between 2 vertically adjacent
50     *                     samples in the destination buffer
51     * @param src_linesize number of bytes between 2 vertically adjacent
52     *                     samples in both the source buffer
53     * @param block_w width of block
54     * @param block_h height of block
55     * @param src_x x coordinate of the top left sample of the block in the
56     *                source buffer
57     * @param src_y y coordinate of the top left sample of the block in the
58     *                source buffer
59     * @param w width of the source buffer
60     * @param h height of the source buffer
61     */
62    void (*emulated_edge_mc)(uint8_t *dst, const uint8_t *src,
63                             ptrdiff_t dst_linesize,
64                             ptrdiff_t src_linesize,
65                             int block_w, int block_h,
66                             int src_x, int src_y, int w, int h);
67
68    /**
69     * Prefetch memory into cache (if supported by hardware).
70     *
71     * @param buf    pointer to buffer to prefetch memory from
72     * @param stride distance between two lines of buf (in bytes)
73     * @param h      number of lines to prefetch
74     */
75    void (*prefetch)(uint8_t *buf, ptrdiff_t stride, int h);
76} VideoDSPContext;
77
78void ff_videodsp_init(VideoDSPContext *ctx, int bpc);
79
80/* for internal use only (i.e. called by ff_videodsp_init() */
81void ff_videodsp_init_aarch64(VideoDSPContext *ctx, int bpc);
82void ff_videodsp_init_arm(VideoDSPContext *ctx, int bpc);
83void ff_videodsp_init_ppc(VideoDSPContext *ctx, int bpc);
84void ff_videodsp_init_x86(VideoDSPContext *ctx, int bpc);
85void ff_videodsp_init_mips(VideoDSPContext *ctx, int bpc);
86void ff_videodsp_init_loongarch(VideoDSPContext *ctx, int bpc);
87
88#endif /* AVCODEC_VIDEODSP_H */
89