Merge with trunk r40409
[blender.git] / source / blender / blenkernel / BKE_material.h
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL 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.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * The Original Code is: all of this file.
24  *
25  * Contributor(s): none yet.
26  *
27  * ***** END GPL LICENSE BLOCK *****
28  */
29
30 #ifndef BKE_MATERIAL_H
31 #define BKE_MATERIAL_H
32
33 /** \file BKE_material.h
34  *  \ingroup bke
35  *  \brief General operations, lookup, etc. for materials.
36  */
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40
41 struct Main;
42 struct Material;
43 struct ID;
44 struct Object;
45 struct Mesh;
46 struct MTFace;
47
48 /* materials */
49
50 void init_def_material(void);
51 void free_material(struct Material *sc); 
52 void test_object_materials(struct ID *id);
53 void resize_object_material(struct Object *ob, const short totcol);
54 void init_material(struct Material *ma);
55 struct Material *add_material_main(struct Main *main, const char *name);
56 struct Material *add_material(const char *name);
57 struct Material *copy_material(struct Material *ma);
58 struct Material *localize_material(struct Material *ma);
59 struct Material *give_node_material(struct Material *ma); /* returns node material or self */
60 void make_local_material(struct Material *ma);
61 void extern_local_matarar(struct Material **matar, short totcol);
62
63 void automatname(struct Material *);
64
65 /* material slots */
66
67 struct Material ***give_matarar(struct Object *ob);
68 short *give_totcolp(struct Object *ob);
69 struct Material ***give_matarar_id(struct ID *id); /* same but for ID's */
70 short *give_totcolp_id(struct ID *id);
71
72 struct Material *give_current_material(struct Object *ob, short act);
73 struct ID *material_from(struct Object *ob, short act);
74 void assign_material(struct Object *ob, struct Material *ma, short act);
75 void assign_matarar(struct Object *ob, struct Material ***matar, short totcol);
76
77 short find_material_index(struct Object *ob, struct Material *ma);
78
79 int object_add_material_slot(struct Object *ob);
80 int object_remove_material_slot(struct Object *ob);
81
82 /* rna api */
83 void material_append_id(struct ID *id, struct Material *ma);
84 struct Material *material_pop_id(struct ID *id, int index, int remove_material_slot); /* index is an int because of RNA */
85
86 /* rendering */
87
88 void init_render_material(struct Material *, int, float *);
89 void init_render_materials(struct Main *, int, float *);
90 void end_render_material(struct Material *);
91 void end_render_materials(struct Main *);
92
93 int material_in_material(struct Material *parmat, struct Material *mat);
94
95 void ramp_blend(int type, float *r, float *g, float *b, float fac, const float col[3]);
96
97 /* copy/paste */
98 void clear_matcopybuf(void);
99 void free_matcopybuf(void);
100 void copy_matcopybuf(struct Material *ma);
101 void paste_matcopybuf(struct Material *ma);
102
103 void clear_mat_mtex_copybuf(void);
104 void copy_mat_mtex_copybuf(struct ID *id);
105 void paste_mat_mtex_copybuf(struct ID *id);
106
107 /* handle backward compatibility for tface/materials called from doversion (fileload=1) or Help Menu (fileload=0) */    
108 int do_version_tface(struct Main *main, int fileload);
109
110 #ifdef __cplusplus
111 }
112 #endif
113
114 #endif
115