Next level of Proxy support for animation: Proxy for duplicated groups.
[blender.git] / source / blender / blenkernel / BKE_object.h
1 /**
2  * $Id$
3  *
4  * ***** BEGIN GPL/BL DUAL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version. The Blender
10  * Foundation also sells licenses for use in proprietary software under
11  * the Blender License.  See http://www.blender.org/BL/ for information
12  * about this.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software Foundation,
21  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
22  *
23  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
24  * All rights reserved.
25  *
26  * The Original Code is: all of this file.
27  *
28  * Contributor(s): none yet.
29  *
30  * ***** END GPL/BL DUAL LICENSE BLOCK *****
31  * General operations, lookup, etc. for blender objects.
32  */
33
34 #ifndef BKE_OBJECT_H
35 #define BKE_OBJECT_H
36
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40
41 /* defines now, might become functions */
42
43 /* proxy rule: lib_object->proxy == the one we borrow from, only set temporal and cleared here */
44 /*             local_object->proxy == pointer to library object, saved in files and read */
45         
46 #define OB_COPY_PROXY(a)        a->id.lib && a->proxy
47 #define OB_IS_PROXY(a)          a->id.lib==NULL && a->proxy
48 #define OB_DO_PROXY(a)          a->id.lib==NULL && a->proxy && a->proxy_group==NULL
49         
50
51 struct Base;
52 struct Object;
53 struct Camera;
54 struct BoundBox;
55 struct View3D;
56 struct SoftBody;
57 struct Group;
58
59 void clear_workob(void);
60 void copy_baseflags(void);
61 void copy_objectflags(void);
62 struct SoftBody *copy_softbody(struct SoftBody *sb);
63 void update_base_layer(struct Object *ob);
64
65 void free_object(struct Object *ob);
66 void object_free_display(struct Object *ob);
67 void object_free_modifiers(struct Object *ob);
68
69 void object_make_proxy(struct Object *ob, struct Object *target, struct Object *gob);
70
71 void unlink_object(struct Object *ob);
72 int exist_object(struct Object *obtest);
73 void *add_camera(void);
74 struct Camera *copy_camera(struct Camera *cam);
75 void make_local_camera(struct Camera *cam);
76 void *add_lamp(void);
77 struct Lamp *copy_lamp(struct Lamp *la);
78 void make_local_lamp(struct Lamp *la);
79 void free_camera(struct Camera *ca);
80 void free_lamp(struct Lamp *la);
81 void *add_wave(void);
82
83 struct Object *add_object(int type);
84 void base_init_from_view3d(struct Base *base, struct View3D *v3d);
85
86 struct Object *copy_object(struct Object *ob);
87 void expand_local_object(struct Object *ob);
88 void make_local_object(struct Object *ob);
89 void set_mblur_offs(float blur);
90 void set_field_offs(float field);
91 void disable_speed_curve(int val);
92
93 float bsystem_time(struct Object *ob, struct Object *par, float cfra, float ofs);
94 void object_to_mat3(struct Object *ob, float mat[][3]);
95 void object_to_mat4(struct Object *ob, float mat[][4]);
96
97 void set_no_parent_ipo(int val);
98
99 void disable_where_script(short on);
100 int during_script(void);
101 void disable_where_scriptlink(short on);
102 int during_scriptlink(void);
103
104 void where_is_object_time(struct Object *ob, float ctime);
105 void where_is_object(struct Object *ob);
106 void where_is_object_simul(struct Object *ob);
107
108 void what_does_parent(struct Object *ob);
109 struct BoundBox *unit_boundbox(void);
110 void boundbox_set_from_min_max(struct BoundBox *bb, float min[3], float max[3]);
111 struct BoundBox *object_get_boundbox(struct Object *ob);
112 void minmax_object(struct Object *ob, float *min, float *max);
113 void solve_tracking (struct Object *ob, float targetmat[][4]);
114 void solve_constraints (struct Object *ob, short obtype, void *obdata, float ctime);
115
116 void object_handle_update(struct Object *ob);
117
118 #ifdef __cplusplus
119 }
120 #endif
121
122 #endif
123