]> git.sesse.net Git - ffmpeg/blob - libavfilter/v360.h
avfilter/vf_v360: add cylindrical output projection
[ffmpeg] / libavfilter / v360.h
1 /*
2  * Copyright (c) 2019 Eugene Lyapustin
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 AVFILTER_V360_H
22 #define AVFILTER_V360_H
23 #include "avfilter.h"
24
25 enum StereoFormats {
26     STEREO_2D,
27     STEREO_SBS,
28     STEREO_TB,
29     NB_STEREO_FMTS,
30 };
31
32 enum Projections {
33     EQUIRECTANGULAR,
34     CUBEMAP_3_2,
35     CUBEMAP_6_1,
36     EQUIANGULAR,
37     FLAT,
38     DUAL_FISHEYE,
39     BARREL,
40     CUBEMAP_1_6,
41     STEREOGRAPHIC,
42     MERCATOR,
43     BALL,
44     HAMMER,
45     SINUSOIDAL,
46     FISHEYE,
47     PANNINI,
48     CYLINDRICAL,
49     NB_PROJECTIONS,
50 };
51
52 enum InterpMethod {
53     NEAREST,
54     BILINEAR,
55     BICUBIC,
56     LANCZOS,
57     NB_INTERP_METHODS,
58 };
59
60 enum Faces {
61     TOP_LEFT,
62     TOP_MIDDLE,
63     TOP_RIGHT,
64     BOTTOM_LEFT,
65     BOTTOM_MIDDLE,
66     BOTTOM_RIGHT,
67     NB_FACES,
68 };
69
70 enum Direction {
71     RIGHT,  ///< Axis +X
72     LEFT,   ///< Axis -X
73     UP,     ///< Axis +Y
74     DOWN,   ///< Axis -Y
75     FRONT,  ///< Axis -Z
76     BACK,   ///< Axis +Z
77     NB_DIRECTIONS,
78 };
79
80 enum Rotation {
81     ROT_0,
82     ROT_90,
83     ROT_180,
84     ROT_270,
85     NB_ROTATIONS,
86 };
87
88 enum RotationOrder {
89     YAW,
90     PITCH,
91     ROLL,
92     NB_RORDERS,
93 };
94
95 typedef struct XYRemap {
96     uint16_t u[4][4];
97     uint16_t v[4][4];
98     float ker[4][4];
99 } XYRemap;
100
101 typedef struct V360Context {
102     const AVClass *class;
103     int in, out;
104     int interp;
105     int width, height;
106     char *in_forder;
107     char *out_forder;
108     char *in_frot;
109     char *out_frot;
110     char *rorder;
111
112     int in_cubemap_face_order[6];
113     int out_cubemap_direction_order[6];
114     int in_cubemap_face_rotation[6];
115     int out_cubemap_face_rotation[6];
116     int rotation_order[3];
117
118     int in_stereo, out_stereo;
119
120     float in_pad, out_pad;
121     int fin_pad, fout_pad;
122
123     float yaw, pitch, roll;
124
125     int ih_flip, iv_flip;
126     int h_flip, v_flip, d_flip;
127     int in_transpose, out_transpose;
128
129     float h_fov, v_fov, d_fov;
130     float flat_range[2];
131
132     float rot_mat[3][3];
133
134     float input_mirror_modifier[2];
135     float output_mirror_modifier[3];
136
137     int in_width, in_height;
138     int out_width, out_height;
139
140     int pr_width[4], pr_height[4];
141
142     int in_offset_w[4], in_offset_h[4];
143     int out_offset_w[4], out_offset_h[4];
144
145     int planewidth[4], planeheight[4];
146     int inplanewidth[4], inplaneheight[4];
147     int uv_linesize[4];
148     int nb_planes;
149     int nb_allocated;
150     int elements;
151
152     uint16_t *u[2], *v[2];
153     int16_t *ker[2];
154     unsigned map[4];
155
156     void (*in_transform)(const struct V360Context *s,
157                          const float *vec, int width, int height,
158                          uint16_t us[4][4], uint16_t vs[4][4], float *du, float *dv);
159
160     void (*out_transform)(const struct V360Context *s,
161                           int i, int j, int width, int height,
162                           float *vec);
163
164     void (*calculate_kernel)(float du, float dv, const XYRemap *rmap,
165                              uint16_t *u, uint16_t *v, int16_t *ker);
166
167     int (*remap_slice)(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs);
168
169     void (*remap_line)(uint8_t *dst, int width, const uint8_t *src, ptrdiff_t in_linesize,
170                        const uint16_t *u, const uint16_t *v, const int16_t *ker);
171 } V360Context;
172
173 void ff_v360_init(V360Context *s, int depth);
174 void ff_v360_init_x86(V360Context *s, int depth);
175
176 #endif /* AVFILTER_V360_H */