2.5 / RNA: Material
[blender-staging.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 <stdlib.h>
26
27 #include "RNA_define.h"
28 #include "RNA_types.h"
29
30 #include "rna_internal.h"
31
32 #include "DNA_material_types.h"
33
34 #ifdef RNA_RUNTIME
35
36 #else
37
38 void RNA_def_material(BlenderRNA *brna)
39 {
40         StructRNA *srna;
41         PropertyRNA *prop;
42         
43         static EnumPropertyItem prop_type_items[] = {
44                 {MA_RGB, "RGB", "RGB", ""},
45                 /* not used in blender yet
46                 {MA_CMYK, "CMYK", "CMYK", ""}, 
47                 {MA_YUV, "YUV", "YUV", ""}, */
48                 {MA_HSV, "HSV", "HSV", ""},
49                 {0, NULL, NULL, NULL}};
50         static EnumPropertyItem prop_fadeto_mir_items[] = {
51                 {MA_RAYMIR_FADETOSKY, "RAYMIR_FADETOSKY", "Fade to sky color", ""},
52                 {MA_RAYMIR_FADETOMAT, "RAYMIR_FADETOMAT", "Fade to material color", ""},
53                 {0, NULL, NULL, NULL}};
54         static EnumPropertyItem prop_diff_shader_items[] = {
55                 {MA_DIFF_LAMBERT, "DIFF_LAMBERT", "Lambert", ""},
56                 {MA_DIFF_ORENNAYAR, "DIFF_ORENNAYAR", "Oren-Nayar", ""},
57                 {MA_DIFF_TOON, "DIFF_TOON", "Toon", ""},
58                 {MA_DIFF_MINNAERT, "DIFF_MINNAERT", "Minnaert", ""},
59                 {MA_DIFF_FRESNEL, "DIFF_FRESNEL", "Fresnel", ""},
60                 {0, NULL, NULL, NULL}};
61         
62         
63         srna= RNA_def_struct(brna, "Material", "ID");
64         RNA_def_struct_ui_text(srna, "Material", "DOC_BROKEN");
65                 
66         prop= RNA_def_property(srna, "color_model", PROP_ENUM, PROP_NONE);
67         RNA_def_property_enum_sdna(prop, NULL, "colormodel");
68         RNA_def_property_enum_items(prop, prop_type_items);
69         RNA_def_property_ui_text(prop, "Color Model", "");
70         
71         /* colors */
72         prop= RNA_def_property(srna, "diffuse_color", PROP_FLOAT, PROP_COLOR);
73         RNA_def_property_float_sdna(prop, NULL, "r");
74         RNA_def_property_array(prop, 3);
75         RNA_def_property_ui_text(prop, "Diffuse Color", "");
76         RNA_def_property_ui_range(prop, 0.0f , 1.0f, 10.0f, 3.0f);
77         
78         prop= RNA_def_property(srna, "specular_color", PROP_FLOAT, PROP_COLOR);
79         RNA_def_property_float_sdna(prop, NULL, "specr");
80         RNA_def_property_array(prop, 3);
81         RNA_def_property_ui_text(prop, "Specular Color", "");
82         RNA_def_property_ui_range(prop, 0.0f , 1.0f, 10.0f, 3.0f);
83         
84         prop= RNA_def_property(srna, "mirror_color", PROP_FLOAT, PROP_COLOR);
85         RNA_def_property_float_sdna(prop, NULL, "mirr");
86         RNA_def_property_array(prop, 3);
87         RNA_def_property_ui_text(prop, "Mirror Color", "");
88         RNA_def_property_ui_range(prop, 0.0f , 1.0f, 10.0f, 3.0f);
89                 
90         prop= RNA_def_property(srna, "ambient_color", PROP_FLOAT, PROP_COLOR);
91         RNA_def_property_float_sdna(prop, NULL, "ambr");
92         RNA_def_property_array(prop, 3);
93         RNA_def_property_ui_text(prop, "Ambient Color", "");
94         RNA_def_property_ui_range(prop, 0.0f , 1.0f, 10.0f, 3.0f);
95         
96         prop= RNA_def_property(srna, "alpha", PROP_FLOAT, PROP_NONE);
97         RNA_def_property_range(prop, 0.0f, 1.0f);
98         RNA_def_property_ui_text(prop, "Alpha", "");
99         
100         /* diffuse shaders */
101         
102         prop= RNA_def_property(srna, "diffuse_shader", PROP_ENUM, PROP_NONE);
103         RNA_def_property_enum_sdna(prop, NULL, "diff_shader");
104         RNA_def_property_enum_items(prop, prop_diff_shader_items);
105         RNA_def_property_ui_text(prop, "Diffuse Shader Model", "");
106         
107         prop= RNA_def_property(srna, "diffuse_reflection", PROP_FLOAT, PROP_NONE);
108         RNA_def_property_float_sdna(prop, NULL, "ref");
109         RNA_def_property_range(prop, 0.0f, 1.0f);
110         RNA_def_property_ui_text(prop, "Diffuse Reflection", "Amount of diffuse reflection.");
111         
112         prop= RNA_def_property(srna, "roughness", PROP_FLOAT, PROP_NONE);
113         RNA_def_property_range(prop, 0.0f, 3.14f);
114         RNA_def_property_ui_text(prop, "Roughness", "Oren-Nayar Roughness");
115         
116         prop= RNA_def_property(srna, "params1_4", PROP_FLOAT, PROP_NONE);
117         RNA_def_property_float_sdna(prop, NULL, "param");
118         RNA_def_property_array(prop, 4);
119         RNA_def_property_range(prop, 0.0f, 5.0f);
120         RNA_def_property_ui_text(prop, "Params 1-4", "Parameters used for diffuse and specular Toon, and diffuse Fresnel shaders. Check documentation for details.");
121         
122         prop= RNA_def_property(srna, "darkness", PROP_FLOAT, PROP_NONE);
123         RNA_def_property_range(prop, 0.0f, 2.0f);
124         RNA_def_property_ui_text(prop, "Darkness", "Minnaert darkness.");
125         
126         /* raytrace mirror */
127         prop= RNA_def_property(srna, "mode_ray_mirror", PROP_BOOLEAN, PROP_NONE);
128         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYMIRROR); /* use bitflags */
129         RNA_def_property_ui_text(prop, "Ray Mirror Mode", "Toggle raytrace mirror.");
130         
131         prop= RNA_def_property(srna, "ray_mirror", PROP_FLOAT, PROP_NONE);
132         RNA_def_property_range(prop, 0.0f, 1.0f);
133         RNA_def_property_ui_text(prop, "Ray Mirror", "Sets the amount mirror reflection for raytrace.");
134         
135         prop= RNA_def_property(srna, "ray_mirror_fresnel", PROP_FLOAT, PROP_NONE);
136         RNA_def_property_float_sdna(prop, NULL, "fresnel_mir");
137         RNA_def_property_range(prop, 0.0f, 5.0f);
138         RNA_def_property_ui_text(prop, "Ray Mirror Fresnel", "Power of Fresnel for mirror reflection.");
139         
140         prop= RNA_def_property(srna, "ray_mirror_fresnel_fac", PROP_FLOAT, PROP_NONE);
141         RNA_def_property_float_sdna(prop, NULL, "fresnel_mir_i");
142         RNA_def_property_range(prop, 0.0f, 1.0f);
143         RNA_def_property_ui_text(prop, "Ray Mirror Fresnel Factor", "Blending factor for Fresnel.");
144         
145         prop= RNA_def_property(srna, "ray_mirror_gloss", PROP_FLOAT, PROP_NONE);
146         RNA_def_property_float_sdna(prop, NULL, "gloss_mir");
147         RNA_def_property_range(prop, 0.0f, 1.0f);
148         RNA_def_property_ui_text(prop, "Ray Mirror Gloss", "The shininess of the reflection. Values < 1.0 give diffuse, blurry reflections.");
149         
150         prop= RNA_def_property(srna, "ray_mirror_gloss_aniso", PROP_FLOAT, PROP_NONE);
151         RNA_def_property_float_sdna(prop, NULL, "aniso_gloss_mir");
152         RNA_def_property_range(prop, 0.0f, 1.0f);
153         RNA_def_property_ui_text(prop, "Ray Mirror Gloss Aniso", "The shape of the reflection, from 0.0 (circular) to 1.0 (fully stretched along the tangent.");
154                 
155         prop= RNA_def_property(srna, "ray_mirror_gloss_samples", PROP_FLOAT, PROP_NONE);
156         RNA_def_property_float_sdna(prop, NULL, "samp_gloss_mir");
157         RNA_def_property_range(prop, 0.0f, 1024.0f);
158         RNA_def_property_ui_text(prop, "Ray Mirror Gloss Samples", "Number of cone samples averaged for blurry reflections.");
159         
160         prop= RNA_def_property(srna, "ray_mirror_adapt_thresh", PROP_FLOAT, PROP_NONE);
161         RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_mir");
162         RNA_def_property_range(prop, 0.0f, 1.0f);
163         RNA_def_property_ui_text(prop, "Ray Mirror Gloss Threshold", "Threshold for adaptive sampling. If a sample contributes less than this amount (as a percentage), sampling is stopped.");
164         
165         prop= RNA_def_property(srna, "ray_mirror_depth", PROP_FLOAT, PROP_NONE);
166         RNA_def_property_float_sdna(prop, NULL, "ray_depth");
167         RNA_def_property_range(prop, 0.0f, 10.0f);
168         RNA_def_property_ui_text(prop, "Ray Mirror Depth", "Maximum allowed number of light inter-reflections.");
169         
170         prop= RNA_def_property(srna, "ray_mirror_distance", PROP_FLOAT, PROP_NONE);
171         RNA_def_property_float_sdna(prop, NULL, "dist_mir");
172         RNA_def_property_range(prop, 0.0f, 10000.0f);
173         RNA_def_property_ui_text(prop, "Ray Mirror Max Dist", "Maximum distance of reflected rays. Reflections further than this range fade to sky color or material color.");
174         
175         prop= RNA_def_property(srna, "ray_mirror_fadeto", PROP_ENUM, PROP_NONE);
176         RNA_def_property_enum_sdna(prop, NULL, "fadeto_mir");
177         RNA_def_property_enum_items(prop, prop_fadeto_mir_items);
178         RNA_def_property_ui_text(prop, "Ray Mirror End Fade-out", "The color that rays with no intersection within the Max Distance take. Material color can be best for indoor scenes, sky color for outdoor.");
179         
180         /* raytrace transparency */
181         
182         prop= RNA_def_property(srna, "mode_ray_transparency", PROP_BOOLEAN, PROP_NONE);
183         RNA_def_property_boolean_sdna(prop, NULL, "mode", MA_RAYTRANSP); /* use bitflags */
184         RNA_def_property_ui_text(prop, "Ray Transparency Mode", "Enables raytracing for transparent refraction rendering.");
185         
186         prop= RNA_def_property(srna, "ray_transparency_ior", PROP_FLOAT, PROP_NONE);
187         RNA_def_property_float_sdna(prop, NULL, "ang");
188         RNA_def_property_range(prop, 1.0f, 3.0f);
189         RNA_def_property_ui_text(prop, "Ray Transparency IOR", "Sets angular index of refraction for raytraced refraction.");
190         
191         prop= RNA_def_property(srna, "ray_transparency_fresnel", PROP_FLOAT, PROP_NONE);
192         RNA_def_property_float_sdna(prop, NULL, "fresnel_tra");
193         RNA_def_property_range(prop, 0.0f, 5.0f);
194         RNA_def_property_ui_text(prop, "Ray Transparency Fresnel", "Power of Fresnel for transparency (Ray or ZTransp).");
195         
196         prop= RNA_def_property(srna, "ray_transparency_fresnel_fac", PROP_FLOAT, PROP_NONE);
197         RNA_def_property_float_sdna(prop, NULL, "fresnel_tra_i");
198         RNA_def_property_range(prop, 1.0f, 5.0f);
199         RNA_def_property_ui_text(prop, "Ray Transparency Fresnel Factor", "Blending factor for Fresnel.");
200         
201         prop= RNA_def_property(srna, "ray_transparency_gloss", PROP_FLOAT, PROP_NONE);
202         RNA_def_property_float_sdna(prop, NULL, "gloss_tra");
203         RNA_def_property_range(prop, 0.0f, 1.0f);
204         RNA_def_property_ui_text(prop, "Ray Transparency Gloss", "The clarity of the refraction. Values < 1.0 give diffuse, blurry refractions.");
205         
206         prop= RNA_def_property(srna, "ray_transparency_gloss_samples", PROP_FLOAT, PROP_NONE);
207         RNA_def_property_float_sdna(prop, NULL, "samp_gloss_tra");
208         RNA_def_property_range(prop, 0.0f, 1024.0f);
209         RNA_def_property_ui_text(prop, "Ray Transparency Gloss Samples", "Number of cone samples averaged for blurry refractions.");
210         
211         prop= RNA_def_property(srna, "ray_transparency_adapt_thresh", PROP_FLOAT, PROP_NONE);
212         RNA_def_property_float_sdna(prop, NULL, "adapt_thresh_tra");
213         RNA_def_property_range(prop, 0.0f, 1.0f);
214         RNA_def_property_ui_text(prop, "Ray Transparency Gloss Threshold", "Threshold for adaptive sampling. If a sample contributes less than this amount (as a percentage), sampling is stopped.");
215         
216         prop= RNA_def_property(srna, "ray_transparency_depth", PROP_FLOAT, PROP_NONE);
217         RNA_def_property_float_sdna(prop, NULL, "ray_depth_tra");
218         RNA_def_property_range(prop, 0.0f, 10.0f);
219         RNA_def_property_ui_text(prop, "Ray Transparency Depth", "Maximum allowed number of light inter-refractions.");
220         
221         prop= RNA_def_property(srna, "ray_transparency_filter", PROP_FLOAT, PROP_NONE);
222         RNA_def_property_float_sdna(prop, NULL, "filter");
223         RNA_def_property_range(prop, 0.0f, 1.0f);
224         RNA_def_property_ui_text(prop, "Ray Transparency Filter", "Amount to blend in the material's diffuse color in raytraced transparency (simulating absorption).");
225         
226         prop= RNA_def_property(srna, "ray_transparency_limit", PROP_FLOAT, PROP_NONE);
227         RNA_def_property_float_sdna(prop, NULL, "tx_limit");
228         RNA_def_property_range(prop, 0.0f, 100.0f);
229         RNA_def_property_ui_text(prop, "Ray Transparency Limit", "Maximum depth for light to travel through the transparent material before becoming fully filtered (0.0 is disabled).");
230         
231         prop= RNA_def_property(srna, "ray_transparency_falloff", PROP_FLOAT, PROP_NONE);
232         RNA_def_property_float_sdna(prop, NULL, "tx_falloff");
233         RNA_def_property_range(prop, 0.1f, 10.0f);
234         RNA_def_property_ui_text(prop, "Ray Transparency Falloff", "Falloff power for transmissivity filter effect (1.0 is linear).");
235         
236         prop= RNA_def_property(srna, "ray_transparency_specular_opacity", PROP_FLOAT, PROP_NONE);
237         RNA_def_property_float_sdna(prop, NULL, "spectra");
238         RNA_def_property_range(prop, 0.0f, 1.0f);
239         RNA_def_property_ui_text(prop, "Ray Transparency Specular Opacity", "Makes specular areas opaque on transparent materials.");
240         
241         /* nodetree */
242         prop= RNA_def_property(srna, "nodetree", PROP_POINTER, PROP_NONE);
243         RNA_def_property_ui_text(prop, "Node Tree", "");
244 }
245
246 #endif
247
248