Merging r46203 through r46413 from trunk into soc-2011-tomato
[blender.git] / source / blender / makesrna / intern / rna_image.c
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * Contributor(s): Brecht Van Lommel
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/makesrna/intern/rna_image.c
24  *  \ingroup RNA
25  */
26
27
28 #include <stdlib.h>
29
30 #include "RNA_define.h"
31 #include "RNA_enum_types.h"
32
33 #include "rna_internal.h"
34
35 #include "DNA_image_types.h"
36 #include "DNA_scene_types.h"
37
38 #include "BKE_context.h"
39 #include "BKE_depsgraph.h"
40 #include "BKE_image.h"
41
42 #include "WM_types.h"
43 #include "WM_api.h"
44
45 static EnumPropertyItem image_source_items[] = {
46         {IMA_SRC_FILE, "FILE", 0, "Single Image", "Single image file"},
47         {IMA_SRC_SEQUENCE, "SEQUENCE", 0, "Image Sequence", "Multiple image files, as a sequence"},
48         {IMA_SRC_MOVIE, "MOVIE", 0, "Movie", "Movie file"},
49         {IMA_SRC_GENERATED, "GENERATED", 0, "Generated", "Generated image"},
50         {IMA_SRC_VIEWER, "VIEWER", 0, "Viewer", "Compositing node viewer"},
51         {0, NULL, 0, NULL, NULL}};
52
53 #ifdef RNA_RUNTIME
54
55 #include "IMB_imbuf_types.h"
56
57 static void rna_Image_animated_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
58 {
59         Image *ima = (Image*)ptr->data;
60         int  nr;
61
62         if (ima->flag & IMA_TWINANIM) {
63                 nr = ima->xrep*ima->yrep;
64                 if (ima->twsta >= nr) ima->twsta = 1;
65                 if (ima->twend >= nr) ima->twend = nr-1;
66                 if (ima->twsta>ima->twend) ima->twsta = 1;
67         }
68 }
69
70 static int rna_Image_dirty_get(PointerRNA *ptr)
71 {
72         Image *ima = (Image*)ptr->data;
73         ImBuf *ibuf;
74
75         for (ibuf = ima->ibufs.first; ibuf; ibuf = ibuf->next)
76                 if (ibuf->userflags & IB_BITMAPDIRTY)
77                         return 1;
78         
79         return 0;
80 }
81
82 static void rna_Image_source_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
83 {
84         Image *ima = ptr->id.data;
85         BKE_image_signal(ima, NULL, IMA_SIGNAL_SRC_CHANGE);
86         DAG_id_tag_update(&ima->id, 0);
87 }
88
89 static void rna_Image_fields_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
90 {
91         Image *ima = ptr->id.data;
92         ImBuf *ibuf;
93         void *lock;
94
95         ibuf = BKE_image_acquire_ibuf(ima, NULL, &lock);
96
97         if (ibuf) {
98                 short nr = 0;
99
100                 if (!(ima->flag & IMA_FIELDS) && (ibuf->flags & IB_fields)) nr = 1;
101                 if ((ima->flag & IMA_FIELDS) && !(ibuf->flags & IB_fields)) nr = 1;
102
103                 if (nr)
104                         BKE_image_signal(ima, NULL, IMA_SIGNAL_FREE);
105         }
106
107         BKE_image_release_ibuf(ima, lock);
108 }
109
110 static void rna_Image_free_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
111 {
112         Image *ima = ptr->id.data;
113         BKE_image_signal(ima, NULL, IMA_SIGNAL_FREE);
114         WM_main_add_notifier(NC_IMAGE|NA_EDITED, &ima->id);
115         DAG_id_tag_update(&ima->id, 0);
116 }
117
118
119 static void rna_Image_reload_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
120 {
121         Image *ima = ptr->id.data;
122         BKE_image_signal(ima, NULL, IMA_SIGNAL_RELOAD);
123         WM_main_add_notifier(NC_IMAGE|NA_EDITED, &ima->id);
124         DAG_id_tag_update(&ima->id, 0);
125 }
126
127 static void rna_Image_generated_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
128 {
129         Image *ima = ptr->id.data;
130         BKE_image_signal(ima, NULL, IMA_SIGNAL_FREE);
131 }
132
133 static void rna_ImageUser_update(Main *UNUSED(bmain), Scene *scene, PointerRNA *ptr)
134 {
135         ImageUser *iuser = ptr->data;
136
137         BKE_image_user_frame_calc(iuser, scene->r.cfra, 0);
138 }
139
140
141 char *rna_ImageUser_path(PointerRNA *ptr)
142 {
143         if (ptr->id.data) {
144                 /* ImageUser *iuser= ptr->data; */
145                 
146                 switch (GS(((ID *)ptr->id.data)->name)) {
147                 case ID_TE:
148                         return BLI_strdup("image_user");
149                 }
150         }
151         
152         return BLI_strdup("");
153 }
154
155 static EnumPropertyItem *rna_Image_source_itemf(bContext *UNUSED(C), PointerRNA *ptr,
156                                                 PropertyRNA *UNUSED(prop), int *free)
157 {
158         Image *ima = (Image*)ptr->data;
159         EnumPropertyItem *item = NULL;
160         int totitem = 0;
161         
162         if (ima->source == IMA_SRC_VIEWER) {
163                 RNA_enum_items_add_value(&item, &totitem, image_source_items, IMA_SRC_VIEWER);
164         }
165         else {
166                 RNA_enum_items_add_value(&item, &totitem, image_source_items, IMA_SRC_FILE);
167                 RNA_enum_items_add_value(&item, &totitem, image_source_items, IMA_SRC_SEQUENCE);
168                 RNA_enum_items_add_value(&item, &totitem, image_source_items, IMA_SRC_MOVIE);
169                 RNA_enum_items_add_value(&item, &totitem, image_source_items, IMA_SRC_GENERATED);
170         }
171
172         RNA_enum_item_end(&item, &totitem);
173         *free = 1;
174
175         return item;
176 }
177
178 static int rna_Image_file_format_get(PointerRNA *ptr)
179 {
180         Image *image = (Image*)ptr->data;
181         ImBuf *ibuf = BKE_image_get_ibuf(image, NULL);
182         return BKE_ftype_to_imtype(ibuf ? ibuf->ftype : 0);
183 }
184
185 static void rna_Image_file_format_set(PointerRNA *ptr, int value)
186 {
187         Image *image = (Image*)ptr->data;
188         if (BKE_imtype_is_movie(value) == 0) { /* should be able to throw an error here */
189                 ImBuf *ibuf;
190                 int ftype = BKE_imtype_to_ftype(value);
191
192 #if 0
193                 ibuf= BKE_image_get_ibuf(image, NULL);
194                 if (ibuf)
195                         ibuf->ftype= ftype;
196 #endif
197
198                 /* to be safe change all buffer file types */
199                 for (ibuf = image->ibufs.first; ibuf; ibuf = ibuf->next) {
200                         ibuf->ftype = ftype;
201                 }
202         }
203 }
204
205 static int rna_Image_has_data_get(PointerRNA *ptr)
206 {
207         Image *im = (Image*)ptr->data;
208
209         if (im->ibufs.first)
210                 return 1;
211
212         return 0;
213 }
214
215 static void rna_Image_size_get(PointerRNA *ptr, int *values)
216 {
217         Image *im = (Image*)ptr->data;
218         ImBuf *ibuf;
219         void *lock;
220
221         ibuf = BKE_image_acquire_ibuf(im, NULL, &lock);
222         if (ibuf) {
223                 values[0] = ibuf->x;
224                 values[1] = ibuf->y;
225         }
226         else {
227                 values[0] = 0;
228                 values[1] = 0;
229         }
230
231         BKE_image_release_ibuf(im, lock);
232 }
233
234 static void rna_Image_resolution_get(PointerRNA *ptr, float *values)
235 {
236         Image *im = (Image*)ptr->data;
237         ImBuf *ibuf;
238         void *lock;
239
240         ibuf = BKE_image_acquire_ibuf(im, NULL, &lock);
241         if (ibuf) {
242                 values[0] = ibuf->ppm[0];
243                 values[1] = ibuf->ppm[1];
244         }
245         else {
246                 values[0] = 0;
247                 values[1] = 0;
248         }
249
250         BKE_image_release_ibuf(im, lock);
251 }
252
253 static void rna_Image_resolution_set(PointerRNA *ptr, const float *values)
254 {
255         Image *im = (Image*)ptr->data;
256         ImBuf *ibuf;
257         void *lock;
258
259         ibuf = BKE_image_acquire_ibuf(im, NULL, &lock);
260         if (ibuf) {
261                 ibuf->ppm[0] = values[0];
262                 ibuf->ppm[1] = values[1];
263         }
264
265         BKE_image_release_ibuf(im, lock);
266 }
267
268 static int rna_Image_depth_get(PointerRNA *ptr)
269 {
270         Image *im = (Image*)ptr->data;
271         ImBuf *ibuf;
272         void *lock;
273         int planes;
274         
275         ibuf = BKE_image_acquire_ibuf(im, NULL, &lock);
276
277         if (!ibuf)
278                 planes = 0;
279         else if (ibuf->rect_float)
280                 planes = ibuf->planes * 4;
281         else
282                 planes = ibuf->planes;
283
284         BKE_image_release_ibuf(im, lock);
285
286         return planes;
287 }
288
289 static int rna_Image_pixels_get_length(PointerRNA *ptr, int length[RNA_MAX_ARRAY_DIMENSION])
290 {
291         Image *ima = ptr->id.data;
292         ImBuf *ibuf;
293         void *lock;
294
295         ibuf = BKE_image_acquire_ibuf(ima, NULL, &lock);
296
297         if (ibuf)
298                 length[0] = ibuf->x*ibuf->y*ibuf->channels;
299         else
300                 length[0] = 0;
301
302         BKE_image_release_ibuf(ima, lock);
303
304         return length[0];
305 }
306
307 static void rna_Image_pixels_get(PointerRNA *ptr, float *values)
308 {
309         Image *ima = ptr->id.data;
310         ImBuf *ibuf;
311         void *lock;
312         int i, size;
313
314         ibuf = BKE_image_acquire_ibuf(ima, NULL, &lock);
315
316         if (ibuf) {
317                 size = ibuf->x*ibuf->y*ibuf->channels;
318
319                 if (ibuf->rect_float) {
320                         memcpy(values, ibuf->rect_float, sizeof(float)*size);
321                 }
322                 else {
323                         for (i = 0; i < size; i++)
324                                 values[i] = ((unsigned char*)ibuf->rect)[i]*(1.0f/255.0f);
325                 }
326         }
327
328         BKE_image_release_ibuf(ima, lock);
329 }
330
331 static void rna_Image_pixels_set(PointerRNA *ptr, const float *values)
332 {
333         Image *ima = ptr->id.data;
334         ImBuf *ibuf;
335         void *lock;
336         int i, size;
337
338         ibuf = BKE_image_acquire_ibuf(ima, NULL, &lock);
339
340         if (ibuf) {
341                 size = ibuf->x*ibuf->y*ibuf->channels;
342
343                 if (ibuf->rect_float) {
344                         memcpy(ibuf->rect_float, values, sizeof(float)*size);
345                 }
346                 else {
347                         for (i = 0; i < size; i++)
348                                 ((unsigned char*)ibuf->rect)[i] = FTOCHAR(values[i]);
349                 }
350
351                 ibuf->userflags |= IB_BITMAPDIRTY;
352         }
353
354         BKE_image_release_ibuf(ima, lock);
355 }
356
357 #else
358
359 static void rna_def_imageuser(BlenderRNA *brna)
360 {
361         StructRNA *srna;
362         PropertyRNA *prop;
363
364         srna = RNA_def_struct(brna, "ImageUser", NULL);
365         RNA_def_struct_ui_text(srna, "Image User",
366                                "Parameters defining how an Image datablock is used by another datablock");
367         RNA_def_struct_path_func(srna, "rna_ImageUser_path");
368
369         prop = RNA_def_property(srna, "use_auto_refresh", PROP_BOOLEAN, PROP_NONE);
370         RNA_def_property_boolean_sdna(prop, NULL, "flag", IMA_ANIM_ALWAYS);
371         RNA_def_property_ui_text(prop, "Auto Refresh", "Always refresh image on frame changes");
372         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
373
374         /* animation */
375         prop = RNA_def_property(srna, "use_cyclic", PROP_BOOLEAN, PROP_NONE);
376         RNA_def_property_boolean_sdna(prop, NULL, "cycl", 0);
377         RNA_def_property_ui_text(prop, "Cyclic", "Cycle the images in the movie");
378         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
379
380         prop = RNA_def_property(srna, "frame_duration", PROP_INT, PROP_NONE);
381         RNA_def_property_int_sdna(prop, NULL, "frames");
382         RNA_def_property_range(prop, 0, MAXFRAMEF);
383         RNA_def_property_ui_text(prop, "Frames", "Number of images of a movie to use");
384         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
385
386         prop = RNA_def_property(srna, "frame_offset", PROP_INT, PROP_NONE);
387         RNA_def_property_int_sdna(prop, NULL, "offset");
388         RNA_def_property_range(prop, MINAFRAMEF, MAXFRAMEF);
389         RNA_def_property_ui_text(prop, "Offset", "Offset the number of the frame to use in the animation");
390         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
391
392         prop = RNA_def_property(srna, "frame_start", PROP_INT, PROP_TIME);
393         RNA_def_property_int_sdna(prop, NULL, "sfra");
394         RNA_def_property_range(prop, MINAFRAMEF, MAXFRAMEF);
395         RNA_def_property_ui_text(prop, "Start Frame",
396                                  "Global starting frame of the movie/sequence, assuming first picture has a #1");
397         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
398
399         prop = RNA_def_property(srna, "fields_per_frame", PROP_INT, PROP_NONE);
400         RNA_def_property_int_sdna(prop, NULL, "fie_ima");
401         RNA_def_property_range(prop, 1, 200);
402         RNA_def_property_ui_text(prop, "Fields per Frame", "Number of fields per rendered frame (2 fields is 1 image)");
403         RNA_def_property_update(prop, 0, "rna_ImageUser_update");
404
405         prop = RNA_def_property(srna, "multilayer_layer", PROP_INT, PROP_UNSIGNED);
406         RNA_def_property_int_sdna(prop, NULL, "layer");
407         RNA_def_property_clear_flag(prop, PROP_EDITABLE); /* image_multi_cb */
408         RNA_def_property_ui_text(prop, "Layer", "Layer in multilayer image");
409
410         prop = RNA_def_property(srna, "multilayer_pass", PROP_INT, PROP_UNSIGNED);
411         RNA_def_property_int_sdna(prop, NULL, "pass");
412         RNA_def_property_clear_flag(prop, PROP_EDITABLE); /* image_multi_cb */
413         RNA_def_property_ui_text(prop, "Pass", "Pass in multilayer image");
414 }
415
416 static void rna_def_image(BlenderRNA *brna)
417 {
418         StructRNA *srna;
419         PropertyRNA *prop;
420         static const EnumPropertyItem prop_type_items[] = {
421                 {IMA_TYPE_IMAGE, "IMAGE", 0, "Image", ""},
422                 {IMA_TYPE_MULTILAYER, "MULTILAYER", 0, "Multilayer", ""},
423                 {IMA_TYPE_UV_TEST, "UV_TEST", 0, "UV Test", ""},
424                 {IMA_TYPE_R_RESULT, "RENDER_RESULT", 0, "Render Result", ""},
425                 {IMA_TYPE_COMPOSITE, "COMPOSITING", 0, "Compositing", ""},
426                 {0, NULL, 0, NULL, NULL}};
427         static const EnumPropertyItem prop_generated_type_items[] = {
428                 {0, "BLANK", 0, "Blank", "Generate a blank image"},
429                 {1, "UV_GRID", 0, "UV Grid", "Generated grid to test UV mappings"},
430                 {2, "COLOR_GRID", 0, "Color Grid", "Generated improved UV grid to test UV mappings"},
431                 {0, NULL, 0, NULL, NULL}};
432         static const EnumPropertyItem prop_mapping_items[] = {
433                 {0, "UV", 0, "UV Coordinates", "Use UV coordinates for mapping the image"},
434                 {IMA_REFLECT, "REFLECTION", 0, "Reflection", "Use reflection mapping for mapping the image"},
435                 {0, NULL, 0, NULL, NULL}};
436         static const EnumPropertyItem prop_field_order_items[] = {
437                 {0, "EVEN", 0, "Upper First", "Upper field first"},
438                 {IMA_STD_FIELD, "ODD", 0, "Lower First", "Lower field first"},
439                 {0, NULL, 0, NULL, NULL}};
440
441         srna = RNA_def_struct(brna, "Image", "ID");
442         RNA_def_struct_ui_text(srna, "Image", "Image datablock referencing an external or packed image");
443         RNA_def_struct_ui_icon(srna, ICON_IMAGE_DATA);
444
445         prop = RNA_def_property(srna, "filepath", PROP_STRING, PROP_FILEPATH);
446         RNA_def_property_string_sdna(prop, NULL, "name");
447         RNA_def_property_ui_text(prop, "File Name", "Image/Movie file name");
448         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_reload_update");
449
450         /* eek. this is horrible but needed so we can save to a new name without blanking the data :( */
451         prop = RNA_def_property(srna, "filepath_raw", PROP_STRING, PROP_FILEPATH);
452         RNA_def_property_string_sdna(prop, NULL, "name");
453         RNA_def_property_ui_text(prop, "File Name", "Image/Movie file name (without data refreshing)");
454
455         prop = RNA_def_property(srna, "file_format", PROP_ENUM, PROP_NONE);
456         RNA_def_property_enum_items(prop, image_type_items);
457         RNA_def_property_enum_funcs(prop, "rna_Image_file_format_get", "rna_Image_file_format_set", NULL);
458         RNA_def_property_ui_text(prop, "File Format", "Format used for re-saving this file");
459
460         prop = RNA_def_property(srna, "source", PROP_ENUM, PROP_NONE);
461         RNA_def_property_enum_items(prop, image_source_items);
462         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Image_source_itemf");
463         RNA_def_property_ui_text(prop, "Source", "Where the image comes from");
464         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_source_update");
465
466         prop = RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
467         RNA_def_property_enum_items(prop, prop_type_items);
468         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
469         RNA_def_property_ui_text(prop, "Type", "How to generate the image");
470         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
471
472         prop = RNA_def_property(srna, "packed_file", PROP_POINTER, PROP_NONE);
473         RNA_def_property_pointer_sdna(prop, NULL, "packedfile");
474         RNA_def_property_ui_text(prop, "Packed File", "");
475         
476         prop = RNA_def_property(srna, "field_order", PROP_ENUM, PROP_NONE);
477         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
478         RNA_def_property_enum_items(prop, prop_field_order_items);
479         RNA_def_property_ui_text(prop, "Field Order", "Order of video fields (select which lines are displayed first)");
480         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
481         
482         /* booleans */
483         prop = RNA_def_property(srna, "use_fields", PROP_BOOLEAN, PROP_NONE);
484         RNA_def_property_boolean_sdna(prop, NULL, "flag", IMA_FIELDS);
485         RNA_def_property_ui_text(prop, "Fields", "Use fields of the image");
486         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_fields_update");
487
488         prop = RNA_def_property(srna, "use_premultiply", PROP_BOOLEAN, PROP_NONE);
489         RNA_def_property_boolean_sdna(prop, NULL, "flag", IMA_DO_PREMUL);
490         RNA_def_property_ui_text(prop, "Premultiply", "Convert RGB from key alpha to premultiplied alpha");
491         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_free_update");
492         
493         prop = RNA_def_property(srna, "use_color_unpremultiply", PROP_BOOLEAN, PROP_NONE);
494         RNA_def_property_boolean_sdna(prop, NULL, "flag", IMA_CM_PREDIVIDE);
495         RNA_def_property_ui_text(prop, "Color Unpremultiply",
496                                  "For premultiplied alpha images, do color space conversion on colors without alpha, "
497                                  "to avoid fringing for images with light backgrounds");
498         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_free_update");
499
500         prop = RNA_def_property(srna, "is_dirty", PROP_BOOLEAN, PROP_NONE);
501         RNA_def_property_boolean_funcs(prop, "rna_Image_dirty_get", NULL);
502         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
503         RNA_def_property_ui_text(prop, "Dirty", "Image has changed and is not saved");
504
505         /* generated image (image_generated_change_cb) */
506         prop = RNA_def_property(srna, "generated_type", PROP_ENUM, PROP_NONE);
507         RNA_def_property_enum_sdna(prop, NULL, "gen_type");
508         RNA_def_property_enum_items(prop, prop_generated_type_items);
509         RNA_def_property_ui_text(prop, "Generated Type", "Generated image type");
510         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_generated_update");
511
512         prop = RNA_def_property(srna, "generated_width", PROP_INT, PROP_NONE);
513         RNA_def_property_int_sdna(prop, NULL, "gen_x");
514         RNA_def_property_range(prop, 1, 16384);
515         RNA_def_property_ui_text(prop, "Generated Width", "Generated image width");
516         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_generated_update");
517
518         prop = RNA_def_property(srna, "generated_height", PROP_INT, PROP_NONE);
519         RNA_def_property_int_sdna(prop, NULL, "gen_y");
520         RNA_def_property_range(prop, 1, 16384);
521         RNA_def_property_ui_text(prop, "Generated Height", "Generated image height");
522         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_generated_update");
523
524         prop = RNA_def_property(srna, "use_generated_float", PROP_BOOLEAN, PROP_NONE);
525         RNA_def_property_boolean_sdna(prop, NULL, "gen_flag", IMA_GEN_FLOAT);
526         RNA_def_property_ui_text(prop, "Float Buffer", "Generate floating point buffer");
527         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_generated_update");
528
529         /* realtime properties */
530         prop = RNA_def_property(srna, "mapping", PROP_ENUM, PROP_NONE);
531         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
532         RNA_def_property_enum_items(prop, prop_mapping_items);
533         RNA_def_property_ui_text(prop, "Mapping", "Mapping type to use for this image in the game engine");
534         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
535
536         prop = RNA_def_property(srna, "display_aspect", PROP_FLOAT, PROP_XYZ);
537         RNA_def_property_float_sdna(prop, NULL, "aspx");
538         RNA_def_property_array(prop, 2);
539         RNA_def_property_range(prop, 0.1f, 5000.0f);
540         RNA_def_property_ui_text(prop, "Display Aspect", "Display Aspect for this image, does not affect rendering");
541         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
542
543         prop = RNA_def_property(srna, "use_animation", PROP_BOOLEAN, PROP_NONE);
544         RNA_def_property_boolean_sdna(prop, NULL, "tpageflag", IMA_TWINANIM);
545         RNA_def_property_ui_text(prop, "Animated", "Use as animated texture in the game engine");
546         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_animated_update");
547
548         prop = RNA_def_property(srna, "frame_start", PROP_INT, PROP_NONE);
549         RNA_def_property_int_sdna(prop, NULL, "twsta");
550         RNA_def_property_range(prop, 0, 128);
551         RNA_def_property_ui_text(prop, "Animation Start", "Start frame of an animated texture");
552         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_animated_update");
553
554         prop = RNA_def_property(srna, "frame_end", PROP_INT, PROP_NONE);
555         RNA_def_property_int_sdna(prop, NULL, "twend");
556         RNA_def_property_range(prop, 0, 128);
557         RNA_def_property_ui_text(prop, "Animation End", "End frame of an animated texture");
558         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, "rna_Image_animated_update");
559
560         prop = RNA_def_property(srna, "fps", PROP_INT, PROP_NONE);
561         RNA_def_property_int_sdna(prop, NULL, "animspeed");
562         RNA_def_property_range(prop, 1, 100);
563         RNA_def_property_ui_text(prop, "Animation Speed", "Speed of the animation in frames per second");
564         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
565
566         prop = RNA_def_property(srna, "use_tiles", PROP_BOOLEAN, PROP_NONE);
567         RNA_def_property_boolean_sdna(prop, NULL, "tpageflag", IMA_TILES);
568         RNA_def_property_ui_text(prop, "Tiles",
569                                  "Use of tilemode for faces (default shift-LMB to pick the tile for selected faces)");
570         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
571
572         prop = RNA_def_property(srna, "tiles_x", PROP_INT, PROP_NONE);
573         RNA_def_property_int_sdna(prop, NULL, "xrep");
574         RNA_def_property_range(prop, 1, 16);
575         RNA_def_property_ui_text(prop, "Tiles X", "Degree of repetition in the X direction");
576         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
577
578         prop = RNA_def_property(srna, "tiles_y", PROP_INT, PROP_NONE);
579         RNA_def_property_int_sdna(prop, NULL, "yrep");
580         RNA_def_property_range(prop, 1, 16);
581         RNA_def_property_ui_text(prop, "Tiles Y", "Degree of repetition in the Y direction");
582         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
583
584         prop = RNA_def_property(srna, "use_clamp_x", PROP_BOOLEAN, PROP_NONE);
585         RNA_def_property_boolean_sdna(prop, NULL, "tpageflag", IMA_CLAMP_U);
586         RNA_def_property_ui_text(prop, "Clamp X", "Disable texture repeating horizontally");
587         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
588
589         prop = RNA_def_property(srna, "use_clamp_y", PROP_BOOLEAN, PROP_NONE);
590         RNA_def_property_boolean_sdna(prop, NULL, "tpageflag", IMA_CLAMP_V);
591         RNA_def_property_ui_text(prop, "Clamp Y", "Disable texture repeating vertically");
592         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
593
594         prop = RNA_def_property(srna, "bindcode", PROP_INT, PROP_UNSIGNED);
595         RNA_def_property_int_sdna(prop, NULL, "bindcode");
596         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
597         RNA_def_property_ui_text(prop, "Bindcode", "OpenGL bindcode");
598         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
599
600         prop = RNA_def_property(srna, "render_slot", PROP_INT, PROP_UNSIGNED);
601         RNA_def_property_range(prop, 0, IMA_MAX_RENDER_SLOT - 1);
602         RNA_def_property_ui_text(prop, "Render Slot", "The current render slot displayed, only for viewer type images");
603         RNA_def_property_update(prop, NC_IMAGE|ND_DISPLAY, NULL);
604
605         /*
606          * Image.has_data and Image.depth are temporary,
607          * Update import_obj.py when they are replaced (Arystan)
608          */
609         prop = RNA_def_property(srna, "has_data", PROP_BOOLEAN, PROP_NONE);
610         RNA_def_property_boolean_funcs(prop, "rna_Image_has_data_get", NULL);
611         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
612         RNA_def_property_ui_text(prop, "Has data", "True if this image has data");
613
614         prop = RNA_def_property(srna, "depth", PROP_INT, PROP_UNSIGNED);
615         RNA_def_property_int_funcs(prop, "rna_Image_depth_get", NULL, NULL);
616         RNA_def_property_ui_text(prop, "Depth", "Image bit depth");
617         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
618
619         prop = RNA_def_int_vector(srna, "size", 2, NULL, 0, 0, "Size",
620                                   "Width and height in pixels, zero when image data cant be loaded", 0, 0);
621         RNA_def_property_int_funcs(prop, "rna_Image_size_get", NULL, NULL);
622         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
623
624         prop = RNA_def_float_vector(srna, "resolution", 2, NULL, 0, 0, "Resolution", "X/Y pixels per meter", 0, 0);
625         RNA_def_property_float_funcs(prop, "rna_Image_resolution_get", "rna_Image_resolution_set", NULL);
626
627         prop = RNA_def_property(srna, "pixels", PROP_FLOAT, PROP_NONE);
628         RNA_def_property_flag(prop, PROP_DYNAMIC);
629         RNA_def_property_multi_array(prop, 1, NULL);
630         RNA_def_property_ui_text(prop, "Pixels", "Image pixels in floating point values");
631         RNA_def_property_dynamic_array_funcs(prop, "rna_Image_pixels_get_length");
632         RNA_def_property_float_funcs(prop, "rna_Image_pixels_get", "rna_Image_pixels_set", NULL);
633
634         RNA_api_image(srna);
635 }
636
637 void RNA_def_image(BlenderRNA *brna)
638 {
639         rna_def_image(brna);
640         rna_def_imageuser(brna);
641 }
642
643 #endif