Merge with 2.5 -r 21619:21756.
[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 #include "DNA_material_types.h"
34 #include "DNA_texture_types.h"
35
36 #include "WM_types.h"
37
38 #ifdef RNA_RUNTIME
39
40 #include "MEM_guardedalloc.h"
41
42 #include "BKE_texture.h"
43
44 static void rna_Lamp_buffer_size_set(PointerRNA *ptr, int value)
45 {
46         Lamp *la= (Lamp*)ptr->data;
47
48         CLAMP(value, 512, 10240);
49         la->bufsize= value;
50         la->bufsize &= (~15); /* round to multiple of 16 */
51 }
52
53 static PointerRNA rna_Lamp_sky_settings_get(PointerRNA *ptr)
54 {
55         return rna_pointer_inherit_refine(ptr, &RNA_LampSkySettings, ptr->id.data);
56 }
57
58 static void rna_Lamp_mtex_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
59 {
60         Lamp *la= (Lamp*)ptr->data;
61         rna_iterator_array_begin(iter, (void*)la->mtex, sizeof(MTex*), MAX_MTEX, 0, NULL);
62 }
63
64 static PointerRNA rna_Lamp_active_texture_get(PointerRNA *ptr)
65 {
66         Lamp *la= (Lamp*)ptr->data;
67         return rna_pointer_inherit_refine(ptr, &RNA_TextureSlot, la->mtex[(int)la->texact]);
68 }
69
70 static void rna_Lamp_active_texture_index_set(PointerRNA *ptr, int value)
71 {
72         Lamp *la= (Lamp*)ptr->data;
73         int act= la->texact;
74
75         if(value == act || value < 0 || value >= MAX_MTEX)
76                 return;
77
78         /* auto create/free mtex on activate/deactive, so we can edit
79          * the texture pointer in the buttons UI. */
80         if(la->mtex[act] && !la->mtex[act]->tex) {
81                 MEM_freeN(la->mtex[act]);
82                 la->mtex[act]= NULL;
83         }
84
85         la->texact= value;
86
87         if(!la->mtex[value]) {
88                 la->mtex[value]= add_mtex();
89                 la->mtex[value]->texco= TEXCO_GLOB;
90         }
91 }
92
93 static StructRNA* rna_Lamp_refine(struct PointerRNA *ptr)
94 {
95         Lamp *la= (Lamp*)ptr->data;
96
97         switch(la->type) {
98                 case LA_LOCAL:
99                         return &RNA_LocalLamp;
100                 case LA_SUN:
101                         return &RNA_SunLamp;
102                 case LA_SPOT:
103                         return &RNA_SpotLamp;
104                 case LA_HEMI:
105                         return &RNA_HemiLamp;
106                 case LA_AREA:
107                         return &RNA_AreaLamp;
108                 default:
109                         return &RNA_Lamp;
110         }
111 }
112
113 #else
114
115 static void rna_def_lamp_mtex(BlenderRNA *brna)
116 {
117         StructRNA *srna;
118         PropertyRNA *prop;
119
120         static EnumPropertyItem prop_texture_coordinates_items[] = {
121                 {TEXCO_GLOB, "GLOBAL", 0, "Global", "Uses global coordinates for the texture coordinates."},
122                 {TEXCO_VIEW, "VIEW", 0, "View", "Uses view coordinates for the texture coordinates."},
123                 {TEXCO_OBJECT, "OBJECT", 0, "Object", "Uses linked object's coordinates for texture coordinates."},
124                 {0, NULL, 0, NULL, NULL}};
125
126         srna= RNA_def_struct(brna, "LampTextureSlot", "TextureSlot");
127         RNA_def_struct_sdna(srna, "MTex");
128         RNA_def_struct_ui_text(srna, "Lamp Texture Slot", "Texture slot for textures in a Lamp datablock.");
129
130         prop= RNA_def_property(srna, "texture_coordinates", PROP_ENUM, PROP_NONE);
131         RNA_def_property_enum_sdna(prop, NULL, "texco");
132         RNA_def_property_enum_items(prop, prop_texture_coordinates_items);
133         RNA_def_property_ui_text(prop, "Texture Coordinates", "");
134
135         prop= RNA_def_property(srna, "object", PROP_POINTER, PROP_NONE);
136         RNA_def_property_pointer_sdna(prop, NULL, "object");
137         RNA_def_property_struct_type(prop, "Object");
138         RNA_def_property_flag(prop, PROP_EDITABLE);
139         RNA_def_property_ui_text(prop, "Object", "Object to use for mapping with Object texture coordinates.");
140
141         prop= RNA_def_property(srna, "map_color", PROP_BOOLEAN, PROP_NONE);
142         RNA_def_property_boolean_sdna(prop, NULL, "mapto", LAMAP_COL);
143         RNA_def_property_ui_text(prop, "Color", "Lets the texture affect the basic color of the lamp.");
144
145         prop= RNA_def_property(srna, "map_shadow", PROP_BOOLEAN, PROP_NONE);
146         RNA_def_property_boolean_sdna(prop, NULL, "mapto", LAMAP_SHAD);
147         RNA_def_property_ui_text(prop, "Shadow", "Lets the texture affect the shadow color of the lamp.");
148 }
149
150 static void rna_def_lamp_sky_settings(BlenderRNA *brna)
151 {
152         StructRNA *srna;
153         PropertyRNA *prop;
154
155         static EnumPropertyItem prop_skycolorspace_items[] = {
156                 {0, "SMPTE", 0, "SMPTE", ""},
157                 {1, "REC709", 0, "REC709", ""},
158                 {2, "CIE", 0, "CIE", ""},
159                 {0, NULL, 0, NULL, NULL}};
160                 
161         static EnumPropertyItem prop_blendmode_items[] = {
162                 {0, "MIX", 0, "Mix", ""},
163                 {1, "ADD", 0, "Add", ""},
164                 {2, "MULTIPLY", 0, "Multiply", ""},
165                 {3, "SUBTRACT", 0, "Subtract", ""},
166                 {4, "SCREEN", 0, "Screen", ""},
167                 {5, "DIVIDE", 0, "Divide", ""},
168                 {6, "DIFFERENCE", 0, "Difference", ""},
169                 {7, "DARKEN", 0, "Darken", ""},
170                 {8, "LIGHTEN", 0, "Lighten", ""},
171                 {9, "OVERLAY", 0, "Overlay", ""},
172                 {10, "DODGE", 0, "Dodge", ""},
173                 {11, "BURN", 0, "Burn", ""},
174                 {12, "HUE", 0, "Hue", ""},
175                 {13, "SATURATION", 0, "Saturation", ""},
176                 {14, "VALUE", 0, "Value", ""},
177                 {15, "COLOR", 0, "Color", ""},
178                 {0, NULL, 0, NULL, NULL}};
179                 
180         srna= RNA_def_struct(brna, "LampSkySettings", NULL);
181         RNA_def_struct_sdna(srna, "Lamp");
182         RNA_def_struct_nested(brna, srna, "SunLamp");
183         RNA_def_struct_ui_text(srna, "Lamp Sky Settings", "Sky related settings for a sun lamp.");
184                 
185         prop= RNA_def_property(srna, "sky_color_space", PROP_ENUM, PROP_NONE);
186         RNA_def_property_enum_sdna(prop, NULL, "sky_colorspace");
187         RNA_def_property_enum_items(prop, prop_skycolorspace_items);
188         RNA_def_property_ui_text(prop, "Sky Color Space", "Color space to use for internal XYZ->RGB color conversion.");
189         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
190
191         prop= RNA_def_property(srna, "sky_blend_type", PROP_ENUM, PROP_NONE);
192         RNA_def_property_enum_sdna(prop, NULL, "skyblendtype");
193         RNA_def_property_enum_items(prop, prop_blendmode_items);
194         RNA_def_property_ui_text(prop, "Sky Blend Mode", "Blend mode for combining sun sky with world sky.");
195         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
196         
197         /* Number values */
198         
199         prop= RNA_def_property(srna, "horizon_brightness", PROP_FLOAT, PROP_NONE);
200         RNA_def_property_range(prop, 0.0f, 20.0f);
201         RNA_def_property_ui_text(prop, "Horizon Brightness", "Horizon brightness.");
202         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
203
204         prop= RNA_def_property(srna, "spread", PROP_FLOAT, PROP_NONE);
205         RNA_def_property_range(prop, 0.0f, 10.0f);
206         RNA_def_property_ui_text(prop, "Horizon Spread", "Horizon Spread.");
207         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
208
209         prop= RNA_def_property(srna, "sun_brightness", PROP_FLOAT, PROP_NONE);
210         RNA_def_property_range(prop, 0.0f, 10.0f);
211         RNA_def_property_ui_text(prop, "Sun Brightness", "Sun brightness.");
212         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
213
214         prop= RNA_def_property(srna, "sun_size", PROP_FLOAT, PROP_NONE);
215         RNA_def_property_range(prop, 0.0f, 10.0f);
216         RNA_def_property_ui_text(prop, "Sun Size", "Sun size.");
217         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
218
219         prop= RNA_def_property(srna, "backscattered_light", PROP_FLOAT, PROP_NONE);
220         RNA_def_property_range(prop, -1.0f, 1.0f);
221         RNA_def_property_ui_text(prop, "Backscattered Light", "Backscattered light.");
222         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
223
224         prop= RNA_def_property(srna, "sun_intensity", PROP_FLOAT, PROP_NONE);
225         RNA_def_property_range(prop, 0.0f, 10.0f);
226         RNA_def_property_ui_text(prop, "Sun Intensity", "Sun intensity.");
227         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
228
229         prop= RNA_def_property(srna, "atmosphere_turbidity", PROP_FLOAT, PROP_NONE);
230         RNA_def_property_float_sdna(prop, NULL, "atm_turbidity");
231         RNA_def_property_range(prop, 1.0f, 30.0f);
232         RNA_def_property_ui_text(prop, "Atmosphere Turbidity", "Sky turbidity.");
233         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
234
235         prop= RNA_def_property(srna, "atmosphere_inscattering", PROP_FLOAT, PROP_NONE);
236         RNA_def_property_float_sdna(prop, NULL, "atm_inscattering_factor");
237         RNA_def_property_range(prop, 0.0f, 1.0f);
238         RNA_def_property_ui_text(prop, "Atmosphere Inscatter", "Scatter contribution factor.");
239         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
240
241         prop= RNA_def_property(srna, "atmosphere_extinction", PROP_FLOAT, PROP_NONE);
242         RNA_def_property_float_sdna(prop, NULL, "atm_extinction_factor");
243         RNA_def_property_range(prop, 0.0f, 1.0f);
244         RNA_def_property_ui_text(prop, "Atmosphere Extinction", "Extinction scattering contribution factor.");
245         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
246
247         prop= RNA_def_property(srna, "atmosphere_distance_factor", PROP_FLOAT, PROP_NONE);
248         RNA_def_property_float_sdna(prop, NULL, "atm_distance_factor");
249         RNA_def_property_range(prop, 0.0f, 500.0f);
250         RNA_def_property_ui_text(prop, "Atmosphere Distance Factor", "Multiplier to convert blender units to physical distance.");
251         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
252
253         prop= RNA_def_property(srna, "sky_blend", PROP_FLOAT, PROP_NONE);
254         RNA_def_property_float_sdna(prop, NULL, "skyblendfac");
255         RNA_def_property_range(prop, 0.0f, 2.0f);
256         RNA_def_property_ui_text(prop, "Sky Blend", "Blend factor with sky.");
257         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
258
259         prop= RNA_def_property(srna, "sky_exposure", PROP_FLOAT, PROP_NONE);
260         RNA_def_property_range(prop, 0.0f, 20.0f);
261         RNA_def_property_ui_text(prop, "Sky Exposure", "Strength of sky shading exponential exposure correction.");
262         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
263
264         /* boolean */
265         
266         prop= RNA_def_property(srna, "sky", PROP_BOOLEAN, PROP_NONE);
267         RNA_def_property_boolean_sdna(prop, NULL, "sun_effect_type", LA_SUN_EFFECT_SKY);
268         RNA_def_property_ui_text(prop, "Sky", "Apply sun effect on sky.");
269         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
270
271         prop= RNA_def_property(srna, "atmosphere", PROP_BOOLEAN, PROP_NONE);
272         RNA_def_property_boolean_sdna(prop, NULL, "sun_effect_type", LA_SUN_EFFECT_AP);
273         RNA_def_property_ui_text(prop, "Atmosphere", "Apply sun effect on atmosphere.");
274         RNA_def_property_update(prop, NC_LAMP|ND_SKY, NULL);
275 }
276
277 static void rna_def_lamp(BlenderRNA *brna)
278 {
279         StructRNA *srna;
280         PropertyRNA *prop;
281
282         static EnumPropertyItem prop_type_items[] = {
283                 {LA_LOCAL, "POINT", 0, "Point", "Omnidirectional point light source."},
284                 {LA_SUN, "SUN", 0, "Sun", "Constant direction parallel ray light source."},
285                 {LA_SPOT, "SPOT", 0, "Spot", "Directional cone light source."},
286                 {LA_HEMI, "HEMI", 0, "Hemi", "180 degree constant light source."},
287                 {LA_AREA, "AREA", 0, "Area", "Directional area light source."},
288                 {0, NULL, 0, NULL, NULL}};
289
290         srna= RNA_def_struct(brna, "Lamp", "ID");
291         RNA_def_struct_refine_func(srna, "rna_Lamp_refine");
292         RNA_def_struct_ui_text(srna, "Lamp", "Lamp datablock for lighting a scene.");
293         RNA_def_struct_ui_icon(srna, ICON_LAMP_DATA);
294
295         prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
296         RNA_def_property_enum_items(prop, prop_type_items);
297         RNA_def_property_ui_text(prop, "Type", "Type of Lamp.");
298         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
299
300         prop= RNA_def_property(srna, "distance", PROP_FLOAT, PROP_NONE);
301         RNA_def_property_float_sdna(prop, NULL, "dist");
302         RNA_def_property_ui_range(prop, 0, 1000, 1.0, 2);
303         RNA_def_property_ui_text(prop, "Distance", "Falloff distance - the light is at half the original intensity at this point.");
304         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
305
306         prop= RNA_def_property(srna, "energy", PROP_FLOAT, PROP_NONE);
307         RNA_def_property_ui_range(prop, 0, 10.0, 0.1, 2);
308         RNA_def_property_ui_text(prop, "Energy", "Amount of light that the lamp emits.");
309         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
310
311         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
312         RNA_def_property_float_sdna(prop, NULL, "r");
313         RNA_def_property_array(prop, 3);
314         RNA_def_property_ui_text(prop, "Color", "Light color.");
315         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
316
317         prop= RNA_def_property(srna, "layer", PROP_BOOLEAN, PROP_NONE);
318         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_LAYER);
319         RNA_def_property_ui_text(prop, "Layer", "Illuminates objects only on the same layer the lamp is on.");
320         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
321
322         prop= RNA_def_property(srna, "negative", PROP_BOOLEAN, PROP_NONE);
323         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_NEG);
324         RNA_def_property_ui_text(prop, "Negative", "Lamp casts negative light.");
325         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
326
327         prop= RNA_def_property(srna, "specular", PROP_BOOLEAN, PROP_NONE);
328         RNA_def_property_boolean_negative_sdna(prop, NULL, "mode", LA_NO_SPEC);
329         RNA_def_property_ui_text(prop, "Specular", "Lamp creates specular highlights.");
330         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
331
332         prop= RNA_def_property(srna, "diffuse", PROP_BOOLEAN, PROP_NONE);
333         RNA_def_property_boolean_negative_sdna(prop, NULL, "mode", LA_NO_DIFF);
334         RNA_def_property_ui_text(prop, "Diffuse", "Lamp does diffuse shading.");
335         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
336
337         /* textures */
338         rna_def_mtex_common(srna, "rna_Lamp_mtex_begin", "rna_Lamp_active_texture_get", "rna_Lamp_active_texture_index_set", "LampTextureSlot");
339
340         /* script link */
341         prop= RNA_def_property(srna, "script_link", PROP_POINTER, PROP_NEVER_NULL);
342         RNA_def_property_pointer_sdna(prop, NULL, "scriptlink");
343         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
344         RNA_def_property_ui_text(prop, "Script Link", "Scripts linked to this lamp.");
345 }
346
347 static void rna_def_lamp_falloff(StructRNA *srna)
348 {
349         PropertyRNA *prop;
350
351         static EnumPropertyItem prop_fallofftype_items[] = {
352                 {LA_FALLOFF_CONSTANT, "CONSTANT", 0, "Constant", ""},
353                 {LA_FALLOFF_INVLINEAR, "INVERSE_LINEAR", 0, "Inverse Linear", ""},
354                 {LA_FALLOFF_INVSQUARE, "INVERSE_SQUARE", 0, "Inverse Square", ""},
355                 {LA_FALLOFF_CURVE, "CUSTOM_CURVE", 0, "Custom Curve", ""},
356                 {LA_FALLOFF_SLIDERS, "LINEAR_QUADRATIC_WEIGHTED", 0, "Lin/Quad Weighted", ""},
357                 {0, NULL, 0, NULL, NULL}};
358
359         prop= RNA_def_property(srna, "falloff_type", PROP_ENUM, PROP_NONE);
360         RNA_def_property_enum_items(prop, prop_fallofftype_items);
361         RNA_def_property_ui_text(prop, "Falloff Type", "Intensity Decay with distance.");
362         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
363         
364         prop= RNA_def_property(srna, "falloff_curve", PROP_POINTER, PROP_NONE);
365         RNA_def_property_pointer_sdna(prop, NULL, "curfalloff");
366         RNA_def_property_ui_text(prop, "Falloff Curve", "Custom Lamp Falloff Curve");
367         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
368
369         prop= RNA_def_property(srna, "sphere", PROP_BOOLEAN, PROP_NONE);
370         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_SPHERE);
371         RNA_def_property_ui_text(prop, "Sphere", "Sets light intensity to zero beyond lamp distance.");
372         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
373
374         prop= RNA_def_property(srna, "linear_attenuation", PROP_FLOAT, PROP_NONE);
375         RNA_def_property_float_sdna(prop, NULL, "att1");
376         RNA_def_property_range(prop, 0.0f, 1.0f);
377         RNA_def_property_ui_text(prop, "Linear Attenuation", "Linear distance attentuation.");
378         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
379
380         prop= RNA_def_property(srna, "quadratic_attenuation", PROP_FLOAT, PROP_NONE);
381         RNA_def_property_float_sdna(prop, NULL, "att2");
382         RNA_def_property_range(prop, 0.0f, 1.0f);
383         RNA_def_property_ui_text(prop, "Quadratic Attenuation", "Quadratic distance attentuation.");
384         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
385 }
386
387 static void rna_def_lamp_shadow(StructRNA *srna, int spot, int area)
388 {
389         PropertyRNA *prop;
390
391         static EnumPropertyItem prop_shadow_items[] = {
392                 {0, "NOSHADOW", 0, "No Shadow", ""},
393                 {LA_SHAD_RAY, "RAY_SHADOW", 0, "Ray Shadow", "Use ray tracing for shadow."},
394                 {0, NULL, 0, NULL, NULL}};
395
396         static EnumPropertyItem prop_spot_shadow_items[] = {
397                 {0, "NOSHADOW", 0, "No Shadow", ""},
398                 {LA_SHAD_BUF, "BUFFER_SHADOW", 0, "Buffer Shadow", "Lets spotlight produce shadows using shadow buffer."},
399                 {LA_SHAD_RAY, "RAY_SHADOW", 0, "Ray Shadow", "Use ray tracing for shadow."},
400                 {0, NULL, 0, NULL, NULL}};
401
402         static EnumPropertyItem prop_ray_sampling_method_items[] = {
403                 {LA_SAMP_HALTON, "ADAPTIVE_QMC", 0, "Adaptive QMC", ""},
404                 {LA_SAMP_HAMMERSLEY, "CONSTANT_QMC", 0, "Constant QMC", ""},
405                 {0, NULL, 0, NULL, NULL}};
406         
407         static EnumPropertyItem prop_spot_ray_sampling_method_items[] = {
408                 {LA_SAMP_HALTON, "ADAPTIVE_QMC", 0, "Adaptive QMC", ""},
409                 {LA_SAMP_HAMMERSLEY, "CONSTANT_QMC", 0, "Constant QMC", ""},
410                 {LA_SAMP_CONSTANT, "CONSTANT_JITTERED", 0, "Constant Jittered", ""},
411                 {0, NULL, 0, NULL, NULL}};
412
413         prop= RNA_def_property(srna, "shadow_method", PROP_ENUM, PROP_NONE);
414         RNA_def_property_enum_bitflag_sdna(prop, NULL, "mode");
415         RNA_def_property_enum_items(prop, (spot)? prop_spot_shadow_items: prop_shadow_items);
416         RNA_def_property_ui_text(prop, "Shadow Method", "Method to compute lamp shadow with.");
417         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
418
419         prop= RNA_def_property(srna, "shadow_color", PROP_FLOAT, PROP_COLOR);
420         RNA_def_property_float_sdna(prop, NULL, "shdwr");
421         RNA_def_property_array(prop, 3);
422         RNA_def_property_ui_text(prop, "Shadow Color", "Color of shadows casted by the lamp.");
423         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
424
425         prop= RNA_def_property(srna, "only_shadow", PROP_BOOLEAN, PROP_NONE);
426         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_ONLYSHADOW);
427         RNA_def_property_ui_text(prop, "Only Shadow", "Causes light to cast shadows only without illuminating objects.");
428         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
429
430         prop= RNA_def_property(srna, "shadow_ray_sampling_method", PROP_ENUM, PROP_NONE);
431         RNA_def_property_enum_sdna(prop, NULL, "ray_samp_method");
432         RNA_def_property_enum_items(prop, (area)? prop_spot_ray_sampling_method_items: prop_ray_sampling_method_items);
433         RNA_def_property_ui_text(prop, "Shadow Ray Sampling Method", "Method for generating shadow samples: Adaptive QMC is fastest, Constant QMC is less noisy but slower.");
434         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
435
436         prop= RNA_def_property(srna, (area)? "shadow_ray_samples_x": "shadow_ray_samples", PROP_INT, PROP_NONE);
437         RNA_def_property_int_sdna(prop, NULL, "ray_samp");
438         RNA_def_property_range(prop, 1, 64);
439         RNA_def_property_ui_text(prop, (area)? "Shadow Ray Samples": "Shadow Ray Samples X","Amount of samples taken extra (samples x samples).");
440         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
441
442         if(area) {
443                 prop= RNA_def_property(srna, "shadow_ray_samples_y", PROP_INT, PROP_NONE);
444                 RNA_def_property_int_sdna(prop, NULL, "ray_sampy");
445                 RNA_def_property_range(prop, 1, 64);
446                 RNA_def_property_ui_text(prop, "Shadow Ray Samples Y", "Amount of samples taken extra (samples x samples).");
447                 RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
448         }
449
450         prop= RNA_def_property(srna, "shadow_adaptive_threshold", PROP_FLOAT, PROP_NONE);
451         RNA_def_property_float_sdna(prop, NULL, "adapt_thresh");
452         RNA_def_property_range(prop, 0.0f, 1.0f);
453         RNA_def_property_ui_text(prop, "Shadow Adaptive Threshold", "Threshold for Adaptive Sampling (Raytraced shadows).");
454         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
455
456         prop= RNA_def_property(srna, "shadow_soft_size", PROP_FLOAT, PROP_NONE);
457         RNA_def_property_float_sdna(prop, NULL, "soft");
458         RNA_def_property_ui_range(prop, 0, 100, 0.1, 3);
459         RNA_def_property_ui_text(prop, "Shadow Soft Size", "Light size for ray shadow sampling (Raytraced shadows).");
460         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
461
462         prop= RNA_def_property(srna, "shadow_layer", PROP_BOOLEAN, PROP_NONE);
463         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_LAYER_SHADOW);
464         RNA_def_property_ui_text(prop, "Shadow Layer", "Causes only objects on the same layer to cast shadows.");
465         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
466 }
467
468 static void rna_def_local_lamp(BlenderRNA *brna)
469 {
470         StructRNA *srna;
471
472         srna= RNA_def_struct(brna, "LocalLamp", "Lamp");
473         RNA_def_struct_sdna(srna, "Lamp");
474         RNA_def_struct_ui_text(srna, "Local Lamp", "Omnidirectional point lamp.");
475
476         rna_def_lamp_falloff(srna);
477         rna_def_lamp_shadow(srna, 0, 0);
478 }
479
480 static void rna_def_area_lamp(BlenderRNA *brna)
481 {
482         StructRNA *srna;
483         PropertyRNA *prop;
484
485         static EnumPropertyItem prop_areashape_items[] = {
486                 {LA_AREA_SQUARE, "SQUARE", 0, "Square", ""},
487                 {LA_AREA_RECT, "RECTANGLE", 0, "Rectangle", ""},
488                 {0, NULL, 0, NULL, NULL}};
489
490         srna= RNA_def_struct(brna, "AreaLamp", "Lamp");
491         RNA_def_struct_sdna(srna, "Lamp");
492         RNA_def_struct_ui_text(srna, "Area Lamp", "Directional area lamp.");
493
494         rna_def_lamp_shadow(srna, 0, 1);
495
496         prop= RNA_def_property(srna, "umbra", PROP_BOOLEAN, PROP_NONE);
497         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_UMBRA);
498         RNA_def_property_ui_text(prop, "Umbra", "Emphasize parts that are fully shadowed (Constant Jittered sampling).");
499         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
500
501         prop= RNA_def_property(srna, "dither", PROP_BOOLEAN, PROP_NONE);
502         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_DITHER);
503         RNA_def_property_ui_text(prop, "Dither", "Use 2x2 dithering for sampling  (Constant Jittered sampling).");
504         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
505
506         prop= RNA_def_property(srna, "jitter", PROP_BOOLEAN, PROP_NONE);
507         RNA_def_property_boolean_sdna(prop, NULL, "ray_samp_type", LA_SAMP_JITTER);
508         RNA_def_property_ui_text(prop, "Jitter", "Use noise for sampling  (Constant Jittered sampling).");
509         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
510
511         prop= RNA_def_property(srna, "shape", PROP_ENUM, PROP_NONE);
512         RNA_def_property_enum_sdna(prop, NULL, "area_shape");
513         RNA_def_property_enum_items(prop, prop_areashape_items);
514         RNA_def_property_ui_text(prop, "Shape", "Shape of the area lamp.");
515         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
516
517         prop= RNA_def_property(srna, "size", PROP_FLOAT, PROP_NONE);
518         RNA_def_property_float_sdna(prop, NULL, "area_size");
519         RNA_def_property_ui_range(prop, 0, 100, 0.1, 3);
520         RNA_def_property_ui_text(prop, "Size", "Size of the area of the area Lamp, X direction size for Rectangle shapes.");
521         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
522
523         prop= RNA_def_property(srna, "size_y", PROP_FLOAT, PROP_NONE);
524         RNA_def_property_float_sdna(prop, NULL, "area_sizey");
525         RNA_def_property_ui_range(prop, 0, 100, 0.1, 3);
526         RNA_def_property_ui_text(prop, "Size Y", "Size of the area of the area Lamp in the Y direction for Rectangle shapes.");
527         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
528
529         prop= RNA_def_property(srna, "gamma", PROP_FLOAT, PROP_NONE);
530         RNA_def_property_float_sdna(prop, NULL, "k");
531         RNA_def_property_ui_range(prop, 0.001, 2.0, 0.1, 3);
532         RNA_def_property_ui_text(prop, "Gamma", "Light gamma correction value.");
533         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
534 }
535
536 static void rna_def_spot_lamp(BlenderRNA *brna)
537 {
538         StructRNA *srna;
539         PropertyRNA *prop;
540
541         static EnumPropertyItem prop_shadbuftype_items[] = {
542                 {LA_SHADBUF_REGULAR     , "REGULAR", 0, "Classical", "Classic shadow buffer."},
543                 {LA_SHADBUF_HALFWAY, "HALFWAY", 0, "Classic-Halfway", "Regular buffer, averaging the closest and 2nd closest Z value to reducing bias artifaces."},
544                 {LA_SHADBUF_IRREGULAR, "IRREGULAR", 0, "Irregular", "Irregular buffer produces sharp shadow always, but it doesn't show up for raytracing."},
545                 {0, NULL, 0, NULL, NULL}};
546
547         static EnumPropertyItem prop_shadbuffiltertype_items[] = {
548                 {LA_SHADBUF_BOX , "BOX", 0, "Box", "Apply the Box filter to shadow buffer samples."},
549                 {LA_SHADBUF_TENT, "TENT", 0, "Tent", "Apply the Tent Filter to shadow buffer samples."},
550                 {LA_SHADBUF_GAUSS, "GAUSS", 0, "Gauss", "Apply the Gauss filter to shadow buffer samples."},
551                 {0, NULL, 0, NULL, NULL}};
552
553         static EnumPropertyItem prop_numbuffer_items[] = {
554                 {1, "BUFFERS_1", 0, "1", "Only one buffer rendered."},
555                 {4, "BUFFERS_4", 0, "4", "Renders 4 buffers for better AA, this quadruples memory usage."},
556                 {9, "BUFFERS_9", 0, "9", "Renders 9 buffers for better AA, this uses nine times more memory."},
557                 {0, NULL, 0, NULL, NULL}};
558
559         srna= RNA_def_struct(brna, "SpotLamp", "Lamp");
560         RNA_def_struct_sdna(srna, "Lamp");
561         RNA_def_struct_ui_text(srna, "Spot Lamp", "Directional cone lamp.");
562
563         rna_def_lamp_falloff(srna);
564         rna_def_lamp_shadow(srna, 1, 0);
565
566         prop= RNA_def_property(srna, "square", PROP_BOOLEAN, PROP_NONE);
567         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_SQUARE);
568         RNA_def_property_ui_text(prop, "Square", "Casts a square spot light shape.");
569         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
570
571         prop= RNA_def_property(srna, "halo", PROP_BOOLEAN, PROP_NONE);
572         RNA_def_property_boolean_sdna(prop, NULL, "mode", LA_HALO);
573         RNA_def_property_ui_text(prop, "Halo", "Renders spotlight with a volumetric halo (Buffer Shadows).");
574         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
575
576         prop= RNA_def_property(srna, "halo_intensity", PROP_FLOAT, PROP_NONE);
577         RNA_def_property_float_sdna(prop, NULL, "haint");
578         RNA_def_property_ui_range(prop, 0, 5.0, 0.1, 3);
579         RNA_def_property_ui_text(prop, "Halo Intensity", "Brightness of the spotlight's halo cone  (Buffer Shadows).");
580         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
581
582         prop= RNA_def_property(srna, "halo_step", PROP_INT, PROP_NONE);
583         RNA_def_property_int_sdna(prop, NULL, "shadhalostep");
584         RNA_def_property_range(prop, 0, 12);
585         RNA_def_property_ui_text(prop, "Halo Step", "Volumetric halo sampling frequency.");
586         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
587
588         prop= RNA_def_property(srna, "shadow_buffer_size", PROP_INT, PROP_NONE);
589         RNA_def_property_int_sdna(prop, NULL, "bufsize");
590         RNA_def_property_range(prop, 512, 10240);
591         RNA_def_property_ui_text(prop, "Shadow Buffer Size", "Resolution of the shadow buffer, higher values give crisper shadows but use more memory");
592         RNA_def_property_int_funcs(prop, NULL, "rna_Lamp_buffer_size_set", NULL);
593         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
594
595         prop= RNA_def_property(srna, "shadow_filter_type", PROP_ENUM, PROP_NONE);
596         RNA_def_property_enum_sdna(prop, NULL, "filtertype");
597         RNA_def_property_enum_items(prop, prop_shadbuffiltertype_items);
598         RNA_def_property_ui_text(prop, "Shadow Filter Type", "Type of shadow filter (Buffer Shadows).");
599         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
600
601         prop= RNA_def_property(srna, "shadow_sample_buffers", PROP_ENUM, PROP_NONE);
602         RNA_def_property_enum_sdna(prop, NULL, "buffers");
603         RNA_def_property_enum_items(prop, prop_numbuffer_items);
604         RNA_def_property_ui_text(prop, "Shadow Sample Buffers", "Number of shadow buffers to render for better AA, this increases memory usage.");
605         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
606
607         prop= RNA_def_property(srna, "spot_blend", PROP_FLOAT, PROP_NONE);
608         RNA_def_property_float_sdna(prop, NULL, "spotblend");
609         RNA_def_property_range(prop, 0.0f ,1.0f);
610         RNA_def_property_ui_text(prop, "Spot Blend", "The softness of the spotlight edge.");
611         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
612
613         prop= RNA_def_property(srna, "spot_size", PROP_FLOAT, PROP_NONE);
614         RNA_def_property_float_sdna(prop, NULL, "spotsize");
615         RNA_def_property_range(prop, 1.0f ,180.0f);
616         RNA_def_property_ui_text(prop, "Spot Size", "Angle of the spotlight beam in degrees.");
617         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
618
619         prop= RNA_def_property(srna, "shadow_buffer_clip_start", PROP_FLOAT, PROP_NONE);
620         RNA_def_property_float_sdna(prop, NULL, "clipsta");
621         RNA_def_property_range(prop, 0.0f, 9999.0f);
622         RNA_def_property_ui_text(prop, "Shadow Buffer Clip Start", "Shadow map clip start: objects closer will not generate shadows");
623         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
624
625         prop= RNA_def_property(srna, "shadow_buffer_clip_end", PROP_FLOAT, PROP_NONE);
626         RNA_def_property_float_sdna(prop, NULL, "clipend");
627         RNA_def_property_range(prop, 0.0f, 9999.0f);
628         RNA_def_property_ui_text(prop, "Shadow Buffer Clip End", "Shadow map clip end beyond which objects will not generate shadows.");
629         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
630
631         prop= RNA_def_property(srna, "shadow_buffer_bias", PROP_FLOAT, PROP_NONE);
632         RNA_def_property_float_sdna(prop, NULL, "bias");
633         RNA_def_property_range(prop, 0.0f, 5.0f);
634         RNA_def_property_ui_text(prop, "Shadow Buffer Bias", "Shadow buffer sampling bias.");
635         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
636
637         prop= RNA_def_property(srna, "shadow_buffer_soft", PROP_FLOAT, PROP_NONE);
638         RNA_def_property_float_sdna(prop, NULL, "soft");
639         RNA_def_property_range(prop, 0.0f, 100.0f);
640         RNA_def_property_ui_text(prop, "Shadow Buffer Soft", "Size of shadow buffer sampling area.");
641         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
642
643         prop= RNA_def_property(srna, "shadow_buffer_samples", PROP_INT, PROP_NONE);
644         RNA_def_property_int_sdna(prop, NULL, "samp");
645         RNA_def_property_range(prop, 1, 16);
646         RNA_def_property_ui_text(prop, "Samples", "Number of shadow buffer samples.");
647         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
648
649         prop= RNA_def_property(srna, "shadow_buffer_type", PROP_ENUM, PROP_NONE);
650         RNA_def_property_enum_sdna(prop, NULL, "buftype");
651         RNA_def_property_enum_items(prop, prop_shadbuftype_items);
652         RNA_def_property_ui_text(prop, "Shadow Buffer Type", "Type of shadow buffer.");
653         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING, NULL);
654
655         prop= RNA_def_property(srna, "auto_clip_start", PROP_BOOLEAN, PROP_NONE);
656         RNA_def_property_boolean_sdna(prop, NULL, "bufflag", LA_SHADBUF_AUTO_START);
657         RNA_def_property_ui_text(prop, "Autoclip Start",  "Automatic calculation of clipping-start, based on visible vertices.");
658         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
659
660         prop= RNA_def_property(srna, "auto_clip_end", PROP_BOOLEAN, PROP_NONE);
661         RNA_def_property_boolean_sdna(prop, NULL, "bufflag", LA_SHADBUF_AUTO_END);
662         RNA_def_property_ui_text(prop, "Autoclip End", "Automatic calculation of clipping-end, based on visible vertices.");
663         RNA_def_property_update(prop, NC_LAMP|ND_LIGHTING_DRAW, NULL);
664 }
665
666 static void rna_def_sun_lamp(BlenderRNA *brna)
667 {
668         StructRNA *srna;
669         PropertyRNA *prop;
670
671         srna= RNA_def_struct(brna, "SunLamp", "Lamp");
672         RNA_def_struct_sdna(srna, "Lamp");
673         RNA_def_struct_ui_text(srna, "Sun Lamp", "Constant direction parallel ray lamp.");
674
675         rna_def_lamp_shadow(srna, 0, 0);
676
677         /* sky */
678         prop= RNA_def_property(srna, "sky", PROP_POINTER, PROP_NEVER_NULL);
679         RNA_def_property_struct_type(prop, "LampSkySettings");
680         RNA_def_property_pointer_funcs(prop, "rna_Lamp_sky_settings_get", NULL, NULL);
681         RNA_def_property_ui_text(prop, "Sky Settings", "Sky related settings for sun lamps.");
682
683         rna_def_lamp_sky_settings(brna);
684 }
685
686 static void rna_def_hemi_lamp(BlenderRNA *brna)
687 {
688         StructRNA *srna;
689
690         srna= RNA_def_struct(brna, "HemiLamp", "Lamp");
691         RNA_def_struct_sdna(srna, "Lamp");
692         RNA_def_struct_ui_text(srna, "Hemi Lamp", "180 degree constant lamp.");
693 }
694
695 void RNA_def_lamp(BlenderRNA *brna)
696 {
697         rna_def_lamp(brna);
698         rna_def_local_lamp(brna);
699         rna_def_area_lamp(brna);
700         rna_def_spot_lamp(brna);
701         rna_def_sun_lamp(brna);
702         rna_def_hemi_lamp(brna);
703         rna_def_lamp_mtex(brna);
704 }
705
706 #endif
707