2.5
[blender.git] / source / blender / makesrna / intern / rna_material.c
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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * Contributor(s): Blender Foundation (2008), Nathan Letwory
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <float.h>
26 #include <stdlib.h>
27
28 #include "RNA_define.h"
29 #include "RNA_types.h"
30
31 #include "rna_internal.h"
32
33 #include "DNA_material_types.h"
34 #include "DNA_texture_types.h"
35
36 #include "WM_types.h"
37
38 #ifdef RNA_RUNTIME
39
40 static PointerRNA rna_Material_mirror_get(PointerRNA *ptr)
41 {
42         return rna_pointer_inherit_refine(ptr, &RNA_MaterialRaytraceMirror, ptr->id.data);
43 }
44
45 static PointerRNA rna_Material_transp_get(PointerRNA *ptr)
46 {
47         return rna_pointer_inherit_refine(ptr, &RNA_MaterialRaytraceTransparency, ptr->id.data);
48 }
49
50 static PointerRNA rna_Material_halo_get(PointerRNA *ptr)
51 {
52         return rna_pointer_inherit_refine(ptr, &RNA_MaterialHalo, ptr->id.data);
53 }
54
55 static PointerRNA rna_Material_sss_get(PointerRNA *ptr)
56 {
57         return rna_pointer_inherit_refine(ptr, &RNA_MaterialSubsurfaceScattering, ptr->id.data);
58 }
59
60 static PointerRNA rna_Material_strand_get(PointerRNA *ptr)
61 {
62         return rna_pointer_inherit_refine(ptr, &RNA_MaterialStrand, ptr->id.data);
63 }
64
65 static void rna_Material_type_set(PointerRNA *ptr, int value)
66 {
67         Material *ma= (Material*)ptr->data;
68
69         if(ma->material_type == MA_TYPE_HALO && value != MA_TYPE_HALO)
70                 ma->mode &= ~(MA_STAR|MA_HALO_XALPHA|MA_ZINV|MA_ENV);
71
72         ma->material_type= value;
73 }
74
75 static void rna_Material_mtex_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
76 {
77         Material *ma= (Material*)ptr->data;
78         rna_iterator_array_begin(iter, (void*)ma->mtex, sizeof(MTex*), MAX_MTEX, NULL);
79 }
80
81 static PointerRNA rna_Material_active_texture_get(PointerRNA *ptr)
82 {
83         Material *ma= (Material*)ptr->data;
84         return rna_pointer_inherit_refine(ptr, &RNA_TextureSlot, ma->mtex[(int)ma->texact]);
85 }
86
87 static void rna_MaterialStrand_start_size_range(PointerRNA *ptr, float *min, float *max)
88 {
89         Material *ma= (Material*)ptr->id.data;
90
91         if(ma->mode & MA_STR_B_UNITS) {
92                 *min= 0.0001f;
93                 *max= 2.0f;
94         }
95         else {
96                 *min= 0.25f;
97                 *max= 20.0f;
98         }
99 }
100
101 static void rna_MaterialStrand_end_size_range(PointerRNA *ptr, float *min, float *max)
102 {
103         Material *ma= (Material*)ptr->id.data;
104
105         if(ma->mode & MA_STR_B_UNITS) {
106                 *min= 0.0001f;
107                 *max= 1.0f;
108         }
109         else {
110                 *min= 0.25f;
111                 *max= 10.0f;
112         }
113 }
114
115 #else
116
117 static void rna_def_material_mtex(BlenderRNA *brna)
118 {
119         StructRNA *srna;
120         PropertyRNA *prop;
121
122         static EnumPropertyItem prop_texture_coordinates_items[] = {
123                 {TEXCO_GLOB, "GLOBAL", "Global", "Uses global coordinates for the texture coordinates."},
124                 {TEXCO_OBJECT, "OBJECT", "Object", "Uses linked object's coordinates for texture coordinates."},
125                 {TEXCO_UV, "UV", "UV", "Uses UV coordinates for texture coordinates."},
126                 {TEXCO_ORCO, "ORCO", "Orco", "Uses the original undeformed coordinates of the object."},
127                 {TEXCO_STRAND, "STRAND", "Strand", "Uses normalized strand texture coordinate (1D)."},
128                 {TEXCO_STICKY, "STICKY", "Sticky", "Uses mesh's sticky coordinates for the texture coordinates."},
129                 {TEXCO_WINDOW, "WINDOW", "Window", "Uses screen coordinates as texture coordinates."},
130                 {TEXCO_NORM, "NORMAL", "Normal", "Uses normal vector as texture coordinates."},
131                 {TEXCO_REFL, "REFLECTION", "Reflection", "Uses reflection vector as texture coordinates."},
132                 {TEXCO_STRESS, "STRESS", "Stress", "Uses the difference of edge lengths compared to original coordinates of the mesh."},
133                 {TEXCO_SPEED, "TANGENT", "Tangent", "Uses the optional tangent vector as texture coordinates."},
134
135                 {0, NULL, NULL, NULL}};
136
137         static EnumPropertyItem prop_mapping_items[] = {
138                 {MTEX_FLAT, "FLAT", "Flat", "Maps X and Y coordinates directly."},
139                 {MTEX_CUBE, "CUBE", "Cube", "Maps using the normal vector."},
140                 {MTEX_TUBE, "TUBE", "Tube", "Maps with Z as central axis."},
141                 {MTEX_SPHERE, "SPHERE", "Sphere", "Maps with Z as central axis."},
142                 {0, NULL, NULL, NULL}};
143
144         static EnumPropertyItem prop_normal_map_space_items[] = {
145                 {MTEX_NSPACE_CAMERA, "CAMERA", "Camera", ""},
146                 {MTEX_NSPACE_WORLD, "WORLD", "World", ""},
147                 {MTEX_NSPACE_OBJECT, "OBJECT", "Object", ""},
148                 {MTEX_NSPACE_TANGENT, "TANGENT", "Tangent", ""},
149                 {0, NULL, NULL, NULL}};
150
151         srna= RNA_def_struct(brna, "MaterialTextureSlot", "TextureSlot");
152         RNA_def_struct_sdna(srna, "MTex");
153         RNA_def_struct_ui_text(srna, "Material Texture Slot", "Texture slot for textures in a Material datablock.");
154
155         prop= RNA_def_property(srna, "texture_coordinates", PROP_ENUM, PROP_NONE);
156         RNA_def_property_enum_sdna(prop, NULL, "texco");
157         RNA_def_property_enum_items(prop, prop_texture_coordinates_items);
158         RNA_def_property_ui_text(prop, "Texture Coordinates", "");
159
160         prop= RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
161         RNA_def_property_pointer_sdna(prop, NULL, "object");
162         RNA_def_property_struct_type(prop, "Object");
163         RNA_def_property_flag(prop, PROP_EDITABLE);
164         RNA_def_property_ui_text(prop, "Object", "Object to use for mapping with Object texture coordinates.");
165
166         prop= RNA_def_property(srna, "uv_layer", PROP_STRING, PROP_NONE);
167         RNA_def_property_string_sdna(prop, NULL, "uvname");
168         RNA_def_property_ui_text(prop, "UV Layer", "UV layer to use for mapping with UV texture coordinates.");
169
170         prop= RNA_def_property(srna, "from_dupli", PROP_BOOLEAN, PROP_NONE);
171         RNA_def_property_boolean_sdna(prop, NULL, "texflag", MTEX_DUPLI_MAPTO);
172         RNA_def_property_ui_text(prop, "From Dupli", "Dupli's instanced from verts, faces or particles, inherit texture coordinate from their parent (only for UV and Orco texture coordinates).");
173
174         /* XXX: MTex.mapto and MTex.maptoneg */
175
176         /* XXX: MTex.proj[xyz] */
177
178         prop= RNA_def_property(srna, "mapping", PROP_ENUM, PROP_NONE);
179         RNA_def_property_enum_items(prop, prop_mapping_items);
180         RNA_def_property_ui_text(prop, "Mapping", "");
181
182         /* XXX: pmapto, pmaptoneg */
183
184         prop= RNA_def_property(srna, "normal_map_space", PROP_ENUM, PROP_NONE);
185         RNA_def_property_enum_sdna(prop, NULL, "normapspace");
186         RNA_def_property_enum_items(prop, prop_normal_map_space_items);
187         RNA_def_property_ui_text(prop, "Normal Map Space", "");
188
189         /* XXX: MTex.which_output */
190
191         /* XXX: MTex.k */
192
193         prop= RNA_def_property(srna, "displacement_factor", PROP_FLOAT, PROP_VECTOR);
194         RNA_def_property_float_sdna(prop, NULL, "dispfac");
195         RNA_def_property_range(prop, 0, 1);
196         RNA_def_property_ui_text(prop, "Displacement Factor", "Amount texture displaces the surface.");
197
198         prop= RNA_def_property(srna, "warp_factor", PROP_FLOAT, PROP_VECTOR);
199         RNA_def_property_float_sdna(prop, NULL, "warpfac");
200         RNA_def_property_range(prop, 0, 1);
201         RNA_def_property_ui_text(prop, "Warp Factor", "Amount texture affects color values.");
202 }
203
204 static void rna_def_material_colors(StructRNA *srna)
205 {
206         PropertyRNA *prop;
207
208         prop= RNA_def_property(srna, "diffuse_color", PROP_FLOAT, PROP_COLOR);
209         RNA_def_property_float_sdna(prop, NULL, "r");
210         RNA_def_property_array(prop, 3);
211         RNA_def_property_ui_text(prop, "Diffuse Color", "");
212         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
213         
214         prop= RNA_def_property(srna, "specular_color", PROP_FLOAT, PROP_COLOR);
215         RNA_def_property_float_sdna(prop, NULL, "specr");
216         RNA_def_property_array(prop, 3);
217         RNA_def_property_ui_text(prop, "Specular Color", "Specular color of the material.");
218         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
219         
220         prop= RNA_def_property(srna, "mirror_color", PROP_FLOAT, PROP_COLOR);
221         RNA_def_property_float_sdna(prop, NULL, "mirr");
222         RNA_def_property_array(prop, 3);
223         RNA_def_property_ui_text(prop, "Mirror Color", "Mirror color of the material.");
224         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
225         
226         prop= RNA_def_property(srna, "alpha", PROP_FLOAT, PROP_NONE);
227         RNA_def_property_range(prop, 0.0f, 1.0f);
228         RNA_def_property_ui_text(prop, "Alpha", "Alpha transparency of the material.");
229         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
230         
231         /* Color bands */
232         prop= RNA_def_property(srna, "diffuse_ramp", PROP_POINTER, PROP_NONE);
233         RNA_def_property_pointer_sdna(prop, NULL, "ramp_col");
234         RNA_def_property_struct_type(prop, "ColorRamp");
235         RNA_def_property_ui_text(prop, "Diffuse Ramp", "Color ramp used to affect diffuse shading.");
236
237         prop= RNA_def_property(srna, "specular_ramp", PROP_POINTER, PROP_NONE);
238         RNA_def_property_pointer_sdna(prop, NULL, "ramp_spec");
239         RNA_def_property_struct_type(prop, "ColorRamp");
240         RNA_def_property_ui_text(prop, "Specular Ramp", "Color ramp used to affect specular shading.");
241 }
242
243 static void rna_def_material_diffuse(StructRNA *srna)
244 {
245         PropertyRNA *prop;
246
247         static EnumPropertyItem prop_diff_shader_items[] = {
248                 {MA_DIFF_LAMBERT, "LAMBERT", "Lambert", ""},
249                 {MA_DIFF_ORENNAYAR, "OREN_NAYAR", "Oren-Nayar", ""},
250                 {MA_DIFF_TOON, "TOON", "Toon", ""},
251                 {MA_DIFF_MINNAERT, "MINNAERT", "Minnaert", ""},
252                 {MA_DIFF_FRESNEL, "FRESNEL", "Fresnel", ""},
253                 {0, NULL, NULL, NULL}};
254         
255         prop= RNA_def_property(srna, "diffuse_shader", PROP_ENUM, PROP_NONE);
256         RNA_def_property_enum_sdna(prop, NULL, "diff_shader");
257         RNA_def_property_enum_items(prop, prop_diff_shader_items);
258         RNA_def_property_ui_text(prop, "Diffuse Shader Model", "");
259         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
260         
261         prop= RNA_def_property(srna, "diffuse_reflection", PROP_FLOAT, PROP_NONE);
262         RNA_def_property_float_sdna(prop, NULL, "ref");
263         RNA_def_property_range(prop, 0.0f, 1.0f);
264         RNA_def_property_ui_text(prop, "Diffuse Reflection", "Amount of diffuse reflection.");
265         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
266         
267         prop= RNA_def_property(srna, "roughness", PROP_FLOAT, PROP_NONE);
268         RNA_def_property_range(prop, 0.0f, 3.14f);
269         RNA_def_property_ui_text(prop, "Roughness", "Oren-Nayar Roughness");
270         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
271         
272         prop= RNA_def_property(srna, "params1_4", PROP_FLOAT, PROP_NONE);
273         RNA_def_property_float_sdna(prop, NULL, "param");
274         RNA_def_property_array(prop, 4);
275         RNA_def_property_range(prop, 0.0f, 5.0f);
276         RNA_def_property_ui_text(prop, "Params 1-4", "Parameters used for diffuse and specular Toon, and diffuse Fresnel shaders. Check documentation for details.");
277         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
278         
279         prop= RNA_def_property(srna, "darkness", PROP_FLOAT, PROP_NONE);
280         RNA_def_property_range(prop, 0.0f, 2.0f);
281         RNA_def_property_ui_text(prop, "Darkness", "Minnaert darkness.");
282         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
283 }
284
285 static void rna_def_material_raymirror(BlenderRNA *brna)
286 {
287         StructRNA *srna;
288         PropertyRNA *prop;
289
290         static EnumPropertyItem prop_fadeto_mir_items[] = {
291                 {MA_RAYMIR_FADETOSKY, "FADE_TO_SKY", "Fade to Sky Color", ""},
292                 {MA_RAYMIR_FADETOMAT, "FADE_TO_MATERIAL", "Fade to Material Color", ""},
293                 {0, NULL, NULL, NULL}};
294
295         srna= RNA_def_struct(brna, "MaterialRaytraceMirror", NULL);
296         RNA_def_struct_sdna(srna, "Material");
297         RNA_def_struct_nested(brna, srna, "Material");
298         RNA_def_struct_ui_text(srna, "Material Raytrace Mirror", "Raytraced reflection settings for a Material datablock.");
299
300         prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
301         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYMIRROR); /* use bitflags */
302         RNA_def_property_ui_text(prop, "Enabled", "Enable raytraced reflections.");
303         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
304                 
305         prop= RNA_def_property(srna, "reflect", PROP_FLOAT, PROP_NONE);
306         RNA_def_property_float_sdna(prop, NULL, "ray_mirror");
307         RNA_def_property_range(prop, 0.0f, 1.0f);
308         RNA_def_property_ui_text(prop, "Reflect", "Sets the amount mirror reflection for raytrace.");
309         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
310         
311         prop= RNA_def_property(srna, "fresnel", PROP_FLOAT, PROP_NONE);
312         RNA_def_property_float_sdna(prop, NULL, "fresnel_mir");
313         RNA_def_property_range(prop, 0.0f, 5.0f);
314         RNA_def_property_ui_text(prop, "Fresnel", "Power of Fresnel for mirror reflection.");
315         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
316         
317         prop= RNA_def_property(srna, "fresnel_fac", PROP_FLOAT, PROP_NONE);
318         RNA_def_property_float_sdna(prop, NULL, "fresnel_mir_i");
319         RNA_def_property_range(prop, 0.0f, 1.0f);
320         RNA_def_property_ui_text(prop, "Fresnel Factor", "Blending factor for Fresnel.");
321         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
322         
323         prop= RNA_def_property(srna, "gloss", PROP_FLOAT, PROP_NONE);
324         RNA_def_property_float_sdna(prop, NULL, "gloss_mir");
325         RNA_def_property_range(prop, 0.0f, 1.0f);
326         RNA_def_property_ui_text(prop, "Gloss", "The shininess of the reflection. Values < 1.0 give diffuse, blurry reflections.");
327         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
328         
329         prop= RNA_def_property(srna, "gloss_anisotropic", PROP_FLOAT, PROP_NONE);
330         RNA_def_property_float_sdna(prop, NULL, "aniso_gloss_mir");
331         RNA_def_property_range(prop, 0.0f, 1.0f);
332         RNA_def_property_ui_text(prop, "Gloss Anisotropy", "The shape of the reflection, from 0.0 (circular) to 1.0 (fully stretched along the tangent.");
333         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
334                 
335         prop= RNA_def_property(srna, "gloss_samples", PROP_INT, PROP_NONE);
336         RNA_def_property_int_sdna(prop, NULL, "samp_gloss_mir");
337         RNA_def_property_range(prop, 0, 1024);
338         RNA_def_property_ui_text(prop, "Gloss Samples", "Number of cone samples averaged for blurry reflections.");
339         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
340         
341         prop= RNA_def_property(srna, "gloss_threshold", PROP_FLOAT, PROP_NONE);
342         RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_mir");
343         RNA_def_property_range(prop, 0.0f, 1.0f);
344         RNA_def_property_ui_text(prop, "Gloss Threshold", "Threshold for adaptive sampling. If a sample contributes less than this amount (as a percentage), sampling is stopped.");
345         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
346         
347         prop= RNA_def_property(srna, "depth", PROP_INT, PROP_NONE);
348         RNA_def_property_int_sdna(prop, NULL, "ray_depth");
349         RNA_def_property_range(prop, 0, 10);
350         RNA_def_property_ui_text(prop, "Depth", "Maximum allowed number of light inter-reflections.");
351         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
352         
353         prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
354         RNA_def_property_float_sdna(prop, NULL, "dist_mir");
355         RNA_def_property_range(prop, 0.0f, 10000.0f);
356         RNA_def_property_ui_text(prop, "Maximum Distance", "Maximum distance of reflected rays. Reflections further than this range fade to sky color or material color.");
357         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
358         
359         prop= RNA_def_property(srna, "fade_to", PROP_ENUM, PROP_NONE);
360         RNA_def_property_enum_sdna(prop, NULL, "fadeto_mir");
361         RNA_def_property_enum_items(prop, prop_fadeto_mir_items);
362         RNA_def_property_ui_text(prop, "Fade-out Color", "The color that rays with no intersection within the Max Distance take. Material color can be best for indoor scenes, sky color for outdoor.");
363         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
364 }
365
366 static void rna_def_material_raytra(BlenderRNA *brna)
367 {
368         StructRNA *srna;
369         PropertyRNA *prop;
370
371         srna= RNA_def_struct(brna, "MaterialRaytraceTransparency", NULL);
372         RNA_def_struct_sdna(srna, "Material");
373         RNA_def_struct_nested(brna, srna, "Material");
374         RNA_def_struct_ui_text(srna, "Material Raytrace Transparency", "Raytraced refraction settings for a Material datablock.");
375
376         prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
377         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYTRANSP); /* use bitflags */
378         RNA_def_property_ui_text(prop, "Enabled", "Enables raytracing for transparent refraction rendering.");
379         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
380         
381         prop= RNA_def_property(srna, "ior", PROP_FLOAT, PROP_NONE);
382         RNA_def_property_float_sdna(prop, NULL, "ang");
383         RNA_def_property_range(prop, 1.0f, 3.0f);
384         RNA_def_property_ui_text(prop, "IOR", "Sets angular index of refraction for raytraced refraction.");
385         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
386         
387         prop= RNA_def_property(srna, "fresnel", PROP_FLOAT, PROP_NONE);
388         RNA_def_property_float_sdna(prop, NULL, "fresnel_tra");
389         RNA_def_property_range(prop, 0.0f, 5.0f);
390         RNA_def_property_ui_text(prop, "Fresnel", "Power of Fresnel for transparency (Ray or ZTransp).");
391         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
392         
393         prop= RNA_def_property(srna, "fresnel_fac", PROP_FLOAT, PROP_NONE);
394         RNA_def_property_float_sdna(prop, NULL, "fresnel_tra_i");
395         RNA_def_property_range(prop, 1.0f, 5.0f);
396         RNA_def_property_ui_text(prop, "Fresnel Factor", "Blending factor for Fresnel.");
397         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
398         
399         prop= RNA_def_property(srna, "gloss", PROP_FLOAT, PROP_NONE);
400         RNA_def_property_float_sdna(prop, NULL, "gloss_tra");
401         RNA_def_property_range(prop, 0.0f, 1.0f);
402         RNA_def_property_ui_text(prop, "Gloss", "The clarity of the refraction. Values < 1.0 give diffuse, blurry refractions.");
403         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
404         
405         prop= RNA_def_property(srna, "gloss_samples", PROP_INT, PROP_NONE);
406         RNA_def_property_int_sdna(prop, NULL, "samp_gloss_tra");
407         RNA_def_property_range(prop, 0, 1024);
408         RNA_def_property_ui_text(prop, "Gloss Samples", "Number of cone samples averaged for blurry refractions.");
409         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
410         
411         prop= RNA_def_property(srna, "gloss_threshold", PROP_FLOAT, PROP_NONE);
412         RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_tra");
413         RNA_def_property_range(prop, 0.0f, 1.0f);
414         RNA_def_property_ui_text(prop, "Gloss Threshold", "Threshold for adaptive sampling. If a sample contributes less than this amount (as a percentage), sampling is stopped.");
415         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
416         
417         prop= RNA_def_property(srna, "depth", PROP_INT, PROP_NONE);
418         RNA_def_property_int_sdna(prop, NULL, "ray_depth_tra");
419         RNA_def_property_range(prop, 0, 10);
420         RNA_def_property_ui_text(prop, "Depth", "Maximum allowed number of light inter-refractions.");
421         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
422         
423         prop= RNA_def_property(srna, "filter", PROP_FLOAT, PROP_NONE);
424         RNA_def_property_float_sdna(prop, NULL, "filter");
425         RNA_def_property_range(prop, 0.0f, 1.0f);
426         RNA_def_property_ui_text(prop, "Filter", "Amount to blend in the material's diffuse color in raytraced transparency (simulating absorption).");
427         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
428         
429         prop= RNA_def_property(srna, "limit", PROP_FLOAT, PROP_NONE);
430         RNA_def_property_float_sdna(prop, NULL, "tx_limit");
431         RNA_def_property_range(prop, 0.0f, 100.0f);
432         RNA_def_property_ui_text(prop, "Limit", "Maximum depth for light to travel through the transparent material before becoming fully filtered (0.0 is disabled).");
433         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
434         
435         prop= RNA_def_property(srna, "falloff", PROP_FLOAT, PROP_NONE);
436         RNA_def_property_float_sdna(prop, NULL, "tx_falloff");
437         RNA_def_property_range(prop, 0.1f, 10.0f);
438         RNA_def_property_ui_text(prop, "Falloff", "Falloff power for transmissivity filter effect (1.0 is linear).");
439         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
440         
441         prop= RNA_def_property(srna, "specular_opacity", PROP_FLOAT, PROP_NONE);
442         RNA_def_property_float_sdna(prop, NULL, "spectra");
443         RNA_def_property_range(prop, 0.0f, 1.0f);
444         RNA_def_property_ui_text(prop, "Specular Opacity", "Makes specular areas opaque on transparent materials.");
445         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
446 }
447
448 static void rna_def_material_halo(BlenderRNA *brna)
449 {
450         StructRNA *srna;
451         PropertyRNA *prop;
452
453         srna= RNA_def_struct(brna, "MaterialHalo", NULL);
454         RNA_def_struct_sdna(srna, "Material");
455         RNA_def_struct_nested(brna, srna, "Material");
456         RNA_def_struct_ui_text(srna, "Material Halo", "Halo particle effect settings for a Material datablock.");
457
458         prop= RNA_def_property(srna, "size", PROP_FLOAT, PROP_NONE);
459         RNA_def_property_float_sdna(prop, NULL, "hasize");
460         RNA_def_property_range(prop, 0.0f, 100.0f);
461         RNA_def_property_ui_text(prop, "Size", "Sets the dimension of the halo.");
462         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
463         
464         prop= RNA_def_property(srna, "hardness", PROP_INT, PROP_NONE);
465         RNA_def_property_int_sdna(prop, NULL, "har");
466         RNA_def_property_range(prop, 0, 127);
467         RNA_def_property_ui_text(prop, "Hardness", "Sets the hardness of the halo.");
468         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
469         
470         prop= RNA_def_property(srna, "add", PROP_FLOAT, PROP_NONE);
471         RNA_def_property_float_sdna(prop, NULL, "add");
472         RNA_def_property_range(prop, 0.0f, 1.0f);
473         RNA_def_property_ui_text(prop, "Add", "Sets the strength of the add effect.");
474         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
475         
476         prop= RNA_def_property(srna, "rings", PROP_INT, PROP_NONE);
477         RNA_def_property_int_sdna(prop, NULL, "ringc");
478         RNA_def_property_range(prop, 0, 24);
479         RNA_def_property_ui_text(prop, "Rings", "Sets the number of rings rendered over the halo.");
480         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
481         
482         prop= RNA_def_property(srna, "line_number", PROP_INT, PROP_NONE);
483         RNA_def_property_int_sdna(prop, NULL, "linec");
484         RNA_def_property_range(prop, 0, 250);
485         RNA_def_property_ui_text(prop, "Line Number", "Sets the number of star shaped lines rendered over the halo.");
486         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
487         
488         prop= RNA_def_property(srna, "star_tips", PROP_INT, PROP_NONE);
489         RNA_def_property_int_sdna(prop, NULL, "starc");
490         RNA_def_property_range(prop, 3, 50);
491         RNA_def_property_ui_text(prop, "Star Tips", "Sets the number of points on the star shaped halo.");
492         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
493         
494         prop= RNA_def_property(srna, "seed", PROP_INT, PROP_NONE);
495         RNA_def_property_int_sdna(prop, NULL, "seed1");
496         RNA_def_property_range(prop, 0, 255);
497         RNA_def_property_ui_text(prop, "Seed", "Randomizes ring dimension and line location.");
498         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
499         
500         prop= RNA_def_property(srna, "flare_mode", PROP_BOOLEAN, PROP_NONE);
501         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_FLARE); /* use bitflags */
502         RNA_def_property_ui_text(prop, "Flare", "Renders halo as a lensflare.");
503         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
504         
505         prop= RNA_def_property(srna, "flare_size", PROP_FLOAT, PROP_NONE);
506         RNA_def_property_float_sdna(prop, NULL, "flaresize");
507         RNA_def_property_range(prop, 0.1f, 25.0f);
508         RNA_def_property_ui_text(prop, "Flare Size", "Sets the factor by which the flare is larger than the halo.");
509         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
510         
511         prop= RNA_def_property(srna, "flare_subsize", PROP_FLOAT, PROP_NONE);
512         RNA_def_property_float_sdna(prop, NULL, "subsize");
513         RNA_def_property_range(prop, 0.1f, 25.0f);
514         RNA_def_property_ui_text(prop, "Flare Subsize", "Sets the dimension of the subflares, dots and circles.");
515         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
516         
517         prop= RNA_def_property(srna, "flare_boost", PROP_FLOAT, PROP_NONE);
518         RNA_def_property_float_sdna(prop, NULL, "flareboost");
519         RNA_def_property_range(prop, 0.1f, 10.0f);
520         RNA_def_property_ui_text(prop, "Flare Boost", "Gives the flare extra strength.");
521         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
522         
523         prop= RNA_def_property(srna, "flare_seed", PROP_INT, PROP_NONE);
524         RNA_def_property_int_sdna(prop, NULL, "seed2");
525         RNA_def_property_range(prop, 0, 255);
526         RNA_def_property_ui_text(prop, "Flare Seed", "Specifies an offset in the flare seed table.");
527         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
528         
529         prop= RNA_def_property(srna, "flares_sub", PROP_INT, PROP_NONE);
530         RNA_def_property_int_sdna(prop, NULL, "flarec");
531         RNA_def_property_range(prop, 1, 32);
532         RNA_def_property_ui_text(prop, "Flares Sub", "Sets the number of subflares.");
533         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
534         
535         prop= RNA_def_property(srna, "ring", PROP_BOOLEAN, PROP_NONE);
536         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_RINGS);
537         RNA_def_property_ui_text(prop, "Rings", "Renders rings over halo.");
538         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
539         
540         prop= RNA_def_property(srna, "lines", PROP_BOOLEAN, PROP_NONE);
541         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_LINES);
542         RNA_def_property_ui_text(prop, "Lines", "Renders star shaped lines over halo.");
543         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
544         
545         prop= RNA_def_property(srna, "star", PROP_BOOLEAN, PROP_NONE);
546         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STAR);
547         RNA_def_property_ui_text(prop, "Star", "Renders halo as a star.");
548         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
549         
550         prop= RNA_def_property(srna, "use_texture", PROP_BOOLEAN, PROP_NONE);
551         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALOTEX);
552         RNA_def_property_ui_text(prop, "Use Texture", "Gives halo a texture.");
553         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
554         
555         prop= RNA_def_property(srna, "use_vertex_normal", PROP_BOOLEAN, PROP_NONE);
556         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALOPUNO);
557         RNA_def_property_ui_text(prop, "Use Vertex Normal", "Uses the vertex normal to specify the dimension of the halo.");
558         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
559         
560         prop= RNA_def_property(srna, "xalpha", PROP_BOOLEAN, PROP_NONE);
561         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_XALPHA);
562         RNA_def_property_ui_text(prop, "Extreme Alpha", "Uses extreme alpha.");
563         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
564         
565         prop= RNA_def_property(srna, "shaded", PROP_BOOLEAN, PROP_NONE);
566         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_SHADE);
567         RNA_def_property_ui_text(prop, "Shaded", "Lets halo receive light and shadows from external objects.");
568         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
569         
570         prop= RNA_def_property(srna, "soft", PROP_BOOLEAN, PROP_NONE);
571         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_SOFT);
572         RNA_def_property_ui_text(prop, "Soft", "Softens the edges of halos at intersections with other geometry.");
573         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
574 }
575
576 static void rna_def_material_sss(BlenderRNA *brna)
577 {
578         StructRNA *srna;
579         PropertyRNA *prop;
580
581         srna= RNA_def_struct(brna, "MaterialSubsurfaceScattering", NULL);
582         RNA_def_struct_sdna(srna, "Material");
583         RNA_def_struct_nested(brna, srna, "Material");
584         RNA_def_struct_ui_text(srna, "Material Subsurface Scattering", "Diffuse subsurface scattering settings for a Material datablock.");
585
586         prop= RNA_def_property(srna, "radius", PROP_FLOAT, PROP_NONE);
587         RNA_def_property_float_sdna(prop, NULL, "sss_radius");
588         RNA_def_property_range(prop, 0.001, FLT_MAX);
589         RNA_def_property_ui_range(prop, 0.001, 10000, 1, 3);
590         RNA_def_property_ui_text(prop, "Radius", "Mean red/green/blue scattering path length.");
591
592         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
593         RNA_def_property_float_sdna(prop, NULL, "sss_col");
594         RNA_def_property_ui_text(prop, "Color", "Scattering color.");
595
596         prop= RNA_def_property(srna, "error_tolerance", PROP_FLOAT, PROP_NONE);
597         RNA_def_property_float_sdna(prop, NULL, "sss_error");
598         RNA_def_property_ui_range(prop, 0.0001, 10, 1, 3);
599         RNA_def_property_ui_text(prop, "Error Tolerance", "Error tolerance (low values are slower and higher quality).");
600
601         prop= RNA_def_property(srna, "scale", PROP_FLOAT, PROP_NONE);
602         RNA_def_property_float_sdna(prop, NULL, "sss_scale");
603         RNA_def_property_ui_range(prop, 0.001, 1000, 1, 3);
604         RNA_def_property_ui_text(prop, "Scale", "Object scale factor.");
605
606         prop= RNA_def_property(srna, "ior", PROP_FLOAT, PROP_NONE);
607         RNA_def_property_float_sdna(prop, NULL, "sss_ior");
608         RNA_def_property_ui_range(prop, 0.1, 2, 1, 3);
609         RNA_def_property_ui_text(prop, "IOR", "Index of refraction (higher values are denser).");
610
611         prop= RNA_def_property(srna, "color_factor", PROP_FLOAT, PROP_NONE);
612         RNA_def_property_float_sdna(prop, NULL, "sss_colfac");
613         RNA_def_property_range(prop, 0, 1);
614         RNA_def_property_ui_text(prop, "Color Factor", "Blend factor for SSS colors.");
615
616         prop= RNA_def_property(srna, "texture_factor", PROP_FLOAT, PROP_NONE);
617         RNA_def_property_float_sdna(prop, NULL, "sss_texfac");
618         RNA_def_property_range(prop, 0, 1);
619         RNA_def_property_ui_text(prop, "Texture Factor", "Texture scatting blend factor.");
620
621         prop= RNA_def_property(srna, "front", PROP_FLOAT, PROP_NONE);
622         RNA_def_property_float_sdna(prop, NULL, "sss_front");
623         RNA_def_property_range(prop, 0, 2);
624         RNA_def_property_ui_text(prop, "Front", "Front scattering weight.");
625
626         prop= RNA_def_property(srna, "back", PROP_FLOAT, PROP_NONE);
627         RNA_def_property_float_sdna(prop, NULL, "sss_back");
628         RNA_def_property_range(prop, 0, 10);
629         RNA_def_property_ui_text(prop, "Back", "Back scattering weight.");
630
631         prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
632         RNA_def_property_boolean_sdna(prop, NULL, "sss_flag", MA_DIFF_SSS);
633         RNA_def_property_ui_text(prop, "Enabled", "Enable diffuse subsurface scatting effects in a material.");
634 }
635
636 void rna_def_material_specularity(StructRNA *srna)
637 {
638         PropertyRNA *prop;
639
640         prop= RNA_def_property(srna, "specularity", PROP_FLOAT, PROP_NONE);
641         RNA_def_property_float_sdna(prop, NULL, "spec");
642         RNA_def_property_range(prop, 0, 1);
643         RNA_def_property_ui_text(prop, "Specularity Intensity", "");
644
645         /* XXX: this field is also used for Halo hardness. should probably be fixed in DNA */
646         prop= RNA_def_property(srna, "specular_hardness", PROP_FLOAT, PROP_NONE);
647         RNA_def_property_float_sdna(prop, NULL, "har");
648         RNA_def_property_range(prop, 1, 511);
649         RNA_def_property_ui_text(prop, "Specular Hardness", "");
650
651         prop= RNA_def_property(srna, "specular_refraction", PROP_FLOAT, PROP_NONE);
652         RNA_def_property_float_sdna(prop, NULL, "refrac");
653         RNA_def_property_range(prop, 1, 10);
654         RNA_def_property_ui_text(prop, "Specular IOR", "");
655
656         /* XXX: evil "param" field also does specular stuff */
657
658         prop= RNA_def_property(srna, "specular_slope", PROP_FLOAT, PROP_NONE);
659         RNA_def_property_float_sdna(prop, NULL, "rms");
660         RNA_def_property_range(prop, 0, 0.4);
661         RNA_def_property_ui_text(prop, "Specular Slope", "The standard deviation of surface slope.");
662 }
663
664 void rna_def_material_strand(BlenderRNA *brna)
665 {
666         StructRNA *srna;
667         PropertyRNA *prop;
668
669         srna= RNA_def_struct(brna, "MaterialStrand", NULL);
670         RNA_def_struct_sdna(srna, "Material");
671         RNA_def_struct_nested(brna, srna, "Material");
672         RNA_def_struct_ui_text(srna, "Material Strand", "Strand settings for a Material datablock.");
673
674         prop= RNA_def_property(srna, "tangent_shading", PROP_BOOLEAN, PROP_NONE);
675         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TANGENT_STR);
676         RNA_def_property_ui_text(prop, "Tangent Shading", "Uses direction of strands as normal for tangent-shading.");
677         
678         prop= RNA_def_property(srna, "surface_diffuse", PROP_BOOLEAN, PROP_NONE);
679         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STR_SURFDIFF);
680         RNA_def_property_ui_text(prop, "Surface Diffuse", "Make diffuse shading more similar to shading the surface.");
681
682         prop= RNA_def_property(srna, "blend_distance", PROP_FLOAT, PROP_NONE);
683         RNA_def_property_float_sdna(prop, NULL, "strand_surfnor");
684         RNA_def_property_range(prop, 0, 10);
685         RNA_def_property_ui_text(prop, "Blend Distance", "Distance in Blender units over which to blend in the surface normal.");
686
687         prop= RNA_def_property(srna, "blender_units", PROP_BOOLEAN, PROP_NONE);
688         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STR_B_UNITS);
689         RNA_def_property_ui_text(prop, "Blender Units", "Use Blender units for widths instead of pixels.");
690
691         prop= RNA_def_property(srna, "start_size", PROP_FLOAT, PROP_UNSIGNED);
692         RNA_def_property_float_sdna(prop, NULL, "strand_sta");
693         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_MaterialStrand_start_size_range");
694         RNA_def_property_ui_text(prop, "Start Size", "Start size of strands in pixels Blender units.");
695
696         prop= RNA_def_property(srna, "end_size", PROP_FLOAT, PROP_UNSIGNED);
697         RNA_def_property_float_sdna(prop, NULL, "strand_end");
698         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_MaterialStrand_end_size_range");
699         RNA_def_property_ui_text(prop, "End Size", "Start size of strands in pixels or Blender units.");
700
701         prop= RNA_def_property(srna, "min_size", PROP_FLOAT, PROP_UNSIGNED);
702         RNA_def_property_float_sdna(prop, NULL, "strand_min");
703         RNA_def_property_range(prop, 0.001, 10);
704         RNA_def_property_ui_text(prop, "Minimum Size", "Minimum size of strands in pixels.");
705
706         prop= RNA_def_property(srna, "shape", PROP_FLOAT, PROP_NONE);
707         RNA_def_property_float_sdna(prop, NULL, "strand_ease");
708         RNA_def_property_range(prop, -0.9, 0.9);
709         RNA_def_property_ui_text(prop, "Shape", "Positive values make strands rounder, negative makes strands spiky.");
710
711         prop= RNA_def_property(srna, "width_fade", PROP_FLOAT, PROP_NONE);
712         RNA_def_property_float_sdna(prop, NULL, "strand_widthfade");
713         RNA_def_property_range(prop, 0, 2);
714         RNA_def_property_ui_text(prop, "Width Fade", "Transparency along the width of the strand.");
715
716         prop= RNA_def_property(srna, "uv_layer", PROP_STRING, PROP_NONE);
717         RNA_def_property_string_sdna(prop, NULL, "strand_uvname");
718         RNA_def_property_ui_text(prop, "UV Layer", "Name of UV layer to override.");
719 }
720
721 void RNA_def_material(BlenderRNA *brna)
722 {
723         StructRNA *srna;
724         PropertyRNA *prop;
725
726         static EnumPropertyItem prop_type_items[] = {
727                 {MA_TYPE_SURFACE, "SURFACE", "Surface", "Render object as a surface."},
728                 {MA_TYPE_VOLUME, "VOLUME", "Volume", "Render object as a volume."},
729                 {MA_TYPE_HALO, "HALO", "Halo", "Render object as halo particles."},
730                 {0, NULL, NULL, NULL}};
731
732         srna= RNA_def_struct(brna, "Material", "ID");
733         RNA_def_struct_ui_text(srna, "Material", "Material datablock to defined the appearance of geometric objects for rendering.");
734         RNA_def_struct_ui_icon(srna, ICON_MATERIAL_DATA);
735         
736         prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
737         RNA_def_property_enum_sdna(prop, NULL, "material_type");
738         RNA_def_property_enum_items(prop, prop_type_items);
739         RNA_def_property_ui_text(prop, "Type", "Material type defining how the object is rendered.");
740         RNA_def_property_enum_funcs(prop, NULL, "rna_Material_type_set", NULL);
741         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
742         
743         prop= RNA_def_property(srna, "ambient", PROP_FLOAT, PROP_NONE);
744         RNA_def_property_float_sdna(prop, NULL, "amb");
745         RNA_def_property_range(prop, 0, 1);
746         RNA_def_property_ui_text(prop, "Ambient", "Amount of global ambient color the material receives.");
747         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
748
749         prop= RNA_def_property(srna, "emit", PROP_FLOAT, PROP_NONE);
750         RNA_def_property_range(prop, 0, 2);
751         RNA_def_property_ui_text(prop, "Emit", "Amount of light to emit.");
752
753         prop= RNA_def_property(srna, "translucency", PROP_FLOAT, PROP_NONE);
754         RNA_def_property_range(prop, 0, 1);
755         RNA_def_property_ui_text(prop, "Translucency", "Amount of diffuse shading on the back side.");
756         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
757                 
758         prop= RNA_def_property(srna, "cubic", PROP_BOOLEAN, PROP_NONE);
759         RNA_def_property_boolean_sdna(prop, NULL, "shade_flag", MA_CUBIC);
760         RNA_def_property_ui_text(prop, "Cubic Interpolation", "Use cubic interpolation for diffuse values, for smoother transitions.");
761         
762         prop= RNA_def_property(srna, "object_color", PROP_BOOLEAN, PROP_NONE);
763         RNA_def_property_boolean_sdna(prop, NULL, "shade_flag", MA_OBCOLOR);
764         RNA_def_property_ui_text(prop, "Object Color", "Modulate the result with a per-object color.");
765
766         prop= RNA_def_property(srna, "shadow_ray_bias", PROP_FLOAT, PROP_NONE);
767         RNA_def_property_float_sdna(prop, NULL, "sbias");
768         RNA_def_property_range(prop, 0, 0.25);
769         RNA_def_property_ui_text(prop, "Shadow Ray Bias", "Shadow raytracing bias to prevent terminator problems on shadow boundary.");
770
771         prop= RNA_def_property(srna, "shadow_buffer_bias", PROP_FLOAT, PROP_NONE);
772         RNA_def_property_float_sdna(prop, NULL, "lbias");
773         RNA_def_property_range(prop, 0, 10);
774         RNA_def_property_ui_text(prop, "Shadow Buffer Bias", "Factor to multiply shadow buffer bias with (0 is ignore.)");
775
776         prop= RNA_def_property(srna, "shadow_casting_alpha", PROP_FLOAT, PROP_NONE);
777         RNA_def_property_float_sdna(prop, NULL, "shad_alpha");
778         RNA_def_property_range(prop, 0.001, 1);
779         RNA_def_property_ui_text(prop, "Shadow Casting Alpha", "Shadow casting alpha, only in use for Irregular Shadowbuffer.");
780         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
781
782         prop= RNA_def_property(srna, "light_group", PROP_POINTER, PROP_NONE);
783         RNA_def_property_pointer_sdna(prop, NULL, "group");
784         RNA_def_property_struct_type(prop, "Group");
785         RNA_def_property_flag(prop, PROP_EDITABLE);
786         RNA_def_property_ui_text(prop, "Light Group", "Limit lighting to lamps in this Group.");
787         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
788         
789         /* flags */
790         
791         prop= RNA_def_property(srna, "light_group_exclusive", PROP_BOOLEAN, PROP_NONE);
792         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_GROUP_NOLAY);
793         RNA_def_property_ui_text(prop, "Light Group Exclusive", "Material uses the light group exclusively - these lamps are excluded from other scene lighting.");
794         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
795         
796         prop= RNA_def_property(srna, "traceable", PROP_BOOLEAN, PROP_NONE);
797         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TRACEBLE);
798         RNA_def_property_ui_text(prop, "Traceable", "Include this material and geometry that uses it in ray tracing calculations.");
799         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
800         
801         prop= RNA_def_property(srna, "shadows", PROP_BOOLEAN, PROP_NONE);
802         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADOW);
803         RNA_def_property_ui_text(prop, "Shadows", "Allows this material to receive shadows.");
804         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
805         
806         prop= RNA_def_property(srna, "shadeless", PROP_BOOLEAN, PROP_NONE);
807         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHLESS);
808         RNA_def_property_ui_text(prop, "Shadeless", "Makes this material insensitive to light or shadow.");
809         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
810         
811         prop= RNA_def_property(srna, "wireframe", PROP_BOOLEAN, PROP_NONE);
812         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_WIRE);
813         RNA_def_property_ui_text(prop, "Wireframe", "Render the edges of faces as wires (not supported in ray tracing).");
814         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
815         
816         prop= RNA_def_property(srna, "vertex_color_light", PROP_BOOLEAN, PROP_NONE);
817         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_VERTEXCOL);
818         RNA_def_property_ui_text(prop, "Vertex Color Light", "Add vertex colors as additional lighting.");
819         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
820
821         prop= RNA_def_property(srna, "vertex_color_paint", PROP_BOOLEAN, PROP_NONE);
822         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_VERTEXCOLP);
823         RNA_def_property_ui_text(prop, "Vertex Color Paint", "Replaces object base color with vertex colors (multiplies with 'texture face' face assigned textures).");
824         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
825         
826         prop= RNA_def_property(srna, "invert_z", PROP_BOOLEAN, PROP_NONE);
827         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ZINV);
828         RNA_def_property_ui_text(prop, "Invert Z Depth", "Renders material's faces with an inverted Z buffer (scanline only).");
829         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
830         
831         prop= RNA_def_property(srna, "sky", PROP_BOOLEAN, PROP_NONE);
832         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ENV);
833         RNA_def_property_ui_text(prop, "Sky", "Renders this material with zero alpha, with sky background in place (scanline only).");
834         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
835         
836         prop= RNA_def_property(srna, "only_shadow", PROP_BOOLEAN, PROP_NONE);
837         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ONLYSHADOW);
838         RNA_def_property_ui_text(prop, "Only Shadow", "Renders shadows as the material's alpha value, making materials transparent except for shadowed areas.");
839         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
840         
841         prop= RNA_def_property(srna, "face_texture", PROP_BOOLEAN, PROP_NONE);
842         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FACETEXTURE);
843         RNA_def_property_ui_text(prop, "Face Textures", "Replaces the object's base color with color from face assigned image textures");
844         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
845         
846         prop= RNA_def_property(srna, "face_texture_alpha", PROP_BOOLEAN, PROP_NONE);
847         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FACETEXTURE_ALPHA);
848         RNA_def_property_ui_text(prop, "Face Textures Alpha", "Replaces the object's base alpha value with alpha from face assigned image textures");
849         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
850         
851         prop= RNA_def_property(srna, "cast_shadows_only", PROP_BOOLEAN, PROP_NONE);
852         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ONLYCAST);
853         RNA_def_property_ui_text(prop, "Cast Shadows Only", "Makes objects with this material appear invisible, only casting shadows (not rendered).");
854         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
855         
856         prop= RNA_def_property(srna, "exclude_mist", PROP_BOOLEAN, PROP_NONE);
857         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_NOMIST);
858         RNA_def_property_ui_text(prop, "Exclude Mist", "Excludes this material from mist effects (in world settings)");
859         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
860         
861         prop= RNA_def_property(srna, "radiosity", PROP_BOOLEAN, PROP_NONE);
862         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RADIO);
863         RNA_def_property_ui_text(prop, "Radiosity", "Include this material in radiosity calculations");
864         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
865         
866         prop= RNA_def_property(srna, "transparent_shadows", PROP_BOOLEAN, PROP_NONE);
867         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADOW_TRA);
868         RNA_def_property_ui_text(prop, "Transparent Shadows", "Allow this object to receive transparent shadows casted through other objects");
869         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
870         
871         prop= RNA_def_property(srna, "ray_shadow_bias", PROP_BOOLEAN, PROP_NONE);
872         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYBIAS);
873         RNA_def_property_ui_text(prop, "Ray Shadow Bias", "Prevents raytraced shadow errors on surfaces with smooth shaded normals (terminator problem)");
874         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
875         
876         prop= RNA_def_property(srna, "full_oversampling", PROP_BOOLEAN, PROP_NONE);
877         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FULL_OSA);
878         RNA_def_property_ui_text(prop, "Full Oversampling", "Force this material to render full shading/textures for all anti-aliasing samples");
879         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
880
881         prop= RNA_def_property(srna, "cast_buffer_shadows", PROP_BOOLEAN, PROP_NONE);
882         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADBUF);
883         RNA_def_property_ui_text(prop, "Cast Buffer Shadows", "Allow this material to cast shadows from shadow buffer lamps");
884         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
885         
886         prop= RNA_def_property(srna, "tangent_shading", PROP_BOOLEAN, PROP_NONE);
887         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TANGENT_V);
888         RNA_def_property_ui_text(prop, "Tangent Shading", "Use the material's tangent vector instead of the normal for shading - for anisotropic shading effects");
889         RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
890         
891         /* nested structs */
892         prop= RNA_def_property(srna, "raytrace_mirror", PROP_POINTER, PROP_NEVER_NULL);
893         RNA_def_property_struct_type(prop, "MaterialRaytraceMirror");
894         RNA_def_property_pointer_funcs(prop, "rna_Material_mirror_get", NULL);
895         RNA_def_property_ui_text(prop, "Raytrace Mirror", "Raytraced reflection settings for the material.");
896
897         prop= RNA_def_property(srna, "raytrace_transparency", PROP_POINTER, PROP_NEVER_NULL);
898         RNA_def_property_struct_type(prop, "MaterialRaytraceTransparency");
899         RNA_def_property_pointer_funcs(prop, "rna_Material_transp_get", NULL);
900         RNA_def_property_ui_text(prop, "Raytrace Transparency", "Raytraced reflection settings for the material.");
901
902         prop= RNA_def_property(srna, "halo", PROP_POINTER, PROP_NEVER_NULL);
903         RNA_def_property_struct_type(prop, "MaterialHalo");
904         RNA_def_property_pointer_funcs(prop, "rna_Material_halo_get", NULL);
905         RNA_def_property_ui_text(prop, "Halo", "Halo settings for the material.");
906
907         prop= RNA_def_property(srna, "subsurface_scattering", PROP_POINTER, PROP_NEVER_NULL);
908         RNA_def_property_struct_type(prop, "MaterialSubsurfaceScattering");
909         RNA_def_property_pointer_funcs(prop, "rna_Material_sss_get", NULL);
910         RNA_def_property_ui_text(prop, "Subsurface Scattering", "Subsurface scattering settings for the material.");
911
912         prop= RNA_def_property(srna, "strand", PROP_POINTER, PROP_NEVER_NULL);
913         RNA_def_property_struct_type(prop, "MaterialStrand");
914         RNA_def_property_pointer_funcs(prop, "rna_Material_strand_get", NULL);
915         RNA_def_property_ui_text(prop, "Strand", "Strand settings for the material.");
916
917         /* nodetree */
918         prop= RNA_def_property(srna, "node_tree", PROP_POINTER, PROP_NONE);
919         RNA_def_property_pointer_sdna(prop, NULL, "nodetree");
920         RNA_def_property_ui_text(prop, "Node Tree", "Node tree for node based materials.");
921
922         /* common */
923         rna_def_animdata_common(srna);
924         rna_def_mtex_common(srna, "rna_Material_mtex_begin", "rna_Material_active_texture_get", "MaterialTextureSlot");
925
926         prop= RNA_def_property(srna, "script_link", PROP_POINTER, PROP_NEVER_NULL);
927         RNA_def_property_pointer_sdna(prop, NULL, "scriptlink");
928         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
929         RNA_def_property_ui_text(prop, "Script Link", "Scripts linked to this material.");
930
931         /* XXX: does Material.septex get RNA? */
932         
933         rna_def_material_colors(srna);
934         rna_def_material_diffuse(srna);
935         rna_def_material_specularity(srna);
936
937         /* nested structs */
938         rna_def_material_raymirror(brna);
939         rna_def_material_raytra(brna);
940         rna_def_material_halo(brna);
941         rna_def_material_sss(brna);
942         rna_def_material_mtex(brna);
943         rna_def_material_strand(brna);
944 }
945
946 void rna_def_mtex_common(StructRNA *srna, const char *begin, const char *activeget, const char *structname)
947 {
948         PropertyRNA *prop;
949
950         /* mtex */
951         prop= RNA_def_property(srna, "textures", PROP_COLLECTION, PROP_NONE);
952         RNA_def_property_struct_type(prop, structname);
953         RNA_def_property_collection_funcs(prop, begin, "rna_iterator_array_next", "rna_iterator_array_end", "rna_iterator_array_dereference_get", 0, 0, 0);
954         RNA_def_property_ui_text(prop, "Textures", "Texture slots defining the mapping and influence of textures.");
955
956         prop= RNA_def_property(srna, "active_texture", PROP_POINTER, PROP_NONE);
957         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
958         RNA_def_property_struct_type(prop, structname);
959         RNA_def_property_pointer_funcs(prop, activeget, NULL);
960         RNA_def_property_ui_text(prop, "Active Texture", "Active texture slot being displayed.");
961
962         prop= RNA_def_property(srna, "active_texture_index", PROP_INT, PROP_UNSIGNED);
963         RNA_def_property_int_sdna(prop, NULL, "texact");
964         RNA_def_property_range(prop, 0, MAX_MTEX-1);
965         RNA_def_property_ui_text(prop, "Active Texture Index", "Index of active texture slot.");
966 }
967
968 #endif
969
970