FFmpeg
texturedsp.h
Go to the documentation of this file.
1 /*
2  * Texture block module
3  * Copyright (C) 2015 Vittorio Giovara <vittorio.giovara@gmail.com>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /**
23  * @file
24  * Texture block (4x4) module
25  *
26  * References:
27  * https://www.opengl.org/wiki/S3_Texture_Compression
28  * https://www.opengl.org/wiki/Red_Green_Texture_Compression
29  * https://msdn.microsoft.com/en-us/library/bb694531%28v=vs.85%29.aspx
30  *
31  * All functions return how much data has been written or read.
32  *
33  * Pixel input or output format is always AV_PIX_FMT_RGBA.
34  */
35 
36 #ifndef AVCODEC_TEXTUREDSP_H
37 #define AVCODEC_TEXTUREDSP_H
38 
39 #include <stddef.h>
40 #include <stdint.h>
41 
42 #include "avcodec.h"
43 
44 #define TEXTURE_BLOCK_W 4
45 #define TEXTURE_BLOCK_H 4
46 
47 typedef struct TextureDSPContext {
48  int (*dxt1_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
49  int (*dxt1a_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
50  int (*dxt2_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
51  int (*dxt3_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
52  int (*dxt4_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
53  int (*dxt5_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
54  int (*dxt5y_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
55  int (*dxt5ys_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
56  int (*rgtc1s_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
57  int (*rgtc1u_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
58  int (*rgtc1u_gray_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
59  int (*rgtc1u_alpha_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
60  int (*rgtc2s_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
61  int (*rgtc2u_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
62  int (*dxn3dc_block) (uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
64 
65 typedef struct TextureDSPThreadContext {
66  union {
67  const uint8_t *in; // Input frame data
68  uint8_t *out; // Output frame data
69  } frame_data;
70  ptrdiff_t stride; // Frame linesize
71  union {
72  const uint8_t *in; // Compressed texture for decompression
73  uint8_t *out; // Compressed texture of compression
74  } tex_data;
75  int tex_ratio; // Number of compressed bytes in a texture block
76  int raw_ratio; // Number bytes in a line of a raw block
77  int slice_count; // Number of slices for threaded operations
78 
79  /* Pointer to the selected compress or decompress function. */
80  int (*tex_funct)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block);
82 
85 
86 int ff_texturedsp_decompress_thread(AVCodecContext *avctx, void *arg, int slice, int thread_nb);
87 int ff_texturedsp_compress_thread(AVCodecContext *avctx, void *arg, int slice, int thread_nb);
88 
89 #endif /* AVCODEC_TEXTUREDSP_H */
TextureDSPContext::dxt1_block
int(* dxt1_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:48
TextureDSPContext::rgtc1u_alpha_block
int(* rgtc1u_alpha_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:59
TextureDSPContext::rgtc1u_gray_block
int(* rgtc1u_gray_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:58
TextureDSPContext::rgtc2s_block
int(* rgtc2s_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:60
TextureDSPContext::dxt2_block
int(* dxt2_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:50
TextureDSPContext::dxt5ys_block
int(* dxt5ys_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:55
TextureDSPThreadContext::tex_ratio
int tex_ratio
Definition: texturedsp.h:75
TextureDSPContext
Definition: texturedsp.h:47
ff_texturedsp_decompress_thread
int ff_texturedsp_decompress_thread(AVCodecContext *avctx, void *arg, int slice, int thread_nb)
ff_texturedsp_compress_thread
int ff_texturedsp_compress_thread(AVCodecContext *avctx, void *arg, int slice, int thread_nb)
TextureDSPContext::rgtc1u_block
int(* rgtc1u_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:57
TextureDSPThreadContext
Definition: texturedsp.h:65
TextureDSPContext::dxt5_block
int(* dxt5_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:53
TextureDSPContext::dxt1a_block
int(* dxt1a_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:49
TextureDSPThreadContext::out
uint8_t * out
Definition: texturedsp.h:68
TextureDSPContext::dxn3dc_block
int(* dxn3dc_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:62
ff_texturedspenc_init
void ff_texturedspenc_init(TextureDSPContext *c)
Definition: texturedspenc.c:666
arg
const char * arg
Definition: jacosubdec.c:67
TextureDSPThreadContext::stride
ptrdiff_t stride
Definition: texturedsp.h:70
TextureDSPContext::rgtc2u_block
int(* rgtc2u_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:61
TextureDSPContext::dxt4_block
int(* dxt4_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:52
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
TextureDSPThreadContext::tex_data
union TextureDSPThreadContext::@168 tex_data
TextureDSPContext::dxt5y_block
int(* dxt5y_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:54
TextureDSPThreadContext::frame_data
union TextureDSPThreadContext::@167 frame_data
TextureDSPThreadContext::slice_count
int slice_count
Definition: texturedsp.h:77
avcodec.h
stride
#define stride
Definition: h264pred_template.c:537
AVCodecContext
main external API structure.
Definition: avcodec.h:441
TextureDSPContext::dxt3_block
int(* dxt3_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:51
TextureDSPThreadContext::tex_funct
int(* tex_funct)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:80
TextureDSPThreadContext::raw_ratio
int raw_ratio
Definition: texturedsp.h:76
ff_texturedsp_init
void ff_texturedsp_init(TextureDSPContext *c)
Definition: texturedsp.c:637
TextureDSPThreadContext::in
const uint8_t * in
Definition: texturedsp.h:67
block
The exact code depends on how similar the blocks are and how related they are to the block
Definition: filter_design.txt:207
int
int
Definition: ffmpeg_filter.c:368
TextureDSPContext::rgtc1s_block
int(* rgtc1s_block)(uint8_t *dst, ptrdiff_t stride, const uint8_t *block)
Definition: texturedsp.h:56