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