Merge from 2.5 r20991 through r21037
[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 AnimData;
47 struct Ipo;
48 struct BoundBox;
49 struct Path;
50 struct Material;
51 struct bConstraintChannel;
52 struct PartDeflect;
53 struct SoftBody;
54 struct FluidsimSettings;
55 struct ParticleSystem;
56 struct DerivedMesh;
57
58 typedef struct bDeformGroup {
59         struct bDeformGroup *next, *prev;
60         char name[32];
61 } bDeformGroup;
62
63 /**
64  * The following illustrates the orientation of the 
65  * bounding box in local space
66  * 
67  *  
68  * Z  Y
69  * | /
70  * |/
71  * .-----X
72  * 
73  * 
74  *     2----------6
75  *    /|         /|
76  *   / |        / |
77  *  1----------5  |
78  *  |  |       |  |
79  *  |  3-------|--7
80  *  | /        | /
81  *  |/         |/
82  *  0----------4
83  */
84 typedef struct BoundBox {
85         float vec[8][3];
86         int flag, pad;
87 } BoundBox;
88
89 /* boundbox flag */
90 #define OB_BB_DISABLED  1
91
92 typedef struct Object {
93         ID id;
94         struct AnimData *adt;           /* animation data (must be immediately after id for utilities to use it) */ 
95         
96         short type, partype;
97         int par1, par2, par3;   /* can be vertexnrs */
98         char parsubstr[32];     /* String describing subobject info */
99         struct Object *parent, *track;
100         /* if ob->proxy (or proxy_group), this object is proxy for object ob->proxy */
101         /* proxy_from is set in target back to the proxy. */
102         struct Object *proxy, *proxy_group, *proxy_from;
103         struct Ipo *ipo;                // XXX depreceated... old animation system
104         struct Path *path;
105         struct BoundBox *bb;
106         struct bAction *action;  // XXX depreceated... old animation system
107         struct bAction *poselib;
108         struct bPose *pose;     
109         void *data;
110         
111         ListBase constraintChannels; // XXX depreceated... old animation system
112         ListBase effect;
113         ListBase disp;
114         ListBase defbase;
115         ListBase modifiers; /* list of ModifierData structures */
116         
117         struct Material **mat;
118         
119         /* rot en drot have to be together! (transform('r' en 's')) */
120         float loc[3], dloc[3], orig[3];
121         float size[3], dsize[3];
122         float rot[3], drot[3];
123         /* float quat[4], dquat[4]; (not used yet) */
124         float obmat[4][4];
125         float parentinv[4][4]; /* inverse result of parent, so that object doesn't 'stick' to parent */
126         float constinv[4][4]; /* inverse result of constraints. doesn't include effect of parent or object local transform */
127         float imat[4][4];       /* for during render, old game engine, temporally: ipokeys of transform  */
128         
129         unsigned int lay;                               /* copy of Base */
130         
131         short flag;                     /* copy of Base */
132         short colbits;          /* when zero, from obdata */
133         
134         short transflag, protectflag;   /* transformation settings and transform locks  */
135         short trackflag, upflag;
136         short nlaflag, ipoflag;         // xxx depreceated... old animation system
137         short ipowin, scaflag;          /* ipowin: blocktype last ipowindow */
138         short scavisflag, boundtype;
139         
140         int dupon, dupoff, dupsta, dupend;
141
142         float sf, ctime; /* sf is time-offset, ctime is the objects current time (XXX timing needs to be revised) */
143         
144         /* during realtime */
145
146         /* note that inertia is only called inertia for historical reasons
147          * and is not changed to avoid DNA surgery. It actually reflects the 
148          * Size value in the GameButtons (= radius) */
149
150         float mass, damping, inertia;
151         /* The form factor k is introduced to give the user more control
152          * and to fix incompatibility problems.
153      * For rotational symmetric objects, the inertia value can be
154          * expressed as: Theta = k * m * r^2
155          * where m = Mass, r = Radius
156          * For a Sphere, the form factor is by default = 0.4
157          */
158
159         float formfactor;
160         float rdamping, sizefac;
161         float margin;
162         float max_vel; /* clamp the maximum velocity 0.0 is disabled */
163         float min_vel; /* clamp the maximum velocity 0.0 is disabled */
164         float m_contactProcessingThreshold;
165
166         char dt, dtx;
167         char totcol;    /* copy of mesh or curve or meta */
168         char actcol;    /* currently selected material in the user interface */
169         char empty_drawtype, pad1[3];
170         float empty_drawsize;
171         float dupfacesca;       /* dupliface scale */
172         
173         ScriptLink scriptlink;
174         ListBase prop;
175         ListBase sensors;
176         ListBase controllers;
177         ListBase actuators;
178     
179         float bbsize[3];
180         short index;                    /* custom index, for renderpasses */
181         unsigned short actdef;  /* current deformation group */
182         float col[4];                   /* object color, adjusted via IPO's only */
183         /**
184          * Settings for game objects
185          * bit 0: Object has dynamic behaviour
186          * bit 2: Object is evaluated by the gameengine
187          * bit 6: Use Fh settings in Materials
188          * bit 7: Use face normal to rotate Object
189          * bit 8: Friction is anisotropic
190          * bit 9: Object is a ghost
191          * bit 10: Do rigid body dynamics.
192          * bit 11: Use bounding object for physics
193          */
194         int gameflag;
195         /**
196          * More settings
197          * bit 15: Always ignore activity culling 
198          */
199         int gameflag2;
200         struct BulletSoftBody *bsoft;   /* settings for game engine bullet soft body */
201
202         short softflag;                 /* softbody settings */
203         short recalc;                   /* dependency flag */
204         float anisotropicFriction[3];
205
206         ListBase constraints;
207         ListBase nlastrips;                     // XXX depreceated... old animation system
208         ListBase hooks;
209         ListBase particlesystem;        /* particle systems */
210         
211         struct PartDeflect *pd;         /* particle deflector/attractor/collision data */
212         struct SoftBody *soft;          /* if exists, saved in file */
213         struct Group *dup_group;        /* object duplicator for group */
214         
215         short fluidsimFlag;                     /* NT toggle fluidsim participation on/off */
216         
217         short restrictflag;                     /* for restricting view, select, render etc. accessible in outliner */
218
219         short shapenr, shapeflag;       /* current shape key for menu or pinned, flag for pinning */
220         float smoothresh;                       /* smoothresh is phong interpolation ray_shadow correction in render */
221         short recalco;                          /* recalco for temp storage of ob->recalc, bad design warning */
222         short body_type;                        /* for now used to temporarily holds the type of collision object */
223         
224         struct FluidsimSettings *fluidsimSettings; /* if fluidsim enabled, store additional settings */
225
226         struct DerivedMesh *derivedDeform, *derivedFinal;
227         int lastDataMask;                       /* the custom data layer mask that was last used to calculate derivedDeform and derivedFinal */
228         unsigned int state;                     /* bit masks of game controllers that are active */
229         unsigned int init_state;        /* bit masks of initial state as recorded by the users */
230         int pad2;
231
232         ListBase gpulamp;               /* runtime, for lamps only */
233         ListBase *duplilist;    /* only for internal use by RNA API functions. To get dupli list, use object_duplilist instead */
234 } Object;
235
236 /* Warning, this is not used anymore because hooks are now modifiers */
237 typedef struct ObHook {
238         struct ObHook *next, *prev;
239         
240         struct Object *parent;
241         float parentinv[4][4];  /* matrix making current transform unmodified */
242         float mat[4][4];                /* temp matrix while hooking */
243         float cent[3];                  /* visualization of hook */
244         float falloff;                  /* if not zero, falloff is distance where influence zero */
245         
246         char name[32];
247
248         int *indexar;
249         int totindex, curindex; /* curindex is cache for fast lookup */
250         short type, active;             /* active is only first hook, for button menu */
251         float force;
252 } ObHook;
253
254 typedef struct DupliObject {
255         struct DupliObject *next, *prev;
256         struct Object *ob;
257         unsigned int origlay;
258         int index, no_draw, type, animated;
259         float mat[4][4], omat[4][4];
260         float orco[3], uv[2];
261 } DupliObject;
262
263 /* this work object is defined in object.c */
264 extern Object workob;
265
266
267 /* **************** OBJECT ********************* */
268
269 /* used many places... should be specialized  */
270 #define SELECT                  1
271
272 /* type */
273 #define OB_EMPTY                0
274 #define OB_MESH                 1
275 #define OB_CURVE                2
276 #define OB_SURF                 3
277 #define OB_FONT                 4
278 #define OB_MBALL                5
279
280 #define OB_LAMP                 10
281 #define OB_CAMERA               11
282
283 #define OB_WAVE                 21
284 #define OB_LATTICE              22
285
286 /* 23 and 24 are for life and sector (old file compat.) */
287 #define OB_ARMATURE             25
288
289 /* partype: first 4 bits: type */
290 #define PARTYPE                 15
291 #define PAROBJECT               0
292 #define PARCURVE                1
293 #define PARKEY                  2
294
295 #define PARSKEL                 4
296 #define PARVERT1                5
297 #define PARVERT3                6
298 #define PARBONE                 7
299 #define PARSLOW                 16
300
301 /* (short) transflag */
302 #define OB_OFFS_LOCAL           1
303 #define OB_QUAT                         2
304 #define OB_NEG_SCALE            4
305 #define OB_DUPLI                        (8+16+256+512+2048)
306 #define OB_DUPLIFRAMES          8
307 #define OB_DUPLIVERTS           16
308 #define OB_DUPLIROT                     32
309 #define OB_DUPLINOSPEED         64
310 #define OB_POWERTRACK           128
311 #define OB_DUPLIGROUP           256
312 #define OB_DUPLIFACES           512
313 #define OB_DUPLIFACES_SCALE     1024
314 #define OB_DUPLIPARTS           2048
315 #define OB_RENDER_DUPLI         4096
316
317 /* (short) ipoflag */
318         // XXX depreceated - old animation system crap
319 #define OB_DRAWKEY                      1
320 #define OB_DRAWKEYSEL           2
321 #define OB_OFFS_OB                      4
322 #define OB_OFFS_MAT                     8
323 #define OB_OFFS_VKEY            16
324 #define OB_OFFS_PATH            32
325 #define OB_OFFS_PARENT          64
326 #define OB_OFFS_PARTICLE        128
327         /* get ipo from from action or not? */
328 #define OB_ACTION_OB            256
329 #define OB_ACTION_KEY           512
330         /* for stride edit */
331 #define OB_DISABLE_PATH         1024
332
333 #define OB_OFFS_PARENTADD       2048
334
335
336 /* (short) trackflag / upflag */
337 #define OB_POSX                 0
338 #define OB_POSY                 1
339 #define OB_POSZ                 2
340 #define OB_NEGX                 3
341 #define OB_NEGY                 4
342 #define OB_NEGZ                 5
343
344 /* gameflag in game.h */
345
346 /* dt: no flags */
347 #define OB_BOUNDBOX             1
348 #define OB_WIRE                 2
349 #define OB_SOLID                3
350 #define OB_SHADED               4
351 #define OB_TEXTURE              5
352
353 /* dtx: flags, char! */
354 #define OB_AXIS                 2
355 #define OB_TEXSPACE             4
356 #define OB_DRAWNAME             8
357 #define OB_DRAWIMAGE    16
358         /* for solid+wire display */
359 #define OB_DRAWWIRE             32
360         /* for overdraw */
361 #define OB_DRAWXRAY             64
362         /* enable transparent draw */
363 #define OB_DRAWTRANSP   128
364
365 /* empty_drawtype: no flags */
366 #define OB_ARROWS               1
367 #define OB_PLAINAXES    2
368 #define OB_CIRCLE               3
369 #define OB_SINGLE_ARROW 4
370 #define OB_CUBE                 5
371 #define OB_EMPTY_SPHERE 6
372 #define OB_EMPTY_CONE   7
373
374 /* boundtype */
375 #define OB_BOUND_BOX            0
376 #define OB_BOUND_SPHERE         1
377 #define OB_BOUND_CYLINDER       2
378 #define OB_BOUND_CONE           3
379 #define OB_BOUND_POLYH          4
380 #define OB_BOUND_POLYT          5
381 #define OB_BOUND_DYN_MESH   6
382
383
384 /* **************** BASE ********************* */
385
386 /* also needed for base!!!!! or rather, thy interfere....*/
387 /* base->flag and ob->flag */
388 #define BA_WAS_SEL                      2
389 #define BA_HAS_RECALC_OB        4
390 #define BA_HAS_RECALC_DATA      8
391
392 #define BA_DO_IPO                       32
393
394 #define BA_FROMSET                      128
395
396 #define BA_TRANSFORM_CHILD      256 /* child of a transformed object */
397
398 /* an initial attempt as making selection more specific! */
399 #define BA_DESELECT     0
400 #define BA_SELECT               1
401
402
403 #define OB_FROMDUPLI            512
404 #define OB_DONE                         1024
405 #define OB_RADIO                        2048
406 #define OB_FROMGROUP            4096
407 #define OB_POSEMODE                     8192
408
409 /* ob->recalc (flag bits!) */
410 #define OB_RECALC_OB            1
411 #define OB_RECALC_DATA          2
412                 /* time flag is set when time changes need recalc, so baked systems can ignore it */
413 #define OB_RECALC_TIME          4
414 #define OB_RECALC                       7
415
416
417 /* ob->gameflag */
418 #define OB_DYNAMIC              1
419 #define OB_CHILD                2
420 #define OB_ACTOR                4
421 #define OB_INERTIA_LOCK_X       8
422 #define OB_INERTIA_LOCK_Y       16
423 #define OB_INERTIA_LOCK_Z       32
424 #define OB_DO_FH                        64
425 #define OB_ROT_FH                       128
426 #define OB_ANISOTROPIC_FRICTION 256
427 #define OB_GHOST                        512
428 #define OB_RIGID_BODY           1024
429 #define OB_BOUNDS               2048
430
431 #define OB_COLLISION_RESPONSE   4096
432 #define OB_SECTOR               8192
433 #define OB_PROP                 16384
434 #define OB_MAINACTOR    32768
435
436 #define OB_COLLISION    65536
437 #define OB_SOFT_BODY    0x20000
438 #define OB_OCCLUDER             0x40000
439 #define OB_SENSOR               0x80000
440
441 /* ob->gameflag2 */
442 #define OB_NEVER_DO_ACTIVITY_CULLING    1
443 #define OB_LOCK_RIGID_BODY_X_AXIS       4
444 #define OB_LOCK_RIGID_BODY_Y_AXIS       8
445 #define OB_LOCK_RIGID_BODY_Z_AXIS       16
446 #define OB_LOCK_RIGID_BODY_X_ROT_AXIS   32
447 #define OB_LOCK_RIGID_BODY_Y_ROT_AXIS   64
448 #define OB_LOCK_RIGID_BODY_Z_ROT_AXIS   128
449
450 #define OB_LIFE                 (OB_PROP|OB_DYNAMIC|OB_ACTOR|OB_MAINACTOR|OB_CHILD)
451
452 /* ob->body_type */
453 #define OB_BODY_TYPE_NO_COLLISION       0
454 #define OB_BODY_TYPE_STATIC                     1
455 #define OB_BODY_TYPE_DYNAMIC            2
456 #define OB_BODY_TYPE_RIGID                      3
457 #define OB_BODY_TYPE_SOFT                       4
458 #define OB_BODY_TYPE_OCCLUDER           5
459 #define OB_BODY_TYPE_SENSOR                     6
460
461 /* ob->scavisflag */
462 #define OB_VIS_SENS             1
463 #define OB_VIS_CONT             2
464 #define OB_VIS_ACT              4
465
466 /* ob->scaflag */
467 #define OB_SHOWSENS             64
468 #define OB_SHOWACT              128
469 #define OB_ADDSENS              256
470 #define OB_ADDCONT              512
471 #define OB_ADDACT               1024
472 #define OB_SHOWCONT             2048
473 #define OB_SETSTBIT             4096
474 #define OB_INITSTBIT    8192
475 #define OB_DEBUGSTATE   16384
476
477 /* ob->restrictflag */
478 #define OB_RESTRICT_VIEW        1
479 #define OB_RESTRICT_SELECT      2
480 #define OB_RESTRICT_RENDER      4
481
482 /* ob->shapeflag */
483 #define OB_SHAPE_LOCK           1
484 #define OB_SHAPE_TEMPLOCK       2
485
486 /* ob->nlaflag */
487         // XXX depreceated - old animation system
488 #define OB_NLA_OVERRIDE         (1<<0)
489 #define OB_NLA_COLLAPSED        (1<<1)
490
491         /* object-channel expanded status */
492 #define OB_ADS_COLLAPSED        (1<<10)
493         /* object's ipo-block */
494 #define OB_ADS_SHOWIPO          (1<<11)
495         /* object's constraint channels */
496 #define OB_ADS_SHOWCONS         (1<<12)
497         /* object's material channels */
498 #define OB_ADS_SHOWMATS         (1<<13)
499
500 /* ob->protectflag */
501 #define OB_LOCK_LOCX    1
502 #define OB_LOCK_LOCY    2
503 #define OB_LOCK_LOCZ    4
504 #define OB_LOCK_LOC             7
505 #define OB_LOCK_ROTX    8
506 #define OB_LOCK_ROTY    16
507 #define OB_LOCK_ROTZ    32
508 #define OB_LOCK_ROT             56
509 #define OB_LOCK_SCALEX  64
510 #define OB_LOCK_SCALEY  128
511 #define OB_LOCK_SCALEZ  256
512 #define OB_LOCK_SCALE   448
513
514 /* ob->softflag in DNA_object_force.h */
515
516 #ifdef __cplusplus
517 }
518 #endif
519
520 #endif
521
522