bf5f7c1d0dacf206a6d9104b74e43751df93d6fb
[blender.git] / source / blender / makesdna / DNA_scene_types.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) 2001-2002 by NaN Holding BV.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): none yet.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file DNA_scene_types.h
29  *  \ingroup DNA
30  */
31
32 #ifndef __DNA_SCENE_TYPES_H__
33 #define __DNA_SCENE_TYPES_H__
34
35 #include "DNA_defs.h"
36
37 /* XXX, temp feature - campbell */
38 #define DURIAN_CAMERA_SWITCH
39
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43
44 #include "DNA_color_types.h"  /* color management */
45 #include "DNA_vec_types.h"
46 #include "DNA_listBase.h"
47 #include "DNA_ID.h"
48 #include "DNA_freestyle_types.h"
49 #include "DNA_gpu_types.h"
50 #include "DNA_layer_types.h"
51 #include "DNA_material_types.h"
52 #include "DNA_userdef_types.h"
53
54 struct CurveMapping;
55 struct Object;
56 struct Brush;
57 struct World;
58 struct Scene;
59 struct Image;
60 struct Group;
61 struct Text;
62 struct bNodeTree;
63 struct AnimData;
64 struct Editing;
65 struct SceneStats;
66 struct bGPdata;
67 struct bGPDbrush;
68 struct MovieClip;
69 struct ColorSpace;
70 struct SceneCollection;
71
72 /* ************************************************************* */
73 /* Scene Data */
74
75 /* ************************************************************* */
76 /* Output Format Data */
77
78 typedef struct AviCodecData {
79         void                    *lpFormat;  /* save format */
80         void                    *lpParms;   /* compressor options */
81         unsigned int    cbFormat;           /* size of lpFormat buffer */
82         unsigned int    cbParms;            /* size of lpParms buffer */
83
84         unsigned int    fccType;            /* stream type, for consistency */
85         unsigned int    fccHandler;         /* compressor */
86         unsigned int    dwKeyFrameEvery;    /* keyframe rate */
87         unsigned int    dwQuality;          /* compress quality 0-10,000 */
88         unsigned int    dwBytesPerSecond;   /* bytes per second */
89         unsigned int    dwFlags;            /* flags... see below */
90         unsigned int    dwInterleaveEvery;  /* for non-video streams only */
91         unsigned int    pad;
92
93         char                    avicodecname[128];
94 } AviCodecData;
95
96 typedef enum eFFMpegPreset {
97         FFM_PRESET_NONE,
98         FFM_PRESET_ULTRAFAST,
99         FFM_PRESET_SUPERFAST,
100         FFM_PRESET_VERYFAST,
101         FFM_PRESET_FASTER,
102         FFM_PRESET_FAST,
103         FFM_PRESET_MEDIUM,
104         FFM_PRESET_SLOW,
105         FFM_PRESET_SLOWER,
106         FFM_PRESET_VERYSLOW,
107 } eFFMpegPreset;
108
109
110 /* Mapping from easily-understandable descriptions to CRF values.
111  * Assumes we output 8-bit video. Needs to be remapped if 10-bit
112  * is output.
113  * We use a slightly wider than "subjectively sane range" according
114  * to https://trac.ffmpeg.org/wiki/Encode/H.264#a1.ChooseaCRFvalue
115  */
116 typedef enum eFFMpegCrf {
117         FFM_CRF_NONE = -1,
118         FFM_CRF_LOSSLESS = 0,
119         FFM_CRF_PERC_LOSSLESS = 17,
120         FFM_CRF_HIGH = 20,
121         FFM_CRF_MEDIUM = 23,
122         FFM_CRF_LOW = 26,
123         FFM_CRF_VERYLOW = 29,
124         FFM_CRF_LOWEST = 32,
125 } eFFMpegCrf;
126
127 typedef struct FFMpegCodecData {
128         int type;
129         int codec;
130         int audio_codec;
131         int video_bitrate;
132         int audio_bitrate;
133         int audio_mixrate;
134         int audio_channels;
135         int audio_pad;
136         float audio_volume;
137         int gop_size;
138         int max_b_frames; /* only used if FFMPEG_USE_MAX_B_FRAMES flag is set. */
139         int flags;
140         int constant_rate_factor;
141         int ffmpeg_preset; /* see eFFMpegPreset */
142
143         int rc_min_rate;
144         int rc_max_rate;
145         int rc_buffer_size;
146         int mux_packet_size;
147         int mux_rate;
148         int pad1;
149
150         IDProperty *properties;
151 } FFMpegCodecData;
152
153 /* ************************************************************* */
154 /* Audio */
155
156 typedef struct AudioData {
157         int mixrate; // 2.5: now in FFMpegCodecData: audio_mixrate
158         float main; // 2.5: now in FFMpegCodecData: audio_volume
159         float speed_of_sound;
160         float doppler_factor;
161         int distance_model;
162         short flag;
163         short pad;
164         float volume;
165         float pad2;
166 } AudioData;
167
168 /* *************************************************************** */
169 /* Render Layers */
170
171 /* Render Layer */
172 typedef struct SceneRenderLayer {
173         struct SceneRenderLayer *next, *prev;
174         
175         char name[64] DNA_DEPRECATED;   /* MAX_NAME */
176         
177         struct Material *mat_override DNA_DEPRECATED; /* Converted to ViewLayer override. */
178         
179         unsigned int lay DNA_DEPRECATED; /* Converted to LayerCollection cycles camera visibility override. */
180         unsigned int lay_zmask DNA_DEPRECATED; /* Converted to LayerCollection cycles holdout override. */
181         unsigned int lay_exclude DNA_DEPRECATED;
182         int layflag DNA_DEPRECATED; /* Converted to ViewLayer layflag and flag. */
183
184         /* pass_xor has to be after passflag */
185         int passflag DNA_DEPRECATED; /* pass_xor has to be after passflag */
186         int pass_xor DNA_DEPRECATED; /* Converted to ViewLayer passflag and flag. */
187
188         int samples DNA_DEPRECATED; /* Converted to ViewLayer override. */
189         float pass_alpha_threshold DNA_DEPRECATED; /* Converted to ViewLayer pass_alpha_threshold. */
190
191         IDProperty *prop DNA_DEPRECATED; /* Converted to ViewLayer id_properties. */
192
193         struct FreestyleConfig freestyleConfig DNA_DEPRECATED; /* Converted to ViewLayer freestyleConfig. */
194 } SceneRenderLayer;
195
196 /* SceneRenderLayer.layflag */
197 #define SCE_LAY_SOLID   1
198 #define SCE_LAY_ZTRA    2
199 #define SCE_LAY_HALO    4
200 #define SCE_LAY_EDGE    8
201 #define SCE_LAY_SKY             16
202 #define SCE_LAY_STRAND  32
203 #define SCE_LAY_FRS             64
204 #define SCE_LAY_AO              128
205         /* flags between 256 and 0x8000 are set to 1 already, for future options */
206
207 #define SCE_LAY_ALL_Z           0x8000
208 #define SCE_LAY_XOR                     0x10000
209 #define SCE_LAY_DISABLE         0x20000
210 #define SCE_LAY_ZMASK           0x40000
211 #define SCE_LAY_NEG_ZMASK       0x80000
212
213 /* SceneRenderLayer.passflag */
214 typedef enum eScenePassType {
215         SCE_PASS_COMBINED                 = (1 << 0),
216         SCE_PASS_Z                        = (1 << 1),
217         SCE_PASS_RGBA                     = (1 << 2),
218         SCE_PASS_DIFFUSE                  = (1 << 3),
219         SCE_PASS_SPEC                     = (1 << 4),
220         SCE_PASS_SHADOW                   = (1 << 5),
221         SCE_PASS_AO                       = (1 << 6),
222         SCE_PASS_REFLECT                  = (1 << 7),
223         SCE_PASS_NORMAL                   = (1 << 8),
224         SCE_PASS_VECTOR                   = (1 << 9),
225         SCE_PASS_REFRACT                  = (1 << 10),
226         SCE_PASS_INDEXOB                  = (1 << 11),
227         SCE_PASS_UV                       = (1 << 12),
228         SCE_PASS_INDIRECT                 = (1 << 13),
229         SCE_PASS_MIST                     = (1 << 14),
230         SCE_PASS_RAYHITS                  = (1 << 15),
231         SCE_PASS_EMIT                     = (1 << 16),
232         SCE_PASS_ENVIRONMENT              = (1 << 17),
233         SCE_PASS_INDEXMA                  = (1 << 18),
234         SCE_PASS_DIFFUSE_DIRECT           = (1 << 19),
235         SCE_PASS_DIFFUSE_INDIRECT         = (1 << 20),
236         SCE_PASS_DIFFUSE_COLOR            = (1 << 21),
237         SCE_PASS_GLOSSY_DIRECT            = (1 << 22),
238         SCE_PASS_GLOSSY_INDIRECT          = (1 << 23),
239         SCE_PASS_GLOSSY_COLOR             = (1 << 24),
240         SCE_PASS_TRANSM_DIRECT            = (1 << 25),
241         SCE_PASS_TRANSM_INDIRECT          = (1 << 26),
242         SCE_PASS_TRANSM_COLOR             = (1 << 27),
243         SCE_PASS_SUBSURFACE_DIRECT        = (1 << 28),
244         SCE_PASS_SUBSURFACE_INDIRECT      = (1 << 29),
245         SCE_PASS_SUBSURFACE_COLOR         = (1 << 30),
246 } eScenePassType;
247
248 #define RE_PASSNAME_COMBINED "Combined"
249 #define RE_PASSNAME_Z "Depth"
250 #define RE_PASSNAME_VECTOR "Vector"
251 #define RE_PASSNAME_NORMAL "Normal"
252 #define RE_PASSNAME_UV "UV"
253 #define RE_PASSNAME_RGBA "Color"
254 #define RE_PASSNAME_EMIT "Emit"
255 #define RE_PASSNAME_DIFFUSE "Diffuse"
256 #define RE_PASSNAME_SPEC "Spec"
257 #define RE_PASSNAME_SHADOW "Shadow"
258
259 #define RE_PASSNAME_AO "AO"
260 #define RE_PASSNAME_ENVIRONMENT "Env"
261 #define RE_PASSNAME_INDIRECT "Indirect"
262 #define RE_PASSNAME_REFLECT "Reflect"
263 #define RE_PASSNAME_REFRACT "Refract"
264 #define RE_PASSNAME_INDEXOB "IndexOB"
265 #define RE_PASSNAME_INDEXMA "IndexMA"
266 #define RE_PASSNAME_MIST "Mist"
267
268 #define RE_PASSNAME_RAYHITS "RayHits"
269 #define RE_PASSNAME_DIFFUSE_DIRECT "DiffDir"
270 #define RE_PASSNAME_DIFFUSE_INDIRECT "DiffInd"
271 #define RE_PASSNAME_DIFFUSE_COLOR "DiffCol"
272 #define RE_PASSNAME_GLOSSY_DIRECT "GlossDir"
273 #define RE_PASSNAME_GLOSSY_INDIRECT "GlossInd"
274 #define RE_PASSNAME_GLOSSY_COLOR "GlossCol"
275 #define RE_PASSNAME_TRANSM_DIRECT "TransDir"
276 #define RE_PASSNAME_TRANSM_INDIRECT "TransInd"
277 #define RE_PASSNAME_TRANSM_COLOR "TransCol"
278
279 #define RE_PASSNAME_SUBSURFACE_DIRECT "SubsurfaceDir"
280 #define RE_PASSNAME_SUBSURFACE_INDIRECT "SubsurfaceInd"
281 #define RE_PASSNAME_SUBSURFACE_COLOR "SubsurfaceCol"
282
283
284 /* View - MultiView */
285 typedef struct SceneRenderView {
286         struct SceneRenderView *next, *prev;
287
288         char name[64];  /* MAX_NAME */
289         char suffix[64];        /* MAX_NAME */
290
291         int viewflag;
292         int pad[2];
293         char pad2[4];
294
295 } SceneRenderView;
296
297 /* SceneRenderView.viewflag */
298 #define SCE_VIEW_DISABLE                (1<<0)
299
300 /* RenderData.views_format */
301 enum {
302         SCE_VIEWS_FORMAT_STEREO_3D = 0,
303         SCE_VIEWS_FORMAT_MULTIVIEW = 1,
304 };
305
306 /* ImageFormatData.views_format (also used for Sequence.views_format) */
307 enum {
308         R_IMF_VIEWS_INDIVIDUAL = 0,
309         R_IMF_VIEWS_STEREO_3D  = 1,
310         R_IMF_VIEWS_MULTIVIEW  = 2,
311 };
312
313 typedef struct Stereo3dFormat {
314         short flag;
315         char display_mode; /* encoding mode */
316         char anaglyph_type; /* anaglyph scheme for the user display */
317         char interlace_type;  /* interlace type for the user display */
318         char pad[3];
319 } Stereo3dFormat;
320
321 /* Stereo3dFormat.display_mode */
322 typedef enum eStereoDisplayMode {
323         S3D_DISPLAY_ANAGLYPH    = 0,
324         S3D_DISPLAY_INTERLACE   = 1,
325         S3D_DISPLAY_PAGEFLIP    = 2,
326         S3D_DISPLAY_SIDEBYSIDE  = 3,
327         S3D_DISPLAY_TOPBOTTOM   = 4,
328 } eStereoDisplayMode;
329
330 /* Stereo3dFormat.flag */
331 typedef enum eStereo3dFlag {
332         S3D_INTERLACE_SWAP        = (1 << 0),
333         S3D_SIDEBYSIDE_CROSSEYED  = (1 << 1),
334         S3D_SQUEEZED_FRAME        = (1 << 2),
335 } eStereo3dFlag;
336
337 /* Stereo3dFormat.anaglyph_type */
338 typedef enum eStereo3dAnaglyphType {
339         S3D_ANAGLYPH_REDCYAN      = 0,
340         S3D_ANAGLYPH_GREENMAGENTA = 1,
341         S3D_ANAGLYPH_YELLOWBLUE   = 2,
342 } eStereo3dAnaglyphType;
343
344 /* Stereo3dFormat.interlace_type */
345 typedef enum eStereo3dInterlaceType {
346         S3D_INTERLACE_ROW          = 0,
347         S3D_INTERLACE_COLUMN       = 1,
348         S3D_INTERLACE_CHECKERBOARD = 2,
349 } eStereo3dInterlaceType;
350
351 /* *************************************************************** */
352
353 /* Generic image format settings,
354  * this is used for NodeImageFile and IMAGE_OT_save_as operator too.
355  *
356  * note: its a bit strange that even though this is an image format struct
357  *  the imtype can still be used to select video formats.
358  *  RNA ensures these enum's are only selectable for render output.
359  */
360 typedef struct ImageFormatData {
361         char imtype;   /* R_IMF_IMTYPE_PNG, R_... */
362                        /* note, video types should only ever be set from this
363                         * structure when used from RenderData */
364         char depth;    /* bits per channel, R_IMF_CHAN_DEPTH_8 -> 32,
365                         * not a flag, only set 1 at a time */
366
367         char planes;   /* - R_IMF_PLANES_BW, R_IMF_PLANES_RGB, R_IMF_PLANES_RGBA */
368         char flag;     /* generic options for all image types, alpha zbuffer */
369
370         char quality;  /* (0 - 100), eg: jpeg quality */
371         char compress; /* (0 - 100), eg: png compression */
372
373
374         /* --- format specific --- */
375
376         /* OpenEXR */
377         char  exr_codec;
378
379         /* Cineon */
380         char  cineon_flag;
381         short cineon_white, cineon_black;
382         float cineon_gamma;
383
384         /* Jpeg2000 */
385         char  jp2_flag;
386         char jp2_codec;
387
388         /* TIFF */
389         char tiff_codec;
390
391         char pad[4];
392
393         /* Multiview */
394         char views_format;
395         Stereo3dFormat stereo3d_format;
396
397         /* color management */
398         ColorManagedViewSettings view_settings;
399         ColorManagedDisplaySettings display_settings;
400 } ImageFormatData;
401
402
403 /* ImageFormatData.imtype */
404 #define R_IMF_IMTYPE_TARGA           0
405 #define R_IMF_IMTYPE_IRIS            1
406 /* #define R_HAMX                    2 */ /* hamx is nomore */
407 /* #define R_FTYPE                   3 */ /* ftype is nomore */
408 #define R_IMF_IMTYPE_JPEG90          4
409 /* #define R_MOVIE                   5 */ /* movie is nomore */
410 #define R_IMF_IMTYPE_IRIZ            7
411 #define R_IMF_IMTYPE_RAWTGA         14
412 #define R_IMF_IMTYPE_AVIRAW         15
413 #define R_IMF_IMTYPE_AVIJPEG        16
414 #define R_IMF_IMTYPE_PNG            17
415 /* #define R_IMF_IMTYPE_AVICODEC    18 */ /* avicodec is nomore */
416 /* #define R_IMF_IMTYPE_QUICKTIME   19 */ /* quicktime is nomore */
417 #define R_IMF_IMTYPE_BMP            20
418 #define R_IMF_IMTYPE_RADHDR         21
419 #define R_IMF_IMTYPE_TIFF           22
420 #define R_IMF_IMTYPE_OPENEXR        23
421 #define R_IMF_IMTYPE_FFMPEG         24
422 #define R_IMF_IMTYPE_FRAMESERVER    25
423 #define R_IMF_IMTYPE_CINEON         26
424 #define R_IMF_IMTYPE_DPX            27
425 #define R_IMF_IMTYPE_MULTILAYER     28
426 #define R_IMF_IMTYPE_DDS            29
427 #define R_IMF_IMTYPE_JP2            30
428 #define R_IMF_IMTYPE_H264           31
429 #define R_IMF_IMTYPE_XVID           32
430 #define R_IMF_IMTYPE_THEORA         33
431 #define R_IMF_IMTYPE_PSD            34
432
433 #define R_IMF_IMTYPE_INVALID        255
434
435 /* ImageFormatData.flag */
436 #define R_IMF_FLAG_ZBUF         (1<<0)   /* was R_OPENEXR_ZBUF */
437 #define R_IMF_FLAG_PREVIEW_JPG  (1<<1)   /* was R_PREVIEW_JPG */
438
439 /* return values from BKE_imtype_valid_depths, note this is depts per channel */
440 #define R_IMF_CHAN_DEPTH_1  (1<<0) /* 1bits  (unused) */
441 #define R_IMF_CHAN_DEPTH_8  (1<<1) /* 8bits  (default) */
442 #define R_IMF_CHAN_DEPTH_10 (1<<2) /* 10bits (uncommon, Cineon/DPX support) */
443 #define R_IMF_CHAN_DEPTH_12 (1<<3) /* 12bits (uncommon, jp2/DPX support) */
444 #define R_IMF_CHAN_DEPTH_16 (1<<4) /* 16bits (tiff, halff float exr) */
445 #define R_IMF_CHAN_DEPTH_24 (1<<5) /* 24bits (unused) */
446 #define R_IMF_CHAN_DEPTH_32 (1<<6) /* 32bits (full float exr) */
447
448 /* ImageFormatData.planes */
449 #define R_IMF_PLANES_RGB   24
450 #define R_IMF_PLANES_RGBA  32
451 #define R_IMF_PLANES_BW    8
452
453 /* ImageFormatData.exr_codec */
454 #define R_IMF_EXR_CODEC_NONE  0
455 #define R_IMF_EXR_CODEC_PXR24 1
456 #define R_IMF_EXR_CODEC_ZIP   2
457 #define R_IMF_EXR_CODEC_PIZ   3
458 #define R_IMF_EXR_CODEC_RLE   4
459 #define R_IMF_EXR_CODEC_ZIPS  5
460 #define R_IMF_EXR_CODEC_B44   6
461 #define R_IMF_EXR_CODEC_B44A  7
462 #define R_IMF_EXR_CODEC_DWAA  8
463 #define R_IMF_EXR_CODEC_DWAB  9
464 #define R_IMF_EXR_CODEC_MAX  10
465
466 /* ImageFormatData.jp2_flag */
467 #define R_IMF_JP2_FLAG_YCC          (1<<0)  /* when disabled use RGB */ /* was R_JPEG2K_YCC */
468 #define R_IMF_JP2_FLAG_CINE_PRESET  (1<<1)  /* was R_JPEG2K_CINE_PRESET */
469 #define R_IMF_JP2_FLAG_CINE_48      (1<<2)  /* was R_JPEG2K_CINE_48FPS */
470
471 /* ImageFormatData.jp2_codec */
472 #define R_IMF_JP2_CODEC_JP2  0
473 #define R_IMF_JP2_CODEC_J2K  1
474
475 /* ImageFormatData.cineon_flag */
476 #define R_IMF_CINEON_FLAG_LOG (1<<0)  /* was R_CINEON_LOG */
477
478 /* ImageFormatData.tiff_codec */
479 enum {
480         R_IMF_TIFF_CODEC_DEFLATE   = 0,
481         R_IMF_TIFF_CODEC_LZW       = 1,
482         R_IMF_TIFF_CODEC_PACKBITS  = 2,
483         R_IMF_TIFF_CODEC_NONE      = 3,
484 };
485
486 typedef struct BakeData {
487         struct ImageFormatData im_format;
488
489         char filepath[1024]; /* FILE_MAX */
490
491         short width, height;
492         short margin, flag;
493
494         float cage_extrusion;
495         int pass_filter;
496
497         char normal_swizzle[3];
498         char normal_space;
499
500         char save_mode;
501         char pad[3];
502
503         char cage[64];  /* MAX_NAME */
504 } BakeData;
505
506 /* BakeData.normal_swizzle (char) */
507 typedef enum eBakeNormalSwizzle {
508         R_BAKE_POSX = 0,
509         R_BAKE_POSY = 1,
510         R_BAKE_POSZ = 2,
511         R_BAKE_NEGX = 3,
512         R_BAKE_NEGY = 4,
513         R_BAKE_NEGZ = 5,
514 } eBakeNormalSwizzle;
515
516 /* BakeData.save_mode (char) */
517 typedef enum eBakeSaveMode {
518         R_BAKE_SAVE_INTERNAL = 0,
519         R_BAKE_SAVE_EXTERNAL = 1,
520 } eBakeSaveMode;
521
522 /* BakeData.pass_filter */
523 typedef enum eBakePassFilter {
524         R_BAKE_PASS_FILTER_NONE           = 0,
525         R_BAKE_PASS_FILTER_AO             = (1 << 0),
526         R_BAKE_PASS_FILTER_EMIT           = (1 << 1),
527         R_BAKE_PASS_FILTER_DIFFUSE        = (1 << 2),
528         R_BAKE_PASS_FILTER_GLOSSY         = (1 << 3),
529         R_BAKE_PASS_FILTER_TRANSM         = (1 << 4),
530         R_BAKE_PASS_FILTER_SUBSURFACE     = (1 << 5),
531         R_BAKE_PASS_FILTER_DIRECT         = (1 << 6),
532         R_BAKE_PASS_FILTER_INDIRECT       = (1 << 7),
533         R_BAKE_PASS_FILTER_COLOR          = (1 << 8),
534 } eBakePassFilter;
535
536 #define R_BAKE_PASS_FILTER_ALL (~0)
537
538 /* RenderEngineSettingsClay.options */
539 typedef enum ClayFlagSettings {
540         CLAY_USE_AO     = (1 << 0),
541         CLAY_USE_HSV    = (1 << 1),
542 } ClayFlagSettings;
543
544 /* *************************************************************** */
545 /* Render Data */
546
547 typedef struct RenderData {
548         struct ImageFormatData im_format;
549         
550         struct AviCodecData *avicodecdata;
551         struct FFMpegCodecData ffcodecdata;
552
553         int cfra, sfra, efra;   /* frames as in 'images' */
554         float subframe;                 /* subframe offset from cfra, in 0.0-1.0 */
555         int psfra, pefra;               /* start+end frames of preview range */
556
557         int images, framapto;
558         short flag, threads;
559
560         float framelen, blurfac;
561
562         /** For UR edge rendering: give the edges this color */
563         float edgeR, edgeG, edgeB;
564
565
566         /* standalone player */  //  XXX deprecated since 2.5
567         short fullscreen  DNA_DEPRECATED, xplay  DNA_DEPRECATED, yplay  DNA_DEPRECATED;
568         short freqplay  DNA_DEPRECATED;
569         /* standalone player */  //  XXX deprecated since 2.5
570         short depth  DNA_DEPRECATED, attrib  DNA_DEPRECATED;
571
572
573         int frame_step;         /* frames to jump during render/playback */
574
575         short stereomode  DNA_DEPRECATED;       /* standalone player stereo settings */  //  XXX deprecated since 2.5
576         
577         short dimensionspreset;         /* for the dimensions presets menu */
578
579         short filtertype;       /* filter is box, tent, gauss, mitch, etc */
580
581         short size; /* size in % */
582         
583         short maximsize DNA_DEPRECATED; /* max in Kb */
584
585         short pad6;
586
587         /* from buttons: */
588         /**
589          * The desired number of pixels in the x direction
590          */
591         int xsch;
592         /**
593          * The desired number of pixels in the y direction
594          */
595         int ysch;
596
597         /**
598          * The number of part to use in the x direction
599          */
600         short xparts DNA_DEPRECATED;
601         /**
602          * The number of part to use in the y direction
603          */
604         short yparts DNA_DEPRECATED;
605
606         /**
607          * render tile dimensions
608          */
609         int tilex, tiley;
610
611         short planes  DNA_DEPRECATED, imtype  DNA_DEPRECATED, subimtype  DNA_DEPRECATED, quality  DNA_DEPRECATED; /*deprecated!*/
612         
613         /**
614          * Render to image editor, fullscreen or to new window.
615          */
616         short displaymode;
617         char use_lock_interface;
618         char pad7;
619
620         /**
621          * Flags for render settings. Use bit-masking to access the settings.
622          */
623         int scemode;
624
625         /**
626          * Flags for render settings. Use bit-masking to access the settings.
627          */
628         int mode;
629
630         /**
631          * Flags for raytrace settings. Use bit-masking to access the settings.
632          */
633         int raytrace_options;
634         
635         /**
636          * Raytrace acceleration structure
637          */
638         short raytrace_structure;
639
640         short pad1;
641
642         /* octree resolution */
643         short ocres;
644         short pad4;
645         
646         /**
647          * What to do with the sky/background. Picks sky/premul/key
648          * blending for the background
649          */
650         short alphamode;
651
652         /**
653          * The number of samples to use per pixel.
654          */
655         short osa;
656
657         short frs_sec, edgeint;
658
659         
660         /* safety, border and display rect */
661         rctf safety, border;
662         rcti disprect;
663         
664         /* information on different layers to be rendered */
665         ListBase layers DNA_DEPRECATED; /* Converted to Scene->view_layers. */
666         short actlay DNA_DEPRECATED; /* Converted to Scene->active_layer. */
667         
668         /* number of mblur samples */
669         short mblur_samples;
670         
671         /**
672          * Adjustment factors for the aspect ratio in the x direction, was a short in 2.45
673          */
674         float xasp, yasp;
675
676         float frs_sec_base;
677         
678         /**
679          * Value used to define filter size for all filter options  */
680         float gauss;
681         
682         
683         /* color management settings - color profiles, gamma correction, etc */
684         int color_mgt_flag;
685         
686         /** post-production settings. deprecated, but here for upwards compat (initialized to 1) */
687         float postgamma, posthue, postsat;
688         
689          /* Dither noise intensity */
690         float dither_intensity;
691         
692         /* Bake Render options */
693         short bake_osa, bake_filter, bake_mode, bake_flag;
694         short bake_normal_space, bake_quad_split;
695         float bake_maxdist, bake_biasdist;
696         short bake_samples, bake_pad;
697         float bake_user_scale, bake_pad1;
698
699         /* path to render output */
700         char pic[1024]; /* 1024 = FILE_MAX */
701
702         /* stamps flags. */
703         int stamp;
704         short stamp_font_id, pad3; /* select one of blenders bitmap fonts */
705
706         /* stamp info user data. */
707         char stamp_udata[768];
708
709         /* foreground/background color. */
710         float fg_stamp[4];
711         float bg_stamp[4];
712
713         /* sequencer options */
714         char seq_prev_type;
715         char seq_rend_type;  /* UNUSED! */
716         char seq_flag; /* flag use for sequence render/draw */
717         char pad5[5];
718
719         /* render simplify */
720         int simplify_flag;
721         short simplify_subsurf;
722         short simplify_subsurf_render;
723         short simplify_shadowsamples, pad9;
724         float simplify_particles;
725         float simplify_particles_render;
726         float simplify_aosss;
727
728         /* cineon */
729         short cineonwhite  DNA_DEPRECATED, cineonblack  DNA_DEPRECATED;  /*deprecated*/
730         float cineongamma  DNA_DEPRECATED;  /*deprecated*/
731         
732         /* jpeg2000 */
733         short jp2_preset  DNA_DEPRECATED, jp2_depth  DNA_DEPRECATED;  /*deprecated*/
734         int rpad3;
735
736         /* Dome variables */ //  XXX deprecated since 2.5
737         short domeres  DNA_DEPRECATED, domemode  DNA_DEPRECATED;        //  XXX deprecated since 2.5
738         short domeangle  DNA_DEPRECATED, dometilt  DNA_DEPRECATED;      //  XXX deprecated since 2.5
739         float domeresbuf  DNA_DEPRECATED;       //  XXX deprecated since 2.5
740         float pad2;
741         struct Text *dometext  DNA_DEPRECATED;  //  XXX deprecated since 2.5
742
743         /* Freestyle line thickness options */
744         int line_thickness_mode;
745         float unit_line_thickness; /* in pixels */
746
747         /* render engine */
748         char engine[32] DNA_DEPRECATED; // XXX deprecated since 2.8
749
750         /* Cycles baking */
751         struct BakeData bake;
752
753         int preview_start_resolution;
754         short preview_pixel_size;
755
756         /* Type of the debug pass to use.
757          * Only used when built with debug passes support.
758          */
759         short debug_pass_type;
760
761         /* MultiView */
762         ListBase views;  /* SceneRenderView */
763         short actview;
764         short views_format;
765         short pad8[2];
766
767         /* Motion blur shutter */
768         struct CurveMapping mblur_shutter_curve;
769 } RenderData;
770
771 /* *************************************************************** */
772 /* Settings related to viewport drawing/render, only settings used by WorkSpace and Scene. */
773 typedef struct ViewRender {
774         char engine_id[32];
775 } ViewRender;
776
777 /* *************************************************************** */
778 /* Render Conversion/Simplfication Settings */
779
780 /* control render convert and shading engine */
781 typedef struct RenderProfile {
782         struct RenderProfile *next, *prev;
783         char name[32];
784         
785         short particle_perc;
786         short subsurf_max;
787         short shadbufsample_max;
788         short pad1;
789         
790         float ao_error, pad2;
791         
792 } RenderProfile;
793
794 /* *************************************************************** */
795 /* Game Engine - Dome */
796
797 typedef struct GameDome {
798         short res, mode;
799         short angle, tilt;
800         float resbuf, pad2;
801         struct Text *warptext;
802 } GameDome;
803
804 /* GameDome.mode */
805 #define DOME_FISHEYE                    1
806 #define DOME_TRUNCATED_FRONT    2
807 #define DOME_TRUNCATED_REAR             3
808 #define DOME_ENVMAP                             4
809 #define DOME_PANORAM_SPH                5
810 #define DOME_NUM_MODES                  6
811
812 /* *************************************************************** */
813 /* Game Engine */
814
815 typedef struct GameFraming {
816         float col[3];
817         char type, pad1, pad2, pad3;
818 } GameFraming;
819
820 /* GameFraming.type */
821 #define SCE_GAMEFRAMING_BARS   0
822 #define SCE_GAMEFRAMING_EXTEND 1
823 #define SCE_GAMEFRAMING_SCALE  2
824
825 typedef struct RecastData {
826         float cellsize;
827         float cellheight;
828         float agentmaxslope;
829         float agentmaxclimb;
830         float agentheight;
831         float agentradius;
832         float edgemaxlen;
833         float edgemaxerror;
834         float regionminsize;
835         float regionmergesize;
836         int vertsperpoly;
837         float detailsampledist;
838         float detailsamplemaxerror;
839         char partitioning;
840         char pad1;
841         short pad2;
842 } RecastData;
843
844 /* RecastData.partitioning */
845 #define RC_PARTITION_WATERSHED 0
846 #define RC_PARTITION_MONOTONE 1
847 #define RC_PARTITION_LAYERS 2
848
849 typedef struct GameData {
850
851         /* standalone player */
852         struct GameFraming framing;
853         short playerflag, xplay, yplay, freqplay;
854         short depth, attrib, rt1, rt2;
855         short aasamples, pad4[3];
856
857         /* stereo/dome mode */
858         struct GameDome dome;
859         short stereoflag, stereomode;
860         float eyeseparation;
861         RecastData recastData;
862
863
864         /* physics (it was in world)*/
865         float gravity; /*Gravitation constant for the game world*/
866
867         /*
868          * Radius of the activity bubble, in Manhattan length. Objects
869          * outside the box are activity-culled. */
870         float activityBoxRadius;
871
872         /*
873          * bit 3: (gameengine): Activity culling is enabled.
874          * bit 5: (gameengine) : enable Bullet DBVT tree for view frustum culling
875          */
876         int flag;
877         short mode, matmode;
878         short occlusionRes;             /* resolution of occlusion Z buffer in pixel */
879         short physicsEngine;
880         short exitkey;
881         short vsync; /* Controls vsync: off, on, or adaptive (if supported) */
882         short ticrate, maxlogicstep, physubstep, maxphystep;
883         short obstacleSimulation;
884         short raster_storage;
885         float levelHeight;
886         float deactivationtime, lineardeactthreshold, angulardeactthreshold;
887
888         /* Scene LoD */
889         short lodflag, pad2;
890         int scehysteresis, pad5;
891
892 } GameData;
893
894 /* GameData.stereoflag */
895 #define STEREO_NOSTEREO         1
896 #define STEREO_ENABLED          2
897 #define STEREO_DOME                     3
898
899 /* GameData.stereomode */
900 //#define STEREO_NOSTEREO                1
901 #define STEREO_QUADBUFFERED 2
902 #define STEREO_ABOVEBELOW        3
903 #define STEREO_INTERLACED        4
904 #define STEREO_ANAGLYPH         5
905 #define STEREO_SIDEBYSIDE       6
906 #define STEREO_VINTERLACE       7
907 //#define STEREO_DOME           8
908 #define STEREO_3DTVTOPBOTTOM 9
909
910 /* GameData.physicsEngine */
911 #define WOPHY_NONE              0
912 #define WOPHY_BULLET    5
913
914 /* obstacleSimulation */
915 #define OBSTSIMULATION_NONE             0
916 #define OBSTSIMULATION_TOI_rays         1
917 #define OBSTSIMULATION_TOI_cells        2
918
919 /* GameData.raster_storage */
920 #define RAS_STORE_AUTO          0
921 /* #define RAS_STORE_IMMEDIATE  1 */  /* DEPRECATED */
922 #define RAS_STORE_VA            2
923 #define RAS_STORE_VBO           3
924
925 /* GameData.vsync */
926 #define VSYNC_ON        0
927 #define VSYNC_OFF       1
928 #define VSYNC_ADAPTIVE  2
929
930 /* GameData.flag */
931 #define GAME_RESTRICT_ANIM_UPDATES                      (1 << 0)
932 #define GAME_ENABLE_ALL_FRAMES                          (1 << 1)
933 #define GAME_SHOW_DEBUG_PROPS                           (1 << 2)
934 #define GAME_SHOW_FRAMERATE                                     (1 << 3)
935 #define GAME_SHOW_PHYSICS                                       (1 << 4)
936 // #define GAME_DISPLAY_LISTS                                   (1 << 5)   /* deprecated */
937 #define GAME_GLSL_NO_LIGHTS                                     (1 << 6)
938 #define GAME_GLSL_NO_SHADERS                            (1 << 7)
939 #define GAME_GLSL_NO_SHADOWS                            (1 << 8)
940 #define GAME_GLSL_NO_RAMPS                                      (1 << 9)
941 #define GAME_GLSL_NO_NODES                                      (1 << 10)
942 #define GAME_GLSL_NO_EXTRA_TEX                          (1 << 11)
943 #define GAME_IGNORE_DEPRECATION_WARNINGS        (1 << 12)
944 #define GAME_ENABLE_ANIMATION_RECORD            (1 << 13)
945 #define GAME_SHOW_MOUSE                                         (1 << 14)
946 #define GAME_GLSL_NO_COLOR_MANAGEMENT           (1 << 15)
947 #define GAME_SHOW_OBSTACLE_SIMULATION           (1 << 16)
948 #define GAME_NO_MATERIAL_CACHING                        (1 << 17)
949 #define GAME_GLSL_NO_ENV_LIGHTING                       (1 << 18)
950 /* Note: GameData.flag is now an int (max 32 flags). A short could only take 16 flags */
951
952 /* GameData.playerflag */
953 #define GAME_PLAYER_FULLSCREEN                          (1 << 0)
954 #define GAME_PLAYER_DESKTOP_RESOLUTION          (1 << 1)
955
956 /* GameData.matmode */
957 enum {
958 #ifdef DNA_DEPRECATED
959         GAME_MAT_TEXFACE    = 0, /* deprecated */
960 #endif
961         GAME_MAT_MULTITEX   = 1,
962         GAME_MAT_GLSL       = 2,
963 };
964
965 /* GameData.lodflag */
966 #define SCE_LOD_USE_HYST                (1 << 0)
967
968 /* UV Paint */
969 /* ToolSettings.uv_sculpt_settings */
970 #define UV_SCULPT_LOCK_BORDERS                          1
971 #define UV_SCULPT_ALL_ISLANDS                           2
972
973 /* ToolSettings.uv_sculpt_tool */
974 #define UV_SCULPT_TOOL_PINCH                            1
975 #define UV_SCULPT_TOOL_RELAX                            2
976 #define UV_SCULPT_TOOL_GRAB                                     3
977
978 /* ToolSettings.uv_relax_method */
979 #define UV_SCULPT_TOOL_RELAX_LAPLACIAN  1
980 #define UV_SCULPT_TOOL_RELAX_HC                 2
981
982 /* Stereo Flags */
983 #define STEREO_RIGHT_NAME "right"
984 #define STEREO_LEFT_NAME "left"
985 #define STEREO_RIGHT_SUFFIX "_R"
986 #define STEREO_LEFT_SUFFIX "_L"
987
988 /* View3D.stereo3d_camera / View3D.multiview_eye / ImageUser.multiview_eye */
989 typedef enum eStereoViews {
990         STEREO_LEFT_ID = 0,
991         STEREO_RIGHT_ID = 1,
992         STEREO_3D_ID = 2,
993         STEREO_MONO_ID = 3,
994 } eStereoViews;
995
996 /* *************************************************************** */
997 /* Markers */
998
999 typedef struct TimeMarker {
1000         struct TimeMarker *next, *prev;
1001         int frame;
1002         char name[64];
1003         unsigned int flag;
1004         struct Object *camera;
1005 } TimeMarker;
1006
1007 /* *************************************************************** */
1008 /* Paint Mode/Tool Data */
1009
1010 #define PAINT_MAX_INPUT_SAMPLES 64
1011
1012 /* Paint Tool Base */
1013 typedef struct Paint {
1014         struct Brush *brush;
1015         struct Palette *palette;
1016         struct CurveMapping *cavity_curve; /* cavity curve */
1017
1018         /* WM Paint cursor */
1019         void *paint_cursor;
1020         unsigned char paint_cursor_col[4];
1021
1022         /* enum ePaintFlags */
1023         int flags;
1024
1025         /* Paint stroke can use up to PAINT_MAX_INPUT_SAMPLES inputs to
1026          * smooth the stroke */
1027         int num_input_samples;
1028         
1029         /* flags used for symmetry */
1030         int symmetry_flags;
1031
1032         float tile_offset[3];
1033         int pad2;
1034 } Paint;
1035
1036 /* ------------------------------------------- */
1037 /* Image Paint */
1038
1039 /* Texture/Image Editor */
1040 typedef struct ImagePaintSettings {
1041         Paint paint;
1042
1043         short flag, missing_data;
1044         
1045         /* for projection painting only */
1046         short seam_bleed, normal_angle;
1047         short screen_grab_size[2]; /* capture size for re-projection */
1048
1049         int mode;                  /* mode used for texture painting */
1050
1051         void *paintcursor;                 /* wm handle */
1052         struct Image *stencil;     /* workaround until we support true layer masks */
1053         struct Image *clone;       /* clone layer for image mode for projective texture painting */
1054         struct Image *canvas;      /* canvas when the explicit system is used for painting */
1055         float stencil_col[3];
1056         float dither;              /* dither amount used when painting on byte images */
1057 } ImagePaintSettings;
1058
1059 /* ------------------------------------------- */
1060 /* Particle Edit */
1061
1062 /* Settings for a Particle Editing Brush */
1063 typedef struct ParticleBrushData {
1064         short size;                                             /* common setting */
1065         short step, invert, count;              /* for specific brushes only */
1066         int flag;
1067         float strength;
1068 } ParticleBrushData;
1069
1070 /* Particle Edit Mode Settings */
1071 typedef struct ParticleEditSettings {
1072         short flag;
1073         short totrekey;
1074         short totaddkey;
1075         short brushtype;
1076
1077         ParticleBrushData brush[7];
1078         void *paintcursor;                      /* runtime */
1079
1080         float emitterdist, rt;
1081
1082         int selectmode;
1083         int edittype;
1084
1085         int draw_step, fade_frames;
1086
1087         struct Scene *scene;
1088         struct ViewLayer *view_layer;
1089         struct Object *object;
1090         struct Object *shape_object;
1091 } ParticleEditSettings;
1092
1093 /* ------------------------------------------- */
1094 /* Sculpt */
1095
1096 /* Sculpt */
1097 typedef struct Sculpt {
1098         Paint paint;
1099
1100         /* For rotating around a pivot point */
1101         //float pivot[3]; XXX not used?
1102         int flags;
1103
1104         /* Control tablet input */
1105         //char tablet_size, tablet_strength; XXX not used?
1106         int radial_symm[3];
1107
1108         /* Maximum edge length for dynamic topology sculpting (in pixels) */
1109         float detail_size;
1110
1111         /* Direction used for SCULPT_OT_symmetrize operator */
1112         int symmetrize_direction;
1113
1114         /* gravity factor for sculpting */
1115         float gravity_factor;
1116
1117         /* scale for constant detail size */
1118         float constant_detail; /* Constant detail resolution (Blender unit / constant_detail) */
1119         float detail_percent;
1120         float pad;
1121
1122         struct Object *gravity_object;
1123 } Sculpt;
1124
1125 typedef struct UvSculpt {
1126         Paint paint;
1127 } UvSculpt;
1128
1129 /* ------------------------------------------- */
1130 /* Vertex Paint */
1131
1132 /* Vertex Paint */
1133 typedef struct VPaint {
1134         Paint paint;
1135         char flag;
1136         char pad[3];
1137         int radial_symm[3]; /* For mirrored painting */
1138 } VPaint;
1139
1140 /* VPaint.flag */
1141 enum {
1142         /* weight paint only */
1143         VP_FLAG_VGROUP_RESTRICT     = (1 << 7)
1144 };
1145
1146 /* ------------------------------------------- */
1147 /* GPencil Stroke Sculpting */
1148
1149 /* GP_BrushEdit_Settings.brushtype */
1150 typedef enum eGP_EditBrush_Types {
1151         GP_EDITBRUSH_TYPE_SMOOTH    = 0,
1152         GP_EDITBRUSH_TYPE_THICKNESS = 1,
1153         GP_EDITBRUSH_TYPE_GRAB      = 2,
1154         GP_EDITBRUSH_TYPE_PUSH      = 3,
1155         GP_EDITBRUSH_TYPE_TWIST     = 4,
1156         GP_EDITBRUSH_TYPE_PINCH     = 5,
1157         GP_EDITBRUSH_TYPE_RANDOMIZE = 6,
1158         GP_EDITBRUSH_TYPE_SUBDIVIDE = 7,
1159         GP_EDITBRUSH_TYPE_SIMPLIFY  = 8,
1160         GP_EDITBRUSH_TYPE_CLONE     = 9,
1161         GP_EDITBRUSH_TYPE_STRENGTH  = 10,
1162
1163         /* !!! Update GP_EditBrush_Data brush[###]; below !!! */
1164         TOT_GP_EDITBRUSH_TYPES
1165 } eGP_EditBrush_Types;
1166
1167 /* GP_BrushEdit_Settings.lock_axis */
1168 typedef enum eGP_Lockaxis_Types {
1169         GP_LOCKAXIS_NONE = 0,
1170         GP_LOCKAXIS_X = 1,
1171         GP_LOCKAXIS_Y = 2,
1172         GP_LOCKAXIS_Z = 3
1173 } eGP_Lockaxis_Types;
1174
1175 /* Settings for a GPencil Stroke Sculpting Brush */
1176 typedef struct GP_EditBrush_Data {
1177         short size;             /* radius of brush */
1178         short flag;             /* eGP_EditBrush_Flag */
1179         float strength;         /* strength of effect */
1180 } GP_EditBrush_Data;
1181
1182 /* GP_EditBrush_Data.flag */
1183 typedef enum eGP_EditBrush_Flag {
1184         /* invert the effect of the brush */
1185         GP_EDITBRUSH_FLAG_INVERT       = (1 << 0),
1186         /* adjust strength using pen pressure */
1187         GP_EDITBRUSH_FLAG_USE_PRESSURE = (1 << 1),
1188         
1189         /* strength of brush falls off with distance from cursor */
1190         GP_EDITBRUSH_FLAG_USE_FALLOFF  = (1 << 2),
1191         
1192         /* smooth brush affects pressure values as well */
1193         GP_EDITBRUSH_FLAG_SMOOTH_PRESSURE  = (1 << 3)
1194 } eGP_EditBrush_Flag;
1195
1196
1197
1198 /* GPencil Stroke Sculpting Settings */
1199 typedef struct GP_BrushEdit_Settings {
1200         GP_EditBrush_Data brush[11];  /* TOT_GP_EDITBRUSH_TYPES */
1201         void *paintcursor;            /* runtime */
1202         
1203         int brushtype;                /* eGP_EditBrush_Types */
1204         int flag;                     /* eGP_BrushEdit_SettingsFlag */
1205         int lock_axis;                /* eGP_Lockaxis_Types lock drawing to one axis */
1206         float alpha;                  /* alpha factor for selection color */
1207 } GP_BrushEdit_Settings;
1208
1209 /* GP_BrushEdit_Settings.flag */
1210 typedef enum eGP_BrushEdit_SettingsFlag {
1211         /* only affect selected points */
1212         GP_BRUSHEDIT_FLAG_SELECT_MASK = (1 << 0),
1213         /* apply brush to position */
1214         GP_BRUSHEDIT_FLAG_APPLY_POSITION = (1 << 1),
1215         /* apply brush to strength */
1216         GP_BRUSHEDIT_FLAG_APPLY_STRENGTH = (1 << 2),
1217         /* apply brush to thickness */
1218         GP_BRUSHEDIT_FLAG_APPLY_THICKNESS = (1 << 3),
1219 } eGP_BrushEdit_SettingsFlag;
1220
1221
1222 /* Settings for GP Interpolation Operators */
1223 typedef struct GP_Interpolate_Settings {
1224         short flag;                        /* eGP_Interpolate_SettingsFlag */
1225         
1226         char type;                         /* eGP_Interpolate_Type - Interpolation Mode */ 
1227         char easing;                       /* eBezTriple_Easing - Easing mode (if easing equation used) */
1228         
1229         float back;                        /* BEZT_IPO_BACK */
1230         float amplitude, period;           /* BEZT_IPO_ELASTIC */
1231         
1232         struct CurveMapping *custom_ipo;   /* custom interpolation curve (for use with GP_IPO_CURVEMAP) */
1233 } GP_Interpolate_Settings;
1234
1235 /* GP_Interpolate_Settings.flag */
1236 typedef enum eGP_Interpolate_SettingsFlag {
1237         /* apply interpolation to all layers */
1238         GP_TOOLFLAG_INTERPOLATE_ALL_LAYERS    = (1 << 0),
1239         /* apply interpolation to only selected */
1240         GP_TOOLFLAG_INTERPOLATE_ONLY_SELECTED = (1 << 1),
1241 } eGP_Interpolate_SettingsFlag;
1242
1243 /* GP_Interpolate_Settings.type */
1244 typedef enum eGP_Interpolate_Type {
1245         /* Traditional Linear Interpolation */
1246         GP_IPO_LINEAR   = 0,
1247         
1248         /* CurveMap Defined Interpolation */
1249         GP_IPO_CURVEMAP = 1,
1250         
1251         /* Easing Equations */
1252         GP_IPO_BACK = 3,
1253         GP_IPO_BOUNCE = 4,
1254         GP_IPO_CIRC = 5,
1255         GP_IPO_CUBIC = 6,
1256         GP_IPO_ELASTIC = 7,
1257         GP_IPO_EXPO = 8,
1258         GP_IPO_QUAD = 9,
1259         GP_IPO_QUART = 10,
1260         GP_IPO_QUINT = 11,
1261         GP_IPO_SINE = 12,
1262 } eGP_Interpolate_Type;
1263
1264 /* *************************************************************** */
1265 /* Unified Paint Settings
1266  */
1267
1268 /* These settings can override the equivalent fields in the active
1269  * Brush for any paint mode; the flag field controls whether these
1270  * values are used */
1271 typedef struct UnifiedPaintSettings {
1272         /* unified radius of brush in pixels */
1273         int size;
1274
1275         /* unified radius of brush in Blender units */
1276         float unprojected_radius;
1277
1278         /* unified strength of brush */
1279         float alpha;
1280
1281         /* unified brush weight, [0, 1] */
1282         float weight;
1283
1284         /* unified brush color */
1285         float rgb[3];
1286         /* unified brush secondary color */
1287         float secondary_rgb[3];
1288
1289         /* user preferences for sculpt and paint */
1290         int flag;
1291
1292         /* rake rotation */
1293
1294         /* record movement of mouse so that rake can start at an intuitive angle */
1295         float last_rake[2];
1296         float last_rake_angle;
1297         
1298         int last_stroke_valid;
1299         float average_stroke_accum[3];
1300         int average_stroke_counter;
1301         
1302
1303         float brush_rotation;
1304         float brush_rotation_sec;
1305
1306         /*********************************************************************************
1307          *  all data below are used to communicate with cursor drawing and tex sampling  *
1308          *********************************************************************************/
1309         int anchored_size;
1310
1311         float overlap_factor; /* normalization factor due to accumulated value of curve along spacing.
1312                                * Calculated when brush spacing changes to dampen strength of stroke
1313                                * if space attenuation is used*/
1314         char draw_inverted;
1315         /* check is there an ongoing stroke right now */
1316         char stroke_active;
1317
1318         char draw_anchored;
1319         char do_linear_conversion;
1320
1321         /* store last location of stroke or whether the mesh was hit. Valid only while stroke is active */
1322         float last_location[3];
1323         int last_hit;
1324
1325         float anchored_initial_mouse[2];
1326
1327         /* radius of brush, premultiplied with pressure.
1328          * In case of anchored brushes contains the anchored radius */
1329         float pixel_radius;
1330
1331         /* drawing pressure */
1332         float size_pressure_value;
1333
1334         /* position of mouse, used to sample the texture */
1335         float tex_mouse[2];
1336
1337         /* position of mouse, used to sample the mask texture */
1338         float mask_tex_mouse[2];
1339
1340         /* ColorSpace cache to avoid locking up during sampling */
1341         struct ColorSpace *colorspace;
1342 } UnifiedPaintSettings;
1343
1344 /* UnifiedPaintSettings.flag */
1345 typedef enum {
1346         UNIFIED_PAINT_SIZE  = (1 << 0),
1347         UNIFIED_PAINT_ALPHA = (1 << 1),
1348         UNIFIED_PAINT_WEIGHT = (1 << 5),
1349         UNIFIED_PAINT_COLOR = (1 << 6),
1350
1351         /* only used if unified size is enabled, mirrors the brush flags
1352          * BRUSH_LOCK_SIZE and BRUSH_SIZE_PRESSURE */
1353         UNIFIED_PAINT_BRUSH_LOCK_SIZE = (1 << 2),
1354         UNIFIED_PAINT_BRUSH_SIZE_PRESSURE   = (1 << 3),
1355
1356         /* only used if unified alpha is enabled, mirrors the brush flag
1357          * BRUSH_ALPHA_PRESSURE */
1358         UNIFIED_PAINT_BRUSH_ALPHA_PRESSURE  = (1 << 4)
1359 } eUnifiedPaintSettingsFlags;
1360
1361
1362 typedef struct CurvePaintSettings {
1363         char curve_type;
1364         char flag;
1365         char depth_mode;
1366         char surface_plane;
1367         char fit_method;
1368         char pad;
1369         short error_threshold;
1370         float radius_min, radius_max;
1371         float radius_taper_start, radius_taper_end;
1372         float surface_offset;
1373         float corner_angle;
1374 } CurvePaintSettings;
1375
1376 /* CurvePaintSettings.flag */
1377 enum {
1378         CURVE_PAINT_FLAG_CORNERS_DETECT             = (1 << 0),
1379         CURVE_PAINT_FLAG_PRESSURE_RADIUS            = (1 << 1),
1380         CURVE_PAINT_FLAG_DEPTH_STROKE_ENDPOINTS     = (1 << 2),
1381         CURVE_PAINT_FLAG_DEPTH_STROKE_OFFSET_ABS    = (1 << 3),
1382 };
1383
1384 /* CurvePaintSettings.fit_method */
1385 enum {
1386         CURVE_PAINT_FIT_METHOD_REFIT            = 0,
1387         CURVE_PAINT_FIT_METHOD_SPLIT            = 1,
1388 };
1389
1390 /* CurvePaintSettings.depth_mode */
1391 enum {
1392         CURVE_PAINT_PROJECT_CURSOR              = 0,
1393         CURVE_PAINT_PROJECT_SURFACE             = 1,
1394 };
1395
1396 /* CurvePaintSettings.surface_plane */
1397 enum {
1398         CURVE_PAINT_SURFACE_PLANE_NORMAL_VIEW           = 0,
1399         CURVE_PAINT_SURFACE_PLANE_NORMAL_SURFACE        = 1,
1400         CURVE_PAINT_SURFACE_PLANE_VIEW                  = 2,
1401 };
1402
1403
1404 /* *************************************************************** */
1405 /* Stats */
1406
1407 /* Stats for Meshes */
1408 typedef struct MeshStatVis {
1409         char type;
1410         char _pad1[2];
1411
1412         /* overhang */
1413         char  overhang_axis;
1414         float overhang_min, overhang_max;
1415
1416         /* thickness */
1417         float thickness_min, thickness_max;
1418         char thickness_samples;
1419         char _pad2[3];
1420
1421         /* distort */
1422         float distort_min, distort_max;
1423
1424         /* sharp */
1425         float sharp_min, sharp_max;
1426 } MeshStatVis;
1427
1428
1429 /* *************************************************************** */
1430 /* Tool Settings */
1431
1432 typedef struct ToolSettings {
1433         VPaint *vpaint;         /* vertex paint */
1434         VPaint *wpaint;         /* weight paint */
1435         Sculpt *sculpt;
1436         UvSculpt *uvsculpt;     /* uv smooth */
1437         
1438         /* Vertex group weight - used only for editmode, not weight
1439          * paint */
1440         float vgroup_weight;
1441
1442         float doublimit;        /* remove doubles limit */
1443         float normalsize;       /* size of normals */
1444         short automerge;
1445
1446         /* Selection Mode for Mesh */
1447         short selectmode;
1448
1449         /* UV Calculation */
1450         char unwrapper;
1451         char uvcalc_flag;
1452         char uv_flag;
1453         char uv_selectmode;
1454
1455         float uvcalc_margin;
1456
1457         /* Auto-IK */
1458         short autoik_chainlen;  /* runtime only */
1459
1460         /* Grease Pencil */
1461         char gpencil_flags;             /* flags/options for how the tool works */
1462         char gpencil_src;               /* for main 3D view Grease Pencil, where data comes from */
1463
1464         char gpencil_v3d_align; /* stroke placement settings: 3D View */
1465         char gpencil_v2d_align; /*                          : General 2D Editor */
1466         char gpencil_seq_align; /*                          : Sequencer Preview */
1467         char gpencil_ima_align; /*                          : Image Editor */
1468         
1469         /* Grease Pencil Sculpt */
1470         struct GP_BrushEdit_Settings gp_sculpt;
1471         
1472         /* Grease Pencil Interpolation Tool(s) */
1473         struct GP_Interpolate_Settings gp_interpolate;
1474         
1475         /* Grease Pencil Drawing Brushes (bGPDbrush) */
1476         ListBase gp_brushes; 
1477
1478         /* Image Paint (8 byttse aligned please!) */
1479         struct ImagePaintSettings imapaint;
1480
1481         /* Particle Editing */
1482         struct ParticleEditSettings particle;
1483         
1484         /* Transform Proportional Area of Effect */
1485         float proportional_size;
1486
1487         /* Select Group Threshold */
1488         float select_thresh;
1489
1490         /* Auto-Keying Mode */
1491         short autokey_mode, autokey_flag;       /* defines in DNA_userdef_types.h */
1492         char keyframe_type;                 /* keyframe type (see DNA_curve_types.h) */
1493
1494         /* Multires */
1495         char multires_subdiv_type;
1496
1497         /* Skeleton generation */
1498         short skgen_resolution;
1499         float skgen_threshold_internal;
1500         float skgen_threshold_external;
1501         float skgen_length_ratio;
1502         float skgen_length_limit;
1503         float skgen_angle_limit;
1504         float skgen_correlation_limit;
1505         float skgen_symmetry_limit;
1506         float skgen_retarget_angle_weight;
1507         float skgen_retarget_length_weight;
1508         float skgen_retarget_distance_weight;
1509         short skgen_options;
1510         char  skgen_postpro;
1511         char  skgen_postpro_passes;
1512         char  skgen_subdivisions[3];
1513         char  skgen_multi_level;
1514
1515         /* Skeleton Sketching */
1516         struct Object *skgen_template;
1517         char bone_sketching;
1518         char bone_sketching_convert;
1519         char skgen_subdivision_number;
1520         char skgen_retarget_options;
1521         char skgen_retarget_roll;
1522         char skgen_side_string[8];
1523         char skgen_num_string[8];
1524         
1525         /* Alt+RMB option */
1526         char edge_mode;
1527         char edge_mode_live_unwrap;
1528
1529         /* Transform */
1530         char snap_mode, snap_node_mode;
1531         char snap_uv_mode;
1532         short snap_flag, snap_target;
1533         short proportional, prop_mode;
1534         char proportional_objects; /* proportional edit, object mode */
1535         char proportional_mask; /* proportional edit, mask editing */
1536         char proportional_action; /* proportional edit, action editor */
1537         char proportional_fcurve; /* proportional edit, graph editor */
1538         char lock_markers; /* lock marker editing */
1539         char pad4[5];
1540
1541         char auto_normalize; /*auto normalizing mode in wpaint*/
1542         char multipaint; /* paint multiple bones in wpaint */
1543         char weightuser;
1544         char vgroupsubset; /* subset selection filter in wpaint */
1545
1546         /* UV painting */
1547         int use_uv_sculpt;
1548         int uv_sculpt_settings;
1549         int uv_sculpt_tool;
1550         int uv_relax_method;
1551         /* XXX: these sculpt_paint_* fields are deprecated, use the
1552          * unified_paint_settings field instead! */
1553         short sculpt_paint_settings DNA_DEPRECATED;     short pad5;
1554         int sculpt_paint_unified_size DNA_DEPRECATED;
1555         float sculpt_paint_unified_unprojected_radius DNA_DEPRECATED;
1556         float sculpt_paint_unified_alpha DNA_DEPRECATED;
1557
1558         /* Unified Paint Settings */
1559         struct UnifiedPaintSettings unified_paint_settings;
1560
1561         struct CurvePaintSettings curve_paint_settings;
1562
1563         struct MeshStatVis statvis;
1564 } ToolSettings;
1565
1566 /* *************************************************************** */
1567 /* Assorted Scene Data */
1568
1569 /* ------------------------------------------- */
1570 /* Stats (show in Info header) */
1571
1572 typedef struct bStats {
1573         /* scene totals for visible layers */
1574         int totobj, totlamp, totobjsel, totcurve, totmesh, totarmature;
1575         int totvert, totface;
1576 } bStats;
1577
1578 /* ------------------------------------------- */
1579 /* Unit Settings */
1580
1581 typedef struct UnitSettings {
1582         /* Display/Editing unit options for each scene */
1583         float scale_length; /* maybe have other unit conversions? */
1584         char system; /* imperial, metric etc */
1585         char system_rotation; /* not implemented as a proper unit system yet */
1586         short flag;
1587 } UnitSettings;
1588
1589 /* ------------------------------------------- */
1590 /* Global/Common Physics Settings */
1591
1592 typedef struct PhysicsSettings {
1593         float gravity[3];
1594         int flag, quick_cache_step, rt;
1595 } PhysicsSettings;
1596
1597 /* ------------------------------------------- */
1598 /* Safe Area options used in Camera View & VSE
1599  */
1600 typedef struct DisplaySafeAreas {
1601         /* each value represents the (x,y) margins as a multiplier.
1602          * 'center' in this context is just the name for a different kind of safe-area */
1603
1604         float title[2];         /* Title Safe */
1605         float action[2];        /* Image/Graphics Safe */
1606
1607         /* use for alternate aspect ratio */
1608         float title_center[2];
1609         float action_center[2];
1610 } DisplaySafeAreas;
1611
1612 /* *************************************************************** */
1613 /* Scene ID-Block */
1614
1615 typedef struct Scene {
1616         ID id;
1617         struct AnimData *adt;   /* animation data (must be immediately after id for utilities to use it) */ 
1618         
1619         struct Object *camera;
1620         struct World *world;
1621         
1622         struct Scene *set;
1623         
1624         ListBase base DNA_DEPRECATED;
1625         struct Base  *basact DNA_DEPRECATED; /* active base */
1626         struct Object *obedit;          /* name replaces old G.obedit */
1627         
1628         float cursor[3];                        /* 3d cursor location */
1629         char _pad[4];
1630         
1631         unsigned int lay;                       /* bitflags for layer visibility */
1632         int layact;             /* active layer */
1633         unsigned int lay_updated;       /* runtime flag, has layer ever been updated since load? */
1634         
1635         short flag;                                                             /* various settings */
1636         
1637         char use_nodes;
1638         char pad[1];
1639         
1640         struct bNodeTree *nodetree;
1641         
1642         struct Editing *ed;                                                             /* sequence editor data is allocated here */
1643         
1644         struct ToolSettings *toolsettings;              /* default allocated now */
1645         void *pad2;
1646         struct DisplaySafeAreas safe_areas;
1647
1648         /* migrate or replace? depends on some internal things... */
1649         /* no, is on the right place (ton) */
1650         struct RenderData r;
1651         struct AudioData audio;
1652
1653         ListBase markers;
1654         ListBase transform_spaces DNA_DEPRECATED;
1655
1656         void *sound_scene;
1657         void *playback_handle;
1658         void *sound_scrub_handle;
1659         void *speaker_handles;
1660         
1661         void *fps_info;                                 /* (runtime) info/cache used for presenting playback framerate info to the user */
1662         
1663         /* none of the dependency graph  vars is mean to be saved */
1664         struct GHash *depsgraph_hash;
1665         int pad7;
1666
1667         /* User-Defined KeyingSets */
1668         int active_keyingset;                   /* index of the active KeyingSet. first KeyingSet has index 1, 'none' active is 0, 'add new' is -1 */
1669         ListBase keyingsets;                    /* KeyingSets for this scene */
1670         
1671         /* Game Settings */
1672         struct GameFraming framing  DNA_DEPRECATED; // XXX  deprecated since 2.5
1673         struct GameData gm;
1674
1675         /* Units */
1676         struct UnitSettings unit;
1677         
1678         /* Grease Pencil */
1679         struct bGPdata *gpd;
1680
1681         /* Movie Tracking */
1682         struct MovieClip *clip;                 /* active movie clip */
1683
1684         /* Physics simulation settings */
1685         struct PhysicsSettings physics_settings;
1686
1687         uint64_t customdata_mask;       /* XXX. runtime flag for drawing, actually belongs in the window, only used by BKE_object_handle_update() */
1688         uint64_t customdata_mask_modal; /* XXX. same as above but for temp operator use (gl renders) */
1689
1690         /* Color Management */
1691         ColorManagedViewSettings view_settings;
1692         ColorManagedDisplaySettings display_settings;
1693         ColorManagedColorspaceSettings sequencer_colorspace_settings;
1694         
1695         /* RigidBody simulation world+settings */
1696         struct RigidBodyWorld *rigidbody_world;
1697
1698         struct PreviewImage *preview;
1699
1700         ListBase view_layers;
1701         struct SceneCollection *collection;
1702         int active_view_layer;
1703         int pad4;
1704
1705         IDProperty *collection_properties;  /* settings to be overriden by layer collections */
1706         IDProperty *layer_properties;  /* settings to be override by workspaces */
1707
1708         int pad5[2];
1709
1710         ViewRender view_render;
1711 } Scene;
1712
1713 /* **************** RENDERDATA ********************* */
1714
1715 /* RenderData.flag */
1716         /* use preview range */
1717 #define SCER_PRV_RANGE  (1<<0)
1718 #define SCER_LOCK_FRAME_SELECTION       (1<<1)
1719         /* show/use subframes (for checking motion blur) */
1720 #define SCER_SHOW_SUBFRAME      (1<<3)
1721
1722 /* RenderData.mode */
1723 #define R_OSA                   0x0001
1724 #define R_SHADOW                0x0002
1725 #define R_GAMMA                 0x0004
1726 #define R_ORTHO                 0x0008
1727 #define R_ENVMAP                0x0010
1728 #define R_EDGE                  0x0020
1729 #define R_FIELDS                0x0040
1730 #define R_FIELDSTILL    0x0080
1731 /*#define R_RADIO                       0x0100 */ /* deprecated */
1732 #define R_BORDER                0x0200
1733 #define R_PANORAMA              0x0400  /* deprecated as scene option, still used in renderer */
1734 #define R_CROP                  0x0800
1735                 /* Disable camera switching: runtime (DURIAN_CAMERA_SWITCH) */
1736 #define R_NO_CAMERA_SWITCH      0x1000
1737 #define R_ODDFIELD              0x2000
1738 #define R_MBLUR                 0x4000
1739                 /* unified was here */
1740 #define R_RAYTRACE      0x10000
1741                 /* R_GAUSS is obsolete, but used to retrieve setting from old files */
1742 #define R_GAUSS         0x20000
1743                 /* fbuf obsolete... */
1744 /*#define R_FBUF                        0x40000*/
1745                 /* threads obsolete... is there for old files, now use for autodetect threads */
1746 #define R_THREADS               0x80000
1747                 /* Use the same flag for autothreads */
1748 #define R_FIXED_THREADS         0x80000 
1749
1750 #define R_SPEED                         0x100000
1751 #define R_SSS                           0x200000
1752 #define R_NO_OVERWRITE          0x400000  /* skip existing files */
1753 #define R_TOUCH                         0x800000  /* touch files before rendering */
1754 #define R_SIMPLIFY                      0x1000000
1755 #define R_EDGE_FRS                      0x2000000 /* R_EDGE reserved for Freestyle */
1756 #define R_PERSISTENT_DATA       0x4000000 /* keep data around for re-render */
1757 #define R_USE_WS_SHADING        0x8000000 /* use world space interpretation of lighting data */
1758
1759 /* RenderData.seq_flag */
1760 enum {
1761         // R_SEQ_GL_PREV = (1 << 1),  // UNUSED, we just use setting from seq_prev_type now.
1762         // R_SEQ_GL_REND = (1 << 2),  // UNUSED, opengl render has its own operator now.
1763         R_SEQ_SOLID_TEX  = (1 << 3),
1764         R_SEQ_CAMERA_DOF = (1 << 4),
1765 };
1766
1767 /* RenderData.displaymode */
1768 #define R_OUTPUT_SCREEN 0
1769 #define R_OUTPUT_AREA   1
1770 #define R_OUTPUT_WINDOW 2
1771 #define R_OUTPUT_NONE   3
1772 /*#define R_OUTPUT_FORKED       4*/
1773
1774 /* RenderData.filtertype */
1775 #define R_FILTER_BOX    0
1776 #define R_FILTER_TENT   1
1777 #define R_FILTER_QUAD   2
1778 #define R_FILTER_CUBIC  3
1779 #define R_FILTER_CATROM 4
1780 #define R_FILTER_GAUSS  5
1781 #define R_FILTER_MITCH  6
1782 #define R_FILTER_FAST_GAUSS     7 /* note, this is only used for nodes at the moment */
1783
1784 /* RenderData.raytrace_structure */
1785 #define R_RAYSTRUCTURE_AUTO                             0
1786 #define R_RAYSTRUCTURE_OCTREE                   1
1787 #define R_RAYSTRUCTURE_BLIBVH                   2       /* removed */
1788 #define R_RAYSTRUCTURE_VBVH                             3
1789 #define R_RAYSTRUCTURE_SIMD_SVBVH               4       /* needs SIMD */
1790 #define R_RAYSTRUCTURE_SIMD_QBVH                5       /* needs SIMD */
1791
1792 /* RenderData.raytrace_options */
1793 #define R_RAYTRACE_USE_LOCAL_COORDS             0x0001
1794 #define R_RAYTRACE_USE_INSTANCES                0x0002
1795
1796 /* RenderData.scemode (int now) */
1797 #define R_DOSEQ                         0x0001
1798 #define R_BG_RENDER                     0x0002
1799                 /* passepartout is camera option now, keep this for backward compatibility */
1800 #define R_PASSEPARTOUT          0x0004
1801 #define R_BUTS_PREVIEW          0x0008
1802 #define R_EXTENSION                     0x0010
1803 #define R_MATNODE_PREVIEW       0x0020
1804 #define R_DOCOMP                        0x0040
1805 #define R_COMP_CROP                     0x0080
1806 #define R_FREE_IMAGE            0x0100
1807 #define R_SINGLE_LAYER          0x0200
1808 #define R_EXR_TILE_FILE         0x0400
1809 /* #define R_COMP_FREE                  0x0800 */
1810 #define R_NO_IMAGE_LOAD         0x1000
1811 #define R_NO_TEX                        0x2000
1812 #define R_NO_FRAME_UPDATE       0x4000
1813 #define R_FULL_SAMPLE           0x8000
1814 /* #define R_DEPRECATED         0x10000 */
1815 /* #define R_RECURS_PROTECTION  0x20000 */
1816 #define R_TEXNODE_PREVIEW       0x40000
1817 #define R_VIEWPORT_PREVIEW      0x80000
1818 #define R_EXR_CACHE_FILE        0x100000
1819 #define R_MULTIVIEW                     0x200000
1820
1821 /* RenderData.stamp */
1822 #define R_STAMP_TIME    0x0001
1823 #define R_STAMP_FRAME   0x0002
1824 #define R_STAMP_DATE    0x0004
1825 #define R_STAMP_CAMERA  0x0008
1826 #define R_STAMP_SCENE   0x0010
1827 #define R_STAMP_NOTE    0x0020
1828 #define R_STAMP_DRAW    0x0040 /* draw in the image */
1829 #define R_STAMP_MARKER  0x0080
1830 #define R_STAMP_FILENAME        0x0100
1831 #define R_STAMP_SEQSTRIP        0x0200
1832 #define R_STAMP_RENDERTIME      0x0400
1833 #define R_STAMP_CAMERALENS      0x0800
1834 #define R_STAMP_STRIPMETA       0x1000
1835 #define R_STAMP_MEMORY          0x2000
1836 #define R_STAMP_HIDE_LABELS     0x4000
1837 #define R_STAMP_ALL (R_STAMP_TIME|R_STAMP_FRAME|R_STAMP_DATE|R_STAMP_CAMERA|R_STAMP_SCENE| \
1838                      R_STAMP_NOTE|R_STAMP_MARKER|R_STAMP_FILENAME|R_STAMP_SEQSTRIP|        \
1839                      R_STAMP_RENDERTIME|R_STAMP_CAMERALENS|R_STAMP_MEMORY|                 \
1840                      R_STAMP_HIDE_LABELS)
1841
1842 /* RenderData.alphamode */
1843 #define R_ADDSKY                0
1844 #define R_ALPHAPREMUL   1
1845 /*#define R_ALPHAKEY            2*/ /* deprecated, shouldn't be used */
1846
1847 /* RenderData.color_mgt_flag */
1848 enum {
1849         R_COLOR_MANAGEMENT              = (1 << 0),  /* deprecated, should only be used in versioning code only */
1850         /*R_COLOR_MANAGEMENT_PREDIVIDE    = (1 << 1)*/  /* deprecated, shouldn't be used */
1851 };
1852
1853 #ifdef DNA_DEPRECATED
1854 /* RenderData.subimtype flag options for imtype */
1855 enum {
1856         R_OPENEXR_HALF  = 1,  /*deprecated*/
1857         R_OPENEXR_ZBUF  = 2,  /*deprecated*/
1858         R_PREVIEW_JPG   = 4,  /*deprecated*/
1859         R_CINEON_LOG    = 8,  /*deprecated*/
1860         R_TIFF_16BIT    = 16, /*deprecated*/
1861
1862         R_JPEG2K_12BIT                  =     32,  /* Jpeg2000 */                    /*deprecated*/
1863         R_JPEG2K_16BIT                  =     64,                                    /*deprecated*/
1864         R_JPEG2K_YCC                    =     128,  /* when disabled use RGB */      /*deprecated*/
1865         R_JPEG2K_CINE_PRESET    =     256,                                   /*deprecated*/
1866         R_JPEG2K_CINE_48FPS             =     512,                                   /*deprecated*/
1867 };
1868 #endif
1869
1870 /* bake_mode: same as RE_BAKE_xxx defines */
1871 /* RenderData.bake_flag */
1872 #define R_BAKE_CLEAR            1
1873 #define R_BAKE_OSA                      2
1874 #define R_BAKE_TO_ACTIVE        4
1875 #define R_BAKE_NORMALIZE        8
1876 #define R_BAKE_MULTIRES         16
1877 #define R_BAKE_LORES_MESH       32
1878 #define R_BAKE_VCOL                     64
1879 #define R_BAKE_USERSCALE        128
1880 #define R_BAKE_CAGE                     256
1881 #define R_BAKE_SPLIT_MAT        512
1882 #define R_BAKE_AUTO_NAME        1024
1883
1884 /* RenderData.bake_normal_space */
1885 #define R_BAKE_SPACE_CAMERA      0
1886 #define R_BAKE_SPACE_WORLD       1
1887 #define R_BAKE_SPACE_OBJECT      2
1888 #define R_BAKE_SPACE_TANGENT 3
1889
1890 /* RenderData.simplify_flag */
1891 #define R_SIMPLE_NO_TRIANGULATE         1
1892
1893 /* RenderData.line_thickness_mode */
1894 #define R_LINE_THICKNESS_ABSOLUTE 1
1895 #define R_LINE_THICKNESS_RELATIVE 2
1896
1897 /* sequencer seq_prev_type seq_rend_type */
1898
1899 /* RenderData.engine (scene.c) */
1900 extern const char *RE_engine_id_BLENDER_RENDER;
1901 extern const char *RE_engine_id_BLENDER_GAME;
1902 extern const char *RE_engine_id_BLENDER_CLAY;
1903 extern const char *RE_engine_id_BLENDER_EEVEE;
1904 extern const char *RE_engine_id_CYCLES;
1905
1906 /* **************** SCENE ********************* */
1907
1908 /* note that much higher maxframes give imprecise sub-frames, see: T46859 */
1909 /* Current precision is 16 for the sub-frames closer to MAXFRAME. */
1910
1911 /* for general use */
1912 #define MAXFRAME        1048574
1913 #define MAXFRAMEF       1048574.0f
1914
1915 #define MINFRAME        0
1916 #define MINFRAMEF       0.0f
1917
1918 /* (minimum frame number for current-frame) */
1919 #define MINAFRAME       -1048574
1920 #define MINAFRAMEF      -1048574.0f
1921
1922 /* deprecate this! */
1923 #define TESTBASE(base)  (                                                     \
1924         (((base)->flag & BASE_SELECTED) != 0) &&                                  \
1925         (((base)->flag & BASE_VISIBLED) != 0))
1926 #define TESTBASELIB(base)  (                                                  \
1927         (((base)->flag & BASE_SELECTED) != 0) &&                                  \
1928         ((base)->object->id.lib == NULL) &&                                       \
1929         (((base)->flag & BASE_VISIBLED) != 0))
1930 #define TESTBASELIB_BGMODE(base)  (                                           \
1931         (((base)->flag & BASE_SELECTED) != 0) &&                                  \
1932         ((base)->object->id.lib == NULL) &&                                       \
1933         (((base)->flag & BASE_VISIBLED) != 0))
1934 #define BASE_EDITABLE_BGMODE(base)  (                                         \
1935         ((base)->object->id.lib == NULL) &&                                       \
1936         (((base)->flag & BASE_VISIBLED) != 0))
1937 #define BASE_SELECTABLE(base)                                                 \
1938         (((base)->flag & BASE_SELECTABLED) != 0)
1939 #define BASE_VISIBLE(base)  (                                                 \
1940         ((base)->flag & BASE_VISIBLED) != 0)
1941
1942 #define FIRSTBASE(_view_layer)  ((_view_layer)->object_bases.first)
1943 #define LASTBASE(_view_layer)   ((_view_layer)->object_bases.last)
1944 #define BASACT(_view_layer)     ((_view_layer)->basact)
1945 #define OBACT(_view_layer)      (BASACT(_view_layer) ? BASACT(_view_layer)->object: NULL)
1946
1947 #define OBEDIT_FROM_WORKSPACE(workspace, _view_layer) \
1948         (((workspace)->object_mode & OD_MODE_EDIT) ? OBACT(_view_layer) : NULL)
1949 #define OBEDIT_FROM_EVAL_CTX(eval_ctx) \
1950         (((eval_ctx)->object_mode & OB_MODE_EDIT) ? OBACT((eval_ctx)->view_layer) : NULL)
1951
1952 #define OBEDIT_FROM_WINDOW(window) \
1953         BKE_workspace_edit_object(WM_window_get_active_workspace(window), WM_window_get_active_scene(window))
1954
1955 #define V3D_CAMERA_LOCAL(v3d) ((!(v3d)->scenelock && (v3d)->camera) ? (v3d)->camera : NULL)
1956 #define V3D_CAMERA_SCENE(scene, v3d) ((!(v3d)->scenelock && (v3d)->camera) ? (v3d)->camera : (scene)->camera)
1957
1958 #define CFRA            (scene->r.cfra)
1959 #define SUBFRA          (scene->r.subframe)
1960 #define SFRA            (scene->r.sfra)
1961 #define EFRA            (scene->r.efra)
1962 #define PRVRANGEON      (scene->r.flag & SCER_PRV_RANGE)
1963 #define PSFRA           ((PRVRANGEON) ? (scene->r.psfra) : (scene->r.sfra))
1964 #define PEFRA           ((PRVRANGEON) ? (scene->r.pefra) : (scene->r.efra))
1965 #define FRA2TIME(a)     ((((double) scene->r.frs_sec_base) * (double)(a)) / (double)scene->r.frs_sec)
1966 #define TIME2FRA(a)     ((((double) scene->r.frs_sec) * (double)(a)) / (double)scene->r.frs_sec_base)
1967 #define FPS              (((double) scene->r.frs_sec) / (double)scene->r.frs_sec_base)
1968
1969 /* Base.flag is in DNA_object_types.h */
1970
1971 /* ToolSettings.snap_flag */
1972 #define SCE_SNAP                                1
1973 #define SCE_SNAP_ROTATE                 2
1974 #define SCE_SNAP_PEEL_OBJECT    4
1975 #define SCE_SNAP_PROJECT                8
1976 #define SCE_SNAP_NO_SELF                16
1977 #define SCE_SNAP_ABS_GRID               32
1978
1979 /* ToolSettings.snap_target */
1980 #define SCE_SNAP_TARGET_CLOSEST 0
1981 #define SCE_SNAP_TARGET_CENTER  1
1982 #define SCE_SNAP_TARGET_MEDIAN  2
1983 #define SCE_SNAP_TARGET_ACTIVE  3
1984 /* ToolSettings.snap_mode */
1985 #define SCE_SNAP_MODE_INCREMENT 0
1986 #define SCE_SNAP_MODE_VERTEX    1
1987 #define SCE_SNAP_MODE_EDGE              2
1988 #define SCE_SNAP_MODE_FACE              3
1989 #define SCE_SNAP_MODE_VOLUME    4
1990 #define SCE_SNAP_MODE_NODE_X    5
1991 #define SCE_SNAP_MODE_NODE_Y    6
1992 #define SCE_SNAP_MODE_NODE_XY   7
1993 #define SCE_SNAP_MODE_GRID              8
1994
1995 /* ToolSettings.selectmode */
1996 #define SCE_SELECT_VERTEX       1 /* for mesh */
1997 #define SCE_SELECT_EDGE         2
1998 #define SCE_SELECT_FACE         4
1999
2000 /* MeshStatVis.type */
2001 #define SCE_STATVIS_OVERHANG    0
2002 #define SCE_STATVIS_THICKNESS   1
2003 #define SCE_STATVIS_INTERSECT   2
2004 #define SCE_STATVIS_DISTORT             3
2005 #define SCE_STATVIS_SHARP               4
2006
2007 /* ParticleEditSettings.selectmode for particles */
2008 #define SCE_SELECT_PATH         1
2009 #define SCE_SELECT_POINT        2
2010 #define SCE_SELECT_END          4
2011
2012 /* ToolSettings.prop_mode (proportional falloff) */
2013 #define PROP_SMOOTH            0
2014 #define PROP_SPHERE            1
2015 #define PROP_ROOT              2
2016 #define PROP_SHARP             3
2017 #define PROP_LIN               4
2018 #define PROP_CONST             5
2019 #define PROP_RANDOM            6
2020 #define PROP_INVSQUARE         7
2021 #define PROP_MODE_MAX          8
2022
2023 /* ToolSettings.proportional */
2024 #define PROP_EDIT_OFF                   0
2025 #define PROP_EDIT_ON                    1
2026 #define PROP_EDIT_CONNECTED             2
2027 #define PROP_EDIT_PROJECTED             3
2028
2029 /* ToolSettings.weightuser */
2030 enum {
2031         OB_DRAW_GROUPUSER_NONE      = 0,
2032         OB_DRAW_GROUPUSER_ACTIVE    = 1,
2033         OB_DRAW_GROUPUSER_ALL       = 2
2034 };
2035
2036 /* object_vgroup.c */
2037 /* ToolSettings.vgroupsubset */
2038 typedef enum eVGroupSelect {
2039         WT_VGROUP_ALL = 0,
2040         WT_VGROUP_ACTIVE = 1,
2041         WT_VGROUP_BONE_SELECT = 2,
2042         WT_VGROUP_BONE_DEFORM = 3,
2043         WT_VGROUP_BONE_DEFORM_OFF = 4
2044 } eVGroupSelect;
2045
2046 #define WT_VGROUP_MASK_ALL \
2047         ((1 << WT_VGROUP_ACTIVE) | \
2048          (1 << WT_VGROUP_BONE_SELECT) | \
2049          (1 << WT_VGROUP_BONE_DEFORM) | \
2050          (1 << WT_VGROUP_BONE_DEFORM_OFF) | \
2051          (1 << WT_VGROUP_ALL))
2052
2053
2054 /* Scene.flag */
2055 #define SCE_DS_SELECTED                 (1<<0)
2056 #define SCE_DS_COLLAPSED                (1<<1)
2057 #define SCE_NLA_EDIT_ON                 (1<<2)
2058 #define SCE_FRAME_DROP                  (1<<3)
2059 #define SCE_KEYS_NO_SELONLY         (1<<4)
2060
2061         /* return flag BKE_scene_base_iter_next functions */
2062 /* #define F_ERROR                      -1 */  /* UNUSED */
2063 #define F_START                 0
2064 #define F_SCENE                 1
2065 #define F_DUPLI                 3
2066
2067 /* AudioData.flag */
2068 #define AUDIO_MUTE                (1<<0)
2069 #define AUDIO_SYNC                (1<<1)
2070 #define AUDIO_SCRUB                       (1<<2)
2071 #define AUDIO_VOLUME_ANIMATED     (1<<3)
2072
2073 /* FFMpegCodecData.flags */
2074 enum {
2075 #ifdef DNA_DEPRECATED
2076         FFMPEG_MULTIPLEX_AUDIO  = 1,  /* deprecated, you can choose none as audiocodec now */
2077 #endif
2078         FFMPEG_AUTOSPLIT_OUTPUT = 2,
2079         FFMPEG_LOSSLESS_OUTPUT  = 4,
2080         FFMPEG_USE_MAX_B_FRAMES = (1 << 3),
2081 };
2082
2083 /* Paint.flags */
2084 typedef enum ePaintFlags {
2085         PAINT_SHOW_BRUSH = (1 << 0),
2086         PAINT_FAST_NAVIGATE = (1 << 1),
2087         PAINT_SHOW_BRUSH_ON_SURFACE = (1 << 2),
2088         PAINT_USE_CAVITY_MASK = (1 << 3)
2089 } ePaintFlags;
2090
2091 /* Paint.symmetry_flags
2092  * (for now just a duplicate of sculpt symmetry flags) */
2093 typedef enum ePaintSymmetryFlags {
2094         PAINT_SYMM_X = (1 << 0),
2095         PAINT_SYMM_Y = (1 << 1),
2096         PAINT_SYMM_Z = (1 << 2),
2097         PAINT_SYMMETRY_FEATHER = (1 << 3),
2098         PAINT_TILE_X = (1 << 4),
2099         PAINT_TILE_Y = (1 << 5),
2100         PAINT_TILE_Z = (1 << 6),
2101 } ePaintSymmetryFlags;
2102
2103 #define PAINT_SYMM_AXIS_ALL (PAINT_SYMM_X | PAINT_SYMM_Y | PAINT_SYMM_Z)
2104
2105 /* Sculpt.flags */
2106 /* These can eventually be moved to paint flags? */
2107 typedef enum eSculptFlags {
2108 #ifdef DNA_DEPRECATED
2109         /* deprecated, part of paint struct symmetry_flags now */
2110         SCULPT_SYMM_X = (1 << 0),
2111         SCULPT_SYMM_Y = (1 << 1),
2112         SCULPT_SYMM_Z = (1 << 2),
2113 #endif
2114
2115         SCULPT_LOCK_X = (1 << 3),
2116         SCULPT_LOCK_Y = (1 << 4),
2117         SCULPT_LOCK_Z = (1 << 5),
2118         /* deprecated, part of paint struct symmetry_flags now */
2119         SCULPT_SYMMETRY_FEATHER = (1 << 6),
2120
2121         SCULPT_USE_OPENMP = (1 << 7),
2122         SCULPT_ONLY_DEFORM = (1 << 8),
2123         SCULPT_SHOW_DIFFUSE = (1 << 9),
2124
2125         /* If set, the mesh will be drawn with smooth-shading in
2126          * dynamic-topology mode */
2127         SCULPT_DYNTOPO_SMOOTH_SHADING = (1 << 10),
2128
2129         /* If set, dynamic-topology brushes will subdivide short edges */
2130         SCULPT_DYNTOPO_SUBDIVIDE = (1 << 12),
2131         /* If set, dynamic-topology brushes will collapse short edges */
2132         SCULPT_DYNTOPO_COLLAPSE = (1 << 11),
2133
2134         /* If set, dynamic-topology detail size will be constant in object space */
2135         SCULPT_DYNTOPO_DETAIL_CONSTANT = (1 << 13),
2136         SCULPT_DYNTOPO_DETAIL_BRUSH = (1 << 14),
2137
2138         /* Don't display mask in viewport, but still use it for strokes. */
2139         SCULPT_HIDE_MASK = (1 << 15),
2140 } eSculptFlags;
2141
2142 /* ImagePaintSettings.mode */
2143 typedef enum eImagePaintMode {
2144         IMAGEPAINT_MODE_MATERIAL, /* detect texture paint slots from the material */
2145         IMAGEPAINT_MODE_IMAGE,    /* select texture paint image directly */
2146 } eImagePaintMode;
2147
2148 /* ImagePaintSettings.flag */
2149 #define IMAGEPAINT_DRAWING                              1
2150 // #define IMAGEPAINT_DRAW_TOOL                 2 // deprecated
2151 // #define IMAGEPAINT_DRAW_TOOL_DRAWING 4 // deprecated
2152
2153 /* projection painting only */
2154 /* ImagePaintSettings.flag */
2155 #define IMAGEPAINT_PROJECT_XRAY                 (1 << 4)
2156 #define IMAGEPAINT_PROJECT_BACKFACE             (1 << 5)
2157 #define IMAGEPAINT_PROJECT_FLAT                 (1 << 6)
2158 #define IMAGEPAINT_PROJECT_LAYER_CLONE  (1 << 7)
2159 #define IMAGEPAINT_PROJECT_LAYER_STENCIL        (1 << 8)
2160 #define IMAGEPAINT_PROJECT_LAYER_STENCIL_INV    (1 << 9)
2161
2162 /* ImagePaintSettings.missing_data */
2163 #define IMAGEPAINT_MISSING_UVS       (1 << 0)
2164 #define IMAGEPAINT_MISSING_MATERIAL  (1 << 1)
2165 #define IMAGEPAINT_MISSING_TEX       (1 << 2)
2166 #define IMAGEPAINT_MISSING_STENCIL   (1 << 3)
2167
2168 /* ToolSettings.uvcalc_flag */
2169 #define UVCALC_FILLHOLES                        1
2170 #define UVCALC_NO_ASPECT_CORRECT        2       /* would call this UVCALC_ASPECT_CORRECT, except it should be default with old file */
2171 #define UVCALC_TRANSFORM_CORRECT        4       /* adjust UV's while transforming to avoid distortion */
2172 #define UVCALC_USESUBSURF                       8       /* Use mesh data after subsurf to compute UVs*/
2173
2174 /* ToolSettings.uv_flag */
2175 #define UV_SYNC_SELECTION       1
2176 #define UV_SHOW_SAME_IMAGE      2
2177
2178 /* ToolSettings.uv_selectmode */
2179 #define UV_SELECT_VERTEX        1
2180 #define UV_SELECT_EDGE          2
2181 #define UV_SELECT_FACE          4
2182 #define UV_SELECT_ISLAND        8
2183
2184 /* ToolSettings.edge_mode */
2185 #define EDGE_MODE_SELECT                                0
2186 #define EDGE_MODE_TAG_SEAM                              1
2187 #define EDGE_MODE_TAG_SHARP                             2
2188 #define EDGE_MODE_TAG_CREASE                    3
2189 #define EDGE_MODE_TAG_BEVEL                             4
2190 #define EDGE_MODE_TAG_FREESTYLE                 5
2191
2192 /* ToolSettings.gpencil_flags */
2193 typedef enum eGPencil_Flags {
2194         /* "Continuous Drawing" - The drawing operator enters a mode where multiple strokes can be drawn */
2195         GP_TOOL_FLAG_PAINTSESSIONS_ON       = (1 << 0),
2196         /* When creating new frames, the last frame gets used as the basis for the new one */
2197         GP_TOOL_FLAG_RETAIN_LAST            = (1 << 1),
2198         /* Add the strokes below all strokes in the layer */
2199         GP_TOOL_FLAG_PAINT_ONBACK = (1 << 2)
2200 } eGPencil_Flags;
2201
2202 /* ToolSettings.gpencil_src */
2203 typedef enum eGPencil_Source_3D {
2204         GP_TOOL_SOURCE_SCENE    = 0,
2205         GP_TOOL_SOURCE_OBJECT   = 1
2206 } eGPencil_Source_3d;
2207
2208 /* ToolSettings.gpencil_*_align - Stroke Placement mode flags */
2209 typedef enum eGPencil_Placement_Flags {
2210         /* New strokes are added in viewport/data space (i.e. not screen space) */
2211         GP_PROJECT_VIEWSPACE    = (1 << 0),
2212         
2213         /* Viewport space, but relative to render canvas (Sequencer Preview Only) */
2214         GP_PROJECT_CANVAS       = (1 << 1),
2215         
2216         /* Project into the screen's Z values */
2217         GP_PROJECT_DEPTH_VIEW   = (1 << 2),
2218         GP_PROJECT_DEPTH_STROKE = (1 << 3),
2219         
2220         /* "Use Endpoints" */
2221         GP_PROJECT_DEPTH_STROKE_ENDPOINTS = (1 << 4),
2222 } eGPencil_Placement_Flags;
2223
2224 /* ToolSettings.particle flag */
2225 #define PE_KEEP_LENGTHS                 1
2226 #define PE_LOCK_FIRST                   2
2227 #define PE_DEFLECT_EMITTER              4
2228 #define PE_INTERPOLATE_ADDED    8
2229 #define PE_DRAW_PART                    16
2230 /* #define PE_X_MIRROR                  64 */   /* deprecated */
2231 #define PE_FADE_TIME                    128
2232 #define PE_AUTO_VELOCITY                256
2233
2234 /* ParticleEditSettings.brushtype */
2235 #define PE_BRUSH_NONE           -1
2236 #define PE_BRUSH_COMB           0
2237 #define PE_BRUSH_CUT            1
2238 #define PE_BRUSH_LENGTH         2
2239 #define PE_BRUSH_PUFF           3
2240 #define PE_BRUSH_ADD            4
2241 #define PE_BRUSH_SMOOTH         5
2242 #define PE_BRUSH_WEIGHT         6
2243
2244 /* ParticleBrushData.flag */
2245 #define PE_BRUSH_DATA_PUFF_VOLUME 1
2246
2247 /* ParticleBrushData.edittype */
2248 #define PE_TYPE_PARTICLES       0
2249 #define PE_TYPE_SOFTBODY        1
2250 #define PE_TYPE_CLOTH           2
2251
2252 /* ToolSettings.skgen_options */
2253 #define SKGEN_FILTER_INTERNAL   (1 << 0)
2254 #define SKGEN_FILTER_EXTERNAL   (1 << 1)
2255 #define SKGEN_SYMMETRY                  (1 << 2)
2256 #define SKGEN_CUT_LENGTH                (1 << 3)
2257 #define SKGEN_CUT_ANGLE                 (1 << 4)
2258 #define SKGEN_CUT_CORRELATION   (1 << 5)
2259 #define SKGEN_HARMONIC                  (1 << 6)
2260 #define SKGEN_STICK_TO_EMBEDDING        (1 << 7)
2261 #define SKGEN_ADAPTIVE_DISTANCE         (1 << 8)
2262 #define SKGEN_FILTER_SMART              (1 << 9)
2263 #define SKGEN_DISP_LENGTH               (1 << 10)
2264 #define SKGEN_DISP_WEIGHT               (1 << 11)
2265 #define SKGEN_DISP_ORIG                 (1 << 12)
2266 #define SKGEN_DISP_EMBED                (1 << 13)
2267 #define SKGEN_DISP_INDEX                (1 << 14)
2268
2269 #define SKGEN_SUB_LENGTH                0
2270 #define SKGEN_SUB_ANGLE                 1
2271 #define SKGEN_SUB_CORRELATION   2
2272 #define SKGEN_SUB_TOTAL                 3
2273
2274 /* ToolSettings.skgen_postpro */
2275 #define SKGEN_SMOOTH                    0
2276 #define SKGEN_AVERAGE                   1
2277 #define SKGEN_SHARPEN                   2
2278
2279 /* ToolSettings.bone_sketching */
2280 #define BONE_SKETCHING                  1
2281 #define BONE_SKETCHING_QUICK    2
2282 #define BONE_SKETCHING_ADJUST   4
2283
2284 /* ToolSettings.bone_sketching_convert */
2285 #define SK_CONVERT_CUT_FIXED                    0
2286 #define SK_CONVERT_CUT_LENGTH                   1
2287 #define SK_CONVERT_CUT_ADAPTATIVE               2
2288 #define SK_CONVERT_RETARGET                             3
2289
2290 /* ToolSettings.skgen_retarget_options */
2291 #define SK_RETARGET_AUTONAME                    1
2292
2293 /* ToolSettings.skgen_retarget_roll */
2294 #define SK_RETARGET_ROLL_NONE                   0
2295 #define SK_RETARGET_ROLL_VIEW                   1
2296 #define SK_RETARGET_ROLL_JOINT                  2
2297
2298 /* PhysicsSettings.flag */
2299 #define PHYS_GLOBAL_GRAVITY             1
2300
2301 /* UnitSettings */
2302
2303 /* UnitSettings.system */
2304 #define USER_UNIT_NONE                  0
2305 #define USER_UNIT_METRIC                1
2306 #define USER_UNIT_IMPERIAL              2
2307 /* UnitSettings.flag */
2308 #define USER_UNIT_OPT_SPLIT             1
2309 #define USER_UNIT_ROT_RADIANS   2
2310
2311 #ifdef __cplusplus
2312 }
2313 #endif
2314
2315 #endif  /* __DNA_SCENE_TYPES_H__ */