svn merge -r 15649:15800 https://svn.blender.org/svnroot/bf-blender/trunk/blender...
[blender-staging.git] / source / blender / makesdna / DNA_object_types.h
1 /**
2  * blenlib/DNA_object_types.h (mar-2001 nzc)
3  *      
4  * Object is a sort of wrapper for general info.
5  *
6  * $Id$ 
7  *
8  * ***** BEGIN GPL LICENSE BLOCK *****
9  *
10  * This program is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU General Public License
12  * as published by the Free Software Foundation; either version 2
13  * of the License, or (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program; if not, write to the Free Software Foundation,
22  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
23  *
24  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
25  * All rights reserved.
26  *
27  * The Original Code is: all of this file.
28  *
29  * Contributor(s): none yet.
30  *
31  * ***** END GPL LICENSE BLOCK *****
32  */
33 #ifndef DNA_OBJECT_TYPES_H
34 #define DNA_OBJECT_TYPES_H
35
36 #include "DNA_listBase.h"
37 #include "DNA_ID.h"
38 #include "DNA_scriptlink_types.h"
39
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43
44 struct bPose;   
45 struct Object;
46 struct Ipo;
47 struct BoundBox;
48 struct Path;
49 struct Material;
50 struct bConstraintChannel;
51 struct PartDeflect;
52 struct SoftBody;
53 struct FluidsimSettings;
54 struct ParticleSystem;
55 struct DerivedMesh;
56
57 typedef struct bDeformGroup {
58         struct bDeformGroup *next, *prev;
59         char name[32];
60 } bDeformGroup;
61
62 /**
63  * The following illustrates the orientation of the 
64  * bounding box in local space
65  * 
66  *  
67  * Z  Y
68  * | /
69  * |/
70  * .-----X
71  * 
72  * 
73  *     2----------6
74  *    /|         /|
75  *   / |        / |
76  *  1----------5  |
77  *  |  |       |  |
78  *  |  3-------|--7
79  *  | /        | /
80  *  |/         |/
81  *  0----------4
82  */
83 typedef struct BoundBox {
84         float vec[8][3];
85         int flag, pad;
86 } BoundBox;
87
88 /* boundbox flag */
89 #define OB_BB_DISABLED  1
90
91 typedef struct Object {
92         ID id;
93
94         short type, partype;
95         int par1, par2, par3;   /* can be vertexnrs */
96         char parsubstr[32];     /* String describing subobject info */
97         struct Object *parent, *track;
98         /* if ob->proxy (or proxy_group), this object is proxy for object ob->proxy */
99         /* proxy_from is set in target back to the proxy. */
100         struct Object *proxy, *proxy_group, *proxy_from;
101         struct Ipo *ipo;
102         struct Path *path;
103         struct BoundBox *bb;
104         struct bAction *action; 
105         struct bAction *poselib;
106         struct bPose *pose;     
107         void *data;
108         
109         ListBase constraintChannels;
110         ListBase effect;
111         ListBase disp;
112         ListBase defbase;
113         ListBase modifiers; /* list of ModifierData structures */
114         
115         struct Material **mat;
116         
117         /* rot en drot have to be together! (transform('r' en 's')) */
118         float loc[3], dloc[3], orig[3];
119         float size[3], dsize[3];
120         float rot[3], drot[3];
121         /* float quat[4], dquat[4]; (not used yet) */
122         float obmat[4][4];
123         float parentinv[4][4]; /* inverse result of parent, so that object doesn't 'stick' to parent */
124         float constinv[4][4]; /* inverse result of constraints. doesn't include effect of parent or object local transform */
125         float imat[4][4];       /* for during render, old game engine, temporally: ipokeys of transform  */
126         
127         unsigned int lay;                               /* copy of Base */
128         
129         short flag;                     /* copy of Base */
130         short colbits;          /* when zero, from obdata */
131         
132         short transflag, ipoflag;       /* transformation and ipo settings */
133         short trackflag, upflag;
134         short nlaflag, protectflag;     /* nlaflag defines NLA override, protectflag is bits to lock transform */
135         short ipowin, scaflag;          /* ipowin: blocktype last ipowindow */
136         short scavisflag, boundtype;
137         
138         int dupon, dupoff, dupsta, dupend;
139
140         float sf, ctime; /* sf is time-offset, ctime is the objects current time */
141         
142         /* during realtime */
143
144         /* note that inertia is only called inertia for historical reasons
145          * and is not changed to avoid DNA surgery. It actually reflects the 
146          * Size value in the GameButtons (= radius) */
147
148         float mass, damping, inertia;
149         /* The form factor k is introduced to give the user more control
150          * and to fix incompatibility problems.
151      * For rotational symmetric objects, the inertia value can be
152          * expressed as: Theta = k * m * r^2
153          * where m = Mass, r = Radius
154          * For a Sphere, the form factor is by default = 0.4
155          */
156
157         float formfactor;
158         float rdamping, sizefac;
159         
160         char dt, dtx;
161         char totcol;    /* copy of mesh or curve or meta */
162         char actcol;    /* currently selected material in the user interface */
163         char empty_drawtype, pad1[3];
164         float empty_drawsize;
165         float dupfacesca;       /* dupliface scale */
166         
167         ScriptLink scriptlink;
168         ListBase prop;
169         ListBase sensors;
170         ListBase controllers;
171         ListBase actuators;
172     
173         float bbsize[3];
174         short index;                    /* custom index, for renderpasses */
175         unsigned short actdef;  /* current deformation group */
176         float col[4];                   /* object color, adjusted via IPO's only */
177         /**
178          * Settings for game objects
179          * bit 0: Object has dynamic behaviour
180          * bit 2: Object is evaluated by the gameengine
181          * bit 6: Use Fh settings in Materials
182          * bit 7: Use face normal to rotate Object
183          * bit 8: Friction is anisotropic
184          * bit 9: Object is a ghost
185          * bit 10: Do rigid body dynamics.
186          * bit 11: Use bounding object for physics
187          */
188         int gameflag;
189         /**
190          * More settings
191          * bit 15: Always ignore activity culling 
192          */
193         int gameflag2;
194         short softflag;                 /* softboday settings */
195         short recalc;                   /* dependency flag */
196         float anisotropicFriction[3];
197
198         ListBase constraints;
199         ListBase nlastrips;
200         ListBase hooks;
201         ListBase particlesystem;        /* particle systems */
202         
203         struct PartDeflect *pd;         /* particle deflector/attractor/collision data */
204         struct SoftBody *soft;          /* if exists, saved in file */
205         struct Group *dup_group;        /* object duplicator for group */
206         
207         short fluidsimFlag;                     /* NT toggle fluidsim participation on/off */
208         
209         short restrictflag;                     /* for restricting view, select, render etc. accessible in outliner */
210
211         short shapenr, shapeflag;       /* current shape key for menu or pinned, flag for pinning */
212         float smoothresh;                       /* smoothresh is phong interpolation ray_shadow correction in render */
213         short recalco, pad4;            /* recalco for temp storage of ob->recalc, bad design warning */
214         
215         struct FluidsimSettings *fluidsimSettings; /* if fluidsim enabled, store additional settings */
216
217         struct DerivedMesh *derivedDeform, *derivedFinal;
218         int lastDataMask;                       /* the custom data layer mask that was last used to calculate derivedDeform and derivedFinal */
219         unsigned int state;                     /* bit masks of game controllers that are active */
220         unsigned int init_state;        /* bit masks of initial state as recorded by the users */
221         int pad2;
222
223 /*#ifdef WITH_VERSE*/
224         void *vnode;                    /* pointer at object VerseNode */
225 /*#endif*/
226 } Object;
227
228 /* Warning, this is not used anymore because hooks are now modifiers */
229 typedef struct ObHook {
230         struct ObHook *next, *prev;
231         
232         struct Object *parent;
233         float parentinv[4][4];  /* matrix making current transform unmodified */
234         float mat[4][4];                /* temp matrix while hooking */
235         float cent[3];                  /* visualization of hook */
236         float falloff;                  /* if not zero, falloff is distance where influence zero */
237         
238         char name[32];
239
240         int *indexar;
241         int totindex, curindex; /* curindex is cache for fast lookup */
242         short type, active;             /* active is only first hook, for button menu */
243         float force;
244 } ObHook;
245
246
247 /* this work object is defined in object.c */
248 extern Object workob;
249
250
251 /* **************** OBJECT ********************* */
252
253 /* used many places... should be specialized  */
254 #define SELECT                  1
255
256 /* type */
257 #define OB_EMPTY                0
258 #define OB_MESH                 1
259 #define OB_CURVE                2
260 #define OB_SURF                 3
261 #define OB_FONT                 4
262 #define OB_MBALL                5
263
264 #define OB_LAMP                 10
265 #define OB_CAMERA               11
266
267 #define OB_WAVE                 21
268 #define OB_LATTICE              22
269
270 /* 23 and 24 are for life and sector (old file compat.) */
271 #define OB_ARMATURE             25
272
273 /* partype: first 4 bits: type */
274 #define PARTYPE                 15
275 #define PAROBJECT               0
276 #define PARCURVE                1
277 #define PARKEY                  2
278
279 #define PARSKEL                 4
280 #define PARVERT1                5
281 #define PARVERT3                6
282 #define PARBONE                 7
283 #define PARSLOW                 16
284
285 /* (short) transflag */
286 #define OB_OFFS_LOCAL           1
287 #define OB_QUAT                         2
288 #define OB_NEG_SCALE            4
289 #define OB_DUPLI                        (8+16+256+512+2048)
290 #define OB_DUPLIFRAMES          8
291 #define OB_DUPLIVERTS           16
292 #define OB_DUPLIROT                     32
293 #define OB_DUPLINOSPEED         64
294 #define OB_POWERTRACK           128
295 #define OB_DUPLIGROUP           256
296 #define OB_DUPLIFACES           512
297 #define OB_DUPLIFACES_SCALE     1024
298 #define OB_DUPLIPARTS           2048
299 #define OB_RENDER_DUPLI         4096
300
301 /* (short) ipoflag */
302 #define OB_DRAWKEY                      1
303 #define OB_DRAWKEYSEL           2
304 #define OB_OFFS_OB                      4
305 #define OB_OFFS_MAT                     8
306 #define OB_OFFS_VKEY            16
307 #define OB_OFFS_PATH            32
308 #define OB_OFFS_PARENT          64
309 #define OB_OFFS_PARTICLE        128
310         /* get ipo from from action or not? */
311 #define OB_ACTION_OB            256
312 #define OB_ACTION_KEY           512
313         /* for stride edit */
314 #define OB_DISABLE_PATH         1024
315
316 #define OB_OFFS_PARENTADD       2048
317
318
319 /* (short) trackflag / upflag */
320 #define OB_POSX                 0
321 #define OB_POSY                 1
322 #define OB_POSZ                 2
323 #define OB_NEGX                 3
324 #define OB_NEGY                 4
325 #define OB_NEGZ                 5
326
327 /* gameflag in game.h */
328
329 /* dt: no flags */
330 #define OB_BOUNDBOX             1
331 #define OB_WIRE                 2
332 #define OB_SOLID                3
333 #define OB_SHADED               4
334 #define OB_TEXTURE              5
335
336 /* this condition has been made more complex since editmode can draw textures */
337 #define CHECK_OB_DRAWTEXTURE(vd, dt) \
338         ((vd->drawtype==OB_TEXTURE && dt>OB_SOLID) || \
339         (vd->drawtype==OB_SOLID && vd->flag2 & V3D_SOLID_TEX))
340
341 #define CHECK_OB_DRAWFACEDOT(sce, vd, dt) \
342         (       (sce->selectmode & SCE_SELECT_FACE) && \
343                 (vd->drawtype<=OB_SOLID) && \
344                 (((vd->drawtype==OB_SOLID) && (dt>=OB_SOLID) && (vd->flag2 & V3D_SOLID_TEX) && (vd->flag & V3D_ZBUF_SELECT)) == 0) \
345         )
346
347
348 /* dtx: flags, char! */
349 #define OB_AXIS                 2
350 #define OB_TEXSPACE             4
351 #define OB_DRAWNAME             8
352 #define OB_DRAWIMAGE    16
353         /* for solid+wire display */
354 #define OB_DRAWWIRE             32
355         /* for overdraw */
356 #define OB_DRAWXRAY             64
357         /* enable transparent draw */
358 #define OB_DRAWTRANSP   128
359
360 /* empty_drawtype: no flags */
361 #define OB_ARROWS               1
362 #define OB_PLAINAXES    2
363 #define OB_CIRCLE               3
364 #define OB_SINGLE_ARROW 4
365 #define OB_CUBE                 5
366 #define OB_EMPTY_SPHERE 6
367 #define OB_EMPTY_CONE   7
368
369 /* boundtype */
370 #define OB_BOUND_BOX            0
371 #define OB_BOUND_SPHERE         1
372 #define OB_BOUND_CYLINDER       2
373 #define OB_BOUND_CONE           3
374 #define OB_BOUND_POLYH          4
375 #define OB_BOUND_POLYT          5
376 #define OB_BOUND_DYN_MESH   6
377
378
379 /* **************** BASE ********************* */
380
381 /* also needed for base!!!!! or rather, thy interfere....*/
382 /* base->flag and ob->flag */
383 #define BA_WAS_SEL                      2
384 #define BA_HAS_RECALC_OB        4
385 #define BA_HAS_RECALC_DATA      8
386
387 #define BA_DO_IPO                       32
388
389 #define BA_FROMSET                      128
390
391 /* an initial attempt as making selection more specific! */
392 #define BA_DESELECT     0
393 #define BA_SELECT               1
394
395
396 #define OB_FROMDUPLI            512
397 #define OB_DONE                         1024
398 #define OB_RADIO                        2048
399 #define OB_FROMGROUP            4096
400 #define OB_POSEMODE                     8192
401
402 /* ob->recalc (flag bits!) */
403 #define OB_RECALC_OB            1
404 #define OB_RECALC_DATA          2
405                 /* time flag is set when time changes need recalc, so baked systems can ignore it */
406 #define OB_RECALC_TIME          4
407 #define OB_RECALC                       7
408
409 /* ob->gameflag */
410 #define OB_DYNAMIC              1
411 #define OB_CHILD                2
412 #define OB_ACTOR                4
413 #define OB_INERTIA_LOCK_X       8
414 #define OB_INERTIA_LOCK_Y       16
415 #define OB_INERTIA_LOCK_Z       32
416 #define OB_DO_FH                        64
417 #define OB_ROT_FH                       128
418 #define OB_ANISOTROPIC_FRICTION 256
419 #define OB_GHOST                        512
420 #define OB_RIGID_BODY           1024
421 #define OB_BOUNDS               2048
422
423 #define OB_COLLISION_RESPONSE   4096
424 #define OB_SECTOR               8192
425 #define OB_PROP                 16384
426 #define OB_MAINACTOR    32768
427
428 /* ob->gameflag2 */
429 #define OB_NEVER_DO_ACTIVITY_CULLING    1
430
431 #define OB_LIFE                 (OB_PROP|OB_DYNAMIC|OB_ACTOR|OB_MAINACTOR|OB_CHILD)
432
433 /* ob->scavisflag */
434 #define OB_VIS_SENS             1
435 #define OB_VIS_CONT             2
436 #define OB_VIS_ACT              4
437
438 /* ob->scaflag */
439 #define OB_SHOWSENS             64
440 #define OB_SHOWACT              128
441 #define OB_ADDSENS              256
442 #define OB_ADDCONT              512
443 #define OB_ADDACT               1024
444 #define OB_SHOWCONT             2048
445 #define OB_SETSTBIT             4096
446 #define OB_INITSTBIT    8192
447
448 /* ob->restrictflag */
449 #define OB_RESTRICT_VIEW        1
450 #define OB_RESTRICT_SELECT      2
451 #define OB_RESTRICT_RENDER      4
452
453 /* ob->shapeflag */
454 #define OB_SHAPE_LOCK           1
455 #define OB_SHAPE_TEMPLOCK       2
456
457 /* ob->nlaflag */
458 #define OB_NLA_OVERRIDE         1
459 #define OB_NLA_COLLAPSED        2
460
461 /* ob->protectflag */
462 #define OB_LOCK_LOCX    1
463 #define OB_LOCK_LOCY    2
464 #define OB_LOCK_LOCZ    4
465 #define OB_LOCK_LOC             7
466 #define OB_LOCK_ROTX    8
467 #define OB_LOCK_ROTY    16
468 #define OB_LOCK_ROTZ    32
469 #define OB_LOCK_ROT             56
470 #define OB_LOCK_SCALEX  64
471 #define OB_LOCK_SCALEY  128
472 #define OB_LOCK_SCALEZ  256
473 #define OB_LOCK_SCALE   448
474
475 /* ob->softflag in DNA_object_force.h */
476
477 #ifdef __cplusplus
478 }
479 #endif
480
481 #endif
482
483