2.50: svn merge https://svn.blender.org/svnroot/bf-blender/trunk/blender -r17434...
[blender.git] / source / blender / makesrna / intern / rna_lamp.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).
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_lamp_types.h"
33
34 #ifdef RNA_RUNTIME
35
36 static void rna_Lamp_buffer_size_set(PointerRNA *ptr, int value)
37 {
38         Lamp *la= (Lamp*)ptr->data;
39
40         CLAMP(value, 512, 10240);
41         la->bufsize= value;
42         la->bufsize &= (~15); /* round to multiple of 16 */
43 }
44
45
46 #else
47
48 void RNA_def_lamp(BlenderRNA *brna)
49 {
50         StructRNA *srna;
51         PropertyRNA *prop;
52         static EnumPropertyItem prop_type_items[] = {
53                 {LA_LOCAL, "LOCAL", "Local", ""},
54                 {LA_SUN, "SUN", "Sun", ""},
55                 {LA_SPOT, "SPOT", "Spot", ""},
56                 {LA_HEMI, "HEMI", "Hemi", ""},
57                 {LA_AREA, "AREA", "Area", ""},
58                 {0, NULL, NULL, NULL}};
59         static EnumPropertyItem prop_shadow_items[] = {
60                 {0, "NOSHADOW", "No Shadow", ""},
61                 {LA_SHAD_BUF, "BUFSHADOW", "Buffer Shadow", "Lets spotlight produce shadows using shadow buffer."},
62                 {LA_SHAD_RAY, "RAYSHADOW", "Ray Shadow", "Use ray tracing for shadow."},
63                 {0, NULL, NULL, NULL}};
64         static EnumPropertyItem prop_raysampmethod_items[] = {
65                 {LA_SAMP_CONSTANT, "CONSTANT", "Constant", ""},
66                 {LA_SAMP_HALTON, "HALTON", "Halton", ""},
67                 {LA_SHAD_RAY, "LA_SAMP_HAMMERSLEY", "Hammersley", ""},
68                 {0, NULL, NULL, NULL}};
69         static EnumPropertyItem prop_areashape_items[] = {
70                 {LA_AREA_SQUARE, "SQUARE", "Square", ""},
71                 {LA_AREA_RECT, "RECTANGLE", "Rectangle", ""},
72                 {0, NULL, NULL, NULL}};
73         static EnumPropertyItem prop_shadbuftype_items[] = {
74                 {LA_SHADBUF_REGULAR     , "REGULAR", "Classical", "Use the Classic Buffer type"},
75                 {LA_SHADBUF_IRREGULAR, "IRREGULAR", "Irregular", "Use the Irregular Shadow Buffer type."},
76                 {LA_SHADBUF_HALFWAY, "HALFWAY", "Classic-Halfway", "Use the Classic-Halfway Buffer type."},
77                 {0, NULL, NULL, NULL}};
78         static EnumPropertyItem prop_shadbuffiltertype_items[] = {
79                 {LA_SHADBUF_BOX , "BOX", "Box", "Use the Box filter"},
80                 {LA_SHADBUF_TENT, "TENT", "Tent", "Use the Tent Filter."},
81                 {LA_SHADBUF_GAUSS, "GAUSS", "Gauss", "Use the Gauss filter."},
82                 {0, NULL, NULL, NULL}};
83         static EnumPropertyItem prop_numbuffer_items[] = {
84                 {1, "1BUFF", "1", "Sample 1 Shadow Buffer."},
85                 {4, "4BUFF", "4", "Sample 4 Shadow Buffers."},
86                 {9, "9BUFF", "9", "Sample 9 Shadow Buffers."},
87                 {0, NULL, NULL, NULL}};
88         static EnumPropertyItem prop_skycolorspace_items[] = {
89                 {0, "SMPTE", "SMPTE", ""},
90                 {1, "REC709", "REC709", ""},
91                 {2, "CIE", "CIE", ""},
92                 {0, NULL, NULL, NULL}};
93         static EnumPropertyItem prop_blendmode_items[] = {
94                 {0, "MIX", "Mix", ""},
95                 {1, "ADD", "Add", ""},
96                 {2, "MULTIPLY", "Multiply", ""},
97                 {3, "SUBTRACT", "Subtract", ""},
98                 {4, "SCREEN", "Screen", ""},
99                 {5, "DIVIDE", "Divide", ""},
100                 {6, "DIFFERENCE", "Difference", ""},
101                 {7, "DARKEN", "Darken", ""},
102                 {8, "LIGHTEN", "Lighten", ""},
103                 {9, "OVERLAY", "Overlay", ""},
104                 {10, "DODGE", "Dodge", ""},
105                 {11, "BURN", "Burn", ""},
106                 {12, "HUE", "Hue", ""},
107                 {13, "SATURATION", "Saturation", ""},
108                 {14, "VALUE", "Value", ""},
109                 {15, "COLOR", "Color", ""},
110                 {0, NULL, NULL, NULL}};
111         static EnumPropertyItem prop_fallofftype_items[] = {
112                 {LA_FALLOFF_CONSTANT, "CONSTANT", "Constant", ""},
113                 {LA_FALLOFF_INVLINEAR, "INVLINEAR", "Inverse Linear", ""},
114                 {LA_FALLOFF_INVSQUARE, "INVSQUARE", "Inverse Square", ""},
115                 {LA_FALLOFF_CURVE, "CURVE", "Custom Curve", ""},
116                 {LA_FALLOFF_SLIDERS, "SLIDERS", "Lin/Quad Weighted", ""},
117                 {0, NULL, NULL, NULL}};
118
119         srna= RNA_def_struct(brna, "Lamp", "ID", "Lamp");
120
121         /* Enums */
122         prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
123         RNA_def_property_enum_items(prop, prop_type_items);
124         RNA_def_property_ui_text(prop, "Type", "Type of Lamp.");
125
126         prop= RNA_def_property(srna, "sky_colorspace", PROP_ENUM, PROP_NONE);
127         RNA_def_property_enum_items(prop, prop_skycolorspace_items);
128         RNA_def_property_ui_text(prop, "Sky Color Space", "");
129
130         prop= RNA_def_property(srna, "sky_blend_type", PROP_ENUM, PROP_NONE);
131         RNA_def_property_enum_sdna(prop, NULL, "skyblendtype");
132         RNA_def_property_enum_items(prop, prop_blendmode_items);
133         RNA_def_property_ui_text(prop, "Sky Blend Type", "Blend type for how sky is combined with world sky");
134
135         prop= RNA_def_property(srna, "area_shape", PROP_ENUM, PROP_NONE);
136         RNA_def_property_enum_items(prop, prop_areashape_items);
137         RNA_def_property_ui_text(prop, "Area Shape", "Shape of the Area lamp");
138
139         prop= RNA_def_property(srna, "ray_samp_method", PROP_ENUM, PROP_NONE);
140         RNA_def_property_enum_items(prop, prop_raysampmethod_items);
141         RNA_def_property_ui_text(prop, "Ray Sample Method", "The Method in how rays are sampled");
142
143         prop= RNA_def_property(srna, "buffer_type", PROP_ENUM, PROP_NONE);
144         RNA_def_property_enum_sdna(prop, NULL, "buftype");
145         RNA_def_property_enum_items(prop, prop_shadbuftype_items);
146         RNA_def_property_ui_text(prop, "Buffer Type", "Type of Shadow Buffer.");
147
148         prop= RNA_def_property(srna, "filter_type", PROP_ENUM, PROP_NONE);
149         RNA_def_property_enum_sdna(prop, NULL, "filtertype");
150         RNA_def_property_enum_items(prop, prop_shadbuffiltertype_items);
151         RNA_def_property_ui_text(prop, "Filter Type", "Type of Shadow Buffer Filter.");
152
153         prop= RNA_def_property(srna, "buffers", PROP_ENUM, PROP_NONE);
154         RNA_def_property_enum_items(prop, prop_numbuffer_items);
155         RNA_def_property_ui_text(prop, "Sample Buffers", "Number of Buffers to sample.");
156
157         prop= RNA_def_property(srna, "falloff_type", PROP_ENUM, PROP_NONE);
158         RNA_def_property_flag(prop, PROP_NOT_EDITABLE); /* needs to be able to create curve mapping */
159         RNA_def_property_enum_items(prop, prop_fallofftype_items);
160         RNA_def_property_ui_text(prop, "Falloff Type", "Intensity Decay with distance.");
161
162         prop= RNA_def_property(srna, "falloff_curve", PROP_POINTER, PROP_NONE);
163         RNA_def_property_pointer_sdna(prop, NULL, "curfalloff");
164         RNA_def_property_ui_text(prop, "Falloff Curve", "Custom Lamp Falloff Curve");
165
166         /* Number values */
167         prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
168         RNA_def_property_float_sdna(prop, NULL, "dist");
169         RNA_def_property_range(prop, 0.0f, 9999.0f);
170         RNA_def_property_ui_text(prop, "Distance", "Distance that the lamp emits light.");
171
172         prop= RNA_def_property(srna, "linear_attenuation", PROP_FLOAT, PROP_NONE);
173         RNA_def_property_float_sdna(prop, NULL, "att1");
174         RNA_def_property_range(prop, 0.0f, 1.0f);
175         RNA_def_property_ui_text(prop, "Linear Attenuation", "Linear distance attentuation.");
176
177         prop= RNA_def_property(srna, "quadratic_attenuation", PROP_FLOAT, PROP_NONE);
178         RNA_def_property_float_sdna(prop, NULL, "att2");
179         RNA_def_property_range(prop, 0.0f, 1.0f);
180         RNA_def_property_ui_text(prop, "Quadratic Attenuation", "Quadratic distance attentuation.");
181
182         prop= RNA_def_property(srna, "spot_blend", PROP_FLOAT, PROP_NONE);
183         RNA_def_property_float_sdna(prop, NULL, "spotblend");
184         RNA_def_property_range(prop, 0.0f ,1.0f);
185         RNA_def_property_ui_text(prop, "Spot Blend", "The softeness of the spotlight edge.");
186
187         prop= RNA_def_property(srna, "spot_size", PROP_FLOAT, PROP_NONE);
188         RNA_def_property_float_sdna(prop, NULL, "spotsize");
189         RNA_def_property_range(prop, 1.0f ,180.0f);
190         RNA_def_property_ui_text(prop, "Spot Size", "The angle of the spotlight beam in degrees.");
191
192         prop= RNA_def_property(srna, "clip_start", PROP_FLOAT, PROP_NONE);
193         RNA_def_property_float_sdna(prop, NULL, "clipsta");
194         RNA_def_property_range(prop, 0.0f, 9999.0f);
195         RNA_def_property_ui_text(prop, "Clip Start", "Distance that the buffer calculations start.");
196
197         prop= RNA_def_property(srna, "clip_end", PROP_FLOAT, PROP_NONE);
198         RNA_def_property_float_sdna(prop, NULL, "clipend");
199         RNA_def_property_range(prop, 0.0f, 9999.0f);
200         RNA_def_property_ui_text(prop, "Clip End", "Distance that the buffer calculations finish.");
201
202         prop= RNA_def_property(srna, "bias", PROP_FLOAT, PROP_NONE);
203         RNA_def_property_range(prop, 0.0f, 5.0f);
204         RNA_def_property_ui_text(prop, "Bias", "Shadow Map sampling bias.");
205
206         prop= RNA_def_property(srna, "soft", PROP_FLOAT, PROP_NONE);
207         RNA_def_property_range(prop, 0.0f, 100.0f);
208         RNA_def_property_ui_text(prop, "Soft", "Size of shadow sampling area.");
209
210         prop= RNA_def_property(srna, "samples", PROP_INT, PROP_NONE);
211         RNA_def_property_int_sdna(prop, NULL, "samp");
212         RNA_def_property_range(prop, 1,16);
213         RNA_def_property_ui_text(prop, "Samples", "Number of shadow map samples.");
214
215         prop= RNA_def_property(srna, "energy", PROP_FLOAT, PROP_NONE);
216         RNA_def_property_range(prop, 0.0f, 10.0f);
217         RNA_def_property_ui_text(prop, "Energy", "Amount of light that the lamp emits.");
218
219         prop= RNA_def_property(srna, "ray_samples", PROP_INT, PROP_NONE);
220         RNA_def_property_int_sdna(prop, NULL, "ray_samp");
221         RNA_def_property_range(prop, 1, 16);
222         RNA_def_property_ui_text(prop, "Ray Samples", "Amount of samples taken extra (samples x samples).");
223
224         prop= RNA_def_property(srna, "ray_sampy", PROP_INT, PROP_NONE);
225         RNA_def_property_range(prop, 1,16);
226         RNA_def_property_ui_text(prop, "Ray Samples Y", "Amount of samples taken extra (samples x samples).");
227
228         prop= RNA_def_property(srna, "area_size", PROP_FLOAT, PROP_NONE);
229         RNA_def_property_range(prop, 0.0f, 100.0f);
230         RNA_def_property_ui_text(prop, "Area Size", "Size of the area of the Area Lamp.");
231
232         prop= RNA_def_property(srna, "area_sizey", PROP_FLOAT, PROP_NONE);
233         RNA_def_property_range(prop, 0.0f, 100.0f);
234         RNA_def_property_ui_text(prop, "Area Size Y", "Size of the area of the Area Lamp.");
235
236         prop= RNA_def_property(srna, "adapt_thresh", PROP_FLOAT, PROP_NONE);
237         RNA_def_property_range(prop, 0.0f, 1.0f);
238         RNA_def_property_ui_text(prop, "Adapt Threshold", "Threshold for Adaptive Sampling.");
239
240         prop= RNA_def_property(srna, "buffer_size", PROP_INT, PROP_NONE);
241         RNA_def_property_int_sdna(prop, NULL, "bufsize");
242         RNA_def_property_range(prop, 512, 10240);
243         RNA_def_property_ui_text(prop, "Buffer Size", "Sets the size of the shadow buffer to nearest multiple of 16");
244         RNA_def_property_int_funcs(prop, NULL, "rna_Lamp_buffer_size_set", NULL);
245
246         prop= RNA_def_property(srna, "halo_intensity", PROP_FLOAT, PROP_NONE);
247         RNA_def_property_float_sdna(prop, NULL, "haint");
248         RNA_def_property_range(prop, 0.0f, 5.0f);
249         RNA_def_property_ui_text(prop, "Halo Intensity", "Intensity of Spot Halo");
250
251         prop= RNA_def_property(srna, "horizon_brightness", PROP_FLOAT, PROP_NONE);
252         RNA_def_property_range(prop, 0.0f, 20.0f);
253         RNA_def_property_ui_text(prop, "Hor. Bright", "horizon brightness");
254
255         prop= RNA_def_property(srna, "spread", PROP_FLOAT, PROP_NONE);
256         RNA_def_property_range(prop, 0.0f, 10.0f);
257         RNA_def_property_ui_text(prop, "Hor. Spread", "horizon Spread");
258
259         prop= RNA_def_property(srna, "sun_brightness", PROP_FLOAT, PROP_NONE);
260         RNA_def_property_range(prop, 0.0f, 10.0f);
261         RNA_def_property_ui_text(prop, "Sun Bright", "Sun Brightness");
262
263         prop= RNA_def_property(srna, "sun_size", PROP_FLOAT, PROP_NONE);
264         RNA_def_property_range(prop, 0.0f, 10.0f);
265         RNA_def_property_ui_text(prop, "Sun Size", "Sun Size");
266
267         prop= RNA_def_property(srna, "backscattered_light", PROP_FLOAT, PROP_NONE);
268         RNA_def_property_range(prop, 0.0f, 1.0f);
269         RNA_def_property_ui_text(prop, "Back Light", "Backscatter Light");
270
271         prop= RNA_def_property(srna, "sun_intensity", PROP_FLOAT, PROP_NONE);
272         RNA_def_property_range(prop, 0.0f, 10.0f);
273         RNA_def_property_ui_text(prop, "Sun Intens", "Sun Intensity");
274
275         prop= RNA_def_property(srna, "atm_turbidity", PROP_FLOAT, PROP_NONE);
276         RNA_def_property_range(prop, 0.0f, 30.0f);
277         RNA_def_property_ui_text(prop, "Turbidity", "Sky Tubidity");
278
279         prop= RNA_def_property(srna, "atm_inscattering_factor", PROP_FLOAT, PROP_NONE);
280         RNA_def_property_range(prop, 0.0f, 1.0f);
281         RNA_def_property_ui_text(prop, "Inscatter", "Scatter contribution factor");
282
283         prop= RNA_def_property(srna, "atm_extinction_factor", PROP_FLOAT, PROP_NONE);
284         RNA_def_property_range(prop, 0.0f, 1.0f);
285         RNA_def_property_ui_text(prop, "Extinction", "Extinction scattering contribution factor");
286
287         prop= RNA_def_property(srna, "atm_distance_factor", PROP_FLOAT, PROP_NONE);
288         RNA_def_property_range(prop, 0.0f, 500.0f);
289         RNA_def_property_ui_text(prop, "Atmos Distance", "Scale blender distance to real distance");
290
291         prop= RNA_def_property(srna, "sky_blend_factor", PROP_FLOAT, PROP_NONE);
292         RNA_def_property_float_sdna(prop, NULL, "skyblendfac");
293         RNA_def_property_range(prop, 0.0f, 2.0f);
294         RNA_def_property_ui_text(prop, "Sky Blend Factor", "Blend factor with sky");
295
296         prop= RNA_def_property(srna, "sky_exposure", PROP_FLOAT, PROP_NONE);
297         RNA_def_property_range(prop, 0.0f, 20.0f);
298         RNA_def_property_ui_text(prop, "Sky Exposure", "Exposure correction");
299
300
301         /*short sky_colorspace, pad4;*/
302
303         /* Colors */
304         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
305         RNA_def_property_float_sdna(prop, NULL, "r");
306         RNA_def_property_array(prop, 3);
307         RNA_def_property_ui_text(prop, "Color", "");
308         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 10.0f, 3.0f);
309
310         prop= RNA_def_property(srna, "shadow_color", PROP_FLOAT, PROP_COLOR);
311         RNA_def_property_float_sdna(prop, NULL, "shdwr");
312         RNA_def_property_array(prop, 3);
313         RNA_def_property_ui_text(prop, "Shadow Color", "");
314         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 10.0f, 3.0f);
315
316         /* Booleans */
317         prop= RNA_def_property(srna, "auto_clip_start", PROP_BOOLEAN, PROP_NONE);
318         RNA_def_property_boolean_sdna(prop, NULL, "bufflag", LA_SHADBUF_AUTO_START);
319         RNA_def_property_ui_text(prop, "Autoclip Start", "Automatically Sets Clip start to the nearest pixel.");
320
321         prop= RNA_def_property(srna, "auto_clip_end", PROP_BOOLEAN, PROP_NONE);
322         RNA_def_property_boolean_sdna(prop, NULL, "bufflag", LA_SHADBUF_AUTO_END);
323         RNA_def_property_ui_text(prop, "Autoclip End", "Automatically Sets Clip end to the farthest away pixel.");
324
325         prop= RNA_def_property(srna, "umbra", PROP_BOOLEAN, PROP_NONE);
326         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_UMBRA);
327         RNA_def_property_ui_text(prop, "Umbra", "Emphasise parts in full shadow.");
328
329         prop= RNA_def_property(srna, "dither", PROP_BOOLEAN, PROP_NONE);
330         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_DITHER);
331         RNA_def_property_ui_text(prop, "Dither", "Use 2x2 dithering for sampling.");
332
333         prop= RNA_def_property(srna, "jitter", PROP_BOOLEAN, PROP_NONE);
334         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_JITTER);
335         RNA_def_property_ui_text(prop, "Jitter", "Use noise for sampling.");
336
337         prop= RNA_def_property(srna, "sky", PROP_BOOLEAN, PROP_NONE);
338         RNA_def_property_boolean_sdna(prop, NULL, "sun_effect_type", LA_SUN_EFFECT_SKY);
339         RNA_def_property_ui_text(prop, "sky", "Apply sun effect on sky");
340
341         prop= RNA_def_property(srna, "atmosphere", PROP_BOOLEAN, PROP_NONE);
342         RNA_def_property_boolean_sdna(prop, NULL, "sun_effect_type", LA_SUN_EFFECT_AP);
343         RNA_def_property_ui_text(prop, "Atmosphere", "Apply sun effect on Atmosphere");
344
345         /* mode */
346         prop= RNA_def_property(srna, "halo", PROP_BOOLEAN, PROP_NONE);
347         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_HALO);
348         RNA_def_property_ui_text(prop, "Halo", "Lamp creates a halo.");
349
350         prop= RNA_def_property(srna, "layer", PROP_BOOLEAN, PROP_NONE);
351         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_LAYER);
352         RNA_def_property_ui_text(prop, "Layer", "Lamp is only used on the Scene layer the lamp is on.");
353
354         prop= RNA_def_property(srna, "negative", PROP_BOOLEAN, PROP_NONE);
355         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_NEG);
356         RNA_def_property_ui_text(prop, "Negative", "Lamp casts negative light.");
357
358         prop= RNA_def_property(srna, "specular", PROP_BOOLEAN, PROP_NONE);
359         RNA_def_property_boolean_negative_sdna(prop, NULL, "mode", LA_NO_SPEC);
360         RNA_def_property_ui_text(prop, "Specular", "Lamp creates specular highlights.");
361
362         prop= RNA_def_property(srna, "diffuse", PROP_BOOLEAN, PROP_NONE);
363         RNA_def_property_boolean_negative_sdna(prop, NULL, "mode", LA_NO_DIFF);
364         RNA_def_property_ui_text(prop, "Diffuse", "Lamp does diffuse shading.");
365
366         prop= RNA_def_property(srna, "only_shadow", PROP_BOOLEAN, PROP_NONE);
367         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_ONLYSHADOW);
368         RNA_def_property_ui_text(prop, "Only Shadow", "Lamp only creates shadows.");
369
370         prop= RNA_def_property(srna, "shadow", PROP_ENUM, PROP_NONE);
371         RNA_def_property_enum_bitflag_sdna(prop, NULL, "mode");
372         RNA_def_property_enum_items(prop, prop_shadow_items);
373         RNA_def_property_ui_text(prop, "Shadow", "Method to compute lamp shadow.");
374
375         prop= RNA_def_property(srna, "sphere", PROP_BOOLEAN, PROP_NONE);
376         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_SPHERE);
377         RNA_def_property_ui_text(prop, "Sphere", "Sets square spotbundles.");
378
379         prop= RNA_def_property(srna, "square", PROP_BOOLEAN, PROP_NONE);
380         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_SQUARE);
381         RNA_def_property_ui_text(prop, "Square", "Sets light intensity to zero beyond lamp distance.");
382 }
383
384 #endif
385