FFmpeg
idctdsp.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_IDCTDSP_H
20 #define AVCODEC_IDCTDSP_H
21 
22 #include <stddef.h>
23 #include <stdint.h>
24 
25 struct AVCodecContext;
26 
34 };
35 
36 void ff_permute_scantable(uint8_t dst[64], const uint8_t src[64],
37  const uint8_t permutation[64]);
38 void ff_init_scantable_permutation(uint8_t *idct_permutation,
39  enum idct_permutation_type perm_type);
40 int ff_init_scantable_permutation_x86(uint8_t *idct_permutation,
41  enum idct_permutation_type perm_type);
42 
43 typedef struct IDCTDSPContext {
44  /* pixel ops : interface with DCT */
45  void (*put_pixels_clamped)(const int16_t *block /* align 16 */,
46  uint8_t *restrict pixels /* align 8 */,
47  ptrdiff_t line_size);
48  void (*put_signed_pixels_clamped)(const int16_t *block /* align 16 */,
49  uint8_t *restrict pixels /* align 8 */,
50  ptrdiff_t line_size);
51  void (*add_pixels_clamped)(const int16_t *block /* align 16 */,
52  uint8_t *restrict pixels /* align 8 */,
53  ptrdiff_t line_size);
54 
55  void (*idct)(int16_t *block /* align 16 */);
56 
57  /**
58  * block -> idct -> clip to unsigned 8 bit -> dest.
59  * (-1392, 0, 0, ...) -> idct -> (-174, -174, ...) -> put -> (0, 0, ...)
60  * @param line_size size in bytes of a horizontal line of dest
61  */
62  void (*idct_put)(uint8_t *dest /* align 8 */,
63  ptrdiff_t line_size, int16_t *block /* align 16 */);
64 
65  /**
66  * block -> idct -> add dest -> clip to unsigned 8 bit -> dest.
67  * @param line_size size in bytes of a horizontal line of dest
68  */
69  void (*idct_add)(uint8_t *dest /* align 8 */,
70  ptrdiff_t line_size, int16_t *block /* align 16 */);
71 
72  /**
73  * IDCT input permutation.
74  * Several optimized IDCTs need a permutated input (relative to the
75  * normal order of the reference IDCT).
76  * This permutation must be performed before the idct_put/add.
77  * Note, normally this can be merged with the zigzag/alternate scan<br>
78  * An example to avoid confusion:
79  * - (->decode coeffs -> zigzag reorder -> dequant -> reference IDCT -> ...)
80  * - (x -> reference DCT -> reference IDCT -> x)
81  * - (x -> reference DCT -> simple_mmx_perm = idct_permutation
82  * -> simple_idct_mmx -> x)
83  * - (-> decode coeffs -> zigzag reorder -> simple_mmx_perm -> dequant
84  * -> simple_idct_mmx -> ...)
85  */
86  uint8_t idct_permutation[64];
88 
91 
92 void ff_put_pixels_clamped_c(const int16_t *block, uint8_t *restrict pixels,
93  ptrdiff_t line_size);
94 void ff_add_pixels_clamped_c(const int16_t *block, uint8_t *restrict pixels,
95  ptrdiff_t line_size);
96 
97 void ff_idctdsp_init(IDCTDSPContext *c, struct AVCodecContext *avctx);
98 
100  unsigned high_bit_depth);
102  unsigned high_bit_depth);
104  unsigned high_bit_depth);
106  unsigned high_bit_depth);
108  unsigned high_bit_depth);
110  unsigned high_bit_depth);
112  unsigned high_bit_depth);
114  unsigned high_bit_depth);
115 
116 #endif /* AVCODEC_IDCTDSP_H */
ff_init_scantable_permutation_x86
int ff_init_scantable_permutation_x86(uint8_t *idct_permutation, enum idct_permutation_type perm_type)
Definition: idctdsp_init.c:42
ff_idctdsp_init
void ff_idctdsp_init(IDCTDSPContext *c, struct AVCodecContext *avctx)
Definition: idctdsp.c:228
IDCTDSPContext::mpeg4_studio_profile
int mpeg4_studio_profile
Definition: idctdsp.h:89
IDCTDSPContext::idct_add
void(* idct_add)(uint8_t *dest, ptrdiff_t line_size, int16_t *block)
block -> idct -> add dest -> clip to unsigned 8 bit -> dest.
Definition: idctdsp.h:69
ff_put_pixels_clamped_c
void ff_put_pixels_clamped_c(const int16_t *block, uint8_t *restrict pixels, ptrdiff_t line_size)
Definition: idctdsp.c:73
IDCTDSPContext::idct
void(* idct)(int16_t *block)
Definition: idctdsp.h:55
IDCTDSPContext::idct_put
void(* idct_put)(uint8_t *dest, ptrdiff_t line_size, int16_t *block)
block -> idct -> clip to unsigned 8 bit -> dest.
Definition: idctdsp.h:62
ff_idctdsp_init_riscv
void ff_idctdsp_init_riscv(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init.c:36
ff_idctdsp_init_alpha
void ff_idctdsp_init_alpha(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_alpha.c:109
ff_permute_scantable
void ff_permute_scantable(uint8_t dst[64], const uint8_t src[64], const uint8_t permutation[64])
Definition: idctdsp.c:30
ff_init_scantable_permutation
void ff_init_scantable_permutation(uint8_t *idct_permutation, enum idct_permutation_type perm_type)
Definition: idctdsp.c:39
ff_add_pixels_clamped_c
void ff_add_pixels_clamped_c(const int16_t *block, uint8_t *restrict pixels, ptrdiff_t line_size)
Definition: idctdsp.c:147
ff_idctdsp_init_x86
void ff_idctdsp_init_x86(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init.c:63
IDCTDSPContext::put_signed_pixels_clamped
void(* put_signed_pixels_clamped)(const int16_t *block, uint8_t *restrict pixels, ptrdiff_t line_size)
Definition: idctdsp.h:48
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
IDCTDSPContext::add_pixels_clamped
void(* add_pixels_clamped)(const int16_t *block, uint8_t *restrict pixels, ptrdiff_t line_size)
Definition: idctdsp.h:51
ff_idctdsp_init_mips
void ff_idctdsp_init_mips(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init_mips.c:27
IDCTDSPContext::put_pixels_clamped
void(* put_pixels_clamped)(const int16_t *block, uint8_t *restrict pixels, ptrdiff_t line_size)
Definition: idctdsp.h:45
FF_IDCT_PERM_NONE
@ FF_IDCT_PERM_NONE
Definition: idctdsp.h:28
ff_idctdsp_init_ppc
void ff_idctdsp_init_ppc(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp.c:256
FF_IDCT_PERM_TRANSPOSE
@ FF_IDCT_PERM_TRANSPOSE
Definition: idctdsp.h:31
IDCTDSPContext
Definition: idctdsp.h:43
ff_idctdsp_init_aarch64
void ff_idctdsp_init_aarch64(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init_aarch64.c:34
FF_IDCT_PERM_SSE2
@ FF_IDCT_PERM_SSE2
Definition: idctdsp.h:33
AVCodecContext
main external API structure.
Definition: avcodec.h:445
FF_IDCT_PERM_PARTTRANS
@ FF_IDCT_PERM_PARTTRANS
Definition: idctdsp.h:32
idct_permutation_type
idct_permutation_type
Definition: idctdsp.h:27
IDCTDSPContext::perm_type
enum idct_permutation_type perm_type
Definition: idctdsp.h:87
IDCTDSPContext::idct_permutation
uint8_t idct_permutation[64]
IDCT input permutation.
Definition: idctdsp.h:86
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
block
The exact code depends on how similar the blocks are and how related they are to the block
Definition: filter_design.txt:207
FF_IDCT_PERM_SIMPLE
@ FF_IDCT_PERM_SIMPLE
Definition: idctdsp.h:30
ff_idctdsp_init_arm
void ff_idctdsp_init_arm(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init_arm.c:66
FF_IDCT_PERM_LIBMPEG2
@ FF_IDCT_PERM_LIBMPEG2
Definition: idctdsp.h:29
ff_idctdsp_init_loongarch
void ff_idctdsp_init_loongarch(IDCTDSPContext *c, struct AVCodecContext *avctx, unsigned high_bit_depth)
Definition: idctdsp_init_loongarch.c:26