Merge branch 'master' into blender2.8
[blender.git] / source / blender / gpu / GPU_compositing.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program 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
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2005 Blender Foundation.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Antony Riakiotakis.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file GPU_compositing.h
29  *  \ingroup gpu
30  */
31
32 #ifndef __GPU_COMPOSITING_H__
33 #define __GPU_COMPOSITING_H__
34
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38
39 /* opaque handle for framebuffer compositing effects (defined in gpu_compositing.c )*/
40 typedef struct GPUFX GPUFX;
41 struct GPUDOFSettings;
42 struct GPUSSAOSettings;
43 struct GPUOffScreen;
44 struct GPUFXSettings;
45 struct rcti;
46 struct Scene;
47 struct GPUShader;
48 enum eGPUFXFlags;
49
50 /**** Public API *****/
51
52 typedef enum GPUFXShaderEffect {
53         /* Screen space ambient occlusion shader */
54         GPU_SHADER_FX_SSAO = 1,
55
56         /* depth of field passes. Yep, quite a complex effect */
57         GPU_SHADER_FX_DEPTH_OF_FIELD_PASS_ONE = 2,
58         GPU_SHADER_FX_DEPTH_OF_FIELD_PASS_TWO = 3,
59         GPU_SHADER_FX_DEPTH_OF_FIELD_PASS_THREE = 4,
60         GPU_SHADER_FX_DEPTH_OF_FIELD_PASS_FOUR = 5,
61         GPU_SHADER_FX_DEPTH_OF_FIELD_PASS_FIVE = 6,
62
63         /* high quality */
64         GPU_SHADER_FX_DEPTH_OF_FIELD_HQ_PASS_ONE = 7,
65         GPU_SHADER_FX_DEPTH_OF_FIELD_HQ_PASS_TWO = 8,
66         GPU_SHADER_FX_DEPTH_OF_FIELD_HQ_PASS_THREE = 9,
67
68         GPU_SHADER_FX_DEPTH_RESOLVE = 10,
69 } GPUFXShaderEffect;
70
71 /* keep in synch with enum above! */
72 #define MAX_FX_SHADERS 11
73
74 /* generate a new FX compositor */
75 GPUFX *GPU_fx_compositor_create(void);
76
77 /* destroy a text compositor */
78 void GPU_fx_compositor_destroy(GPUFX *fx);
79
80 /* initialize a framebuffer with size taken from the viewport */
81 bool GPU_fx_compositor_initialize_passes(
82         GPUFX *fx, const struct rcti *rect, const struct rcti *scissor_rect,
83         const struct GPUFXSettings *fx_settings);
84
85 /* do compositing on the fx passes that have been initialized */
86 bool GPU_fx_do_composite_pass(
87         GPUFX *fx, float projmat[4][4], bool is_persp,
88         struct Scene *scene, struct GPUOffScreen *ofs);
89
90 /* bind new depth buffer for XRay pass */
91 void GPU_fx_compositor_setup_XRay_pass(GPUFX *fx, bool do_xray);
92
93 /* resolve a final depth buffer by compositing the XRay and normal depth buffers */
94 void GPU_fx_compositor_XRay_resolve(GPUFX *fx);
95
96 void GPU_fx_compositor_init_dof_settings(struct GPUDOFSettings *dof);
97 void GPU_fx_compositor_init_ssao_settings(struct GPUSSAOSettings *ssao);
98
99
100 /* initialize and cache the shader unform interface for effects */
101 void GPU_fx_shader_init_interface(struct GPUShader *shader, GPUFXShaderEffect effect);
102 #ifdef __cplusplus
103 }
104 #endif
105
106 #endif // __GPU_COMPOSITING_H__