a62658349c1359acaf00b82403d62a6b6b5bc91e
[blender.git] / source / blender / editors / interface / interface.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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * Contributor(s): Blender Foundation 2002-2008, full recode.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file blender/editors/interface/interface.c
29  *  \ingroup edinterface
30  */
31
32
33 #include <float.h>
34 #include <limits.h>
35 #include <math.h>
36 #include <string.h>
37 #include <ctype.h>
38  
39 #include "MEM_guardedalloc.h"
40
41 #include "DNA_scene_types.h"
42 #include "DNA_screen_types.h"
43 #include "DNA_userdef_types.h"
44
45 #include "BLI_math.h"
46 #include "BLI_blenlib.h"
47 #include "BLI_dynstr.h"
48 #include "BLI_utildefines.h"
49
50 #include "BKE_context.h"
51 #include "BKE_library.h"
52 #include "BKE_unit.h"
53 #include "BKE_utildefines.h" /* FILE_MAX */
54
55 #include "BIF_gl.h"
56
57 #include "BLF_api.h"
58 #include "BLF_translation.h"
59
60 #include "UI_interface.h"
61
62 #include "IMB_imbuf.h"
63
64 #include "WM_api.h"
65 #include "WM_types.h"
66 #include "wm_subwindow.h"
67 #include "wm_window.h"
68
69 #include "RNA_access.h"
70
71 #include "BPY_extern.h"
72
73 #include "interface_intern.h"
74
75 #define MENU_WIDTH                      120
76 #define MENU_ITEM_HEIGHT        20
77 #define MENU_SEP_HEIGHT         6
78
79 #define PRECISION_FLOAT_MAX 6
80 #define PRECISION_FLOAT_MAX_POW 1000000 /* pow(10, PRECISION_FLOAT_MAX)  */
81
82 /* avoid unneeded calls to ui_get_but_val */
83 #define UI_BUT_VALUE_UNSET DBL_MAX
84 #define UI_GET_BUT_VALUE_INIT(_but, _value) if(_value == DBL_MAX) {  (_value)= ui_get_but_val(_but); }
85
86 /* 
87  * a full doc with API notes can be found in bf-blender/trunk/blender/doc/guides/interface_API.txt
88  * 
89  * uiBlahBlah()         external function
90  * ui_blah_blah()       internal function
91  */
92
93 static void ui_free_but(const bContext *C, uiBut *but);
94
95 /* ************* translation ************** */
96
97 int UI_translate_iface(void)
98 {
99 #ifdef WITH_INTERNATIONAL
100         return (U.transopts & USER_DOTRANSLATE) && (U.transopts & USER_TR_IFACE);
101 #else
102         return 0;
103 #endif
104 }
105
106 int UI_translate_tooltips(void)
107 {
108 #ifdef WITH_INTERNATIONAL
109         return (U.transopts & USER_DOTRANSLATE) && (U.transopts & USER_TR_TOOLTIPS);
110 #else
111         return 0;
112 #endif
113 }
114
115 const char *UI_translate_do_iface(const char *msgid)
116 {
117 #ifdef WITH_INTERNATIONAL
118         if(UI_translate_iface())
119                 return BLF_gettext(msgid);
120         else
121                 return msgid;
122 #else
123         return msgid;
124 #endif
125 }
126
127 const char *UI_translate_do_tooltip(const char *msgid)
128 {
129 #ifdef WITH_INTERNATIONAL
130         if(UI_translate_tooltips())
131                 return BLF_gettext(msgid);
132         else
133                 return msgid;
134 #else
135         return msgid;
136 #endif
137 }
138
139 /* ************* window matrix ************** */
140
141 void ui_block_to_window_fl(const ARegion *ar, uiBlock *block, float *x, float *y)
142 {
143         float gx, gy;
144         int sx, sy, getsizex, getsizey;
145
146         getsizex= ar->winrct.xmax-ar->winrct.xmin+1;
147         getsizey= ar->winrct.ymax-ar->winrct.ymin+1;
148         sx= ar->winrct.xmin;
149         sy= ar->winrct.ymin;
150
151         gx= *x;
152         gy= *y;
153
154         if(block->panel) {
155                 gx += block->panel->ofsx;
156                 gy += block->panel->ofsy;
157         }
158
159         *x= ((float)sx) + ((float)getsizex)*(0.5f+ 0.5f*(gx*block->winmat[0][0]+ gy*block->winmat[1][0]+ block->winmat[3][0]));
160         *y= ((float)sy) + ((float)getsizey)*(0.5f+ 0.5f*(gx*block->winmat[0][1]+ gy*block->winmat[1][1]+ block->winmat[3][1]));
161 }
162
163 void ui_block_to_window(const ARegion *ar, uiBlock *block, int *x, int *y)
164 {
165         float fx, fy;
166
167         fx= *x;
168         fy= *y;
169
170         ui_block_to_window_fl(ar, block, &fx, &fy);
171
172         *x= (int)(fx+0.5f);
173         *y= (int)(fy+0.5f);
174 }
175
176 void ui_block_to_window_rct(const ARegion *ar, uiBlock *block, rctf *graph, rcti *winr)
177 {
178         rctf tmpr;
179
180         tmpr= *graph;
181         ui_block_to_window_fl(ar, block, &tmpr.xmin, &tmpr.ymin);
182         ui_block_to_window_fl(ar, block, &tmpr.xmax, &tmpr.ymax);
183
184         winr->xmin= tmpr.xmin;
185         winr->ymin= tmpr.ymin;
186         winr->xmax= tmpr.xmax;
187         winr->ymax= tmpr.ymax;
188 }
189
190 void ui_window_to_block_fl(const ARegion *ar, uiBlock *block, float *x, float *y)       /* for mouse cursor */
191 {
192         float a, b, c, d, e, f, px, py;
193         int sx, sy, getsizex, getsizey;
194
195         getsizex= ar->winrct.xmax-ar->winrct.xmin+1;
196         getsizey= ar->winrct.ymax-ar->winrct.ymin+1;
197         sx= ar->winrct.xmin;
198         sy= ar->winrct.ymin;
199
200         a= 0.5f*((float)getsizex)*block->winmat[0][0];
201         b= 0.5f*((float)getsizex)*block->winmat[1][0];
202         c= 0.5f*((float)getsizex)*(1.0f+block->winmat[3][0]);
203
204         d= 0.5f*((float)getsizey)*block->winmat[0][1];
205         e= 0.5f*((float)getsizey)*block->winmat[1][1];
206         f= 0.5f*((float)getsizey)*(1.0f+block->winmat[3][1]);
207
208         px= *x - sx;
209         py= *y - sy;
210
211         *y=  (a*(py-f) + d*(c-px))/(a*e-d*b);
212         *x= (px- b*(*y)- c)/a;
213
214         if(block->panel) {
215                 *x -= block->panel->ofsx;
216                 *y -= block->panel->ofsy;
217         }
218 }
219
220 void ui_window_to_block(const ARegion *ar, uiBlock *block, int *x, int *y)
221 {
222         float fx, fy;
223
224         fx= *x;
225         fy= *y;
226
227         ui_window_to_block_fl(ar, block, &fx, &fy);
228
229         *x= (int)(fx+0.5f);
230         *y= (int)(fy+0.5f);
231 }
232
233 void ui_window_to_region(const ARegion *ar, int *x, int *y)
234 {
235         *x-= ar->winrct.xmin;
236         *y-= ar->winrct.ymin;
237 }
238
239 /* ******************* block calc ************************* */
240
241 void ui_block_translate(uiBlock *block, int x, int y)
242 {
243         uiBut *bt;
244
245         for(bt= block->buttons.first; bt; bt=bt->next) {
246                 bt->x1 += x;
247                 bt->y1 += y;
248                 bt->x2 += x;
249                 bt->y2 += y;
250         }
251
252         block->minx += x;
253         block->miny += y;
254         block->maxx += x;
255         block->maxy += y;
256 }
257
258 static void ui_text_bounds_block(uiBlock *block, float offset)
259 {
260         uiStyle *style=UI_GetStyle();
261         uiBut *bt;
262         int i = 0, j, x1addval= offset, nextcol;
263         int lastcol= 0, col= 0;
264         
265         uiStyleFontSet(&style->widget);
266         
267         for(bt= block->buttons.first; bt; bt= bt->next) {
268                 if(bt->type!=SEPR) {
269                         j= BLF_width(style->widget.uifont_id, bt->drawstr);
270
271                         if(j > i) i = j;
272                 }
273
274                 if(bt->next && bt->x1 < bt->next->x1)
275                         lastcol++;
276         }
277
278         /* cope with multi collumns */
279         bt= block->buttons.first;
280         while(bt) {
281                 if(bt->next && bt->x1 < bt->next->x1) {
282                         nextcol= 1;
283                         col++;
284                 }
285                 else nextcol= 0;
286                 
287                 bt->x1 = x1addval;
288                 bt->x2 = bt->x1 + i + block->bounds;
289                 
290                 if(col == lastcol)
291                         bt->x2= MAX2(bt->x2, offset + block->minbounds);
292
293                 ui_check_but(bt);       // clips text again
294                 
295                 if(nextcol)
296                         x1addval+= i + block->bounds;
297                 
298                 bt= bt->next;
299         }
300 }
301
302 void ui_bounds_block(uiBlock *block)
303 {
304         uiBut *bt;
305         int xof;
306         
307         if(block->buttons.first==NULL) {
308                 if(block->panel) {
309                         block->minx= 0.0; block->maxx= block->panel->sizex;
310                         block->miny= 0.0; block->maxy= block->panel->sizey;
311                 }
312         }
313         else {
314         
315                 block->minx= block->miny= 10000;
316                 block->maxx= block->maxy= -10000;
317                 
318                 bt= block->buttons.first;
319                 while(bt) {
320                         if(bt->x1 < block->minx) block->minx= bt->x1;
321                         if(bt->y1 < block->miny) block->miny= bt->y1;
322         
323                           if(bt->x2 > block->maxx) block->maxx= bt->x2;
324                         if(bt->y2 > block->maxy) block->maxy= bt->y2;
325
326                         bt= bt->next;
327                 }
328                 
329                 block->minx -= block->bounds;
330                 block->miny -= block->bounds;
331                 block->maxx += block->bounds;
332                 block->maxy += block->bounds;
333         }
334
335         block->maxx= block->minx + MAX2(block->maxx - block->minx, block->minbounds);
336
337         /* hardcoded exception... but that one is annoying with larger safety */ 
338         bt= block->buttons.first;
339         if(bt && strncmp(bt->str, "ERROR", 5)==0) xof= 10;
340         else xof= 40;
341         
342         block->safety.xmin= block->minx-xof;
343         block->safety.ymin= block->miny-xof;
344         block->safety.xmax= block->maxx+xof;
345         block->safety.ymax= block->maxy+xof;
346 }
347
348 static void ui_centered_bounds_block(const bContext *C, uiBlock *block)
349 {
350         wmWindow *window= CTX_wm_window(C);
351         int xmax, ymax;
352         int startx, starty;
353         int width, height;
354         
355         /* note: this is used for the splash where window bounds event has not been
356          * updated by ghost, get the window bounds from ghost directly */
357
358         // wm_window_get_size(window, &xmax, &ymax);
359         wm_window_get_size_ghost(window, &xmax, &ymax);
360         
361         ui_bounds_block(block);
362         
363         width= block->maxx - block->minx;
364         height= block->maxy - block->miny;
365         
366         startx = (xmax * 0.5f) - (width * 0.5f);
367         starty = (ymax * 0.5f) - (height * 0.5f);
368         
369         ui_block_translate(block, startx - block->minx, starty - block->miny);
370         
371         /* now recompute bounds and safety */
372         ui_bounds_block(block);
373         
374 }
375 static void ui_popup_bounds_block(const bContext *C, uiBlock *block, int bounds_calc)
376 {
377         wmWindow *window= CTX_wm_window(C);
378         int startx, starty, endx, endy, width, height, oldwidth, oldheight;
379         int oldbounds, xmax, ymax;
380
381         oldbounds= block->bounds;
382
383         /* compute mouse position with user defined offset */
384         ui_bounds_block(block);
385         
386         wm_window_get_size(window, &xmax, &ymax);
387
388         oldwidth= block->maxx - block->minx;
389         oldheight= block->maxy - block->miny;
390
391         /* first we ensure wide enough text bounds */
392         if(bounds_calc==UI_BLOCK_BOUNDS_POPUP_MENU) {
393                 if(block->flag & UI_BLOCK_LOOP) {
394                         block->bounds= 50;
395                         ui_text_bounds_block(block, block->minx);
396                 }
397         }
398
399         /* next we recompute bounds */
400         block->bounds= oldbounds;
401         ui_bounds_block(block);
402
403         /* and we adjust the position to fit within window */
404         width= block->maxx - block->minx;
405         height= block->maxy - block->miny;
406
407         /* avoid divide by zero below, caused by calling with no UI, but better not crash */
408         oldwidth= oldwidth > 0 ? oldwidth : MAX2(1, width);
409         oldheight= oldheight > 0 ? oldheight : MAX2(1, height);
410
411         /* offset block based on mouse position, user offset is scaled
412            along in case we resized the block in ui_text_bounds_block */
413         startx= window->eventstate->x + block->minx + (block->mx*width)/oldwidth;
414         starty= window->eventstate->y + block->miny + (block->my*height)/oldheight;
415
416         if(startx<10)
417                 startx= 10;
418         if(starty<10)
419                 starty= 10;
420         
421         endx= startx+width;
422         endy= starty+height;
423         
424         if(endx>xmax) {
425                 endx= xmax-10;
426                 startx= endx-width;
427         }
428         if(endy>ymax-20) {
429                 endy= ymax-20;
430                 starty= endy-height;
431         }
432
433         ui_block_translate(block, startx - block->minx, starty - block->miny);
434
435         /* now recompute bounds and safety */
436         ui_bounds_block(block);
437 }
438
439 /* used for various cases */
440 void uiBoundsBlock(uiBlock *block, int addval)
441 {
442         if(block==NULL)
443                 return;
444         
445         block->bounds= addval;
446         block->dobounds= UI_BLOCK_BOUNDS;
447 }
448
449 /* used for pulldowns */
450 void uiTextBoundsBlock(uiBlock *block, int addval)
451 {
452         block->bounds= addval;
453         block->dobounds= UI_BLOCK_BOUNDS_TEXT;
454 }
455
456 /* used for block popups */
457 void uiPopupBoundsBlock(uiBlock *block, int addval, int mx, int my)
458 {
459         block->bounds= addval;
460         block->dobounds= UI_BLOCK_BOUNDS_POPUP_MOUSE;
461         block->mx= mx;
462         block->my= my;
463 }
464
465 /* used for menu popups */
466 void uiMenuPopupBoundsBlock(uiBlock *block, int addval, int mx, int my)
467 {
468         block->bounds= addval;
469         block->dobounds= UI_BLOCK_BOUNDS_POPUP_MENU;
470         block->mx= mx;
471         block->my= my;
472 }
473
474 /* used for centered popups, i.e. splash */
475 void uiCenteredBoundsBlock(uiBlock *block, int addval)
476 {
477         block->bounds= addval;
478         block->dobounds= UI_BLOCK_BOUNDS_POPUP_CENTER;
479 }
480
481 /* ************** LINK LINE DRAWING  ************* */
482
483 /* link line drawing is not part of buttons or theme.. so we stick with it here */
484
485 static int ui_but_float_precision(uiBut *but, double value)
486 {
487         int prec;
488
489         /* first check if prec is 0 and fallback to a simple default */
490         if((prec= (int)but->a2) == 0) {
491                 prec= (but->hardmax < 10.001f) ? 3 : 2;
492         }
493
494         /* check on the number of decimal places neede to display
495          * the number, this is so 0.00001 is not displayed as 0.00,
496          * _but_, this is only for small values si 10.0001 will not get
497          * the same treatment */
498         if(value != 0.0 && (value= ABS(value)) < 0.1) {
499                 int value_i= (int)((value * PRECISION_FLOAT_MAX_POW) + 0.5);
500                 if(value_i != 0) {
501                         const int prec_span= 3; /* show: 0.01001, 5 would allow 0.0100001 for eg. */
502                         int test_prec;
503                         int prec_min= -1;
504                         int dec_flag= 0;
505                         int i= PRECISION_FLOAT_MAX;
506                         while(i && value_i) {
507                                 if(value_i % 10) {
508                                         dec_flag |= 1<<i;
509                                         prec_min= i;
510                                 }
511                                 value_i /= 10;
512                                 i--;
513                         }
514
515                         /* even though its a small value, if the second last digit is not 0, use it */
516                         test_prec = prec_min;
517
518                         dec_flag= (dec_flag >> (prec_min + 1)) & ((1 << prec_span) - 1);
519
520                         while(dec_flag) {
521                                 test_prec++;
522                                 dec_flag = dec_flag >> 1;
523                         }
524
525                         if(test_prec > prec) {
526                                 prec= test_prec;
527                         }
528                 }
529         }
530
531         CLAMP(prec, 1, PRECISION_FLOAT_MAX);
532
533         return prec;
534 }
535
536 static void ui_draw_linkline(uiLinkLine *line)
537 {
538         rcti rect;
539
540         if(line->from==NULL || line->to==NULL) return;
541         
542         rect.xmin= (line->from->x1+line->from->x2)/2.0f;
543         rect.ymin= (line->from->y1+line->from->y2)/2.0f;
544         rect.xmax= (line->to->x1+line->to->x2)/2.0f;
545         rect.ymax= (line->to->y1+line->to->y2)/2.0f;
546         
547         if(line->flag & UI_SELECT) 
548                 glColor3ub(100,100,100);
549         else 
550                 glColor3ub(0,0,0);
551
552         ui_draw_link_bezier(&rect);
553 }
554
555 static void ui_draw_links(uiBlock *block)
556 {
557         uiBut *but;
558         uiLinkLine *line;
559         
560         but= block->buttons.first;
561         while(but) {
562                 if(but->type==LINK && but->link) {
563                         line= but->link->lines.first;
564                         while(line) {
565                                 ui_draw_linkline(line);
566                                 line= line->next;
567                         }
568                 }
569                 but= but->next;
570         }       
571 }
572
573 /* ************** BLOCK ENDING FUNCTION ************* */
574
575 /* NOTE: if but->poin is allocated memory for every defbut, things fail... */
576 static int ui_but_equals_old(uiBut *but, uiBut *oldbut)
577 {
578         /* various properties are being compared here, hopfully sufficient
579          * to catch all cases, but it is simple to add more checks later */
580         if(but->retval != oldbut->retval) return 0;
581         if(but->rnapoin.data != oldbut->rnapoin.data) return 0;
582         if(but->rnaprop != oldbut->rnaprop)
583                 if(but->rnaindex != oldbut->rnaindex) return 0;
584         if(but->func != oldbut->func) return 0;
585         if(but->funcN != oldbut->funcN) return 0;
586         if(oldbut->func_arg1 != oldbut && but->func_arg1 != oldbut->func_arg1) return 0;
587         if(oldbut->func_arg2 != oldbut && but->func_arg2 != oldbut->func_arg2) return 0;
588         if(!but->funcN && ((but->poin != oldbut->poin && (uiBut*)oldbut->poin != oldbut) || but->pointype != oldbut->pointype)) return 0;
589         if(but->optype != oldbut->optype) return 0;
590
591         return 1;
592 }
593
594 /* oldbut is being inserted in new block, so we use the lines from new button, and replace button pointers */
595 static void ui_but_update_linklines(uiBlock *block, uiBut *oldbut, uiBut *newbut)
596 {
597         uiLinkLine *line;
598         uiBut *but;
599         
600         /* if active button is LINK */
601         if(newbut->type==LINK && newbut->link) {
602                 
603                 SWAP(uiLink *, oldbut->link, newbut->link);
604                 
605                 for(line= oldbut->link->lines.first; line; line= line->next) {
606                         if(line->to==newbut)
607                                 line->to= oldbut;
608                         if(line->from==newbut)
609                                 line->from= oldbut;
610                 }
611         }               
612         
613         /* check all other button links */
614         for(but= block->buttons.first; but; but= but->next) {
615                 if(but!=newbut && but->type==LINK && but->link) {
616                         for(line= but->link->lines.first; line; line= line->next) {
617                                 if(line->to==newbut)
618                                         line->to= oldbut;
619                                 if(line->from==newbut)
620                                         line->from= oldbut;
621                         }
622                 }
623         }
624 }
625
626 static int ui_but_update_from_old_block(const bContext *C, uiBlock *block, uiBut **butpp)
627 {
628         uiBlock *oldblock;
629         uiBut *oldbut, *but= *butpp;
630         int found= 0;
631
632         oldblock= block->oldblock;
633         if(!oldblock)
634                 return found;
635
636         for(oldbut=oldblock->buttons.first; oldbut; oldbut=oldbut->next) {
637                 if(ui_but_equals_old(oldbut, but)) {
638                         if(oldbut->active) {
639 #if 0
640 //                              but->flag= oldbut->flag;
641 #else
642                                 /* exception! redalert flag can't be update from old button. 
643                                  * perhaps it should only copy spesific flags rather than all. */
644 //                              but->flag= (oldbut->flag & ~UI_BUT_REDALERT) | (but->flag & UI_BUT_REDALERT);
645 #endif
646 //                              but->active= oldbut->active;
647 //                              but->pos= oldbut->pos;
648 //                              but->ofs= oldbut->ofs;
649 //                              but->editstr= oldbut->editstr;
650 //                              but->editval= oldbut->editval;
651 //                              but->editvec= oldbut->editvec;
652 //                              but->editcoba= oldbut->editcoba;
653 //                              but->editcumap= oldbut->editcumap;
654 //                              but->selsta= oldbut->selsta;
655 //                              but->selend= oldbut->selend;
656 //                              but->softmin= oldbut->softmin;
657 //                              but->softmax= oldbut->softmax;
658 //                              but->linkto[0]= oldbut->linkto[0];
659 //                              but->linkto[1]= oldbut->linkto[1];
660                                 found= 1;
661 //                              oldbut->active= NULL;
662                         
663                                 /* move button over from oldblock to new block */
664                                 BLI_remlink(&oldblock->buttons, oldbut);
665                                 BLI_insertlink(&block->buttons, but, oldbut);
666                                 oldbut->block= block;
667                                 *butpp= oldbut;
668                                 
669                                 /* still stuff needs to be copied */
670                                 oldbut->x1= but->x1; oldbut->y1= but->y1;
671                                 oldbut->x2= but->x2; oldbut->y2= but->y2;
672                                 oldbut->context= but->context; /* set by Layout */
673                                 
674                                 /* typically the same pointers, but not on undo/redo */
675                                 /* XXX some menu buttons store button itself in but->poin. Ugly */
676                                 if(oldbut->poin != (char *)oldbut) {
677                                         SWAP(char *, oldbut->poin, but->poin)
678                                         SWAP(void *, oldbut->func_argN, but->func_argN)
679                                 }
680                                 
681                                 /* copy hardmin for list rows to prevent 'sticking' highlight to mouse position
682                                    when scrolling without moving mouse (see [#28432]) */
683                                 if(ELEM(oldbut->type, ROW, LISTROW))
684                                         oldbut->hardmax= but->hardmax;
685                                 
686                                 ui_but_update_linklines(block, oldbut, but);
687                                 
688                                 BLI_remlink(&block->buttons, but);
689                                 ui_free_but(C, but);
690                                 
691                                 /* note: if layout hasn't been applied yet, it uses old button pointers... */
692                         }
693                         else {
694                                 /* ensures one button can get activated, and in case the buttons
695                                  * draw are the same this gives O(1) lookup for each button */
696                                 BLI_remlink(&oldblock->buttons, oldbut);
697                                 ui_free_but(C, oldbut);
698                         }
699                         
700                         break;
701                 }
702         }
703         
704         return found;
705 }
706
707 /* needed for temporarily rename buttons, such as in outliner or fileselect,
708    they should keep calling uiDefButs to keep them alive */
709 /* returns 0 when button removed */
710 int uiButActiveOnly(const bContext *C, uiBlock *block, uiBut *but)
711 {
712         uiBlock *oldblock;
713         uiBut *oldbut;
714         int activate= 0, found= 0, isactive= 0;
715         
716         oldblock= block->oldblock;
717         if(!oldblock)
718                 activate= 1;
719         else {
720                 for(oldbut=oldblock->buttons.first; oldbut; oldbut=oldbut->next) {
721                         if(ui_but_equals_old(oldbut, but)) {
722                                 found= 1;
723                                 
724                                 if(oldbut->active)
725                                         isactive= 1;
726                                 
727                                 break;
728                         }
729                 }
730         }
731         if(activate || found==0) {
732                 ui_button_activate_do( (bContext *)C, CTX_wm_region(C), but);
733         }
734         else if(found && isactive==0) {
735                 
736                 BLI_remlink(&block->buttons, but);
737                 ui_free_but(C, but);
738                 return 0;
739         }
740         
741         return 1;
742 }
743
744 /* use to check if we need to disable undo, but dont make any changes
745  * returns FALSE if undo needs to be disabled. */
746 static int ui_but_is_rna_undo(uiBut *but)
747 {
748         if(but->rnapoin.id.data) {
749                 /* avoid undo push for buttons who's ID are screen or wm level
750                  * we could disable undo for buttons with no ID too but may have
751                  * unforseen conciquences, so best check for ID's we _know_ are not
752                  * handled by undo - campbell */
753                 ID *id= but->rnapoin.id.data;
754                 if(ID_CHECK_UNDO(id) == FALSE) {
755                         return FALSE;
756                 }
757                 else {
758                         return TRUE;
759                 }
760         }
761
762         return TRUE;
763 }
764
765 /* assigns automatic keybindings to menu items for fast access
766  * (underline key in menu) */
767 static void ui_menu_block_set_keyaccels(uiBlock *block)
768 {
769         uiBut *but;
770
771         unsigned int meny_key_mask= 0;
772         unsigned char menu_key;
773         const char *str_pt;
774         int pass;
775         int tot_missing= 0;
776
777         /* only do it before bounding */
778         if(block->minx != block->maxx)
779                 return;
780
781         for(pass=0; pass<2; pass++) {
782                 /* 2 Passes, on for first letter only, second for any letter if first fails
783                  * fun first pass on all buttons so first word chars always get first priority */
784
785                 for(but=block->buttons.first; but; but=but->next) {
786                         if(!ELEM4(but->type, BUT, MENU, BLOCK, PULLDOWN) || (but->flag & UI_HIDDEN)) {
787                                 /* pass */
788                         }
789                         else if(but->menu_key=='\0') {
790                                 if(but->str) {
791                                         for(str_pt= but->str; *str_pt; ) {
792                                                 menu_key= tolower(*str_pt);
793                                                 if((menu_key >= 'a' && menu_key <= 'z') && !(meny_key_mask & 1<<(menu_key-'a'))) {
794                                                         meny_key_mask |= 1<<(menu_key-'a');
795                                                         break;
796                                                 }
797
798                                                 if(pass==0) {
799                                                         /* Skip to next delimeter on first pass (be picky) */
800                                                         while(isalpha(*str_pt))
801                                                                 str_pt++;
802
803                                                         if(*str_pt)
804                                                                 str_pt++;
805                                                 }
806                                                 else {
807                                                         /* just step over every char second pass and find first usable key */
808                                                         str_pt++;
809                                                 }
810                                         }
811
812                                         if(*str_pt) {
813                                                 but->menu_key= menu_key;
814                                         }
815                                         else {
816                                                 /* run second pass */
817                                                 tot_missing++;
818                                         }
819
820                                         /* if all keys have been used just exit, unlikely */
821                                         if(meny_key_mask == (1<<26)-1) {
822                                                 return;
823                                         }
824                                 }
825                         }
826                 }
827
828                 /* check if second pass is needed */
829                 if(!tot_missing) {
830                         break;
831                 }
832         }
833 }
834
835
836 static void ui_menu_block_set_keymaps(const bContext *C, uiBlock *block)
837 {
838         uiBut *but;
839         IDProperty *prop;
840         char buf[512];
841
842         /* only do it before bounding */
843         if(block->minx != block->maxx)
844                 return;
845
846         for(but=block->buttons.first; but; but=but->next) {
847                 if(but->optype) {
848                         prop= (but->opptr)? but->opptr->data: NULL;
849
850                         if(WM_key_event_operator_string(C, but->optype->idname, but->opcontext, prop, buf, sizeof(buf))) {
851                                 char *butstr_orig= BLI_strdup(but->str);
852                                 BLI_snprintf(but->strdata, sizeof(but->strdata), "%s|%s", butstr_orig, buf);
853                                 MEM_freeN(butstr_orig);
854                                 but->str= but->strdata;
855                                 ui_check_but(but);
856                         }
857                 }
858         }
859 }
860
861 void uiEndBlock(const bContext *C, uiBlock *block)
862 {
863         uiBut *but;
864         Scene *scene= CTX_data_scene(C);
865
866         /* inherit flags from 'old' buttons that was drawn here previous, based
867          * on matching buttons, we need this to make button event handling non
868          * blocking, while still alowing buttons to be remade each redraw as it
869          * is expected by blender code */
870         for(but=block->buttons.first; but; but=but->next) {
871                 if(ui_but_update_from_old_block(C, block, &but))
872                         ui_check_but(but);
873                 
874                 /* temp? Proper check for greying out */
875                 if(but->optype) {
876                         wmOperatorType *ot= but->optype;
877
878                         if(but->context)
879                                 CTX_store_set((bContext*)C, but->context);
880
881                         if(ot == NULL || WM_operator_poll_context((bContext*)C, ot, but->opcontext)==0) {
882                                 but->flag |= UI_BUT_DISABLED;
883                                 but->lock = 1;
884                         }
885
886                         if(but->context)
887                                 CTX_store_set((bContext*)C, NULL);
888                 }
889
890                 ui_but_anim_flag(but, (scene)? scene->r.cfra: 0.0f);
891         }
892
893         if(block->oldblock) {
894                 block->auto_open= block->oldblock->auto_open;
895                 block->auto_open_last= block->oldblock->auto_open_last;
896                 block->tooltipdisabled= block->oldblock->tooltipdisabled;
897
898                 block->oldblock= NULL;
899         }
900
901         /* handle pending stuff */
902         if(block->layouts.first) uiBlockLayoutResolve(block, NULL, NULL);
903         ui_block_do_align(block);
904         if((block->flag & UI_BLOCK_LOOP) && (block->flag & UI_BLOCK_NUMSELECT)) ui_menu_block_set_keyaccels(block); /* could use a different flag to check */
905         if(block->flag & UI_BLOCK_LOOP) ui_menu_block_set_keymaps(C, block);
906         
907         /* after keymaps! */
908         if(block->dobounds == UI_BLOCK_BOUNDS) ui_bounds_block(block);
909         else if(block->dobounds == UI_BLOCK_BOUNDS_TEXT) ui_text_bounds_block(block, 0.0f);
910         else if(block->dobounds == UI_BLOCK_BOUNDS_POPUP_CENTER) ui_centered_bounds_block(C, block);
911         else if(block->dobounds) ui_popup_bounds_block(C, block, block->dobounds);
912
913         if(block->minx==0.0f && block->maxx==0.0f) uiBoundsBlock(block, 0);
914         if(block->flag & UI_BUT_ALIGN) uiBlockEndAlign(block);
915
916         block->endblock= 1;
917 }
918
919 /* ************** BLOCK DRAWING FUNCTION ************* */
920
921 void ui_fontscale(short *points, float aspect)
922 {
923         if(aspect < 0.9f || aspect > 1.1f) {
924                 float pointsf= *points;
925                 
926                 /* for some reason scaling fonts goes too fast compared to widget size */
927                 aspect= sqrt(aspect);
928                 pointsf /= aspect;
929                 
930                 if(aspect > 1.0f)
931                         *points= ceilf(pointsf);
932                 else
933                         *points= floorf(pointsf);
934         }
935 }
936
937 /* project button or block (but==NULL) to pixels in regionspace */
938 static void ui_but_to_pixelrect(rcti *rect, const ARegion *ar, uiBlock *block, uiBut *but)
939 {
940         float gx, gy;
941         float getsizex, getsizey;
942         
943         getsizex= ar->winx;
944         getsizey= ar->winy;
945
946         gx= (but?but->x1:block->minx) + (block->panel?block->panel->ofsx:0.0f);
947         gy= (but?but->y1:block->miny) + (block->panel?block->panel->ofsy:0.0f);
948         
949         rect->xmin= floorf(getsizex*(0.5f+ 0.5f*(gx*block->winmat[0][0]+ gy*block->winmat[1][0]+ block->winmat[3][0])));
950         rect->ymin= floorf(getsizey*(0.5f+ 0.5f*(gx*block->winmat[0][1]+ gy*block->winmat[1][1]+ block->winmat[3][1])));
951         
952         gx= (but?but->x2:block->maxx) + (block->panel?block->panel->ofsx:0.0f);
953         gy= (but?but->y2:block->maxy) + (block->panel?block->panel->ofsy:0.0f);
954         
955         rect->xmax= floorf(getsizex*(0.5f+ 0.5f*(gx*block->winmat[0][0]+ gy*block->winmat[1][0]+ block->winmat[3][0])));
956         rect->ymax= floorf(getsizey*(0.5f+ 0.5f*(gx*block->winmat[0][1]+ gy*block->winmat[1][1]+ block->winmat[3][1])));
957
958 }
959
960 /* uses local copy of style, to scale things down, and allow widgets to change stuff */
961 void uiDrawBlock(const bContext *C, uiBlock *block)
962 {
963         uiStyle style= *UI_GetStyle();  // XXX pass on as arg
964         ARegion *ar;
965         uiBut *but;
966         rcti rect;
967         
968         /* get menu region or area region */
969         ar= CTX_wm_menu(C);
970         if(!ar)
971                 ar= CTX_wm_region(C);
972
973         if(!block->endblock)
974                 uiEndBlock(C, block);
975
976         /* we set this only once */
977         glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
978         
979         /* scale fonts */
980         ui_fontscale(&style.paneltitle.points, block->aspect);
981         ui_fontscale(&style.grouplabel.points, block->aspect);
982         ui_fontscale(&style.widgetlabel.points, block->aspect);
983         ui_fontscale(&style.widget.points, block->aspect);
984         
985         /* scale block min/max to rect */
986         ui_but_to_pixelrect(&rect, ar, block, NULL);
987         
988         /* pixel space for AA widgets */
989         glMatrixMode(GL_PROJECTION);
990         glPushMatrix();
991         glMatrixMode(GL_MODELVIEW);
992         glPushMatrix();
993         glLoadIdentity();
994         
995         wmOrtho2(-0.01f, ar->winx-0.01f, -0.01f, ar->winy-0.01f);
996         
997         /* back */
998         if(block->flag & UI_BLOCK_LOOP)
999                 ui_draw_menu_back(&style, block, &rect);
1000         else if(block->panel)
1001                 ui_draw_aligned_panel(&style, block, &rect);
1002
1003         /* widgets */
1004         for(but= block->buttons.first; but; but= but->next) {
1005                 if(!(but->flag & (UI_HIDDEN|UI_SCROLLED))) {
1006                         ui_but_to_pixelrect(&rect, ar, block, but);
1007                 
1008                         /* XXX: figure out why invalid coordinates happen when closing render window */
1009                         /* and material preview is redrawn in main window (temp fix for bug #23848) */
1010                         if(rect.xmin < rect.xmax && rect.ymin < rect.ymax)
1011                                 ui_draw_but(C, ar, &style, but, &rect);
1012                 }
1013         }
1014         
1015         /* restore matrix */
1016         glMatrixMode(GL_PROJECTION);
1017         glPopMatrix();
1018         glMatrixMode(GL_MODELVIEW);
1019         glPopMatrix();
1020         
1021         ui_draw_links(block);
1022 }
1023
1024 /* ************* EVENTS ************* */
1025
1026 static void ui_is_but_sel(uiBut *but, double *value)
1027 {
1028         short push=0, true=1;
1029
1030         if(ELEM3(but->type, TOGN, ICONTOGN, OPTIONN)) true= 0;
1031
1032         if( but->bit ) {
1033                 int lvalue;
1034                 UI_GET_BUT_VALUE_INIT(but, *value)
1035                 lvalue= (int)*value;
1036                 if( BTST(lvalue, (but->bitnr)) ) push= true;
1037                 else push= !true;
1038         }
1039         else {
1040                 switch(but->type) {
1041                 case BUT:
1042                         push= 2;
1043                         break;
1044                 case HOTKEYEVT:
1045                 case KEYEVT:
1046                         push= 2;
1047                         break;
1048                 case TOGBUT:
1049                 case TOG:
1050                 case TOGR:
1051                 case TOG3:
1052                 case BUT_TOGDUAL:
1053                 case ICONTOG:
1054                 case OPTION:
1055                         UI_GET_BUT_VALUE_INIT(but, *value)
1056                         if(*value != (double)but->hardmin) push= 1;
1057                         break;
1058                 case ICONTOGN:
1059                 case TOGN:
1060                 case OPTIONN:
1061                         UI_GET_BUT_VALUE_INIT(but, *value)
1062                         if(*value==0.0) push= 1;
1063                         break;
1064                 case ROW:
1065                 case LISTROW:
1066                         UI_GET_BUT_VALUE_INIT(but, *value)
1067                         /* support for rna enum buts */
1068                         if(but->rnaprop && (RNA_property_flag(but->rnaprop) & PROP_ENUM_FLAG)) {
1069                                 if((int)*value & (int)but->hardmax) push= 1;
1070                         }
1071                         else {
1072                                 if(*value == (double)but->hardmax) push= 1;
1073                         }
1074                         break;
1075                 case COL:
1076                         push= 2;
1077                         break;
1078                 default:
1079                         push= 2;
1080                         break;
1081                 }
1082         }
1083         
1084         if(push==2);
1085         else if(push==1) but->flag |= UI_SELECT;
1086         else but->flag &= ~UI_SELECT;
1087 }
1088
1089 static uiBut *ui_find_inlink(uiBlock *block, void *poin)
1090 {
1091         uiBut *but;
1092         
1093         but= block->buttons.first;
1094         while(but) {
1095                 if(but->type==INLINK) {
1096                         if(but->poin == poin) return but;
1097                 }
1098                 but= but->next;
1099         }
1100         return NULL;
1101 }
1102
1103 static void ui_add_link_line(ListBase *listb, uiBut *but, uiBut *bt)
1104 {
1105         uiLinkLine *line;
1106         
1107         line= MEM_callocN(sizeof(uiLinkLine), "linkline");
1108         BLI_addtail(listb, line);
1109         line->from= but;
1110         line->to= bt;
1111 }
1112
1113 uiBut *uiFindInlink(uiBlock *block, void *poin)
1114 {
1115         return ui_find_inlink(block, poin);
1116 }
1117
1118 void uiComposeLinks(uiBlock *block)
1119 {
1120         uiBut *but, *bt;
1121         uiLink *link;
1122         void ***ppoin;
1123         int a;
1124         
1125         but= block->buttons.first;
1126         while(but) {
1127                 if(but->type==LINK) {
1128                         link= but->link;
1129                         
1130                         /* for all pointers in the array */
1131                         if(link) {
1132                                 if(link->ppoin) {
1133                                         ppoin= link->ppoin;
1134                                         for(a=0; a < *(link->totlink); a++) {
1135                                                 bt= ui_find_inlink(block, (*ppoin)[a] );
1136                                                 if(bt) {
1137                                                         ui_add_link_line(&link->lines, but, bt);
1138                                                 }
1139                                         }
1140                                 }
1141                                 else if(link->poin) {
1142                                         bt= ui_find_inlink(block, *(link->poin) );
1143                                         if(bt) {
1144                                                 ui_add_link_line(&link->lines, but, bt);
1145                                         }
1146                                 }
1147                         }
1148                 }
1149                 but= but->next;
1150         }
1151 }
1152
1153
1154 /* ************************************************ */
1155
1156 void uiBlockSetButLock(uiBlock *block, int val, const char *lockstr)
1157 {
1158         if(val) {
1159                 block->lock= val ? 1:0;
1160                 block->lockstr= lockstr;
1161         }
1162 }
1163
1164 void uiBlockClearButLock(uiBlock *block)
1165 {
1166         block->lock= 0;
1167         block->lockstr= NULL;
1168 }
1169
1170 /* *************************************************************** */
1171
1172 void ui_delete_linkline(uiLinkLine *line, uiBut *but)
1173 {
1174         uiLink *link;
1175         int a, b;
1176         
1177         BLI_remlink(&but->link->lines, line);
1178
1179         link= line->from->link;
1180
1181         /* are there more pointers allowed? */
1182         if(link->ppoin) {
1183                 
1184                 if(*(link->totlink)==1) {
1185                         *(link->totlink)= 0;
1186                         MEM_freeN(*(link->ppoin));
1187                         *(link->ppoin)= NULL;
1188                 }
1189                 else {
1190                         b= 0;
1191                         for(a=0; a< (*(link->totlink)); a++) {
1192                                 
1193                                 if( (*(link->ppoin))[a] != line->to->poin ) {
1194                                         (*(link->ppoin))[b]= (*(link->ppoin))[a];
1195                                         b++;
1196                                 }
1197                         }       
1198                         (*(link->totlink))--;
1199                 }
1200         }
1201         else {
1202                 *(link->poin)= NULL;
1203         }
1204
1205         MEM_freeN(line);
1206         //REDRAW
1207 }
1208
1209 /* *********************** data get/set ***********************
1210  * this either works with the pointed to data, or can work with
1211  * an edit override pointer while dragging for example */
1212
1213 /* for buttons pointing to color for example */
1214 void ui_get_but_vectorf(uiBut *but, float vec[3])
1215 {
1216         PropertyRNA *prop;
1217         int a, tot;
1218
1219         if(but->editvec) {
1220                 VECCOPY(vec, but->editvec);
1221         }
1222
1223         if(but->rnaprop) {
1224                 prop= but->rnaprop;
1225
1226                 vec[0]= vec[1]= vec[2]= 0.0f;
1227
1228                 if(RNA_property_type(prop) == PROP_FLOAT) {
1229                         tot= RNA_property_array_length(&but->rnapoin, prop);
1230                         tot= MIN2(tot, 3);
1231
1232                         for(a=0; a<tot; a++)
1233                                 vec[a]= RNA_property_float_get_index(&but->rnapoin, prop, a);
1234                 }
1235         }
1236         else if(but->pointype == CHA) {
1237                 char *cp= (char *)but->poin;
1238                 vec[0]= ((float)cp[0])/255.0f;
1239                 vec[1]= ((float)cp[1])/255.0f;
1240                 vec[2]= ((float)cp[2])/255.0f;
1241         }
1242         else if(but->pointype == FLO) {
1243                 float *fp= (float *)but->poin;
1244                 VECCOPY(vec, fp);
1245         }
1246         else {
1247                 if (but->editvec==NULL) {
1248                         fprintf(stderr, "ui_get_but_vectorf: can't get color, should never happen\n");
1249                         vec[0]= vec[1]= vec[2]= 0.0f;
1250                 }
1251         }
1252
1253         if (but->type == BUT_NORMAL) {
1254                 normalize_v3(vec);
1255         }
1256 }
1257
1258 /* for buttons pointing to color for example */
1259 void ui_set_but_vectorf(uiBut *but, const float vec[3])
1260 {
1261         PropertyRNA *prop;
1262         int a, tot;
1263
1264         if(but->editvec) {
1265                 copy_v3_v3(but->editvec, vec);
1266         }
1267
1268         if(but->rnaprop) {
1269                 prop= but->rnaprop;
1270
1271                 if(RNA_property_type(prop) == PROP_FLOAT) {
1272                         tot= RNA_property_array_length(&but->rnapoin, prop);
1273                         tot= MIN2(tot, 3);
1274
1275                         for(a=0; a<tot; a++)
1276                                 RNA_property_float_set_index(&but->rnapoin, prop, a, vec[a]);
1277                 }
1278         }
1279         else if(but->pointype == CHA) {
1280                 char *cp= (char *)but->poin;
1281                 cp[0]= (char)(0.5f + vec[0]*255.0f);
1282                 cp[1]= (char)(0.5f + vec[1]*255.0f);
1283                 cp[2]= (char)(0.5f + vec[2]*255.0f);
1284         }
1285         else if(but->pointype == FLO) {
1286                 float *fp= (float *)but->poin;
1287                 copy_v3_v3(fp, vec);
1288         }
1289 }
1290
1291 int ui_is_but_float(uiBut *but)
1292 {
1293         if(but->pointype==FLO && but->poin)
1294                 return 1;
1295         
1296         if(but->rnaprop && RNA_property_type(but->rnaprop) == PROP_FLOAT)
1297                 return 1;
1298         
1299         return 0;
1300 }
1301
1302 int ui_is_but_unit(uiBut *but)
1303 {
1304         UnitSettings *unit= but->block->unit;
1305         const int unit_type= uiButGetUnitType(but);
1306
1307         if(unit_type == PROP_UNIT_NONE)
1308                 return 0;
1309
1310 #if 1 // removed so angle buttons get correct snapping
1311         if (unit->system_rotation == USER_UNIT_ROT_RADIANS && unit_type == PROP_UNIT_ROTATION)
1312                 return 0;
1313 #endif
1314         
1315         /* for now disable time unit conversion */      
1316         if (unit_type == PROP_UNIT_TIME)
1317                 return 0;
1318
1319         if (unit->system == USER_UNIT_NONE) {
1320                 if (unit_type != PROP_UNIT_ROTATION) {
1321                         return 0;
1322                 }
1323         }
1324
1325         return 1;
1326 }
1327
1328 int ui_is_but_rna_valid(uiBut *but)
1329 {
1330         if (but->rnaprop==NULL || RNA_struct_contains_property(&but->rnapoin, but->rnaprop)) {
1331                 return TRUE;
1332         }
1333         else {
1334                 printf("property removed %s: %p\n", but->drawstr, but->rnaprop);
1335                 return FALSE;
1336         }
1337 }
1338
1339 double ui_get_but_val(uiBut *but)
1340 {
1341         PropertyRNA *prop;
1342         double value = 0.0;
1343
1344         if(but->editval) { return *(but->editval); }
1345         if(but->poin==NULL && but->rnapoin.data==NULL) return 0.0;
1346
1347         if(but->rnaprop) {
1348                 prop= but->rnaprop;
1349
1350                 switch(RNA_property_type(prop)) {
1351                         case PROP_BOOLEAN:
1352                                 if(RNA_property_array_check(prop))
1353                                         value= RNA_property_boolean_get_index(&but->rnapoin, prop, but->rnaindex);
1354                                 else
1355                                         value= RNA_property_boolean_get(&but->rnapoin, prop);
1356                                 break;
1357                         case PROP_INT:
1358                                 if(RNA_property_array_check(prop))
1359                                         value= RNA_property_int_get_index(&but->rnapoin, prop, but->rnaindex);
1360                                 else
1361                                         value= RNA_property_int_get(&but->rnapoin, prop);
1362                                 break;
1363                         case PROP_FLOAT:
1364                                 if(RNA_property_array_check(prop))
1365                                         value= RNA_property_float_get_index(&but->rnapoin, prop, but->rnaindex);
1366                                 else
1367                                         value= RNA_property_float_get(&but->rnapoin, prop);
1368                                 break;
1369                         case PROP_ENUM:
1370                                 value= RNA_property_enum_get(&but->rnapoin, prop);
1371                                 break;
1372                         default:
1373                                 value= 0.0;
1374                                 break;
1375                 }
1376         }
1377         else if(but->type== HSVSLI) {
1378                 float h, s, v, *fp;
1379                 
1380                 fp= (but->editvec)? but->editvec: (float *)but->poin;
1381                 rgb_to_hsv(fp[0], fp[1], fp[2], &h, &s, &v);
1382
1383                 switch(but->str[0]) {
1384                         case 'H': value= h; break;
1385                         case 'S': value= s; break;
1386                         case 'V': value= v; break;
1387                 }
1388         } 
1389         else if( but->pointype == CHA ) {
1390                 value= *(char *)but->poin;
1391         }
1392         else if( but->pointype == SHO ) {
1393                 value= *(short *)but->poin;
1394         } 
1395         else if( but->pointype == INT ) {
1396                 value= *(int *)but->poin;
1397         } 
1398         else if( but->pointype == FLO ) {
1399                 value= *(float *)but->poin;
1400         }
1401
1402         return value;
1403 }
1404
1405 void ui_set_but_val(uiBut *but, double value)
1406 {
1407         PropertyRNA *prop;
1408
1409         /* value is a hsv value: convert to rgb */
1410         if(but->rnaprop) {
1411                 prop= but->rnaprop;
1412
1413                 if(RNA_property_editable(&but->rnapoin, prop)) {
1414                         switch(RNA_property_type(prop)) {
1415                                 case PROP_BOOLEAN:
1416                                         if(RNA_property_array_length(&but->rnapoin, prop))
1417                                                 RNA_property_boolean_set_index(&but->rnapoin, prop, but->rnaindex, value);
1418                                         else
1419                                                 RNA_property_boolean_set(&but->rnapoin, prop, value);
1420                                         break;
1421                                 case PROP_INT:
1422                                         if(RNA_property_array_length(&but->rnapoin, prop))
1423                                                 RNA_property_int_set_index(&but->rnapoin, prop, but->rnaindex, (int)value);
1424                                         else
1425                                                 RNA_property_int_set(&but->rnapoin, prop, (int)value);
1426                                         break;
1427                                 case PROP_FLOAT:
1428                                         if(RNA_property_array_length(&but->rnapoin, prop))
1429                                                 RNA_property_float_set_index(&but->rnapoin, prop, but->rnaindex, value);
1430                                         else
1431                                                 RNA_property_float_set(&but->rnapoin, prop, value);
1432                                         break;
1433                                 case PROP_ENUM:
1434                                         if(RNA_property_flag(prop) & PROP_ENUM_FLAG) {
1435                                                 int ivalue= (int)value;
1436                                                 ivalue ^= RNA_property_enum_get(&but->rnapoin, prop); /* toggle for enum/flag buttons */
1437                                                 RNA_property_enum_set(&but->rnapoin, prop, ivalue);
1438                                         }
1439                                         else {
1440                                                 RNA_property_enum_set(&but->rnapoin, prop, value);
1441                                         }
1442                                         break;
1443                                 default:
1444                                         break;
1445                         }
1446                 }
1447
1448                 /* we can't be sure what RNA set functions actually do,
1449                  * so leave this unset */
1450                 value= UI_BUT_VALUE_UNSET;
1451         }
1452         else if(but->pointype==0);
1453         else if(but->type==HSVSLI ) {
1454                 float h, s, v, *fp;
1455                 
1456                 fp= (but->editvec)? but->editvec: (float *)but->poin;
1457                 rgb_to_hsv(fp[0], fp[1], fp[2], &h, &s, &v);
1458                 
1459                 switch(but->str[0]) {
1460                 case 'H': h= value; break;
1461                 case 'S': s= value; break;
1462                 case 'V': v= value; break;
1463                 }
1464                 
1465                 hsv_to_rgb(h, s, v, fp, fp+1, fp+2);
1466                 
1467         }
1468         else {
1469                 /* first do rounding */
1470                 if(but->pointype==CHA)
1471                         value= (char)floor(value+0.5);
1472                 else if(but->pointype==SHO ) {
1473                         /* gcc 3.2.1 seems to have problems 
1474                          * casting a double like 32772.0 to
1475                          * a short so we cast to an int, then 
1476                          to a short */
1477                         int gcckludge;
1478                         gcckludge = (int) floor(value+0.5);
1479                         value= (short)gcckludge;
1480                 }
1481                 else if(but->pointype==INT )
1482                         value= (int)floor(value+0.5);
1483                 else if(but->pointype==FLO ) {
1484                         float fval= (float)value;
1485                         if(fval>= -0.00001f && fval<= 0.00001f) fval= 0.0f;     /* prevent negative zero */
1486                         value= fval;
1487                 }
1488                 
1489                 /* then set value with possible edit override */
1490                 if(but->editval)
1491                         value= *but->editval= value;
1492                 else if(but->pointype==CHA)
1493                         value= *((char *)but->poin)= (char)value;
1494                 else if(but->pointype==SHO)
1495                         value= *((short *)but->poin)= (short)value;
1496                 else if(but->pointype==INT)
1497                         value= *((int *)but->poin)= (int)value;
1498                 else if(but->pointype==FLO)
1499                         value= *((float *)but->poin)= (float)value;
1500         }
1501
1502         /* update select flag */
1503         ui_is_but_sel(but, &value);
1504 }
1505
1506 int ui_get_but_string_max_length(uiBut *but)
1507 {
1508         if(ELEM(but->type, TEX, SEARCH_MENU))
1509                 return but->hardmax;
1510         else if(but->type == IDPOIN)
1511                 return MAX_ID_NAME-2;
1512         else
1513                 return UI_MAX_DRAW_STR;
1514 }
1515
1516 static double ui_get_but_scale_unit(uiBut *but, double value)
1517 {
1518         UnitSettings *unit= but->block->unit;
1519         int unit_type= uiButGetUnitType(but);
1520
1521         if(unit_type == PROP_UNIT_LENGTH) {
1522                 return value * (double)unit->scale_length;
1523         }
1524         else if(unit_type == PROP_UNIT_AREA) {
1525                 return value * pow(unit->scale_length, 2);
1526         }
1527         else if(unit_type == PROP_UNIT_VOLUME) {
1528                 return value * pow(unit->scale_length, 3);
1529         }
1530         else if(unit_type == PROP_UNIT_TIME) { /* WARNING - using evil_C :| */
1531                 Scene *scene= CTX_data_scene(but->block->evil_C);
1532                 return FRA2TIME(value);
1533         }
1534         else {
1535                 return value;
1536         }
1537 }
1538
1539 /* str will be overwritten */
1540 void ui_convert_to_unit_alt_name(uiBut *but, char *str, size_t maxlen)
1541 {
1542         if(ui_is_but_unit(but)) {
1543                 UnitSettings *unit= but->block->unit;
1544                 int unit_type= uiButGetUnitType(but);
1545                 char *orig_str;
1546                 
1547                 orig_str= MEM_callocN(sizeof(char)*maxlen + 1, "textedit sub str");
1548                 memcpy(orig_str, str, maxlen);
1549                 
1550                 bUnit_ToUnitAltName(str, maxlen, orig_str, unit->system, unit_type>>16);
1551                 
1552                 MEM_freeN(orig_str);
1553         }
1554 }
1555
1556 static void ui_get_but_string_unit(uiBut *but, char *str, int len_max, double value, int pad)
1557 {
1558         UnitSettings *unit= but->block->unit;
1559         int do_split= unit->flag & USER_UNIT_OPT_SPLIT;
1560         int unit_type= uiButGetUnitType(but);
1561         int precision= but->a2;
1562
1563         if(unit->scale_length<0.0001f) unit->scale_length= 1.0f; // XXX do_versions
1564
1565         /* Sanity checks */
1566         if(precision > PRECISION_FLOAT_MAX)     precision= PRECISION_FLOAT_MAX;
1567         else if(precision==0)                           precision= 2;
1568
1569         bUnit_AsString(str, len_max, ui_get_but_scale_unit(but, value), precision, unit->system, unit_type>>16, do_split, pad);
1570 }
1571
1572 static float ui_get_but_step_unit(uiBut *but, float step_default)
1573 {
1574         int unit_type= uiButGetUnitType(but)>>16;
1575         float step;
1576
1577         step = bUnit_ClosestScalar(ui_get_but_scale_unit(but, step_default), but->block->unit->system, unit_type);
1578
1579         if(step > 0.0f) { /* -1 is an error value */
1580                 return (float)((double)step/ui_get_but_scale_unit(but, 1.0))*100.0f;
1581         }
1582         else {
1583                 return step_default;
1584         }
1585 }
1586
1587
1588 void ui_get_but_string(uiBut *but, char *str, size_t maxlen)
1589 {
1590         if(but->rnaprop && ELEM3(but->type, TEX, IDPOIN, SEARCH_MENU)) {
1591                 PropertyType type;
1592                 char *buf= NULL;
1593
1594                 type= RNA_property_type(but->rnaprop);
1595
1596                 if(type == PROP_STRING) {
1597                         /* RNA string */
1598                         buf= RNA_property_string_get_alloc(&but->rnapoin, but->rnaprop, str, maxlen);
1599                 }
1600                 else if(type == PROP_POINTER) {
1601                         /* RNA pointer */
1602                         PointerRNA ptr= RNA_property_pointer_get(&but->rnapoin, but->rnaprop);
1603                         buf= RNA_struct_name_get_alloc(&ptr, str, maxlen);
1604                 }
1605
1606                 if(!buf) {
1607                         str[0] = '\0';
1608                 }
1609                 else if(buf && buf != str) {
1610                         /* string was too long, we have to truncate */
1611                         BLI_strncpy(str, buf, maxlen);
1612                         MEM_freeN(buf);
1613                 }
1614         }
1615         else if(but->type == IDPOIN) {
1616                 /* ID pointer */
1617                 if(but->idpoin_idpp) { /* Can be NULL for ID properties by python */
1618                         ID *id= *(but->idpoin_idpp);
1619                         if(id) {
1620                                 BLI_strncpy(str, id->name+2, maxlen);
1621                                 return;
1622                         }
1623                 }
1624                 str[0] = '\0';
1625                 return;
1626         }
1627         else if(but->type == TEX) {
1628                 /* string */
1629                 BLI_strncpy(str, but->poin, maxlen);
1630                 return;
1631         }
1632         else if(but->type == SEARCH_MENU) {
1633                 /* string */
1634                 BLI_strncpy(str, but->poin, maxlen);
1635                 return;
1636         }
1637         else if(ui_but_anim_expression_get(but, str, maxlen))
1638                 ; /* driver expression */
1639         else {
1640                 /* number editing */
1641                 double value;
1642
1643                 value= ui_get_but_val(but);
1644
1645                 if(ui_is_but_float(but)) {
1646                         if(ui_is_but_unit(but)) {
1647                                 ui_get_but_string_unit(but, str, maxlen, value, 0);
1648                         }
1649                         else {
1650                                 const int prec= ui_but_float_precision(but, value);
1651                                 BLI_snprintf(str, maxlen, "%.*f", prec, value);
1652                         }
1653                 }
1654                 else
1655                         BLI_snprintf(str, maxlen, "%d", (int)value);
1656         }
1657 }
1658
1659 #ifdef WITH_PYTHON
1660
1661 static int ui_set_but_string_eval_num_unit(bContext *C, uiBut *but, const char *str, double *value)
1662 {
1663         char str_unit_convert[256];
1664         const int unit_type= uiButGetUnitType(but);
1665
1666         BLI_strncpy(str_unit_convert, str, sizeof(str_unit_convert));
1667
1668         /* ugly, use the draw string to get the value, this could cause problems if it includes some text which resolves to a unit */
1669         bUnit_ReplaceString(str_unit_convert, sizeof(str_unit_convert), but->drawstr, ui_get_but_scale_unit(but, 1.0), but->block->unit->system, unit_type>>16);
1670
1671         return (BPY_button_exec(C, str_unit_convert, value, TRUE) != -1);
1672 }
1673
1674 static int ui_set_but_string_eval_num(bContext *C, uiBut *but, const char *str, double *value)
1675 {
1676         int ok= FALSE;
1677
1678         if(str[0] != '\0') {
1679                 int is_unit_but= ui_is_but_unit(but);
1680                 /* only enable verbose if we won't run again with units */
1681                 if(BPY_button_exec(C, str, value, is_unit_but==FALSE) != -1) {
1682                         /* if the value parsed ok without unit conversion this button may still need a unit multiplier */
1683                         if(is_unit_but) {
1684                                 char str_new[128];
1685
1686                                 BLI_snprintf(str_new, sizeof(str_new), "%f", *value);
1687                                 ok= ui_set_but_string_eval_num_unit(C, but, str_new, value);
1688                         }
1689                         else {
1690                                 ok= TRUE; /* parse normal string via py (no unit conversion needed) */
1691                         }
1692                 }
1693                 else if(is_unit_but) {
1694                         /* parse failed, this is a unit but so run replacements and parse again */
1695                         ok= ui_set_but_string_eval_num_unit(C, but, str, value);
1696                 }
1697         }
1698
1699         return ok;
1700 }
1701
1702 #endif // WITH_PYTHON
1703
1704 int ui_set_but_string(bContext *C, uiBut *but, const char *str)
1705 {
1706         if(but->rnaprop && ELEM3(but->type, TEX, IDPOIN, SEARCH_MENU)) {
1707                 if(RNA_property_editable(&but->rnapoin, but->rnaprop)) {
1708                         PropertyType type;
1709
1710                         type= RNA_property_type(but->rnaprop);
1711
1712                         if(type == PROP_STRING) {
1713                                 /* RNA string */
1714                                 RNA_property_string_set(&but->rnapoin, but->rnaprop, str);
1715                                 return 1;
1716                         }
1717                         else if(type == PROP_POINTER) {
1718                                 /* RNA pointer */
1719                                 PointerRNA ptr, rptr;
1720                                 PropertyRNA *prop;
1721
1722                                 if(str == NULL || str[0] == '\0') {
1723                                         RNA_property_pointer_set(&but->rnapoin, but->rnaprop, PointerRNA_NULL);
1724                                         return 1;
1725                                 }
1726                                 else {
1727                                         ptr= but->rnasearchpoin;
1728                                         prop= but->rnasearchprop;
1729                                         
1730                                         if(prop && RNA_property_collection_lookup_string(&ptr, prop, str, &rptr))
1731                                                 RNA_property_pointer_set(&but->rnapoin, but->rnaprop, rptr);
1732
1733                                         return 1;
1734                                 }
1735
1736                                 return 0;
1737                         }
1738                 }
1739         }
1740         else if(but->type == IDPOIN) {
1741                 /* ID pointer */
1742                 but->idpoin_func(C, str, but->idpoin_idpp);
1743                 return 1;
1744         }
1745         else if(but->type == TEX) {
1746                 /* string */
1747                 BLI_strncpy(but->poin, str, but->hardmax);
1748                 return 1;
1749         }
1750         else if(but->type == SEARCH_MENU) {
1751                 /* string */
1752                 BLI_strncpy(but->poin, str, but->hardmax);
1753                 return 1;
1754         }
1755         else if(ui_but_anim_expression_set(but, str)) {
1756                 /* driver expression */
1757                 return 1;
1758         }
1759         else if(str[0]=='#') {
1760                 /* shortcut to create new driver expression (versus immediate Py-execution) */
1761                 return ui_but_anim_expression_create(but, str+1);
1762         }
1763         else {
1764                 /* number editing */
1765                 double value;
1766
1767 #ifdef WITH_PYTHON
1768                 if(ui_set_but_string_eval_num(C, but, str, &value) == FALSE) {
1769                         return 0;
1770                 }
1771 #else
1772                 value= atof(str);
1773 #endif // WITH_PYTHON
1774
1775                 if(!ui_is_but_float(but)) value= (int)floor(value + 0.5);
1776                 if(but->type==NUMABS) value= fabs(value);
1777
1778                 /* not that we use hard limits here */
1779                 if(value < (double)but->hardmin) value= but->hardmin;
1780                 if(value > (double)but->hardmax) value= but->hardmax;
1781
1782                 ui_set_but_val(but, value);
1783                 return 1;
1784         }
1785
1786         return 0;
1787 }
1788
1789 void ui_set_but_default(bContext *C, short all)
1790 {
1791         PointerRNA ptr;
1792
1793         WM_operator_properties_create(&ptr, "UI_OT_reset_default_button");
1794         RNA_boolean_set(&ptr, "all", all);
1795         WM_operator_name_call(C, "UI_OT_reset_default_button", WM_OP_EXEC_DEFAULT, &ptr);
1796         WM_operator_properties_free(&ptr);
1797 }
1798
1799 static double soft_range_round_up(double value, double max)
1800 {
1801         /* round up to .., 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, .. */
1802         double newmax= pow(10.0, ceil(log(value)/M_LN10));
1803
1804         if(newmax*0.2 >= max && newmax*0.2 >= value)
1805                 return newmax*0.2;
1806         else if(newmax*0.5 >= max && newmax*0.5 >= value)
1807                 return newmax*0.5;
1808         else
1809                 return newmax;
1810 }
1811
1812 static double soft_range_round_down(double value, double max)
1813 {
1814         /* round down to .., 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, .. */
1815         double newmax= pow(10.0, floor(log(value)/M_LN10));
1816
1817         if(newmax*5.0 <= max && newmax*5.0 <= value)
1818                 return newmax*5.0;
1819         else if(newmax*2.0 <= max && newmax*2.0 <= value)
1820                 return newmax*2.0;
1821         else
1822                 return newmax;
1823 }
1824
1825 void ui_set_but_soft_range(uiBut *but, double value)
1826 {
1827         /* ideally we would not limit this but practially, its more then
1828          * enough worst case is very long vectors wont use a smart soft-range
1829          * which isnt so bad. */
1830
1831         if(but->rnaprop) {
1832                 const PropertyType type= RNA_property_type(but->rnaprop);
1833                 double softmin, softmax /*, step, precision*/;
1834                 double value_min= value;
1835                 double value_max= value;
1836
1837                 /* clamp button range to something reasonable in case
1838                  * we get -inf/inf from RNA properties */
1839                 if(type == PROP_INT) {
1840                         int imin, imax, istep;
1841                         const int array_len= RNA_property_array_length(&but->rnapoin, but->rnaprop);
1842
1843                         RNA_property_int_ui_range(&but->rnapoin, but->rnaprop, &imin, &imax, &istep);
1844                         softmin= (imin == INT_MIN)? -1e4: imin;
1845                         softmax= (imin == INT_MAX)? 1e4: imax;
1846                         /*step= istep;*/ /*UNUSED*/
1847                         /*precision= 1;*/ /*UNUSED*/
1848
1849                         if(array_len >= 2) {
1850                                 int value_range[2];
1851                                 RNA_property_int_get_array_range(&but->rnapoin, but->rnaprop, value_range);
1852                                 value_min= (double)value_range[0];
1853                                 value_max= (double)value_range[1];
1854                         }
1855                 }
1856                 else if(type == PROP_FLOAT) {
1857                         float fmin, fmax, fstep, fprecision;
1858                         const int array_len= RNA_property_array_length(&but->rnapoin, but->rnaprop);
1859
1860                         RNA_property_float_ui_range(&but->rnapoin, but->rnaprop, &fmin, &fmax, &fstep, &fprecision);
1861                         softmin= (fmin == -FLT_MAX)? (float)-1e4: fmin;
1862                         softmax= (fmax == FLT_MAX)? (float)1e4: fmax;
1863                         /*step= fstep;*/ /*UNUSED*/
1864                         /*precision= fprecision;*/ /*UNUSED*/
1865
1866                         if(array_len >= 2) {
1867                                 float value_range[2];
1868                                 RNA_property_float_get_array_range(&but->rnapoin, but->rnaprop, value_range);
1869                                 value_min= (double)value_range[0];
1870                                 value_max= (double)value_range[1];
1871                         }
1872                 }
1873                 else
1874                         return;
1875
1876                 /* if the value goes out of the soft/max range, adapt the range */
1877                 if(value_min+1e-10 < softmin) {
1878                         if(value_min < 0.0)
1879                                 softmin= -soft_range_round_up(-value_min, -softmin);
1880                         else
1881                                 softmin= soft_range_round_down(value_min, softmin);
1882
1883                         if(softmin < (double)but->hardmin)
1884                                 softmin= (double)but->hardmin;
1885                 }
1886                 else if(value_max-1e-10 > softmax) {
1887                         if(value_max < 0.0)
1888                                 softmax= -soft_range_round_down(-value_max, -softmax);
1889                         else
1890                                 softmax= soft_range_round_up(value_max, softmax);
1891
1892                         if(softmax > (double)but->hardmax)
1893                                 softmax= but->hardmax;
1894                 }
1895
1896                 but->softmin= softmin;
1897                 but->softmax= softmax;
1898         }
1899 }
1900
1901 /* ******************* Free ********************/
1902
1903 static void ui_free_link(uiLink *link)
1904 {
1905         if(link) {      
1906                 BLI_freelistN(&link->lines);
1907                 MEM_freeN(link);
1908         }
1909 }
1910
1911 /* can be called with C==NULL */
1912 static void ui_free_but(const bContext *C, uiBut *but)
1913 {
1914         if(but->opptr) {
1915                 WM_operator_properties_free(but->opptr);
1916                 MEM_freeN(but->opptr);
1917         }
1918         if(but->func_argN) MEM_freeN(but->func_argN);
1919         if(but->active) {
1920                 /* XXX solve later, buttons should be free-able without context ideally,
1921                    however they may have open tooltips or popup windows, which need to
1922                    be closed using a context pointer */
1923                 if(C) 
1924                         ui_button_active_free(C, but);
1925                 else
1926                         if(but->active) 
1927                                 MEM_freeN(but->active);
1928         }
1929         if(but->str && but->str != but->strdata) MEM_freeN(but->str);
1930         ui_free_link(but->link);
1931
1932         if((but->type == BUT_IMAGE) && but->poin) IMB_freeImBuf((struct ImBuf *)but->poin);
1933
1934         MEM_freeN(but);
1935 }
1936
1937 /* can be called with C==NULL */
1938 void uiFreeBlock(const bContext *C, uiBlock *block)
1939 {
1940         uiBut *but;
1941
1942         while( (but= block->buttons.first) ) {
1943                 BLI_remlink(&block->buttons, but);      
1944                 ui_free_but(C, but);
1945         }
1946
1947         if(block->unit)
1948                 MEM_freeN(block->unit);
1949
1950         if(block->func_argN)
1951                 MEM_freeN(block->func_argN);
1952
1953         CTX_store_free_list(&block->contexts);
1954
1955         BLI_freelistN(&block->saferct);
1956         
1957         MEM_freeN(block);
1958 }
1959
1960 /* can be called with C==NULL */
1961 void uiFreeBlocks(const bContext *C, ListBase *lb)
1962 {
1963         uiBlock *block;
1964         
1965         while( (block= lb->first) ) {
1966                 BLI_remlink(lb, block);
1967                 uiFreeBlock(C, block);
1968         }
1969 }
1970
1971 void uiFreeInactiveBlocks(const bContext *C, ListBase *lb)
1972 {
1973         uiBlock *block, *nextblock;
1974
1975         for(block=lb->first; block; block=nextblock) {
1976                 nextblock= block->next;
1977         
1978                 if(!block->handle) {
1979                         if(!block->active) {
1980                                 BLI_remlink(lb, block);
1981                                 uiFreeBlock(C, block);
1982                         }
1983                         else
1984                                 block->active= 0;
1985                 }
1986         }
1987 }
1988
1989 void uiBlockSetRegion(uiBlock *block, ARegion *region)
1990 {
1991         ListBase *lb= &region->uiblocks;
1992         uiBlock *oldblock= NULL;
1993
1994         /* each listbase only has one block with this name, free block
1995          * if is already there so it can be rebuilt from scratch */
1996         if(lb) {
1997                 oldblock= BLI_findstring(lb, block->name, offsetof(uiBlock, name));
1998
1999                 if (oldblock) {
2000                         oldblock->active= 0;
2001                         oldblock->panel= NULL;
2002                 }
2003
2004                 /* at the beginning of the list! for dynamical menus/blocks */
2005                 BLI_addhead(lb, block);
2006         }
2007
2008         block->oldblock= oldblock;
2009 }
2010
2011 uiBlock *uiBeginBlock(const bContext *C, ARegion *region, const char *name, short dt)
2012 {
2013         uiBlock *block;
2014         wmWindow *window;
2015         Scene *scn;
2016         int getsizex, getsizey;
2017
2018         window= CTX_wm_window(C);
2019         scn = CTX_data_scene(C);
2020
2021         block= MEM_callocN(sizeof(uiBlock), "uiBlock");
2022         block->active= 1;
2023         block->dt= dt;
2024         block->evil_C= (void*)C; // XXX
2025
2026         if (scn) {
2027                 block->color_profile= (scn->r.color_mgt_flag & R_COLOR_MANAGEMENT);
2028
2029                 /* copy to avoid crash when scene gets deleted with ui still open */
2030                 block->unit= MEM_mallocN(sizeof(scn->unit), "UI UnitSettings");
2031                 memcpy(block->unit, &scn->unit, sizeof(scn->unit));
2032         }
2033
2034         BLI_strncpy(block->name, name, sizeof(block->name));
2035
2036         if(region)
2037                 uiBlockSetRegion(block, region);
2038
2039         /* window matrix and aspect */
2040         if(region && region->swinid) {
2041                 wm_subwindow_getmatrix(window, region->swinid, block->winmat);
2042                 wm_subwindow_getsize(window, region->swinid, &getsizex, &getsizey);
2043
2044                 /* TODO - investigate why block->winmat[0][0] is negative
2045                  * in the image view when viewRedrawForce is called */
2046                 block->aspect= 2.0/fabs( (getsizex)*block->winmat[0][0]);
2047         }
2048         else {
2049                 /* no subwindow created yet, for menus for example, so we
2050                  * use the main window instead, since buttons are created
2051                  * there anyway */
2052                 wm_subwindow_getmatrix(window, window->screen->mainwin, block->winmat);
2053                 wm_subwindow_getsize(window, window->screen->mainwin, &getsizex, &getsizey);
2054
2055                 block->aspect= 2.0/fabs(getsizex*block->winmat[0][0]);
2056                 block->auto_open= TRUE;
2057                 block->flag |= UI_BLOCK_LOOP; /* tag as menu */
2058         }
2059
2060         return block;
2061 }
2062
2063 uiBlock *uiGetBlock(const char *name, ARegion *ar)
2064 {
2065         return BLI_findstring(&ar->uiblocks, name, offsetof(uiBlock, name));
2066 }
2067
2068 void uiBlockSetEmboss(uiBlock *block, char dt)
2069 {
2070         block->dt= dt;
2071 }
2072
2073 void ui_check_but(uiBut *but)
2074 {
2075         /* if something changed in the button */
2076         double value= UI_BUT_VALUE_UNSET;
2077 //      float okwidth; // UNUSED
2078         
2079         ui_is_but_sel(but, &value);
2080         
2081         /* only update soft range while not editing */
2082         if(but->rnaprop && !(but->editval || but->editstr || but->editvec)) {
2083                 UI_GET_BUT_VALUE_INIT(but, value)
2084                 ui_set_but_soft_range(but, value);
2085         }
2086
2087         /* test for min and max, icon sliders, etc */
2088         switch( but->type ) {
2089                 case NUM:
2090                 case SLI:
2091                 case SCROLL:
2092                 case NUMSLI:
2093                 case HSVSLI:
2094                         UI_GET_BUT_VALUE_INIT(but, value)
2095                         if(value < (double)but->hardmin) ui_set_but_val(but, but->hardmin);
2096                         else if(value > (double)but->hardmax) ui_set_but_val(but, but->hardmax);
2097                         break;
2098                         
2099                 case NUMABS:
2100                 {
2101                         double value_abs;
2102                         UI_GET_BUT_VALUE_INIT(but, value)
2103                         value_abs= fabs(value);
2104                         if(value_abs < (double)but->hardmin) ui_set_but_val(but, but->hardmin);
2105                         else if(value_abs > (double)but->hardmax) ui_set_but_val(but, but->hardmax);
2106                         break;
2107                 }
2108                 case ICONTOG: 
2109                 case ICONTOGN:
2110                         if(!but->rnaprop || (RNA_property_flag(but->rnaprop) & PROP_ICONS_CONSECUTIVE)) {
2111                                 if(but->flag & UI_SELECT) but->iconadd= 1;
2112                                 else but->iconadd= 0;
2113                         }
2114                         break;
2115                         
2116                 case ICONROW:
2117                         if(!but->rnaprop || (RNA_property_flag(but->rnaprop) & PROP_ICONS_CONSECUTIVE)) {
2118                                 UI_GET_BUT_VALUE_INIT(but, value)
2119                                 but->iconadd= (int)value- (int)(but->hardmin);
2120                         }
2121                         break;
2122                         
2123                 case ICONTEXTROW:
2124                         if(!but->rnaprop || (RNA_property_flag(but->rnaprop) & PROP_ICONS_CONSECUTIVE)) {
2125                                 UI_GET_BUT_VALUE_INIT(but, value)
2126                                 but->iconadd= (int)value- (int)(but->hardmin);
2127                         }
2128                         break;
2129         }
2130         
2131         
2132         /* safety is 4 to enable small number buttons (like 'users') */
2133         // okwidth= -4 + (but->x2 - but->x1); // UNUSED
2134         
2135         /* name: */
2136         switch( but->type ) {
2137         
2138         case MENU:
2139         case ICONTEXTROW:
2140                 
2141                 if(but->x2 - but->x1 > 24) {
2142                         UI_GET_BUT_VALUE_INIT(but, value)
2143                         ui_set_name_menu(but, (int)value);
2144                 }
2145                 break;
2146         
2147         case NUM:
2148         case NUMSLI:
2149         case HSVSLI:
2150         case NUMABS:
2151
2152                 UI_GET_BUT_VALUE_INIT(but, value)
2153
2154                 if(ui_is_but_float(but)) {
2155                         if(value == (double) FLT_MAX) BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%sinf", but->str);
2156                         else if(value == (double) -FLT_MAX) BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s-inf", but->str);
2157                         /* support length type buttons */
2158                         else if(ui_is_but_unit(but)) {
2159                                 char new_str[sizeof(but->drawstr)];
2160                                 ui_get_but_string_unit(but, new_str, sizeof(new_str), value, TRUE);
2161                                 BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%s", but->str, new_str);
2162                         }
2163                         else {
2164                                 const int prec= ui_but_float_precision(but, value);
2165                                 BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%.*f", but->str, prec, value);
2166                         }
2167                 }
2168                 else {
2169                         BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%d", but->str, (int)value);
2170                 }
2171                         
2172                 if(but->rnaprop) {
2173                         PropertySubType pstype = RNA_property_subtype(but->rnaprop);
2174                         
2175                         if (pstype == PROP_PERCENTAGE)
2176                                 strcat(but->drawstr, "%");
2177                 }
2178                 break;
2179
2180         case LABEL:
2181                 if(ui_is_but_float(but)) {
2182                         int prec;
2183                         UI_GET_BUT_VALUE_INIT(but, value)
2184                         prec= ui_but_float_precision(but, value);
2185                         BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%.*f", but->str, prec, value);
2186                 }
2187                 else {
2188                         BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR);
2189                 }
2190                 
2191                 break;
2192
2193         case IDPOIN:
2194         case TEX:
2195         case SEARCH_MENU:
2196                 if(!but->editstr) {
2197                         char str[UI_MAX_DRAW_STR];
2198
2199                         ui_get_but_string(but, str, UI_MAX_DRAW_STR-strlen(but->str));
2200
2201                         BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%s", but->str, str);
2202                 }
2203                 break;
2204         
2205         case KEYEVT:
2206                 BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR);
2207                 if (but->flag & UI_SELECT) {
2208                         strcat(but->drawstr, "Press a key");
2209                 }
2210                 else {
2211                         UI_GET_BUT_VALUE_INIT(but, value)
2212                         strcat(but->drawstr, WM_key_event_string((short)value));
2213                 }
2214                 break;
2215                 
2216         case HOTKEYEVT:
2217                 if (but->flag & UI_SELECT) {
2218                         but->drawstr[0]= '\0';
2219                         
2220                         if(but->modifier_key) {
2221                                 char *str= but->drawstr;
2222                                 
2223                                 if(but->modifier_key & KM_SHIFT)
2224                                         str= strcat(str, "Shift ");
2225                                 if(but->modifier_key & KM_CTRL)
2226                                         str= strcat(str, "Ctrl ");
2227                                 if(but->modifier_key & KM_ALT)
2228                                         str= strcat(str, "Alt ");
2229                                 if(but->modifier_key & KM_OSKEY)
2230                                         str= strcat(str, "Cmd ");
2231
2232                                 (void)str; /* UNUSED */
2233                         }
2234                         else
2235                                 strcat(but->drawstr, "Press a key  ");
2236                 }
2237                 else
2238                         BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR);
2239
2240                 break;
2241                 
2242         case BUT_TOGDUAL:
2243                 /* trying to get the dual-icon to left of text... not very nice */
2244                 if(but->str[0]) {
2245                         BLI_strncpy(but->drawstr, "  ", UI_MAX_DRAW_STR);
2246                         BLI_strncpy(but->drawstr+2, but->str, UI_MAX_DRAW_STR-2);
2247                 }
2248                 break;
2249
2250         case HSVCUBE:
2251         case HSVCIRCLE:
2252                 break;
2253         default:
2254                 BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR);
2255                 
2256         }
2257
2258         /* if we are doing text editing, this will override the drawstr */
2259         if(but->editstr)
2260                 BLI_strncpy(but->drawstr, but->editstr, UI_MAX_DRAW_STR);
2261         
2262         /* text clipping moved to widget drawing code itself */
2263 }
2264
2265
2266 void uiBlockBeginAlign(uiBlock *block)
2267 {
2268         /* if other align was active, end it */
2269         if(block->flag & UI_BUT_ALIGN) uiBlockEndAlign(block);
2270
2271         block->flag |= UI_BUT_ALIGN_DOWN;       
2272         block->alignnr++;
2273
2274         /* buttons declared after this call will get this align nr */ // XXX flag?
2275 }
2276
2277 static int buts_are_horiz(uiBut *but1, uiBut *but2)
2278 {
2279         float dx, dy;
2280         
2281         dx= fabs( but1->x2 - but2->x1);
2282         dy= fabs( but1->y1 - but2->y2);
2283         
2284         if(dx > dy) return 0;
2285         return 1;
2286 }
2287
2288 void uiBlockEndAlign(uiBlock *block)
2289 {
2290         block->flag &= ~UI_BUT_ALIGN;   // all 4 flags
2291 }
2292
2293 int ui_but_can_align(uiBut *but)
2294 {
2295         return !ELEM3(but->type, LABEL, OPTION, OPTIONN);
2296 }
2297
2298 static void ui_block_do_align_but(uiBut *first, short nr)
2299 {
2300         uiBut *prev, *but=NULL, *next;
2301         int flag= 0, cols=0, rows=0;
2302         
2303         /* auto align */
2304
2305         for(but=first; but && but->alignnr == nr; but=but->next) {
2306                 if(but->next && but->next->alignnr == nr) {
2307                         if(buts_are_horiz(but, but->next)) cols++;
2308                         else rows++;
2309                 }
2310         }
2311
2312         /* rows==0: 1 row, cols==0: 1 collumn */
2313         
2314         /* note;  how it uses 'flag' in loop below (either set it, or OR it) is confusing */
2315         for(but=first, prev=NULL; but && but->alignnr == nr; prev=but, but=but->next) {
2316                 next= but->next;
2317                 if(next && next->alignnr != nr)
2318                         next= NULL;
2319
2320                 /* clear old flag */
2321                 but->flag &= ~UI_BUT_ALIGN;
2322                         
2323                 if(flag==0) {   /* first case */
2324                         if(next) {
2325                                 if(buts_are_horiz(but, next)) {
2326                                         if(rows==0)
2327                                                 flag= UI_BUT_ALIGN_RIGHT;
2328                                         else 
2329                                                 flag= UI_BUT_ALIGN_DOWN|UI_BUT_ALIGN_RIGHT;
2330                                 }
2331                                 else {
2332                                         flag= UI_BUT_ALIGN_DOWN;
2333                                 }
2334                         }
2335                 }
2336                 else if(next==NULL) {   /* last case */
2337                         if(prev) {
2338                                 if(buts_are_horiz(prev, but)) {
2339                                         if(rows==0) 
2340                                                 flag= UI_BUT_ALIGN_LEFT;
2341                                         else
2342                                                 flag= UI_BUT_ALIGN_TOP|UI_BUT_ALIGN_LEFT;
2343                                 }
2344                                 else flag= UI_BUT_ALIGN_TOP;
2345                         }
2346                 }
2347                 else if(buts_are_horiz(but, next)) {
2348                         /* check if this is already second row */
2349                         if( prev && buts_are_horiz(prev, but)==0) {
2350                                 flag &= ~UI_BUT_ALIGN_LEFT;
2351                                 flag |= UI_BUT_ALIGN_TOP;
2352                                 /* exception case: bottom row */
2353                                 if(rows>0) {
2354                                         uiBut *bt= but;
2355                                         while(bt && bt->alignnr == nr) {
2356                                                 if(bt->next && bt->next->alignnr == nr && buts_are_horiz(bt, bt->next)==0 ) break; 
2357                                                 bt= bt->next;
2358                                         }
2359                                         if(bt==NULL || bt->alignnr != nr) flag= UI_BUT_ALIGN_TOP|UI_BUT_ALIGN_RIGHT;
2360                                 }
2361                         }
2362                         else flag |= UI_BUT_ALIGN_LEFT;
2363                 }
2364                 else {
2365                         if(cols==0) {
2366                                 flag |= UI_BUT_ALIGN_TOP;
2367                         }
2368                         else {  /* next button switches to new row */
2369                                 
2370                                 if(prev && buts_are_horiz(prev, but))
2371                                         flag |= UI_BUT_ALIGN_LEFT;
2372                                 else {
2373                                         flag &= ~UI_BUT_ALIGN_LEFT;
2374                                         flag |= UI_BUT_ALIGN_TOP;
2375                                 }
2376                                 
2377                                 if( (flag & UI_BUT_ALIGN_TOP)==0) {     /* stil top row */
2378                                         if(prev) {
2379                                                 if(next && buts_are_horiz(but, next))
2380                                                         flag = UI_BUT_ALIGN_DOWN|UI_BUT_ALIGN_LEFT|UI_BUT_ALIGN_RIGHT;
2381                                                 else {
2382                                                         /* last button in top row */
2383                                                         flag = UI_BUT_ALIGN_DOWN|UI_BUT_ALIGN_LEFT;
2384                                                 }
2385                                         }
2386                                         else 
2387                                                 flag |= UI_BUT_ALIGN_DOWN;
2388                                 }
2389                                 else 
2390                                         flag |= UI_BUT_ALIGN_TOP;
2391                         }
2392                 }
2393                 
2394                 but->flag |= flag;
2395                 
2396                 /* merge coordinates */
2397                 if(prev) {
2398                         // simple cases 
2399                         if(rows==0) {
2400                                 but->x1= (prev->x2+but->x1)/2.0f;
2401                                 prev->x2= but->x1;
2402                         }
2403                         else if(cols==0) {
2404                                 but->y2= (prev->y1+but->y2)/2.0f;
2405                                 prev->y1= but->y2;
2406                         }
2407                         else {
2408                                 if(buts_are_horiz(prev, but)) {
2409                                         but->x1= (prev->x2+but->x1)/2.0f;
2410                                         prev->x2= but->x1;
2411                                         /* copy height too */
2412                                         but->y2= prev->y2;
2413                                 }
2414                                 else if(prev->prev && buts_are_horiz(prev->prev, prev)==0) {
2415                                         /* the previous button is a single one in its row */
2416                                         but->y2= (prev->y1+but->y2)/2.0f;
2417                                         prev->y1= but->y2;
2418                                         
2419                                         but->x1= prev->x1;
2420                                         if(next && buts_are_horiz(but, next)==0)
2421                                                 but->x2= prev->x2;
2422                                 }
2423                                 else {
2424                                         /* the previous button is not a single one in its row */
2425                                         but->y2= prev->y1;
2426                                 }
2427                         }
2428                 }
2429         }
2430 }
2431
2432 void ui_block_do_align(uiBlock *block)
2433 {
2434         uiBut *but;
2435         short nr;
2436
2437         /* align buttons with same align nr */
2438         for(but=block->buttons.first; but;) {
2439                 if(but->alignnr) {
2440                         nr= but->alignnr;
2441                         ui_block_do_align_but(but, nr);
2442
2443                         /* skip with same number */
2444                         for(; but && but->alignnr == nr; but=but->next);
2445
2446                         if(!but)
2447                                 break;
2448                 }
2449                 else
2450                         but= but->next;
2451         }
2452 }
2453
2454 /*
2455 ui_def_but is the function that draws many button types
2456
2457 for float buttons:
2458         "a1" Click Step (how much to change the value each click)
2459         "a2" Number of decimal point values to display. 0 defaults to 3 (0.000) 1,2,3, and a maximum of 4,
2460            all greater values will be clamped to 4.
2461
2462 */
2463 static uiBut *ui_def_but(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2, const char *tip)
2464 {
2465         uiBut *but;
2466         int slen;
2467         
2468         if(type & BUTPOIN) {            /* a pointer is required */
2469                 if(poin==NULL)
2470                         return NULL;
2471         }
2472
2473         but= MEM_callocN(sizeof(uiBut), "uiBut");
2474
2475         but->type= type & BUTTYPE;
2476         but->pointype= type & BUTPOIN;
2477         but->bit= type & BIT;
2478         but->bitnr= type & 31;
2479         but->icon = ICON_NONE;
2480         but->iconadd=0;
2481
2482         but->retval= retval;
2483
2484         slen= strlen(str);
2485         if(slen >= UI_MAX_NAME_STR-1) {
2486                 but->str= MEM_mallocN(slen+2, "ui_def_but str"); /* why +2 ? */
2487         }
2488         else {
2489                 but->str= but->strdata;
2490         }
2491         memcpy(but->str, str, slen+1);
2492
2493         but->x1= x1; 
2494         but->y1= y1;
2495         but->x2= (x1+x2); 
2496         but->y2= (y1+y2);
2497         
2498         but->poin= poin;
2499         but->hardmin= but->softmin= min; 
2500         but->hardmax= but->softmax= max;
2501         but->a1= a1; 
2502         but->a2= a2;
2503         but->tip= tip;
2504         
2505         but->lock= block->lock;
2506         but->lockstr= block->lockstr;
2507         but->dt= block->dt;
2508
2509         but->aspect= 1.0f; //XXX block->aspect;
2510         but->block= block;              // pointer back, used for frontbuffer status, and picker
2511
2512         if((block->flag & UI_BUT_ALIGN) && ui_but_can_align(but))
2513                 but->alignnr= block->alignnr;
2514
2515         but->func= block->func;
2516         but->func_arg1= block->func_arg1;
2517         but->func_arg2= block->func_arg2;
2518
2519         but->funcN= block->funcN;
2520         if(block->func_argN)
2521                 but->func_argN= MEM_dupallocN(block->func_argN);
2522         
2523         but->pos= -1;   /* cursor invisible */
2524
2525         if(ELEM4(but->type, NUM, NUMABS, NUMSLI, HSVSLI)) {     /* add a space to name */
2526                 /* slen remains unchanged from previous assignment, ensure this stays true */
2527                 if(slen>0 && slen<UI_MAX_NAME_STR-2) {
2528                         if(but->str[slen-1]!=' ') {
2529                                 but->str[slen]= ' ';
2530                                 but->str[slen+1]= 0;
2531                         }
2532                 }
2533         }
2534
2535         if((block->flag & UI_BLOCK_LOOP) || ELEM8(but->type, MENU, TEX, LABEL, IDPOIN, BLOCK, BUTM, SEARCH_MENU, PROGRESSBAR))
2536                 but->flag |= (UI_TEXT_LEFT|UI_ICON_LEFT);
2537         else if(but->type==BUT_TOGDUAL)
2538                 but->flag |= UI_ICON_LEFT;
2539
2540         but->flag |= (block->flag & UI_BUT_ALIGN);
2541
2542         if (but->lock) {
2543                 if (but->lockstr) {
2544                         but->flag |= UI_BUT_DISABLED;
2545                 }
2546         }
2547
2548         /* keep track of UI_interface.h */
2549         if(ELEM7(but->type, BLOCK, BUT, LABEL, PULLDOWN, ROUNDBOX, LISTBOX, BUTM));
2550         else if(ELEM3(but->type, SCROLL, SEPR, FTPREVIEW));
2551         else if(but->type >= SEARCH_MENU);
2552         else but->flag |= UI_BUT_UNDO;
2553
2554         BLI_addtail(&block->buttons, but);
2555         
2556         if(block->curlayout)
2557                 ui_layout_add_but(block->curlayout, but);
2558
2559         return but;
2560 }
2561
2562 /* ui_def_but_rna_propname and ui_def_but_rna
2563  * both take the same args except for propname vs prop, this is done so we can
2564  * avoid an extra lookup on 'prop' when its already available.
2565  *
2566  * When this kind of change won't disrupt branches, best look into making more
2567  * of our UI functions take prop rather then propname.
2568  */
2569
2570 #define UI_DEF_BUT_RNA_DISABLE(but) \
2571         but->flag |= UI_BUT_DISABLED; \
2572         but->lock = 1; \
2573         but->lockstr = ""
2574
2575
2576 static uiBut *ui_def_but_rna(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2,  const char *tip)
2577 {
2578         const PropertyType proptype= RNA_property_type(prop);
2579         uiBut *but;
2580         int freestr= 0, icon= 0;
2581
2582         /* use rna values if parameters are not specified */
2583         if(!str) {
2584                 if(type == MENU && proptype == PROP_ENUM) {
2585                         EnumPropertyItem *item;
2586                         DynStr *dynstr;
2587                         int i, totitem, value, free;
2588
2589                         RNA_property_enum_items_gettexted(block->evil_C, ptr, prop, &item, &totitem, &free);
2590                         value= RNA_property_enum_get(ptr, prop);
2591
2592                         dynstr= BLI_dynstr_new();
2593                         BLI_dynstr_appendf(dynstr, "%s%%t", RNA_property_ui_name(prop));
2594                         for(i=0; i<totitem; i++) {
2595                                 if(!item[i].identifier[0]) {
2596                                         if(item[i].name)
2597                                                 BLI_dynstr_appendf(dynstr, "|%s%%l", item[i].name);
2598                                         else
2599                                                 BLI_dynstr_append(dynstr, "|%l");
2600                                 }
2601                                 else if(item[i].icon)
2602                                         BLI_dynstr_appendf(dynstr, "|%s %%i%d %%x%d", item[i].name, item[i].icon, item[i].value);
2603                                 else
2604                                         BLI_dynstr_appendf(dynstr, "|%s %%x%d", item[i].name, item[i].value);
2605
2606                                 if(value == item[i].value) {
2607                                         icon= item[i].icon;
2608                                         if(!tip)
2609                                                 tip= item[i].description;
2610                                 }
2611                         }
2612                         str= BLI_dynstr_get_cstring(dynstr);
2613                         BLI_dynstr_free(dynstr);
2614
2615                         if(free)
2616                                 MEM_freeN(item);
2617
2618                         freestr= 1;
2619                 }
2620                 else if(ELEM(type, ROW, LISTROW) && proptype == PROP_ENUM) {
2621                         EnumPropertyItem *item;
2622                         int i, totitem, free;
2623
2624                         RNA_property_enum_items_gettexted(block->evil_C, ptr, prop, &item, &totitem, &free);
2625                         for(i=0; i<totitem; i++) {
2626                                 if(item[i].identifier[0] && item[i].value == (int)max) {
2627                                         str= item[i].name;
2628                                         icon= item[i].icon;
2629                                 }
2630                         }
2631
2632                         if(!str)
2633                                 str= RNA_property_ui_name(prop);
2634                         if(free)
2635                                 MEM_freeN(item);
2636                 }
2637                 else {
2638                         str= RNA_property_ui_name(prop);
2639                         icon= RNA_property_ui_icon(prop);
2640                 }
2641         }
2642
2643         if(!tip && proptype != PROP_ENUM)
2644                 tip= RNA_property_ui_description(prop);
2645
2646         if(min == max || a1 == -1 || a2 == -1) {
2647                 if(proptype == PROP_INT) {
2648                         int hardmin, hardmax, softmin, softmax, step;
2649
2650                         RNA_property_int_range(ptr, prop, &hardmin, &hardmax);
2651                         RNA_property_int_ui_range(ptr, prop, &softmin, &softmax, &step);
2652
2653                         if(!ELEM(type, ROW, LISTROW) && min == max) {
2654                                 min= hardmin;
2655                                 max= hardmax;
2656                         }
2657                         if(a1 == -1)
2658                                 a1= step;
2659                         if(a2 == -1)
2660                                 a2= 0;
2661                 }
2662                 else if(proptype == PROP_FLOAT) {
2663                         float hardmin, hardmax, softmin, softmax, step, precision;
2664
2665                         RNA_property_float_range(ptr, prop, &hardmin, &hardmax);
2666                         RNA_property_float_ui_range(ptr, prop, &softmin, &softmax, &step, &precision);
2667
2668                         if(!ELEM(type, ROW, LISTROW) && min == max) {
2669                                 min= hardmin;
2670                                 max= hardmax;
2671                         }
2672                         if(a1 == -1)
2673                                 a1= step;
2674                         if(a2 == -1)
2675                                 a2= precision;
2676                 }
2677                 else if(proptype == PROP_STRING) {
2678                         min= 0;
2679                         max= RNA_property_string_maxlength(prop);
2680                         if(max == 0) /* interface code should ideally support unlimited length */
2681                                 max= UI_MAX_DRAW_STR;
2682                 }
2683         }
2684
2685         /* now create button */
2686         but= ui_def_but(block, type, retval, str, x1, y1, x2, y2, NULL, min, max, a1, a2, tip);
2687
2688         but->rnapoin= *ptr;
2689         but->rnaprop= prop;
2690
2691         if(RNA_property_array_length(&but->rnapoin, but->rnaprop))
2692                 but->rnaindex= index;
2693         else
2694                 but->rnaindex= 0;
2695
2696         if(icon) {
2697                 but->icon= (BIFIconID)icon;
2698                 but->flag |= UI_HAS_ICON;
2699                 but->flag|= UI_ICON_LEFT;
2700         }
2701         
2702         if (!RNA_property_editable(&but->rnapoin, prop)) {
2703                 UI_DEF_BUT_RNA_DISABLE(but);
2704         }
2705
2706         if (but->flag & UI_BUT_UNDO && (ui_but_is_rna_undo(but) == FALSE)) {
2707                 but->flag &= ~UI_BUT_UNDO;
2708         }
2709
2710         /* If this button uses units, calculate the step from this */
2711         if((proptype == PROP_FLOAT) && ui_is_but_unit(but)) {
2712                 but->a1= ui_get_but_step_unit(but, but->a1);
2713         }
2714
2715         if(freestr)
2716                 MEM_freeN((void *)str);
2717         
2718         return but;
2719 }
2720
2721 static uiBut *ui_def_but_rna_propname(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2,  const char *tip)
2722 {
2723         PropertyRNA *prop= RNA_struct_find_property(ptr, propname);
2724         uiBut *but;
2725
2726         if(prop) {
2727                 but= ui_def_but_rna(block, type, retval, str, x1, y1, x2, y2, ptr, prop, index, min, max, a1, a2,  tip);
2728         }
2729         else {
2730                 but= ui_def_but(block, type, retval, propname, x1, y1, x2, y2, NULL, min, max, a1, a2, tip);
2731
2732                 UI_DEF_BUT_RNA_DISABLE(but);
2733         }
2734
2735         return but;
2736 }
2737
2738 static uiBut *ui_def_but_operator(uiBlock *block, int type, const char *opname, int opcontext, const char *str, int x1, int y1, short x2, short y2, const char *tip)
2739 {
2740         uiBut *but;
2741         wmOperatorType *ot;
2742         
2743         ot= WM_operatortype_find(opname, 0);
2744
2745         if(!str) {
2746                 if(ot) str= ot->name;
2747                 else str= opname;
2748         }
2749         
2750         if ((!tip || tip[0]=='\0') && ot && ot->description) {
2751                 tip= ot->description;
2752
2753 #ifdef WITH_INTERNATIONAL
2754                 if(UI_translate_tooltips())
2755                         tip= BLF_gettext(tip);
2756 #endif
2757         }
2758
2759         but= ui_def_but(block, type, -1, str, x1, y1, x2, y2, NULL, 0, 0, 0, 0, tip);
2760         but->optype= ot;
2761         but->opcontext= opcontext;
2762         but->flag &= ~UI_BUT_UNDO; /* no need for ui_but_is_undo(), we never need undo here */
2763
2764         if(!ot) {
2765                 but->flag |= UI_BUT_DISABLED;
2766                 but->lock = 1;
2767                 but->lockstr = "";
2768         }
2769
2770         return but;
2771 }
2772
2773 static uiBut *ui_def_but_operator_text(uiBlock *block, int type, const char *opname, int opcontext, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2, const char *tip)
2774 {
2775         uiBut *but;
2776         wmOperatorType *ot;
2777         
2778         ot= WM_operatortype_find(opname, 0);
2779
2780         if(!str) {
2781                 if(ot) str= ot->name;
2782                 else str= opname;
2783         }
2784         
2785         if ((!tip || tip[0]=='\0') && ot && ot->description) {
2786                 tip= ot->description;
2787         }
2788
2789         but= ui_def_but(block, type, -1, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
2790         but->optype= ot;
2791         but->opcontext= opcontext;
2792         but->flag &= ~UI_BUT_UNDO; /* no need for ui_but_is_undo(), we never need undo here */
2793
2794         if(!ot) {
2795                 but->flag |= UI_BUT_DISABLED;
2796                 but->lock = 1;
2797                 but->lockstr = "";
2798         }
2799
2800         return but;
2801 }
2802
2803 uiBut *uiDefBut(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2, const char *tip)
2804 {
2805         uiBut *but= ui_def_but(block, type, retval, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
2806
2807         ui_check_but(but);
2808         
2809         return but;
2810 }
2811
2812         /* if _x_ is a power of two (only one bit) return the power,
2813          * otherwise return -1. 
2814          * (1<<findBitIndex(x))==x for powers of two.
2815          */
2816 static int findBitIndex(unsigned int x)
2817 {
2818         if (!x || (x&(x-1))!=0) {       /* x&(x-1) strips lowest bit */
2819                 return -1;
2820         } else {
2821                 int idx= 0;
2822
2823                 if (x&0xFFFF0000)       idx+=16, x>>=16;
2824                 if (x&0xFF00)           idx+=8, x>>=8;
2825                 if (x&0xF0)                     idx+=4, x>>=4;
2826                 if (x&0xC)                      idx+=2, x>>=2;
2827                 if (x&0x2)                      idx+=1;
2828
2829                 return idx;
2830         }
2831 }
2832
2833 /* autocomplete helper functions */
2834 struct AutoComplete {
2835         size_t maxlen;
2836         char *truncate;
2837         const char *startname;
2838 };
2839
2840 AutoComplete *autocomplete_begin(const char *startname, size_t maxlen)
2841 {
2842         AutoComplete *autocpl;
2843         
2844         autocpl= MEM_callocN(sizeof(AutoComplete), "AutoComplete");
2845         autocpl->maxlen= maxlen;
2846         autocpl->truncate= MEM_callocN(sizeof(char)*maxlen, "AutoCompleteTruncate");
2847         autocpl->startname= startname;
2848
2849         return autocpl;
2850 }
2851
2852 void autocomplete_do_name(AutoComplete *autocpl, const char *name)
2853 {
2854         char *truncate= autocpl->truncate;
2855         const char *startname= autocpl->startname;
2856         int a;
2857
2858         for(a=0; a<autocpl->maxlen-1; a++) {
2859                 if(startname[a]==0 || startname[a]!=name[a])
2860                         break;
2861         }
2862         /* found a match */
2863         if(startname[a]==0) {
2864                 /* first match */
2865                 if(truncate[0]==0)
2866                         BLI_strncpy(truncate, name, autocpl->maxlen);
2867                 else {
2868                         /* remove from truncate what is not in bone->name */
2869                         for(a=0; a<autocpl->maxlen-1; a++) {
2870                                 if(name[a] == 0) {
2871                                         truncate[a]= 0;
2872                                         break;
2873                                 }
2874                                 else if(truncate[a]!=name[a])
2875                                         truncate[a]= 0;
2876                         }
2877                 }
2878         }
2879 }
2880
2881 void autocomplete_end(AutoComplete *autocpl, char *autoname)
2882 {       
2883         if(autocpl->truncate[0])
2884                 BLI_strncpy(autoname, autocpl->truncate, autocpl->maxlen);
2885         else {
2886                 if (autoname != autocpl->startname) /* dont copy a string over its self */
2887                         BLI_strncpy(autoname, autocpl->startname, autocpl->maxlen);
2888         }
2889         MEM_freeN(autocpl->truncate);
2890         MEM_freeN(autocpl);
2891 }
2892
2893 /* autocomplete callback for ID buttons */
2894 static void autocomplete_id(bContext *C, char *str, void *arg_v)
2895 {
2896         int blocktype= (intptr_t)arg_v;
2897         ListBase *listb= which_libbase(CTX_data_main(C), blocktype);
2898         
2899         if(listb==NULL) return;
2900         
2901         /* search if str matches the beginning of an ID struct */
2902         if(str[0]) {
2903                 AutoComplete *autocpl= autocomplete_begin(str, 22);
2904                 ID *id;
2905                 
2906                 for(id= listb->first; id; id= id->next)
2907                         autocomplete_do_name(autocpl, id->name+2);
2908
2909                 autocomplete_end(autocpl, str);
2910         }
2911 }
2912
2913 static void ui_check_but_and_iconize(uiBut *but, int icon)
2914 {
2915         if(icon) {
2916                 but->icon= (BIFIconID) icon;
2917                 but->flag|= UI_HAS_ICON;
2918         }
2919
2920         ui_check_but(but);
2921 }
2922
2923 static uiBut *uiDefButBit(uiBlock *block, int type, int bit, int retval, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2,  const char *tip)
2924 {
2925         int bitIdx= findBitIndex(bit);
2926         if (bitIdx==-1) {
2927                 return NULL;
2928         } else {
2929                 return uiDefBut(block, type|BIT|bitIdx, retval, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
2930         }
2931 }
2932 uiBut *uiDefButF(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
2933 {
2934         return uiDefBut(block, type|FLO, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2935 }
2936 uiBut *uiDefButBitF(uiBlock *block, int type, int bit, int retval, const char *str, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
2937 {
2938         return uiDefButBit(block, type|FLO, bit, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2939 }
2940 uiBut *uiDefButI(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
2941 {
2942         return uiDefBut(block, type|INT, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2943 }
2944 uiBut *uiDefButBitI(uiBlock *block, int type, int bit, int retval, const char *str, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
2945 {
2946         return uiDefButBit(block, type|INT, bit, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2947 }
2948 uiBut *uiDefButS(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
2949 {
2950         return uiDefBut(block, type|SHO, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2951 }
2952 uiBut *uiDefButBitS(uiBlock *block, int type, int bit, int retval, const char *str, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
2953 {
2954         return uiDefButBit(block, type|SHO, bit, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2955 }
2956 uiBut *uiDefButC(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
2957 {
2958         return uiDefBut(block, type|CHA, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2959 }
2960 uiBut *uiDefButBitC(uiBlock *block, int type, int bit, int retval, const char *str, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
2961 {
2962         return uiDefButBit(block, type|CHA, bit, retval, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
2963 }
2964 uiBut *uiDefButR(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2,  const char *tip)
2965 {
2966         uiBut *but;
2967         but= ui_def_but_rna_propname(block, type, retval, str, x1, y1, x2, y2, ptr, propname, index, min, max, a1, a2, tip);
2968         ui_check_but(but);
2969         return but;
2970 }
2971 uiBut *uiDefButR_prop(uiBlock *block, int type, int retval, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2,  const char *tip)
2972 {
2973         uiBut *but;
2974         but= ui_def_but_rna(block, type, retval, str, x1, y1, x2, y2, ptr, prop, index, min, max, a1, a2, tip);
2975         ui_check_but(but);
2976         return but;
2977 }
2978 uiBut *uiDefButO(uiBlock *block, int type, const char *opname, int opcontext, const char *str, int x1, int y1, short x2, short y2, const char *tip)
2979 {
2980         uiBut *but;
2981         but= ui_def_but_operator(block, type, opname, opcontext, str, x1, y1, x2, y2, tip);
2982         ui_check_but(but);
2983         return but;
2984 }
2985
2986 uiBut *uiDefButTextO(uiBlock *block, int type, const char *opname, int opcontext, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2,  const char *tip)
2987 {
2988         uiBut *but= ui_def_but_operator_text(block, type, opname, opcontext, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
2989         ui_check_but(but);
2990         return but;
2991 }
2992
2993 /* if a1==1.0 then a2 is an extra icon blending factor (alpha 0.0 - 1.0) */
2994 uiBut *uiDefIconBut(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2,  const char *tip)
2995 {
2996         uiBut *but= ui_def_but(block, type, retval, "", x1, y1, x2, y2, poin, min, max, a1, a2, tip);
2997         ui_check_but_and_iconize(but, icon);
2998         return but;
2999 }
3000 static uiBut *uiDefIconButBit(uiBlock *block, int type, int bit, int retval, int icon, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2, const char *tip)
3001 {
3002         int bitIdx= findBitIndex(bit);
3003         if (bitIdx==-1) {
3004                 return NULL;
3005         } else {
3006                 return uiDefIconBut(block, type|BIT|bitIdx, retval, icon, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
3007         }
3008 }
3009
3010 uiBut *uiDefIconButF(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
3011 {
3012         return uiDefIconBut(block, type|FLO, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3013 }
3014 uiBut *uiDefIconButBitF(uiBlock *block, int type, int bit, int retval, int icon, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
3015 {
3016         return uiDefIconButBit(block, type|FLO, bit, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3017 }
3018 uiBut *uiDefIconButI(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
3019 {
3020         return uiDefIconBut(block, type|INT, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3021 }
3022 uiBut *uiDefIconButBitI(uiBlock *block, int type, int bit, int retval, int icon, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
3023 {
3024         return uiDefIconButBit(block, type|INT, bit, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3025 }
3026 uiBut *uiDefIconButS(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
3027 {
3028         return uiDefIconBut(block, type|SHO, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3029 }
3030 uiBut *uiDefIconButBitS(uiBlock *block, int type, int bit, int retval, int icon, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
3031 {
3032         return uiDefIconButBit(block, type|SHO, bit, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3033 }
3034 uiBut *uiDefIconButC(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
3035 {
3036         return uiDefIconBut(block, type|CHA, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3037 }
3038 uiBut *uiDefIconButBitC(uiBlock *block, int type, int bit, int retval, int icon, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
3039 {
3040         return uiDefIconButBit(block, type|CHA, bit, retval, icon, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3041 }
3042 uiBut *uiDefIconButR(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2,  const char *tip)
3043 {
3044         uiBut *but;
3045         but= ui_def_but_rna_propname(block, type, retval, "", x1, y1, x2, y2, ptr, propname, index, min, max, a1, a2, tip);
3046         ui_check_but_and_iconize(but, icon);
3047         return but;
3048 }
3049 uiBut *uiDefIconButR_prop(uiBlock *block, int type, int retval, int icon, int x1, int y1, short x2, short y2, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2,  const char *tip)
3050 {
3051         uiBut *but;
3052         but= ui_def_but_rna(block, type, retval, "", x1, y1, x2, y2, ptr, prop, index, min, max, a1, a2, tip);
3053         ui_check_but_and_iconize(but, icon);
3054         return but;
3055 }
3056 uiBut *uiDefIconButO(uiBlock *block, int type, const char *opname, int opcontext, int icon, int x1, int y1, short x2, short y2, const char *tip)
3057 {
3058         uiBut *but;
3059         but= ui_def_but_operator(block, type, opname, opcontext, "", x1, y1, x2, y2, tip);
3060         ui_check_but_and_iconize(but, icon);
3061         return but;
3062 }
3063
3064 /* Button containing both string label and icon */
3065 uiBut *uiDefIconTextBut(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2,  const char *tip)
3066 {
3067         uiBut *but= ui_def_but(block, type, retval, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
3068         ui_check_but_and_iconize(but, icon);
3069         but->flag|= UI_ICON_LEFT;
3070         return but;
3071 }
3072 static uiBut *uiDefIconTextButBit(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, void *poin, float min, float max, float a1, float a2,  const char *tip)
3073 {
3074         int bitIdx= findBitIndex(bit);
3075         if (bitIdx==-1) {
3076                 return NULL;
3077         } else {
3078                 return uiDefIconTextBut(block, type|BIT|bitIdx, retval, icon, str, x1, y1, x2, y2, poin, min, max, a1, a2, tip);
3079         }
3080 }
3081
3082 uiBut *uiDefIconTextButF(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
3083 {
3084         return uiDefIconTextBut(block, type|FLO, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3085 }
3086 uiBut *uiDefIconTextButBitF(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, float *poin, float min, float max, float a1, float a2,  const char *tip)
3087 {
3088         return uiDefIconTextButBit(block, type|FLO, bit, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3089 }
3090 uiBut *uiDefIconTextButI(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
3091 {
3092         return uiDefIconTextBut(block, type|INT, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3093 }
3094 uiBut *uiDefIconTextButBitI(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, int *poin, float min, float max, float a1, float a2,  const char *tip)
3095 {
3096         return uiDefIconTextButBit(block, type|INT, bit, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3097 }
3098 uiBut *uiDefIconTextButS(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
3099 {
3100         return uiDefIconTextBut(block, type|SHO, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3101 }
3102 uiBut *uiDefIconTextButBitS(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, short *poin, float min, float max, float a1, float a2,  const char *tip)
3103 {
3104         return uiDefIconTextButBit(block, type|SHO, bit, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3105 }
3106 uiBut *uiDefIconTextButC(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
3107 {
3108         return uiDefIconTextBut(block, type|CHA, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3109 }
3110 uiBut *uiDefIconTextButBitC(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, char *poin, float min, float max, float a1, float a2,  const char *tip)
3111 {
3112         return uiDefIconTextButBit(block, type|CHA, bit, retval, icon, str, x1, y1, x2, y2, (void*) poin, min, max, a1, a2, tip);
3113 }
3114 uiBut *uiDefIconTextButR(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2,  const char *tip)
3115 {
3116         uiBut *but;
3117         but= ui_def_but_rna_propname(block, type, retval, str, x1, y1, x2, y2, ptr, propname, index, min, max, a1, a2, tip);
3118         ui_check_but_and_iconize(but, icon);
3119         but->flag|= UI_ICON_LEFT;
3120         return but;
3121 }
3122 uiBut *uiDefIconTextButR_prop(uiBlock *block, int type, int retval, int icon, const char *str, int x1, int y1, short x2, short y2, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2,  const char *tip)
3123 {
3124         uiBut *but;
3125         but= ui_def_but_rna(block, type, retval, str, x1, y1, x2, y2, ptr, prop, index, min, max, a1, a2, tip);
3126         ui_check_but_and_iconize(but, icon);
3127         but->flag|= UI_ICON_LEFT;
3128         return but;
3129 }</