4 * ***** BEGIN GPL LICENSE BLOCK *****
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.
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.
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.
20 * Contributor(s): Blender Foundation (2008), Nathan Letwory
22 * ***** END GPL LICENSE BLOCK *****
28 #include "RNA_define.h"
29 #include "RNA_types.h"
31 #include "rna_internal.h"
33 #include "DNA_material_types.h"
34 #include "DNA_texture_types.h"
40 static PointerRNA rna_Material_mirror_get(PointerRNA *ptr)
42 return rna_pointer_inherit_refine(ptr, &RNA_MaterialRaytraceMirror, ptr->id.data);
45 static PointerRNA rna_Material_transp_get(PointerRNA *ptr)
47 return rna_pointer_inherit_refine(ptr, &RNA_MaterialRaytraceTransparency, ptr->id.data);
50 static PointerRNA rna_Material_halo_get(PointerRNA *ptr)
52 return rna_pointer_inherit_refine(ptr, &RNA_MaterialHalo, ptr->id.data);
55 static PointerRNA rna_Material_sss_get(PointerRNA *ptr)
57 return rna_pointer_inherit_refine(ptr, &RNA_MaterialSubsurfaceScattering, ptr->id.data);
60 static PointerRNA rna_Material_strand_get(PointerRNA *ptr)
62 return rna_pointer_inherit_refine(ptr, &RNA_MaterialStrand, ptr->id.data);
65 static void rna_Material_type_set(PointerRNA *ptr, int value)
67 Material *ma= (Material*)ptr->data;
69 if(ma->material_type == MA_TYPE_HALO && value != MA_TYPE_HALO)
70 ma->mode &= ~(MA_STAR|MA_HALO_XALPHA|MA_ZINV|MA_ENV);
72 ma->material_type= value;
75 static void rna_Material_mtex_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
77 Material *ma= (Material*)ptr->data;
78 rna_iterator_array_begin(iter, (void*)ma->mtex, sizeof(MTex*), MAX_MTEX, 0, NULL);
81 static PointerRNA rna_Material_active_texture_get(PointerRNA *ptr)
83 Material *ma= (Material*)ptr->data;
84 return rna_pointer_inherit_refine(ptr, &RNA_TextureSlot, ma->mtex[(int)ma->texact]);
87 static void rna_MaterialStrand_start_size_range(PointerRNA *ptr, float *min, float *max)
89 Material *ma= (Material*)ptr->id.data;
91 if(ma->mode & MA_STR_B_UNITS) {
101 static void rna_MaterialStrand_end_size_range(PointerRNA *ptr, float *min, float *max)
103 Material *ma= (Material*)ptr->id.data;
105 if(ma->mode & MA_STR_B_UNITS) {
115 static int rna_MaterialTextureSlot_enabled_get(PointerRNA *ptr)
117 Material *ma= (Material*)ptr->id.data;
118 MTex *mtex= (MTex*)ptr->data;
121 for(a=0; a<MAX_MTEX; a++)
122 if(ma->mtex[a] == mtex)
123 return (ma->septex & (1<<a)) == 0;
128 static void rna_MaterialTextureSlot_enabled_set(PointerRNA *ptr, int value)
130 Material *ma= (Material*)ptr->id.data;
131 MTex *mtex= (MTex*)ptr->data;
134 for(a=0; a<MAX_MTEX; a++) {
135 if(ma->mtex[a] == mtex) {
137 ma->septex &= ~(1<<a);
139 ma->septex |= (1<<a);
146 static void rna_def_material_mtex(BlenderRNA *brna)
151 static EnumPropertyItem prop_texture_coordinates_items[] = {
152 {TEXCO_GLOB, "GLOBAL", 0, "Global", "Uses global coordinates for the texture coordinates."},
153 {TEXCO_OBJECT, "OBJECT", 0, "Object", "Uses linked object's coordinates for texture coordinates."},
154 {TEXCO_UV, "UV", 0, "UV", "Uses UV coordinates for texture coordinates."},
155 {TEXCO_ORCO, "ORCO", 0, "Generated", "Uses the original undeformed coordinates of the object."},
156 {TEXCO_STRAND, "STRAND", 0, "Strand", "Uses normalized strand texture coordinate (1D)."},
157 {TEXCO_STICKY, "STICKY", 0, "Sticky", "Uses mesh's sticky coordinates for the texture coordinates."},
158 {TEXCO_WINDOW, "WINDOW", 0, "Window", "Uses screen coordinates as texture coordinates."},
159 {TEXCO_NORM, "NORMAL", 0, "Normal", "Uses normal vector as texture coordinates."},
160 {TEXCO_REFL, "REFLECTION", 0, "Reflection", "Uses reflection vector as texture coordinates."},
161 {TEXCO_STRESS, "STRESS", 0, "Stress", "Uses the difference of edge lengths compared to original coordinates of the mesh."},
162 {TEXCO_TANGENT, "TANGENT", 0, "Tangent", "Uses the optional tangent vector as texture coordinates."},
164 {0, NULL, 0, NULL, NULL}};
166 static EnumPropertyItem prop_mapping_items[] = {
167 {MTEX_FLAT, "FLAT", 0, "Flat", "Maps X and Y coordinates directly."},
168 {MTEX_CUBE, "CUBE", 0, "Cube", "Maps using the normal vector."},
169 {MTEX_TUBE, "TUBE", 0, "Tube", "Maps with Z as central axis."},
170 {MTEX_SPHERE, "SPHERE", 0, "Sphere", "Maps with Z as central axis."},
171 {0, NULL, 0, NULL, NULL}};
173 static EnumPropertyItem prop_x_mapping_items[] = {
174 {0, "NONE", 0, "None", ""},
175 {1, "X", 0, "X", ""},
176 {2, "Y", 0, "Y", ""},
177 {3, "Z", 0, "Z", ""},
178 {0, NULL, 0, NULL, NULL}};
180 static EnumPropertyItem prop_y_mapping_items[] = {
181 {0, "NONE", 0, "None", ""},
182 {1, "X", 0, "X", ""},
183 {2, "Y", 0, "Y", ""},
184 {3, "Z", 0, "Z", ""},
185 {0, NULL, 0, NULL, NULL}};
187 static EnumPropertyItem prop_z_mapping_items[] = {
188 {0, "NONE", 0, "None", ""},
189 {1, "X", 0, "X", ""},
190 {2, "Y", 0, "Y", ""},
191 {3, "Z", 0, "Z", ""},
192 {0, NULL, 0, NULL, NULL}};
194 static EnumPropertyItem prop_normal_map_space_items[] = {
195 {MTEX_NSPACE_CAMERA, "CAMERA", 0, "Camera", ""},
196 {MTEX_NSPACE_WORLD, "WORLD", 0, "World", ""},
197 {MTEX_NSPACE_OBJECT, "OBJECT", 0, "Object", ""},
198 {MTEX_NSPACE_TANGENT, "TANGENT", 0, "Tangent", ""},
199 {0, NULL, 0, NULL, NULL}};
201 srna= RNA_def_struct(brna, "MaterialTextureSlot", "TextureSlot");
202 RNA_def_struct_sdna(srna, "MTex");
203 RNA_def_struct_ui_text(srna, "Material Texture Slot", "Texture slot for textures in a Material datablock.");
205 prop= RNA_def_property(srna, "texture_coordinates", PROP_ENUM, PROP_NONE);
206 RNA_def_property_enum_sdna(prop, NULL, "texco");
207 RNA_def_property_enum_items(prop, prop_texture_coordinates_items);
208 RNA_def_property_ui_text(prop, "Texture Coordinates", "");
210 prop= RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
211 RNA_def_property_pointer_sdna(prop, NULL, "object");
212 RNA_def_property_struct_type(prop, "Object");
213 RNA_def_property_flag(prop, PROP_EDITABLE);
214 RNA_def_property_ui_text(prop, "Object", "Object to use for mapping with Object texture coordinates.");
216 prop= RNA_def_property(srna, "uv_layer", PROP_STRING, PROP_NONE);
217 RNA_def_property_string_sdna(prop, NULL, "uvname");
218 RNA_def_property_ui_text(prop, "UV Layer", "UV layer to use for mapping with UV texture coordinates.");
220 prop= RNA_def_property(srna, "from_dupli", PROP_BOOLEAN, PROP_NONE);
221 RNA_def_property_boolean_sdna(prop, NULL, "texflag", MTEX_DUPLI_MAPTO);
222 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).");
224 prop= RNA_def_property(srna, "map_color", PROP_BOOLEAN, PROP_NONE);
225 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_COL);
226 RNA_def_property_ui_text(prop, "Color", "Causes the texture to affect basic color of the material");
228 prop= RNA_def_property(srna, "map_normal", PROP_BOOLEAN, PROP_NONE);
229 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_NORM);
230 RNA_def_property_ui_text(prop, "Normal", "Causes the texture to affect the rendered normal");
232 prop= RNA_def_property(srna, "map_colorspec", PROP_BOOLEAN, PROP_NONE);
233 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_COLSPEC);
234 RNA_def_property_ui_text(prop, "Specularity Color", "Causes the texture to affect the specularity color");
236 prop= RNA_def_property(srna, "map_mirror", PROP_BOOLEAN, PROP_NONE);
237 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_COLMIR);
238 RNA_def_property_ui_text(prop, "Mirror", "Causes the texture to affect the mirror color");
240 prop= RNA_def_property(srna, "map_reflection", PROP_BOOLEAN, PROP_NONE);
241 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_REF);
242 RNA_def_property_ui_text(prop, "Reflection", "Causes the texture to affect the value of the materials reflectivity");
244 prop= RNA_def_property(srna, "map_specularity", PROP_BOOLEAN, PROP_NONE);
245 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_SPEC);
246 RNA_def_property_ui_text(prop, "Specularity", "Causes the texture to affect the value of specularity");
248 prop= RNA_def_property(srna, "map_ambient", PROP_BOOLEAN, PROP_NONE);
249 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_AMB);
250 RNA_def_property_ui_text(prop, "Ambient", "Causes the texture to affect the value of ambient");
252 prop= RNA_def_property(srna, "map_hardness", PROP_BOOLEAN, PROP_NONE);
253 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_HAR);
254 RNA_def_property_ui_text(prop, "Hardness", "Causes the texture to affect the hardness value");
256 prop= RNA_def_property(srna, "map_raymir", PROP_BOOLEAN, PROP_NONE);
257 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_RAYMIRR);
258 RNA_def_property_ui_text(prop, "Ray-Mirror", "Causes the texture to affect the ray-mirror value");
260 prop= RNA_def_property(srna, "map_alpha", PROP_BOOLEAN, PROP_NONE);
261 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_ALPHA);
262 RNA_def_property_ui_text(prop, "Alpha", "Causes the texture to affect the alpha value");
264 prop= RNA_def_property(srna, "map_emit", PROP_BOOLEAN, PROP_NONE);
265 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_EMIT);
266 RNA_def_property_ui_text(prop, "Emit", "Causes the texture to affect the emit value");
268 prop= RNA_def_property(srna, "map_translucency", PROP_BOOLEAN, PROP_NONE);
269 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_TRANSLU);
270 RNA_def_property_ui_text(prop, "Translucency", "Causes the texture to affect the translucency value");
272 prop= RNA_def_property(srna, "map_displacement", PROP_BOOLEAN, PROP_NONE);
273 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_DISPLACE);
274 RNA_def_property_ui_text(prop, "Displacement", "Let the texture displace the surface");
276 prop= RNA_def_property(srna, "map_warp", PROP_BOOLEAN, PROP_NONE);
277 RNA_def_property_boolean_sdna(prop, NULL, "mapto", MAP_WARP);
278 RNA_def_property_ui_text(prop, "Warp", "Let the texture warp texture coordinates of next channels");
280 prop= RNA_def_property(srna, "x_mapping", PROP_ENUM, PROP_NONE);
281 RNA_def_property_enum_sdna(prop, NULL, "projx");
282 RNA_def_property_enum_items(prop, prop_x_mapping_items);
283 RNA_def_property_ui_text(prop, "X Mapping", "");
285 prop= RNA_def_property(srna, "y_mapping", PROP_ENUM, PROP_NONE);
286 RNA_def_property_enum_sdna(prop, NULL, "projy");
287 RNA_def_property_enum_items(prop, prop_y_mapping_items);
288 RNA_def_property_ui_text(prop, "Y Mapping", "");
290 prop= RNA_def_property(srna, "z_mapping", PROP_ENUM, PROP_NONE);
291 RNA_def_property_enum_sdna(prop, NULL, "projz");
292 RNA_def_property_enum_items(prop, prop_z_mapping_items);
293 RNA_def_property_ui_text(prop, "Z Mapping", "");
295 prop= RNA_def_property(srna, "mapping", PROP_ENUM, PROP_NONE);
296 RNA_def_property_enum_items(prop, prop_mapping_items);
297 RNA_def_property_ui_text(prop, "Mapping", "");
299 /* XXX: pmapto, pmaptoneg */
301 prop= RNA_def_property(srna, "normal_map_space", PROP_ENUM, PROP_NONE);
302 RNA_def_property_enum_sdna(prop, NULL, "normapspace");
303 RNA_def_property_enum_items(prop, prop_normal_map_space_items);
304 RNA_def_property_ui_text(prop, "Normal Map Space", "");
306 /* XXX: MTex.which_output */
310 prop= RNA_def_property(srna, "displacement_factor", PROP_FLOAT, PROP_VECTOR);
311 RNA_def_property_float_sdna(prop, NULL, "dispfac");
312 RNA_def_property_range(prop, 0, 1);
313 RNA_def_property_ui_text(prop, "Displacement Factor", "Amount texture displaces the surface.");
315 prop= RNA_def_property(srna, "warp_factor", PROP_FLOAT, PROP_VECTOR);
316 RNA_def_property_float_sdna(prop, NULL, "warpfac");
317 RNA_def_property_range(prop, 0, 1);
318 RNA_def_property_ui_text(prop, "Warp Factor", "Amount texture affects color values.");
320 prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
321 RNA_def_property_boolean_funcs(prop, "rna_MaterialTextureSlot_enabled_get", "rna_MaterialTextureSlot_enabled_set");
322 RNA_def_property_ui_text(prop, "Enabled", "Enable this material texture slot.");
323 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
327 static void rna_def_material_colors(StructRNA *srna)
331 prop= RNA_def_property(srna, "diffuse_color", PROP_FLOAT, PROP_COLOR);
332 RNA_def_property_float_sdna(prop, NULL, "r");
333 RNA_def_property_array(prop, 3);
334 RNA_def_property_ui_text(prop, "Diffuse Color", "");
335 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
337 prop= RNA_def_property(srna, "specular_color", PROP_FLOAT, PROP_COLOR);
338 RNA_def_property_float_sdna(prop, NULL, "specr");
339 RNA_def_property_array(prop, 3);
340 RNA_def_property_ui_text(prop, "Specular Color", "Specular color of the material.");
341 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
343 prop= RNA_def_property(srna, "mirror_color", PROP_FLOAT, PROP_COLOR);
344 RNA_def_property_float_sdna(prop, NULL, "mirr");
345 RNA_def_property_array(prop, 3);
346 RNA_def_property_ui_text(prop, "Mirror Color", "Mirror color of the material.");
347 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
349 prop= RNA_def_property(srna, "alpha", PROP_FLOAT, PROP_NONE);
350 RNA_def_property_range(prop, 0.0f, 1.0f);
351 RNA_def_property_ui_text(prop, "Alpha", "Alpha transparency of the material.");
352 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
355 prop= RNA_def_property(srna, "diffuse_ramp", PROP_POINTER, PROP_NONE);
356 RNA_def_property_pointer_sdna(prop, NULL, "ramp_col");
357 RNA_def_property_struct_type(prop, "ColorRamp");
358 RNA_def_property_ui_text(prop, "Diffuse Ramp", "Color ramp used to affect diffuse shading.");
360 prop= RNA_def_property(srna, "specular_ramp", PROP_POINTER, PROP_NONE);
361 RNA_def_property_pointer_sdna(prop, NULL, "ramp_spec");
362 RNA_def_property_struct_type(prop, "ColorRamp");
363 RNA_def_property_ui_text(prop, "Specular Ramp", "Color ramp used to affect specular shading.");
366 static void rna_def_material_diffuse(StructRNA *srna)
370 static EnumPropertyItem prop_diff_shader_items[] = {
371 {MA_DIFF_LAMBERT, "LAMBERT", 0, "Lambert", ""},
372 {MA_DIFF_ORENNAYAR, "OREN_NAYAR", 0, "Oren-Nayar", ""},
373 {MA_DIFF_TOON, "TOON", 0, "Toon", ""},
374 {MA_DIFF_MINNAERT, "MINNAERT", 0, "Minnaert", ""},
375 {MA_DIFF_FRESNEL, "FRESNEL", 0, "Fresnel", ""},
376 {0, NULL, 0, NULL, NULL}};
378 prop= RNA_def_property(srna, "diffuse_shader", PROP_ENUM, PROP_NONE);
379 RNA_def_property_enum_sdna(prop, NULL, "diff_shader");
380 RNA_def_property_enum_items(prop, prop_diff_shader_items);
381 RNA_def_property_ui_text(prop, "Diffuse Shader Model", "");
382 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
384 prop= RNA_def_property(srna, "diffuse_reflection", PROP_FLOAT, PROP_NONE);
385 RNA_def_property_float_sdna(prop, NULL, "ref");
386 RNA_def_property_range(prop, 0.0f, 1.0f);
387 RNA_def_property_ui_text(prop, "Diffuse Reflection", "Amount of diffuse reflection.");
388 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
390 prop= RNA_def_property(srna, "roughness", PROP_FLOAT, PROP_NONE);
391 RNA_def_property_range(prop, 0.0f, 3.14f);
392 RNA_def_property_ui_text(prop, "Roughness", "Oren-Nayar Roughness");
393 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
395 prop= RNA_def_property(srna, "diffuse_toon_size", PROP_FLOAT, PROP_NONE);
396 RNA_def_property_float_sdna(prop, NULL, "param[0]");
397 RNA_def_property_range(prop, 0.0f, 3.14f);
398 RNA_def_property_ui_text(prop, "Diffuse Toon Size", "Size of diffuse toon area.");
399 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
401 prop= RNA_def_property(srna, "diffuse_toon_smooth", PROP_FLOAT, PROP_NONE);
402 RNA_def_property_float_sdna(prop, NULL, "param[1]");
403 RNA_def_property_range(prop, 0.0f, 1.0f);
404 RNA_def_property_ui_text(prop, "Diffuse Toon Smooth", "Smoothness of diffuse toon area.");
405 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
407 prop= RNA_def_property(srna, "diffuse_fresnel", PROP_FLOAT, PROP_NONE);
408 RNA_def_property_float_sdna(prop, NULL, "param[1]");
409 RNA_def_property_range(prop, 0.0f, 5.0f);
410 RNA_def_property_ui_text(prop, "Diffuse Fresnel", "Power of Fresnel.");
411 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
413 prop= RNA_def_property(srna, "diffuse_fresnel_factor", PROP_FLOAT, PROP_NONE);
414 RNA_def_property_float_sdna(prop, NULL, "param[0]");
415 RNA_def_property_range(prop, 0.0f, 5.0f);
416 RNA_def_property_ui_text(prop, "Diffuse Fresnel Factor", "Blending factor of Frensel.");
417 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
419 prop= RNA_def_property(srna, "darkness", PROP_FLOAT, PROP_NONE);
420 RNA_def_property_range(prop, 0.0f, 2.0f);
421 RNA_def_property_ui_text(prop, "Darkness", "Minnaert darkness.");
422 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
425 static void rna_def_material_raymirror(BlenderRNA *brna)
430 static EnumPropertyItem prop_fadeto_mir_items[] = {
431 {MA_RAYMIR_FADETOSKY, "FADE_TO_SKY", 0, "Fade to Sky Color", ""},
432 {MA_RAYMIR_FADETOMAT, "FADE_TO_MATERIAL", 0, "Fade to Material Color", ""},
433 {0, NULL, 0, NULL, NULL}};
435 srna= RNA_def_struct(brna, "MaterialRaytraceMirror", NULL);
436 RNA_def_struct_sdna(srna, "Material");
437 RNA_def_struct_nested(brna, srna, "Material");
438 RNA_def_struct_ui_text(srna, "Material Raytrace Mirror", "Raytraced reflection settings for a Material datablock.");
440 prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
441 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYMIRROR); /* use bitflags */
442 RNA_def_property_ui_text(prop, "Enabled", "Enable raytraced reflections.");
443 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
445 prop= RNA_def_property(srna, "reflect", PROP_FLOAT, PROP_NONE);
446 RNA_def_property_float_sdna(prop, NULL, "ray_mirror");
447 RNA_def_property_range(prop, 0.0f, 1.0f);
448 RNA_def_property_ui_text(prop, "Reflect", "Sets the amount mirror reflection for raytrace.");
449 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
451 prop= RNA_def_property(srna, "fresnel", PROP_FLOAT, PROP_NONE);
452 RNA_def_property_float_sdna(prop, NULL, "fresnel_mir");
453 RNA_def_property_range(prop, 0.0f, 5.0f);
454 RNA_def_property_ui_text(prop, "Fresnel", "Power of Fresnel for mirror reflection.");
455 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
457 prop= RNA_def_property(srna, "fresnel_fac", PROP_FLOAT, PROP_NONE);
458 RNA_def_property_float_sdna(prop, NULL, "fresnel_mir_i");
459 RNA_def_property_range(prop, 0.0f, 5.0f);
460 RNA_def_property_ui_text(prop, "Fresnel Factor", "Blending factor for Fresnel.");
461 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
463 prop= RNA_def_property(srna, "gloss", PROP_FLOAT, PROP_NONE);
464 RNA_def_property_float_sdna(prop, NULL, "gloss_mir");
465 RNA_def_property_range(prop, 0.0f, 1.0f);
466 RNA_def_property_ui_text(prop, "Gloss", "The shininess of the reflection. Values < 1.0 give diffuse, blurry reflections.");
467 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
469 prop= RNA_def_property(srna, "gloss_anisotropic", PROP_FLOAT, PROP_NONE);
470 RNA_def_property_float_sdna(prop, NULL, "aniso_gloss_mir");
471 RNA_def_property_range(prop, 0.0f, 1.0f);
472 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.");
473 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
475 prop= RNA_def_property(srna, "gloss_samples", PROP_INT, PROP_NONE);
476 RNA_def_property_int_sdna(prop, NULL, "samp_gloss_mir");
477 RNA_def_property_range(prop, 0, 1024);
478 RNA_def_property_ui_text(prop, "Gloss Samples", "Number of cone samples averaged for blurry reflections.");
479 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
481 prop= RNA_def_property(srna, "gloss_threshold", PROP_FLOAT, PROP_NONE);
482 RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_mir");
483 RNA_def_property_range(prop, 0.0f, 1.0f);
484 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.");
485 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
487 prop= RNA_def_property(srna, "depth", PROP_INT, PROP_NONE);
488 RNA_def_property_int_sdna(prop, NULL, "ray_depth");
489 RNA_def_property_range(prop, 0, 10);
490 RNA_def_property_ui_text(prop, "Depth", "Maximum allowed number of light inter-reflections.");
491 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
493 prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
494 RNA_def_property_float_sdna(prop, NULL, "dist_mir");
495 RNA_def_property_range(prop, 0.0f, 10000.0f);
496 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.");
497 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
499 prop= RNA_def_property(srna, "fade_to", PROP_ENUM, PROP_NONE);
500 RNA_def_property_enum_sdna(prop, NULL, "fadeto_mir");
501 RNA_def_property_enum_items(prop, prop_fadeto_mir_items);
502 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.");
503 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
506 static void rna_def_material_raytra(BlenderRNA *brna)
511 srna= RNA_def_struct(brna, "MaterialRaytraceTransparency", NULL);
512 RNA_def_struct_sdna(srna, "Material");
513 RNA_def_struct_nested(brna, srna, "Material");
514 RNA_def_struct_ui_text(srna, "Material Raytrace Transparency", "Raytraced refraction settings for a Material datablock.");
516 prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
517 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYTRANSP); /* use bitflags */
518 RNA_def_property_ui_text(prop, "Enabled", "Enables raytracing for transparent refraction rendering.");
519 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
521 prop= RNA_def_property(srna, "ior", PROP_FLOAT, PROP_NONE);
522 RNA_def_property_float_sdna(prop, NULL, "ang");
523 RNA_def_property_range(prop, 1.0f, 3.0f);
524 RNA_def_property_ui_text(prop, "IOR", "Sets angular index of refraction for raytraced refraction.");
525 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
527 prop= RNA_def_property(srna, "fresnel", PROP_FLOAT, PROP_NONE);
528 RNA_def_property_float_sdna(prop, NULL, "fresnel_tra");
529 RNA_def_property_range(prop, 0.0f, 5.0f);
530 RNA_def_property_ui_text(prop, "Fresnel", "Power of Fresnel for transparency (Ray or ZTransp).");
531 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
533 prop= RNA_def_property(srna, "fresnel_fac", PROP_FLOAT, PROP_NONE);
534 RNA_def_property_float_sdna(prop, NULL, "fresnel_tra_i");
535 RNA_def_property_range(prop, 1.0f, 5.0f);
536 RNA_def_property_ui_text(prop, "Fresnel Factor", "Blending factor for Fresnel.");
537 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
539 prop= RNA_def_property(srna, "gloss", PROP_FLOAT, PROP_NONE);
540 RNA_def_property_float_sdna(prop, NULL, "gloss_tra");
541 RNA_def_property_range(prop, 0.0f, 1.0f);
542 RNA_def_property_ui_text(prop, "Gloss", "The clarity of the refraction. Values < 1.0 give diffuse, blurry refractions.");
543 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
545 prop= RNA_def_property(srna, "gloss_samples", PROP_INT, PROP_NONE);
546 RNA_def_property_int_sdna(prop, NULL, "samp_gloss_tra");
547 RNA_def_property_range(prop, 0, 1024);
548 RNA_def_property_ui_text(prop, "Gloss Samples", "Number of cone samples averaged for blurry refractions.");
549 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
551 prop= RNA_def_property(srna, "gloss_threshold", PROP_FLOAT, PROP_NONE);
552 RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_tra");
553 RNA_def_property_range(prop, 0.0f, 1.0f);
554 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.");
555 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
557 prop= RNA_def_property(srna, "depth", PROP_INT, PROP_NONE);
558 RNA_def_property_int_sdna(prop, NULL, "ray_depth_tra");
559 RNA_def_property_range(prop, 0, 10);
560 RNA_def_property_ui_text(prop, "Depth", "Maximum allowed number of light inter-refractions.");
561 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
563 prop= RNA_def_property(srna, "filter", PROP_FLOAT, PROP_NONE);
564 RNA_def_property_float_sdna(prop, NULL, "filter");
565 RNA_def_property_range(prop, 0.0f, 1.0f);
566 RNA_def_property_ui_text(prop, "Filter", "Amount to blend in the material's diffuse color in raytraced transparency (simulating absorption).");
567 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
569 prop= RNA_def_property(srna, "limit", PROP_FLOAT, PROP_NONE);
570 RNA_def_property_float_sdna(prop, NULL, "tx_limit");
571 RNA_def_property_range(prop, 0.0f, 100.0f);
572 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).");
573 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
575 prop= RNA_def_property(srna, "falloff", PROP_FLOAT, PROP_NONE);
576 RNA_def_property_float_sdna(prop, NULL, "tx_falloff");
577 RNA_def_property_range(prop, 0.1f, 10.0f);
578 RNA_def_property_ui_text(prop, "Falloff", "Falloff power for transmissivity filter effect (1.0 is linear).");
579 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
581 prop= RNA_def_property(srna, "specular_opacity", PROP_FLOAT, PROP_NONE);
582 RNA_def_property_float_sdna(prop, NULL, "spectra");
583 RNA_def_property_range(prop, 0.0f, 1.0f);
584 RNA_def_property_ui_text(prop, "Specular Opacity", "Makes specular areas opaque on transparent materials.");
585 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
588 static void rna_def_material_halo(BlenderRNA *brna)
593 srna= RNA_def_struct(brna, "MaterialHalo", NULL);
594 RNA_def_struct_sdna(srna, "Material");
595 RNA_def_struct_nested(brna, srna, "Material");
596 RNA_def_struct_ui_text(srna, "Material Halo", "Halo particle effect settings for a Material datablock.");
598 prop= RNA_def_property(srna, "size", PROP_FLOAT, PROP_NONE);
599 RNA_def_property_float_sdna(prop, NULL, "hasize");
600 RNA_def_property_range(prop, 0.0f, 100.0f);
601 RNA_def_property_ui_text(prop, "Size", "Sets the dimension of the halo.");
602 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
604 prop= RNA_def_property(srna, "hardness", PROP_INT, PROP_NONE);
605 RNA_def_property_int_sdna(prop, NULL, "har");
606 RNA_def_property_range(prop, 0, 127);
607 RNA_def_property_ui_text(prop, "Hardness", "Sets the hardness of the halo.");
608 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
610 prop= RNA_def_property(srna, "add", PROP_FLOAT, PROP_NONE);
611 RNA_def_property_float_sdna(prop, NULL, "add");
612 RNA_def_property_range(prop, 0.0f, 1.0f);
613 RNA_def_property_ui_text(prop, "Add", "Sets the strength of the add effect.");
614 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
616 prop= RNA_def_property(srna, "rings", PROP_INT, PROP_NONE);
617 RNA_def_property_int_sdna(prop, NULL, "ringc");
618 RNA_def_property_range(prop, 0, 24);
619 RNA_def_property_ui_text(prop, "Rings", "Sets the number of rings rendered over the halo.");
620 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
622 prop= RNA_def_property(srna, "line_number", PROP_INT, PROP_NONE);
623 RNA_def_property_int_sdna(prop, NULL, "linec");
624 RNA_def_property_range(prop, 0, 250);
625 RNA_def_property_ui_text(prop, "Line Number", "Sets the number of star shaped lines rendered over the halo.");
626 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
628 prop= RNA_def_property(srna, "star_tips", PROP_INT, PROP_NONE);
629 RNA_def_property_int_sdna(prop, NULL, "starc");
630 RNA_def_property_range(prop, 3, 50);
631 RNA_def_property_ui_text(prop, "Star Tips", "Sets the number of points on the star shaped halo.");
632 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
634 prop= RNA_def_property(srna, "seed", PROP_INT, PROP_NONE);
635 RNA_def_property_int_sdna(prop, NULL, "seed1");
636 RNA_def_property_range(prop, 0, 255);
637 RNA_def_property_ui_text(prop, "Seed", "Randomizes ring dimension and line location.");
638 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
640 prop= RNA_def_property(srna, "flare_mode", PROP_BOOLEAN, PROP_NONE);
641 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_FLARE); /* use bitflags */
642 RNA_def_property_ui_text(prop, "Flare", "Renders halo as a lensflare.");
643 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
645 prop= RNA_def_property(srna, "flare_size", PROP_FLOAT, PROP_NONE);
646 RNA_def_property_float_sdna(prop, NULL, "flaresize");
647 RNA_def_property_range(prop, 0.1f, 25.0f);
648 RNA_def_property_ui_text(prop, "Flare Size", "Sets the factor by which the flare is larger than the halo.");
649 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
651 prop= RNA_def_property(srna, "flare_subsize", PROP_FLOAT, PROP_NONE);
652 RNA_def_property_float_sdna(prop, NULL, "subsize");
653 RNA_def_property_range(prop, 0.1f, 25.0f);
654 RNA_def_property_ui_text(prop, "Flare Subsize", "Sets the dimension of the subflares, dots and circles.");
655 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
657 prop= RNA_def_property(srna, "flare_boost", PROP_FLOAT, PROP_NONE);
658 RNA_def_property_float_sdna(prop, NULL, "flareboost");
659 RNA_def_property_range(prop, 0.1f, 10.0f);
660 RNA_def_property_ui_text(prop, "Flare Boost", "Gives the flare extra strength.");
661 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
663 prop= RNA_def_property(srna, "flare_seed", PROP_INT, PROP_NONE);
664 RNA_def_property_int_sdna(prop, NULL, "seed2");
665 RNA_def_property_range(prop, 0, 255);
666 RNA_def_property_ui_text(prop, "Flare Seed", "Specifies an offset in the flare seed table.");
667 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
669 prop= RNA_def_property(srna, "flares_sub", PROP_INT, PROP_NONE);
670 RNA_def_property_int_sdna(prop, NULL, "flarec");
671 RNA_def_property_range(prop, 1, 32);
672 RNA_def_property_ui_text(prop, "Flares Sub", "Sets the number of subflares.");
673 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
675 prop= RNA_def_property(srna, "ring", PROP_BOOLEAN, PROP_NONE);
676 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_RINGS);
677 RNA_def_property_ui_text(prop, "Rings", "Renders rings over halo.");
678 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
680 prop= RNA_def_property(srna, "lines", PROP_BOOLEAN, PROP_NONE);
681 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_LINES);
682 RNA_def_property_ui_text(prop, "Lines", "Renders star shaped lines over halo.");
683 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
685 prop= RNA_def_property(srna, "star", PROP_BOOLEAN, PROP_NONE);
686 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STAR);
687 RNA_def_property_ui_text(prop, "Star", "Renders halo as a star.");
688 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
690 prop= RNA_def_property(srna, "use_texture", PROP_BOOLEAN, PROP_NONE);
691 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALOTEX);
692 RNA_def_property_ui_text(prop, "Use Texture", "Gives halo a texture.");
693 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
695 prop= RNA_def_property(srna, "use_vertex_normal", PROP_BOOLEAN, PROP_NONE);
696 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALOPUNO);
697 RNA_def_property_ui_text(prop, "Use Vertex Normal", "Uses the vertex normal to specify the dimension of the halo.");
698 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
700 prop= RNA_def_property(srna, "xalpha", PROP_BOOLEAN, PROP_NONE);
701 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_XALPHA);
702 RNA_def_property_ui_text(prop, "Extreme Alpha", "Uses extreme alpha.");
703 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
705 prop= RNA_def_property(srna, "shaded", PROP_BOOLEAN, PROP_NONE);
706 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_SHADE);
707 RNA_def_property_ui_text(prop, "Shaded", "Lets halo receive light and shadows from external objects.");
708 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
710 prop= RNA_def_property(srna, "soft", PROP_BOOLEAN, PROP_NONE);
711 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_HALO_SOFT);
712 RNA_def_property_ui_text(prop, "Soft", "Softens the edges of halos at intersections with other geometry.");
713 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
716 static void rna_def_material_sss(BlenderRNA *brna)
721 srna= RNA_def_struct(brna, "MaterialSubsurfaceScattering", NULL);
722 RNA_def_struct_sdna(srna, "Material");
723 RNA_def_struct_nested(brna, srna, "Material");
724 RNA_def_struct_ui_text(srna, "Material Subsurface Scattering", "Diffuse subsurface scattering settings for a Material datablock.");
726 prop= RNA_def_property(srna, "radius", PROP_FLOAT, PROP_NONE);
727 RNA_def_property_float_sdna(prop, NULL, "sss_radius");
728 RNA_def_property_range(prop, 0.001, FLT_MAX);
729 RNA_def_property_ui_range(prop, 0.001, 10000, 1, 3);
730 RNA_def_property_ui_text(prop, "Radius", "Mean red/green/blue scattering path length.");
731 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
733 prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
734 RNA_def_property_float_sdna(prop, NULL, "sss_col");
735 RNA_def_property_ui_text(prop, "Color", "Scattering color.");
736 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
738 prop= RNA_def_property(srna, "error_tolerance", PROP_FLOAT, PROP_NONE);
739 RNA_def_property_float_sdna(prop, NULL, "sss_error");
740 RNA_def_property_ui_range(prop, 0.0001, 10, 1, 3);
741 RNA_def_property_ui_text(prop, "Error Tolerance", "Error tolerance (low values are slower and higher quality).");
742 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
744 prop= RNA_def_property(srna, "scale", PROP_FLOAT, PROP_NONE);
745 RNA_def_property_float_sdna(prop, NULL, "sss_scale");
746 RNA_def_property_ui_range(prop, 0.001, 1000, 1, 3);
747 RNA_def_property_ui_text(prop, "Scale", "Object scale factor.");
748 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
750 prop= RNA_def_property(srna, "ior", PROP_FLOAT, PROP_NONE);
751 RNA_def_property_float_sdna(prop, NULL, "sss_ior");
752 RNA_def_property_ui_range(prop, 0.1, 2, 1, 3);
753 RNA_def_property_ui_text(prop, "IOR", "Index of refraction (higher values are denser).");
754 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
756 prop= RNA_def_property(srna, "color_factor", PROP_FLOAT, PROP_NONE);
757 RNA_def_property_float_sdna(prop, NULL, "sss_colfac");
758 RNA_def_property_range(prop, 0, 1);
759 RNA_def_property_ui_text(prop, "Color Factor", "Blend factor for SSS colors.");
760 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
762 prop= RNA_def_property(srna, "texture_factor", PROP_FLOAT, PROP_NONE);
763 RNA_def_property_float_sdna(prop, NULL, "sss_texfac");
764 RNA_def_property_range(prop, 0, 1);
765 RNA_def_property_ui_text(prop, "Texture Factor", "Texture scatting blend factor.");
766 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
768 prop= RNA_def_property(srna, "front", PROP_FLOAT, PROP_NONE);
769 RNA_def_property_float_sdna(prop, NULL, "sss_front");
770 RNA_def_property_range(prop, 0, 2);
771 RNA_def_property_ui_text(prop, "Front", "Front scattering weight.");
772 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
774 prop= RNA_def_property(srna, "back", PROP_FLOAT, PROP_NONE);
775 RNA_def_property_float_sdna(prop, NULL, "sss_back");
776 RNA_def_property_range(prop, 0, 10);
777 RNA_def_property_ui_text(prop, "Back", "Back scattering weight.");
778 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
780 prop= RNA_def_property(srna, "enabled", PROP_BOOLEAN, PROP_NONE);
781 RNA_def_property_boolean_sdna(prop, NULL, "sss_flag", MA_DIFF_SSS);
782 RNA_def_property_ui_text(prop, "Enabled", "Enable diffuse subsurface scatting effects in a material.");
783 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
786 void rna_def_material_specularity(StructRNA *srna)
790 static EnumPropertyItem prop_spec_shader_items[] = {
791 {MA_SPEC_COOKTORR, "COOKTORR", 0, "CookTorr", ""},
792 {MA_SPEC_PHONG, "PHONG", 0, "Phong", ""},
793 {MA_SPEC_BLINN, "BLINN", 0, "Blinn", ""},
794 {MA_SPEC_TOON, "TOON", 0, "Toon", ""},
795 {MA_SPEC_WARDISO, "WARDISO", 0, "WardIso", ""},
796 {0, NULL, 0, NULL, NULL}};
798 prop= RNA_def_property(srna, "spec_shader", PROP_ENUM, PROP_NONE);
799 RNA_def_property_enum_sdna(prop, NULL, "spec_shader");
800 RNA_def_property_enum_items(prop, prop_spec_shader_items);
801 RNA_def_property_ui_text(prop, "Specular Shader Model", "");
802 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
804 prop= RNA_def_property(srna, "specular_reflection", PROP_FLOAT, PROP_NONE);
805 RNA_def_property_float_sdna(prop, NULL, "spec");
806 RNA_def_property_range(prop, 0, 1);
807 RNA_def_property_ui_text(prop, "Specularity Intensity", "");
808 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
810 /* NOTE: "har", "param", etc are used for multiple purposes depending on
811 * settings. This should be fixed in DNA once, for RNA we just expose them
812 * multiple times, which may give somewhat strange changes in the outliner,
813 * but in the UI they are never visible at the same time. */
815 prop= RNA_def_property(srna, "specular_hardness", PROP_FLOAT, PROP_NONE);
816 RNA_def_property_float_sdna(prop, NULL, "har");
817 RNA_def_property_range(prop, 1, 511);
818 RNA_def_property_ui_text(prop, "Specular Hardness", "");
819 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
821 prop= RNA_def_property(srna, "specular_ior", PROP_FLOAT, PROP_NONE);
822 RNA_def_property_float_sdna(prop, NULL, "refrac");
823 RNA_def_property_range(prop, 1, 10);
824 RNA_def_property_ui_text(prop, "Specular IOR", "");
825 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
827 prop= RNA_def_property(srna, "specular_toon_size", PROP_FLOAT, PROP_NONE);
828 RNA_def_property_float_sdna(prop, NULL, "param[2]");
829 RNA_def_property_range(prop, 0.0f, 1.53f);
830 RNA_def_property_ui_text(prop, "Specular Toon Size", "Size of specular toon area.");
831 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
833 prop= RNA_def_property(srna, "specular_toon_smooth", PROP_FLOAT, PROP_NONE);
834 RNA_def_property_float_sdna(prop, NULL, "param[3]");
835 RNA_def_property_range(prop, 0.0f, 1.0f);
836 RNA_def_property_ui_text(prop, "Specular Toon Smooth", "Ssmoothness of specular toon area.");
837 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
839 prop= RNA_def_property(srna, "specular_slope", PROP_FLOAT, PROP_NONE);
840 RNA_def_property_float_sdna(prop, NULL, "rms");
841 RNA_def_property_range(prop, 0, 0.4);
842 RNA_def_property_ui_text(prop, "Specular Slope", "The standard deviation of surface slope.");
843 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
846 void rna_def_material_strand(BlenderRNA *brna)
851 srna= RNA_def_struct(brna, "MaterialStrand", NULL);
852 RNA_def_struct_sdna(srna, "Material");
853 RNA_def_struct_nested(brna, srna, "Material");
854 RNA_def_struct_ui_text(srna, "Material Strand", "Strand settings for a Material datablock.");
856 prop= RNA_def_property(srna, "tangent_shading", PROP_BOOLEAN, PROP_NONE);
857 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TANGENT_STR);
858 RNA_def_property_ui_text(prop, "Tangent Shading", "Uses direction of strands as normal for tangent-shading.");
859 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
861 prop= RNA_def_property(srna, "surface_diffuse", PROP_BOOLEAN, PROP_NONE);
862 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STR_SURFDIFF);
863 RNA_def_property_ui_text(prop, "Surface Diffuse", "Make diffuse shading more similar to shading the surface.");
864 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
866 prop= RNA_def_property(srna, "blend_distance", PROP_FLOAT, PROP_NONE);
867 RNA_def_property_float_sdna(prop, NULL, "strand_surfnor");
868 RNA_def_property_range(prop, 0, 10);
869 RNA_def_property_ui_text(prop, "Blend Distance", "Distance in Blender units over which to blend in the surface normal.");
870 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
872 prop= RNA_def_property(srna, "blender_units", PROP_BOOLEAN, PROP_NONE);
873 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_STR_B_UNITS);
874 RNA_def_property_ui_text(prop, "Blender Units", "Use Blender units for widths instead of pixels.");
875 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
877 prop= RNA_def_property(srna, "start_size", PROP_FLOAT, PROP_UNSIGNED);
878 RNA_def_property_float_sdna(prop, NULL, "strand_sta");
879 RNA_def_property_float_funcs(prop, NULL, NULL, "rna_MaterialStrand_start_size_range");
880 RNA_def_property_ui_text(prop, "Start Size", "Start size of strands in pixels Blender units.");
881 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
883 prop= RNA_def_property(srna, "end_size", PROP_FLOAT, PROP_UNSIGNED);
884 RNA_def_property_float_sdna(prop, NULL, "strand_end");
885 RNA_def_property_float_funcs(prop, NULL, NULL, "rna_MaterialStrand_end_size_range");
886 RNA_def_property_ui_text(prop, "End Size", "Start size of strands in pixels or Blender units.");
887 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
889 prop= RNA_def_property(srna, "min_size", PROP_FLOAT, PROP_UNSIGNED);
890 RNA_def_property_float_sdna(prop, NULL, "strand_min");
891 RNA_def_property_range(prop, 0.001, 10);
892 RNA_def_property_ui_text(prop, "Minimum Size", "Minimum size of strands in pixels.");
893 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
895 prop= RNA_def_property(srna, "shape", PROP_FLOAT, PROP_NONE);
896 RNA_def_property_float_sdna(prop, NULL, "strand_ease");
897 RNA_def_property_range(prop, -0.9, 0.9);
898 RNA_def_property_ui_text(prop, "Shape", "Positive values make strands rounder, negative makes strands spiky.");
899 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
901 prop= RNA_def_property(srna, "width_fade", PROP_FLOAT, PROP_NONE);
902 RNA_def_property_float_sdna(prop, NULL, "strand_widthfade");
903 RNA_def_property_range(prop, 0, 2);
904 RNA_def_property_ui_text(prop, "Width Fade", "Transparency along the width of the strand.");
905 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
907 prop= RNA_def_property(srna, "uv_layer", PROP_STRING, PROP_NONE);
908 RNA_def_property_string_sdna(prop, NULL, "strand_uvname");
909 RNA_def_property_ui_text(prop, "UV Layer", "Name of UV layer to override.");
910 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
913 void RNA_def_material(BlenderRNA *brna)
918 static EnumPropertyItem prop_type_items[] = {
919 {MA_TYPE_SURFACE, "SURFACE", 0, "Surface", "Render object as a surface."},
920 {MA_TYPE_VOLUME, "VOLUME", 0, "Volume", "Render object as a volume."},
921 {MA_TYPE_HALO, "HALO", 0, "Halo", "Render object as halo particles."},
922 {0, NULL, 0, NULL, NULL}};
924 srna= RNA_def_struct(brna, "Material", "ID");
925 RNA_def_struct_ui_text(srna, "Material", "Material datablock to defined the appearance of geometric objects for rendering.");
926 RNA_def_struct_ui_icon(srna, ICON_MATERIAL_DATA);
928 prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
929 RNA_def_property_enum_sdna(prop, NULL, "material_type");
930 RNA_def_property_enum_items(prop, prop_type_items);
931 RNA_def_property_ui_text(prop, "Type", "Material type defining how the object is rendered.");
932 RNA_def_property_enum_funcs(prop, NULL, "rna_Material_type_set", NULL);
933 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING_DRAW, NULL);
935 prop= RNA_def_property(srna, "ambient", PROP_FLOAT, PROP_NONE);
936 RNA_def_property_float_sdna(prop, NULL, "amb");
937 RNA_def_property_range(prop, 0, 1);
938 RNA_def_property_ui_text(prop, "Ambient", "Amount of global ambient color the material receives.");
939 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
941 prop= RNA_def_property(srna, "emit", PROP_FLOAT, PROP_NONE);
942 RNA_def_property_range(prop, 0, 2);
943 RNA_def_property_ui_text(prop, "Emit", "Amount of light to emit.");
944 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
946 prop= RNA_def_property(srna, "translucency", PROP_FLOAT, PROP_NONE);
947 RNA_def_property_range(prop, 0, 1);
948 RNA_def_property_ui_text(prop, "Translucency", "Amount of diffuse shading on the back side.");
949 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
951 prop= RNA_def_property(srna, "cubic", PROP_BOOLEAN, PROP_NONE);
952 RNA_def_property_boolean_sdna(prop, NULL, "shade_flag", MA_CUBIC);
953 RNA_def_property_ui_text(prop, "Cubic Interpolation", "Use cubic interpolation for diffuse values, for smoother transitions.");
954 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
956 prop= RNA_def_property(srna, "object_color", PROP_BOOLEAN, PROP_NONE);
957 RNA_def_property_boolean_sdna(prop, NULL, "shade_flag", MA_OBCOLOR);
958 RNA_def_property_ui_text(prop, "Object Color", "Modulate the result with a per-object color.");
959 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
961 prop= RNA_def_property(srna, "shadow_ray_bias", PROP_FLOAT, PROP_NONE);
962 RNA_def_property_float_sdna(prop, NULL, "sbias");
963 RNA_def_property_range(prop, 0, 0.25);
964 RNA_def_property_ui_text(prop, "Shadow Ray Bias", "Shadow raytracing bias to prevent terminator problems on shadow boundary.");
966 prop= RNA_def_property(srna, "shadow_buffer_bias", PROP_FLOAT, PROP_NONE);
967 RNA_def_property_float_sdna(prop, NULL, "lbias");
968 RNA_def_property_range(prop, 0, 10);
969 RNA_def_property_ui_text(prop, "Shadow Buffer Bias", "Factor to multiply shadow buffer bias with (0 is ignore.)");
971 prop= RNA_def_property(srna, "shadow_casting_alpha", PROP_FLOAT, PROP_NONE);
972 RNA_def_property_float_sdna(prop, NULL, "shad_alpha");
973 RNA_def_property_range(prop, 0.001, 1);
974 RNA_def_property_ui_text(prop, "Shadow Casting Alpha", "Shadow casting alpha, only in use for Irregular Shadowbuffer.");
975 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
977 prop= RNA_def_property(srna, "light_group", PROP_POINTER, PROP_NONE);
978 RNA_def_property_pointer_sdna(prop, NULL, "group");
979 RNA_def_property_struct_type(prop, "Group");
980 RNA_def_property_flag(prop, PROP_EDITABLE);
981 RNA_def_property_ui_text(prop, "Light Group", "Limit lighting to lamps in this Group.");
982 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
986 prop= RNA_def_property(srna, "light_group_exclusive", PROP_BOOLEAN, PROP_NONE);
987 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_GROUP_NOLAY);
988 RNA_def_property_ui_text(prop, "Light Group Exclusive", "Material uses the light group exclusively - these lamps are excluded from other scene lighting.");
989 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
991 prop= RNA_def_property(srna, "traceable", PROP_BOOLEAN, PROP_NONE);
992 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TRACEBLE);
993 RNA_def_property_ui_text(prop, "Traceable", "Include this material and geometry that uses it in ray tracing calculations.");
994 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
996 prop= RNA_def_property(srna, "shadows", PROP_BOOLEAN, PROP_NONE);
997 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADOW);
998 RNA_def_property_ui_text(prop, "Shadows", "Allows this material to receive shadows.");
999 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1001 prop= RNA_def_property(srna, "shadeless", PROP_BOOLEAN, PROP_NONE);
1002 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHLESS);
1003 RNA_def_property_ui_text(prop, "Shadeless", "Makes this material insensitive to light or shadow.");
1004 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1006 prop= RNA_def_property(srna, "wireframe", PROP_BOOLEAN, PROP_NONE);
1007 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_WIRE);
1008 RNA_def_property_ui_text(prop, "Wireframe", "Render the edges of faces as wires (not supported in ray tracing).");
1009 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1011 prop= RNA_def_property(srna, "vertex_color_light", PROP_BOOLEAN, PROP_NONE);
1012 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_VERTEXCOL);
1013 RNA_def_property_ui_text(prop, "Vertex Color Light", "Add vertex colors as additional lighting.");
1014 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1016 prop= RNA_def_property(srna, "vertex_color_paint", PROP_BOOLEAN, PROP_NONE);
1017 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_VERTEXCOLP);
1018 RNA_def_property_ui_text(prop, "Vertex Color Paint", "Replaces object base color with vertex colors (multiplies with 'texture face' face assigned textures).");
1019 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1021 prop= RNA_def_property(srna, "invert_z", PROP_BOOLEAN, PROP_NONE);
1022 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ZINV);
1023 RNA_def_property_ui_text(prop, "Invert Z Depth", "Renders material's faces with an inverted Z buffer (scanline only).");
1024 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1026 prop= RNA_def_property(srna, "sky", PROP_BOOLEAN, PROP_NONE);
1027 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ENV);
1028 RNA_def_property_ui_text(prop, "Sky", "Renders this material with zero alpha, with sky background in place (scanline only).");
1029 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1031 prop= RNA_def_property(srna, "only_shadow", PROP_BOOLEAN, PROP_NONE);
1032 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ONLYSHADOW);
1033 RNA_def_property_ui_text(prop, "Only Shadow", "Renders shadows as the material's alpha value, making materials transparent except for shadowed areas.");
1034 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1036 prop= RNA_def_property(srna, "face_texture", PROP_BOOLEAN, PROP_NONE);
1037 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FACETEXTURE);
1038 RNA_def_property_ui_text(prop, "Face Textures", "Replaces the object's base color with color from face assigned image textures");
1039 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1041 prop= RNA_def_property(srna, "face_texture_alpha", PROP_BOOLEAN, PROP_NONE);
1042 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FACETEXTURE_ALPHA);
1043 RNA_def_property_ui_text(prop, "Face Textures Alpha", "Replaces the object's base alpha value with alpha from face assigned image textures");
1044 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1046 prop= RNA_def_property(srna, "cast_shadows_only", PROP_BOOLEAN, PROP_NONE);
1047 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_ONLYCAST);
1048 RNA_def_property_ui_text(prop, "Cast Shadows Only", "Makes objects with this material appear invisible, only casting shadows (not rendered).");
1049 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1051 prop= RNA_def_property(srna, "exclude_mist", PROP_BOOLEAN, PROP_NONE);
1052 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_NOMIST);
1053 RNA_def_property_ui_text(prop, "Exclude Mist", "Excludes this material from mist effects (in world settings)");
1054 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1056 prop= RNA_def_property(srna, "radiosity", PROP_BOOLEAN, PROP_NONE);
1057 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RADIO);
1058 RNA_def_property_ui_text(prop, "Radiosity", "Include this material in radiosity calculations");
1059 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1061 prop= RNA_def_property(srna, "transparent_shadows", PROP_BOOLEAN, PROP_NONE);
1062 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADOW_TRA);
1063 RNA_def_property_ui_text(prop, "Transparent Shadows", "Allow this object to receive transparent shadows casted through other objects");
1064 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1066 prop= RNA_def_property(srna, "ray_shadow_bias", PROP_BOOLEAN, PROP_NONE);
1067 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYBIAS);
1068 RNA_def_property_ui_text(prop, "Ray Shadow Bias", "Prevents raytraced shadow errors on surfaces with smooth shaded normals (terminator problem)");
1069 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1071 prop= RNA_def_property(srna, "full_oversampling", PROP_BOOLEAN, PROP_NONE);
1072 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_FULL_OSA);
1073 RNA_def_property_ui_text(prop, "Full Oversampling", "Force this material to render full shading/textures for all anti-aliasing samples");
1074 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1076 prop= RNA_def_property(srna, "cast_buffer_shadows", PROP_BOOLEAN, PROP_NONE);
1077 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_SHADBUF);
1078 RNA_def_property_ui_text(prop, "Cast Buffer Shadows", "Allow this material to cast shadows from shadow buffer lamps");
1079 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1081 prop= RNA_def_property(srna, "tangent_shading", PROP_BOOLEAN, PROP_NONE);
1082 RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_TANGENT_V);
1083 RNA_def_property_ui_text(prop, "Tangent Shading", "Use the material's tangent vector instead of the normal for shading - for anisotropic shading effects");
1084 RNA_def_property_update(prop, NC_MATERIAL|ND_SHADING, NULL);
1086 /* nested structs */
1087 prop= RNA_def_property(srna, "raytrace_mirror", PROP_POINTER, PROP_NEVER_NULL);
1088 RNA_def_property_struct_type(prop, "MaterialRaytraceMirror");
1089 RNA_def_property_pointer_funcs(prop, "rna_Material_mirror_get", NULL, NULL);
1090 RNA_def_property_ui_text(prop, "Raytrace Mirror", "Raytraced reflection settings for the material.");
1092 prop= RNA_def_property(srna, "raytrace_transparency", PROP_POINTER, PROP_NEVER_NULL);
1093 RNA_def_property_struct_type(prop, "MaterialRaytraceTransparency");
1094 RNA_def_property_pointer_funcs(prop, "rna_Material_transp_get", NULL, NULL);
1095 RNA_def_property_ui_text(prop, "Raytrace Transparency", "Raytraced reflection settings for the material.");
1097 prop= RNA_def_property(srna, "halo", PROP_POINTER, PROP_NEVER_NULL);
1098 RNA_def_property_struct_type(prop, "MaterialHalo");
1099 RNA_def_property_pointer_funcs(prop, "rna_Material_halo_get", NULL, NULL);
1100 RNA_def_property_ui_text(prop, "Halo", "Halo settings for the material.");
1102 prop= RNA_def_property(srna, "subsurface_scattering", PROP_POINTER, PROP_NEVER_NULL);
1103 RNA_def_property_struct_type(prop, "MaterialSubsurfaceScattering");
1104 RNA_def_property_pointer_funcs(prop, "rna_Material_sss_get", NULL, NULL);
1105 RNA_def_property_ui_text(prop, "Subsurface Scattering", "Subsurface scattering settings for the material.");
1107 prop= RNA_def_property(srna, "strand", PROP_POINTER, PROP_NEVER_NULL);
1108 RNA_def_property_struct_type(prop, "MaterialStrand");
1109 RNA_def_property_pointer_funcs(prop, "rna_Material_strand_get", NULL, NULL);
1110 RNA_def_property_ui_text(prop, "Strand", "Strand settings for the material.");
1113 prop= RNA_def_property(srna, "node_tree", PROP_POINTER, PROP_NONE);
1114 RNA_def_property_pointer_sdna(prop, NULL, "nodetree");
1115 RNA_def_property_ui_text(prop, "Node Tree", "Node tree for node based materials.");
1118 rna_def_animdata_common(srna);
1119 rna_def_mtex_common(srna, "rna_Material_mtex_begin", "rna_Material_active_texture_get", "MaterialTextureSlot");
1121 prop= RNA_def_property(srna, "script_link", PROP_POINTER, PROP_NEVER_NULL);
1122 RNA_def_property_pointer_sdna(prop, NULL, "scriptlink");
1123 RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1124 RNA_def_property_ui_text(prop, "Script Link", "Scripts linked to this material.");
1126 rna_def_material_colors(srna);
1127 rna_def_material_diffuse(srna);
1128 rna_def_material_specularity(srna);
1130 /* nested structs */
1131 rna_def_material_raymirror(brna);
1132 rna_def_material_raytra(brna);
1133 rna_def_material_halo(brna);
1134 rna_def_material_sss(brna);
1135 rna_def_material_mtex(brna);
1136 rna_def_material_strand(brna);
1139 void rna_def_mtex_common(StructRNA *srna, const char *begin, const char *activeget, const char *structname)
1144 prop= RNA_def_property(srna, "textures", PROP_COLLECTION, PROP_NONE);
1145 RNA_def_property_struct_type(prop, structname);
1146 RNA_def_property_collection_funcs(prop, begin, "rna_iterator_array_next", "rna_iterator_array_end", "rna_iterator_array_dereference_get", 0, 0, 0, 0, 0);
1147 RNA_def_property_ui_text(prop, "Textures", "Texture slots defining the mapping and influence of textures.");
1149 prop= RNA_def_property(srna, "active_texture", PROP_POINTER, PROP_NONE);
1150 RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1151 RNA_def_property_struct_type(prop, structname);
1152 RNA_def_property_pointer_funcs(prop, activeget, NULL, NULL);
1153 RNA_def_property_ui_text(prop, "Active Texture", "Active texture slot being displayed.");
1155 prop= RNA_def_property(srna, "active_texture_index", PROP_INT, PROP_UNSIGNED);
1156 RNA_def_property_int_sdna(prop, NULL, "texact");
1157 RNA_def_property_range(prop, 0, MAX_MTEX-1);
1158 RNA_def_property_ui_text(prop, "Active Texture Index", "Index of active texture slot.");