Softbody: added "time" button, to control speed for wriggling. Low values
[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/BL DUAL 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. The Blender
14  * Foundation also sells licenses for use in proprietary software under
15  * the Blender License.  See http://www.blender.org/BL/ for information
16  * about this.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software Foundation,
25  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
26  *
27  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
28  * All rights reserved.
29  *
30  * The Original Code is: all of this file.
31  *
32  * Contributor(s): none yet.
33  *
34  * ***** END GPL/BL DUAL LICENSE BLOCK *****
35  */
36 #ifndef DNA_OBJECT_TYPES_H
37 #define DNA_OBJECT_TYPES_H
38
39 #include "DNA_listBase.h"
40 #include "DNA_ID.h"
41 #include "DNA_scriptlink_types.h"
42
43 #ifdef __cplusplus
44 extern "C" {
45 #endif
46
47 struct bPose;   
48 struct Object;
49 struct Ipo;
50 struct BoundBox;
51 struct Path;
52 struct Material;
53 struct bConstraintChannel;
54 struct BodyPoint;
55 struct BodySpring;
56
57 typedef struct bDeformGroup {
58         struct bDeformGroup *next, *prev;
59         char name[32];
60         void *data;     /* Temporary data, most likely a pointer to the bone - no need to delete */
61 } bDeformGroup;
62
63 #
64 #
65 typedef struct BoundBox {
66         float vec[8][3];
67 } BoundBox;
68
69 /* OcInfo and LBuf structs are for the Enji gameengine */
70
71 typedef struct OcInfo {
72         float dvec[3];
73         float size[3];
74 } OcInfo;
75
76 typedef struct LBuf {
77         short tot, max;
78         int pad;
79         struct Object **ob;
80 } LBuf;
81
82 typedef struct PartDeflect {
83         short deflect;          /* Deflection flag - does mesh deflect particles*/
84         short forcefield;       /* Force field type, do the vertices attract / repel particles ? */
85         short flag;                     /* general settings flag */
86         short pad;
87         
88         float pdef_damp;        /* Damping factor for particle deflection       */
89         float pdef_rdamp;       /* Random element of damping for deflection     */
90         float pdef_perm;        /* Chance of particle passing through mesh      */
91
92         float f_strength;       /* The strength of the force (+ or - )       */
93         float f_power;          /* The power law - real gravitation is 2 (square)  */
94         float maxdist;          /* if indicated, use this maximum */
95         
96         float pdef_sbdamp;      /* Damping factor for softbody deflection       */
97         float pdef_sbift;       /* inner face thickness for softbody deflection */
98         float pdef_sboft;       /* outer face thickness for softbody deflection */
99 } PartDeflect;
100
101 /* pd->forcefield:  Effector Fields types */
102 #define PFIELD_FORCE    1
103 #define PFIELD_VORTEX   2
104 #define PFIELD_MAGNET   3
105 #define PFIELD_WIND             4
106
107 /* pd->flag: various settings */
108 #define PFIELD_USEMAX   1
109
110
111 typedef struct SoftBody {
112         /* dynamic data */
113         int totpoint, totspring;
114         struct BodyPoint *bpoint;               /* not saved in file */
115         struct BodySpring *bspring;             /* not saved in file */
116         float ctime;                                    /* last time calculated */
117         
118         /* part of UI: */
119         float nodemass;         /* softbody mass of *vertex* */
120         float grav;                     /* softbody amount of gravitaion to apply */
121         float mediafrict;       /* friction to env */
122         float rklimit;          /* error limit for ODE solver */
123         float physics_speed;/* user control over simulation speed */
124         
125         float goalspring;       /* softbody goal springs */
126         float goalfrict;        /* softbody goal springs friction */
127         float mingoal;          /* quick limits for goal */
128         float maxgoal;
129         short vertgroup;        /* index starting at 1 */
130         short pad1;
131         
132         float inspring;         /* softbody inner springs */
133         float infrict;          /* softbody inner springs friction */
134         
135         float defgoal;          /* default goal for vertices without vgroup */
136         
137 } SoftBody;
138
139 typedef struct Object {
140         ID id;
141
142         short type, partype;
143         int par1, par2, par3;   /* can be vertexnrs */
144         char parsubstr[32];     /* String describing subobject info */
145         void *pardata;
146         struct Object *parent, *track;
147         struct Ipo *ipo;
148         struct Path *path;
149         struct BoundBox *bb;
150         struct bAction *action; 
151         struct bPose *pose;     
152         void *data;
153         
154         struct bConstraintChannel *activecon;           
155         ListBase constraintChannels;
156
157         ListBase effect;
158         ListBase network;
159         ListBase disp;
160         ListBase defbase;
161         struct Material **mat;
162         
163         /* rot en drot have to be together! (transform('r' en 's')) */
164         float loc[3], dloc[3], orig[3];
165         float size[3], dsize[3];
166         float rot[3], drot[3];
167         float quat[4], dquat[4];
168         float obmat[4][4];
169         float parentinv[4][4];
170         float imat[4][4];       /* for during render, old game engine, temporally: ipokeys of transform  */
171         
172         unsigned int lay;                               /* copy of Base */
173         short flag;                     /* copy of Base */
174         short colbits;          /* when zero, from obdata */
175         char transflag, ipoflag;
176         char trackflag, upflag;
177         short ipowin, scaflag;  /* ipowin: blocktype last ipowindow */
178         short scavisflag, boundtype;
179         
180         short dupon, dupoff, dupsta, dupend;
181
182         float sf, ctime;
183         
184         /* during realtime */
185
186         /* note that inertia is only called inertia for historical reasons
187          * and is not changed to avoid DNA surgery. It actually reflects the 
188          * Size value in the GameButtons (= radius) */
189
190         float mass, damping, inertia;
191         /* The form factor k is introduced to give the user more control
192          * and to fix incompatibility problems.
193      * For rotational symmetric objects, the inertia value can be
194          * expressed as: Theta = k * m * r^2
195          * where m = Mass, r = Radius
196          * For a Sphere, the form factor is by default = 0.4
197          */
198
199         float formfactor, softtime;             /* softtime temp for softbody, remove it before release! */
200         float rdamping, sizefac;
201         
202         char dt, dtx;
203         char totcol;    /* copy of mesh or curve or meta */
204         char actcol;
205         
206         ScriptLink scriptlink;
207         ListBase prop;
208         ListBase sensors;
209         ListBase controllers;
210         ListBase actuators;
211
212     void *sumohandle;
213     
214         float bbsize[3];
215         short dfras;
216         unsigned short actdef;  /* current deformation group */
217         float col[4];
218         /**
219          * Settings for game objects
220          * bit 0: Object has dynamic behaviour
221          * bit 2: Object is evaluated by the gameengine
222          * bit 6: Use Fh settings in Materials
223          * bit 7: Use face normal to rotate Object
224          * bit 8: Friction is anisotropic
225          * bit 9: Object is a ghost
226          * bit 10: Do rigid body dynamics.
227          * bit 11: Use bounding object for physics
228          */
229         int gameflag;
230         /**
231          * More settings
232          * bit 15: Always ignore activity culling 
233          */
234         int gameflag2;
235         short softflag, dummy;                  /* temporal stuff softbody experiment */
236         float anisotropicFriction[3];
237
238         ListBase constraints;
239         ListBase nlastrips;
240         ListBase hooks;
241         
242         PartDeflect *pd;                /* particle deflector/attractor/collision data */
243         struct SoftBody *soft;  /* if exists, saved in file */
244         struct Life *life;
245
246         LBuf lbuf;
247         LBuf port;
248
249         float toonedge, smoothresh;     /* smoothresh is phong interpolation ray_shadow correction in render */
250 /* this stuff MUST NOT be here
251    is here for softbody devel purpose 
252 */
253         float sb_goalspring; /* softbody goal springs */
254         float sb_goalfrict;   /* softbody goal springs friction */
255         float sb_inspring;       /* softbody inner springs */
256         float sb_infrict;   /* softbody inner springs friction */
257         float sb_nodemass;       /* softbody mass of *vertex* */
258         float sb_grav;      /* softbody amount of gravitaion to apply */
259         float sb_mingoal;   /* quick limits for goal */
260         float sb_maxgoal;
261         float sb_mediafrict;   /* friction to env */
262         float sb_pad1;        /* free */
263     
264 } Object;
265
266 typedef struct ObHook {
267         struct ObHook *next, *prev;
268         
269         struct Object *parent;
270         float parentinv[4][4];  /* matrix making current transform unmodified */
271         float mat[4][4];                /* temp matrix while hooking */
272         float cent[3];                  /* visualization of hook */
273         float falloff;                  /* if not zero, falloff is distance where influence zero */
274         
275         char name[32];
276
277         int *indexar;
278         int totindex, curindex; /* curindex is cache for fast lookup */
279         short type, active;             /* active is only first hook, for button menu */
280         float force;
281 } ObHook;
282
283
284 /* this work object is defined in object.c */
285 extern Object workob;
286
287
288 /* **************** OBJECT ********************* */
289
290 /* used many places... should be specialized  */
291 #define SELECT                  1
292
293 /* type */
294 #define OB_EMPTY                0
295 #define OB_MESH                 1
296 #define OB_CURVE                2
297 #define OB_SURF                 3
298 #define OB_FONT                 4
299 #define OB_MBALL                5
300
301 #define OB_LAMP                 10
302 #define OB_CAMERA               11
303
304 #define OB_IKA                  20
305 #define OB_WAVE                 21
306 #define OB_LATTICE              22
307
308 /* 23 and 24 are for life and sector (old file compat.) */
309 #define OB_ARMATURE             25
310
311 /* partype: eerste 5 bits: type */
312 #define PARTYPE                 15
313 #define PAROBJECT               0
314 #define PARCURVE                1
315 #define PARKEY                  2
316 #define PARLIMB                 3
317 #define PARSKEL                 4
318 #define PARVERT1                5
319 #define PARVERT3                6
320 #define PARBONE                 7
321 #define PARSLOW                 16
322
323 /* char! transflag */
324 #define OB_OFFS_LOCAL   1
325 #define OB_QUAT                 2
326 #define OB_NEG_SCALE    4
327 #define OB_DUPLI                (8+16)
328 #define OB_DUPLIFRAMES  8
329 #define OB_DUPLIVERTS   16
330 #define OB_DUPLIROT             32
331 #define OB_DUPLINOSPEED 64
332
333 #define OB_POWERTRACK   128
334
335 /* char! ipoflag */
336 #define OB_DRAWKEY                      1
337 #define OB_DRAWKEYSEL           2
338 #define OB_OFFS_OB                      4
339 #define OB_OFFS_MAT                     8
340 #define OB_OFFS_VKEY            16
341 #define OB_OFFS_PATH            32
342 #define OB_OFFS_PARENT          64
343 #define OB_OFFS_PARTICLE        128
344
345
346 /* trackflag / upflag */
347 #define OB_POSX                 0
348 #define OB_POSY                 1
349 #define OB_POSZ                 2
350 #define OB_NEGX                 3
351 #define OB_NEGY                 4
352 #define OB_NEGZ                 5
353
354 /* gameflag in game.h */
355
356 /* dt: nummers */
357 #define OB_BOUNDBOX             1
358 #define OB_WIRE                 2
359 #define OB_SOLID                3
360 #define OB_SHADED               4
361 #define OB_TEXTURE              5
362 #define OB_TOON_MONO    6
363 #define OB_TOON_COLOR   7
364 #define OB_TOON_TRANSP  8
365 #define OB_TOON_FLAT    9
366 #define OB_TOON_SMOOTH  10
367
368 /* dtx: flags */
369 #define OB_AXIS                 2
370 #define OB_TEXSPACE             4
371 #define OB_DRAWNAME             8
372 #define OB_DRAWIMAGE    16
373 #define OB_DRAWWIRE             32 /* for solid+wire display */
374
375 /* boundtype */
376 #define OB_BOUND_BOX            0
377 #define OB_BOUND_SPHERE         1
378 #define OB_BOUND_CYLINDER       2
379 #define OB_BOUND_CONE           3
380 #define OB_BOUND_POLYH          4
381 #define OB_BOUND_POLYT          5
382
383 /* also needed for base!!!!! or rather, thy interfere....*/
384 /* base->flag and ob->flag */
385 #define BA_WASSEL                       2
386 #define BA_PARSEL                       4
387 #define BA_WHERE_UPDATE         8
388 #define BA_DISP_UPDATE          16
389 #define BA_DO_IPO                       32
390 #define OB_GONNA_MOVE           32
391 #define BA_FROMSET                      128
392 #define OB_DO_IMAT                      256
393 #define OB_FROMDUPLI            512
394 #define OB_DONE                         1024
395 #define OB_RADIO                        2048
396 #define OB_FROMGROUP            4096
397 #define OB_POSEMODE                     8192
398
399 /* ob->gameflag */
400 #define OB_DYNAMIC              1
401 #define OB_CHILD                2
402 #define OB_ACTOR                4
403 #define OB_INERTIA_LOCK_X       8
404 #define OB_INERTIA_LOCK_Y       16
405 #define OB_INERTIA_LOCK_Z       32
406 #define OB_DO_FH                        64
407 #define OB_ROT_FH                       128
408 #define OB_ANISOTROPIC_FRICTION 256
409 #define OB_GHOST                        512
410 #define OB_RIGID_BODY           1024
411 #define OB_BOUNDS               2048
412
413 #define OB_COLLISION_RESPONSE   4096
414 #define OB_SECTOR               8192
415 #define OB_PROP                 16384
416 #define OB_MAINACTOR    32768
417
418 /* ob->gameflag2 */
419 #define OB_NEVER_DO_ACTIVITY_CULLING    1
420
421 #define OB_LIFE                 (OB_PROP|OB_DYNAMIC|OB_ACTOR|OB_MAINACTOR|OB_CHILD)
422
423 /* ob->scavisflag */
424 #define OB_VIS_SENS             1
425 #define OB_VIS_CONT             2
426 #define OB_VIS_ACT              4
427
428 /* ob->scaflag */
429 #define OB_SHOWSENS             64
430 #define OB_SHOWACT              128
431 #define OB_ADDSENS              256
432 #define OB_ADDCONT              512
433 #define OB_ADDACT               1024
434 #define OB_SHOWCONT             2048
435
436 /* ob->softflag */
437 #define OB_SB_ENABLE    1
438 #define OB_SB_GOAL              2
439 #define OB_SB_EDGES             4
440 #define OB_SB_QUADS             8
441 #define OB_SB_POSTDEF   16
442 #define OB_SB_REDO              32
443
444 #ifdef __cplusplus
445 }
446 #endif
447
448 #endif
449