Merge branch 'master' into blender2.8
[blender.git] / source / blender / editors / interface / interface_layout.c
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * Contributor(s): Blender Foundation 2009.
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/editors/interface/interface_layout.c
24  *  \ingroup edinterface
25  */
26
27
28 #include <limits.h>
29 #include <math.h>
30 #include <stdlib.h>
31 #include <string.h>
32 #include <assert.h>
33
34 #include "MEM_guardedalloc.h"
35
36 #include "DNA_screen_types.h"
37 #include "DNA_armature_types.h"
38 #include "DNA_userdef_types.h"
39
40 #include "BLI_alloca.h"
41 #include "BLI_listbase.h"
42 #include "BLI_string.h"
43 #include "BLI_rect.h"
44 #include "BLI_utildefines.h"
45 #include "BLI_math.h"
46
47 #include "BLT_translation.h"
48
49 #include "BKE_context.h"
50 #include "BKE_global.h"
51 #include "BKE_idprop.h"
52 #include "BKE_screen.h"
53
54 #include "RNA_access.h"
55
56 #include "UI_interface.h"
57
58 #include "ED_armature.h"
59
60
61 #include "WM_api.h"
62 #include "WM_types.h"
63
64 #include "interface_intern.h"
65
66 /************************ Structs and Defines *************************/
67
68 #define UI_OPERATOR_ERROR_RET(_ot, _opname, return_statement)                 \
69         if (ot == NULL) {                                                         \
70                 ui_item_disabled(layout, _opname);                                    \
71                 RNA_warning("'%s' unknown operator", _opname);                        \
72                 return_statement;                                                     \
73         } (void)0                                                                 \
74
75 #define UI_ITEM_PROP_SEP_DIVIDE 0.5f
76
77 /* uiLayoutRoot */
78
79 typedef struct uiLayoutRoot {
80         struct uiLayoutRoot *next, *prev;
81
82         int type;
83         int opcontext;
84
85         int emw, emh;
86         int padding;
87
88         uiMenuHandleFunc handlefunc;
89         void *argv;
90
91         uiStyle *style;
92         uiBlock *block;
93         uiLayout *layout;
94 } uiLayoutRoot;
95
96 /* Item */
97
98 typedef enum uiItemType {
99         ITEM_BUTTON,
100
101         ITEM_LAYOUT_ROW,
102         ITEM_LAYOUT_COLUMN,
103         ITEM_LAYOUT_COLUMN_FLOW,
104         ITEM_LAYOUT_ROW_FLOW,
105         ITEM_LAYOUT_GRID_FLOW,
106         ITEM_LAYOUT_BOX,
107         ITEM_LAYOUT_ABSOLUTE,
108         ITEM_LAYOUT_SPLIT,
109         ITEM_LAYOUT_OVERLAP,
110         ITEM_LAYOUT_RADIAL,
111
112         ITEM_LAYOUT_ROOT
113 #if 0
114         TEMPLATE_COLUMN_FLOW,
115         TEMPLATE_SPLIT,
116         TEMPLATE_BOX,
117
118         TEMPLATE_HEADER,
119         TEMPLATE_HEADER_ID
120 #endif
121 } uiItemType;
122
123 typedef struct uiItem {
124         void *next, *prev;
125         uiItemType type;
126         int flag;
127 } uiItem;
128
129 enum {
130         UI_ITEM_FIXED     = 1 << 0,
131         UI_ITEM_MIN       = 1 << 1,
132
133         UI_ITEM_BOX_ITEM  = 1 << 2, /* The item is "inside" a box item */
134         UI_ITEM_PROP_SEP  = 1 << 3,
135 };
136
137 typedef struct uiButtonItem {
138         uiItem item;
139         uiBut *but;
140 } uiButtonItem;
141
142 struct uiLayout {
143         uiItem item;
144
145         uiLayoutRoot *root;
146         bContextStore *context;
147         ListBase items;
148
149         int x, y, w, h;
150         float scale[2];
151         short space;
152         bool align;
153         bool active;
154         bool enabled;
155         bool redalert;
156         bool keepaspect;
157         bool variable_size;  /* For layouts inside gridflow, they and their items shall never have a fixed maximal size. */
158         char alignment;
159         char emboss;
160 };
161
162 typedef struct uiLayoutItemFlow {
163         uiLayout litem;
164         int number;
165         int totcol;
166 } uiLayoutItemFlow;
167
168 typedef struct uiLayoutItemGridFlow {
169         uiLayout litem;
170
171         /* Extra parameters */
172         bool row_major;     /* Fill first row first, instead of filling first column first. */
173         bool even_columns;  /* Same width for all columns. */
174         bool even_rows;     /* Same height for all rows. */
175         /* If positive, absolute fixed number of columns.
176          * If 0, fully automatic (based on available width).
177          * If negative, automatic but only generates number of columns/rows multiple of given (absolute) value. */
178         int num_columns;
179
180         /* Pure internal runtime storage. */
181         int tot_items, tot_columns, tot_rows;
182 } uiLayoutItemGridFlow;
183
184 typedef struct uiLayoutItemBx {
185         uiLayout litem;
186         uiBut *roundbox;
187 } uiLayoutItemBx;
188
189 typedef struct uiLayoutItemSplit {
190         uiLayout litem;
191         float percentage;
192 } uiLayoutItemSplit;
193
194 typedef struct uiLayoutItemRoot {
195         uiLayout litem;
196 } uiLayoutItemRoot;
197
198 /************************** Item ***************************/
199
200 static const char *ui_item_name_add_colon(const char *name, char namestr[UI_MAX_NAME_STR])
201 {
202         int len = strlen(name);
203
204         if (len != 0 && len + 1 < UI_MAX_NAME_STR) {
205                 memcpy(namestr, name, len);
206                 namestr[len] = ':';
207                 namestr[len + 1] = '\0';
208                 return namestr;
209         }
210
211         return name;
212 }
213
214 static int ui_item_fit(int item, int pos, int all, int available, bool is_last, int alignment, float *extra_pixel)
215 {
216         /* available == 0 is unlimited */
217         if (ELEM(0, available, all)) {
218                 return item;
219         }
220
221         if (all > available) {
222                 /* contents is bigger than available space */
223                 if (is_last)
224                         return available - pos;
225                 else {
226                         float width = *extra_pixel + (item * available) / (float)all;
227                         *extra_pixel = width - (int)width;
228                         return (int)width;
229                 }
230         }
231         else {
232                 /* contents is smaller or equal to available space */
233                 if (alignment == UI_LAYOUT_ALIGN_EXPAND) {
234                         if (is_last)
235                                 return available - pos;
236                         else {
237                                 float width = *extra_pixel + (item * available) / (float)all;
238                                 *extra_pixel = width - (int)width;
239                                 return (int)width;
240                         }
241                 }
242                 else {
243                         return item;
244                 }
245         }
246 }
247
248 /* variable button size in which direction? */
249 #define UI_ITEM_VARY_X  1
250 #define UI_ITEM_VARY_Y  2
251
252 static int ui_layout_vary_direction(uiLayout *layout)
253 {
254         return ((ELEM(layout->root->type, UI_LAYOUT_HEADER, UI_LAYOUT_PIEMENU) ||
255                 (layout->alignment != UI_LAYOUT_ALIGN_EXPAND)) ?
256                 UI_ITEM_VARY_X : UI_ITEM_VARY_Y);
257 }
258
259 static bool ui_layout_variable_size(uiLayout *layout)
260 {
261         /* Note that this code is probably a bit flacky, we'd probably want to know whether it's variable in X and/or Y,
262          * etc. But for now it mimics previous one, with addition of variable flag set for children of gridflow layouts. */
263         return ui_layout_vary_direction(layout) == UI_ITEM_VARY_X || layout->variable_size;
264 }
265
266 /* estimated size of text + icon */
267 static int ui_text_icon_width(uiLayout *layout, const char *name, int icon, bool compact)
268 {
269         bool variable;
270         const int unit_x = UI_UNIT_X * (layout->scale[0] ? layout->scale[0] : 1.0f);
271
272         if (icon && !name[0])
273                 return unit_x;  /* icon only */
274
275         variable = ui_layout_variable_size(layout);
276
277         if (variable) {
278                 if (layout->alignment != UI_LAYOUT_ALIGN_EXPAND) {
279                         layout->item.flag |= UI_ITEM_MIN;
280                 }
281                 const uiFontStyle *fstyle = UI_FSTYLE_WIDGET;
282                 /* it may seem odd that the icon only adds (unit_x / 4)
283                  * but taking margins into account its fine */
284                 return (UI_fontstyle_string_width(fstyle, name) +
285                         (unit_x * ((compact ? 1.25f : 1.50f) +
286                                    (icon    ? 0.25f : 0.0f))));
287         }
288         else {
289                 return unit_x * 10;
290         }
291 }
292
293 static void ui_item_size(uiItem *item, int *r_w, int *r_h)
294 {
295         if (item->type == ITEM_BUTTON) {
296                 uiButtonItem *bitem = (uiButtonItem *)item;
297
298                 if (r_w) *r_w = BLI_rctf_size_x(&bitem->but->rect);
299                 if (r_h) *r_h = BLI_rctf_size_y(&bitem->but->rect);
300         }
301         else {
302                 uiLayout *litem = (uiLayout *)item;
303
304                 if (r_w) *r_w = litem->w;
305                 if (r_h) *r_h = litem->h;
306         }
307 }
308
309 static void ui_item_offset(uiItem *item, int *r_x, int *r_y)
310 {
311         if (item->type == ITEM_BUTTON) {
312                 uiButtonItem *bitem = (uiButtonItem *)item;
313
314                 if (r_x) *r_x = bitem->but->rect.xmin;
315                 if (r_y) *r_y = bitem->but->rect.ymin;
316         }
317         else {
318                 if (r_x) *r_x = 0;
319                 if (r_y) *r_y = 0;
320         }
321 }
322
323 static void ui_item_position(uiItem *item, int x, int y, int w, int h)
324 {
325         if (item->type == ITEM_BUTTON) {
326                 uiButtonItem *bitem = (uiButtonItem *)item;
327
328                 bitem->but->rect.xmin = x;
329                 bitem->but->rect.ymin = y;
330                 bitem->but->rect.xmax = x + w;
331                 bitem->but->rect.ymax = y + h;
332
333                 ui_but_update(bitem->but); /* for strlen */
334         }
335         else {
336                 uiLayout *litem = (uiLayout *)item;
337
338                 litem->x = x;
339                 litem->y = y + h;
340                 litem->w = w;
341                 litem->h = h;
342         }
343 }
344
345 static void ui_item_move(uiItem *item, int delta_xmin, int delta_xmax)
346 {
347         if (item->type == ITEM_BUTTON) {
348                 uiButtonItem *bitem = (uiButtonItem *)item;
349
350                 bitem->but->rect.xmin += delta_xmin;
351                 bitem->but->rect.xmax += delta_xmax;
352
353                 ui_but_update(bitem->but); /* for strlen */
354         }
355         else {
356                 uiLayout *litem = (uiLayout *)item;
357
358                 if (delta_xmin > 0)
359                         litem->x += delta_xmin;
360                 else
361                         litem->w += delta_xmax;
362         }
363 }
364
365 /******************** Special RNA Items *********************/
366
367 static int ui_layout_local_dir(uiLayout *layout)
368 {
369         switch (layout->item.type) {
370                 case ITEM_LAYOUT_ROW:
371                 case ITEM_LAYOUT_ROOT:
372                 case ITEM_LAYOUT_OVERLAP:
373                         return UI_LAYOUT_HORIZONTAL;
374                 case ITEM_LAYOUT_COLUMN:
375                 case ITEM_LAYOUT_COLUMN_FLOW:
376                 case ITEM_LAYOUT_GRID_FLOW:
377                 case ITEM_LAYOUT_SPLIT:
378                 case ITEM_LAYOUT_ABSOLUTE:
379                 case ITEM_LAYOUT_BOX:
380                 default:
381                         return UI_LAYOUT_VERTICAL;
382         }
383 }
384
385 static uiLayout *ui_item_local_sublayout(uiLayout *test, uiLayout *layout, int align)
386 {
387         uiLayout *sub;
388
389         if (ui_layout_local_dir(test) == UI_LAYOUT_HORIZONTAL)
390                 sub = uiLayoutRow(layout, align);
391         else
392                 sub = uiLayoutColumn(layout, align);
393
394         sub->space = 0;
395         return sub;
396 }
397
398 static void ui_layer_but_cb(bContext *C, void *arg_but, void *arg_index)
399 {
400         wmWindow *win = CTX_wm_window(C);
401         uiBut *but = arg_but, *cbut;
402         PointerRNA *ptr = &but->rnapoin;
403         PropertyRNA *prop = but->rnaprop;
404         int i, index = GET_INT_FROM_POINTER(arg_index);
405         int shift = win->eventstate->shift;
406         int len = RNA_property_array_length(ptr, prop);
407
408         if (!shift) {
409                 RNA_property_boolean_set_index(ptr, prop, index, true);
410
411                 for (i = 0; i < len; i++)
412                         if (i != index)
413                                 RNA_property_boolean_set_index(ptr, prop, i, 0);
414
415                 RNA_property_update(C, ptr, prop);
416
417                 for (cbut = but->block->buttons.first; cbut; cbut = cbut->next)
418                         ui_but_update(cbut);
419         }
420 }
421
422 /* create buttons for an item with an RNA array */
423 static void ui_item_array(
424         uiLayout *layout, uiBlock *block, const char *name, int icon,
425         PointerRNA *ptr, PropertyRNA *prop, int len, int x, int y, int w, int UNUSED(h),
426         bool expand, bool slider, bool toggle, bool icon_only, bool compact, bool show_text)
427 {
428         uiStyle *style = layout->root->style;
429         uiBut *but;
430         PropertyType type;
431         PropertySubType subtype;
432         uiLayout *sub;
433         unsigned int a, b;
434
435         /* retrieve type and subtype */
436         type = RNA_property_type(prop);
437         subtype = RNA_property_subtype(prop);
438
439         sub = ui_item_local_sublayout(layout, layout, 1);
440         UI_block_layout_set_current(block, sub);
441
442         /* create label */
443         if (name[0] && show_text) {
444                 uiDefBut(block, UI_BTYPE_LABEL, 0, name, 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
445         }
446
447         /* create buttons */
448         if (type == PROP_BOOLEAN && ELEM(subtype, PROP_LAYER, PROP_LAYER_MEMBER)) {
449                 /* special check for layer layout */
450                 int butw, buth, unit;
451                 int cols = (len >= 20) ? 2 : 1;
452                 const unsigned int colbuts = len / (2 * cols);
453                 unsigned int layer_used = 0;
454                 unsigned int layer_active = 0;
455
456                 UI_block_layout_set_current(block, uiLayoutAbsolute(layout, false));
457
458                 unit = UI_UNIT_X * 0.75;
459                 butw = unit;
460                 buth = unit;
461
462                 if (ptr->type == &RNA_Armature) {
463                         bArmature *arm = (bArmature *)ptr->data;
464
465                         layer_used = arm->layer_used;
466
467                         if (arm->edbo) {
468                                 if (arm->act_edbone) {
469                                         layer_active |= arm->act_edbone->layer;
470                                 }
471                         }
472                         else {
473                                 if (arm->act_bone) {
474                                         layer_active |= arm->act_bone->layer;
475                                 }
476                         }
477                 }
478
479                 for (b = 0; b < cols; b++) {
480                         UI_block_align_begin(block);
481
482                         for (a = 0; a < colbuts; a++) {
483                                 const int layer_num  = a + b * colbuts;
484                                 const unsigned int layer_flag = (1u << layer_num);
485
486                                 if (layer_used & layer_flag) {
487                                         if (layer_active & layer_flag)
488                                                 icon = ICON_LAYER_ACTIVE;
489                                         else
490                                                 icon = ICON_LAYER_USED;
491                                 }
492                                 else {
493                                         icon = ICON_BLANK1;
494                                 }
495
496                                 but = uiDefAutoButR(block, ptr, prop, layer_num, "", icon, x + butw * a, y + buth, butw, buth);
497                                 if (subtype == PROP_LAYER_MEMBER)
498                                         UI_but_func_set(but, ui_layer_but_cb, but, SET_INT_IN_POINTER(layer_num));
499                         }
500                         for (a = 0; a < colbuts; a++) {
501                                 const int layer_num  = a + len / 2 + b * colbuts;
502                                 const unsigned int layer_flag = (1u << layer_num);
503
504                                 if (layer_used & layer_flag) {
505                                         if (layer_active & layer_flag)
506                                                 icon = ICON_LAYER_ACTIVE;
507                                         else
508                                                 icon = ICON_LAYER_USED;
509                                 }
510                                 else {
511                                         icon = ICON_BLANK1;
512                                 }
513
514                                 but = uiDefAutoButR(block, ptr, prop, layer_num, "", icon, x + butw * a, y, butw, buth);
515                                 if (subtype == PROP_LAYER_MEMBER)
516                                         UI_but_func_set(but, ui_layer_but_cb, but, SET_INT_IN_POINTER(layer_num));
517                         }
518                         UI_block_align_end(block);
519
520                         x += colbuts * butw + style->buttonspacex;
521                 }
522         }
523         else if (subtype == PROP_MATRIX) {
524                 int totdim, dim_size[3];    /* 3 == RNA_MAX_ARRAY_DIMENSION */
525                 int row, col;
526
527                 UI_block_layout_set_current(block, uiLayoutAbsolute(layout, true));
528
529                 totdim = RNA_property_array_dimension(ptr, prop, dim_size);
530                 if (totdim != 2) return;    /* only 2D matrices supported in UI so far */
531
532                 w /= dim_size[0];
533                 /* h /= dim_size[1]; */ /* UNUSED */
534
535                 for (a = 0; a < len; a++) {
536                         col = a % dim_size[0];
537                         row = a / dim_size[0];
538
539                         but = uiDefAutoButR(block, ptr, prop, a, "", ICON_NONE, x + w * col, y + (dim_size[1] * UI_UNIT_Y) - (row * UI_UNIT_Y), w, UI_UNIT_Y);
540                         if (slider && but->type == UI_BTYPE_NUM)
541                                 but->type = UI_BTYPE_NUM_SLIDER;
542                 }
543         }
544         else if (subtype == PROP_DIRECTION && !expand) {
545                 uiDefButR_prop(block, UI_BTYPE_UNITVEC, 0, name, x, y, UI_UNIT_X * 3, UI_UNIT_Y * 3, ptr, prop, -1, 0, 0, -1, -1, NULL);
546         }
547         else {
548                 /* note, this block of code is a bit arbitrary and has just been made
549                  * to work with common cases, but may need to be re-worked */
550
551                 /* special case, boolean array in a menu, this could be used in a more generic way too */
552                 if (ELEM(subtype, PROP_COLOR, PROP_COLOR_GAMMA) && !expand) {
553                         uiDefAutoButR(block, ptr, prop, -1, "", ICON_NONE, 0, 0, w, UI_UNIT_Y);
554                 }
555                 else {
556                         int *boolarr = NULL;
557
558                         /* even if 'expand' is fale, expanding anyway */
559
560                         /* layout for known array subtypes */
561                         char str[3] = {'\0'};
562
563                         if (!icon_only && show_text) {
564                                 if (type != PROP_BOOLEAN) {
565                                         str[1] = ':';
566                                 }
567                         }
568
569                         /* show checkboxes for rna on a non-emboss block (menu for eg) */
570                         if (type == PROP_BOOLEAN && ELEM(layout->root->block->dt, UI_EMBOSS_NONE, UI_EMBOSS_PULLDOWN)) {
571                                 boolarr = MEM_callocN(sizeof(int) * len, __func__);
572                                 RNA_property_boolean_get_array(ptr, prop, boolarr);
573                         }
574
575                         const char *str_buf = show_text ? str: "";
576                         for (a = 0; a < len; a++) {
577                                 int width_item;
578
579                                 if (!icon_only && show_text) {
580                                         str[0] = RNA_property_array_item_char(prop, a);
581                                 }
582                                 if (boolarr) {
583                                         icon = boolarr[a] ? ICON_CHECKBOX_HLT : ICON_CHECKBOX_DEHLT;
584                                 }
585
586                                 width_item = (compact && type == PROP_BOOLEAN) ?
587                                                  min_ii(w, ui_text_icon_width(layout, str_buf, icon, false)) : w;
588
589                                 but = uiDefAutoButR(block, ptr, prop, a, str_buf, icon, 0, 0, width_item, UI_UNIT_Y);
590                                 if (slider && but->type == UI_BTYPE_NUM)
591                                         but->type = UI_BTYPE_NUM_SLIDER;
592                                 if (toggle && but->type == UI_BTYPE_CHECKBOX)
593                                         but->type = UI_BTYPE_TOGGLE;
594                                 if ((a == 0) && (subtype == PROP_AXISANGLE))
595                                         UI_but_unit_type_set(but, PROP_UNIT_ROTATION);
596                         }
597
598                         if (boolarr) {
599                                 MEM_freeN(boolarr);
600                         }
601                 }
602         }
603
604         UI_block_layout_set_current(block, layout);
605 }
606
607 static void ui_item_enum_expand_handle(bContext *C, void *arg1, void *arg2)
608 {
609         wmWindow *win = CTX_wm_window(C);
610
611         if (!win->eventstate->shift) {
612                 uiBut *but = (uiBut *)arg1;
613                 int enum_value = GET_INT_FROM_POINTER(arg2);
614
615                 int current_value = RNA_property_enum_get(&but->rnapoin, but->rnaprop);
616                 if (!(current_value & enum_value)) {
617                         current_value = enum_value;
618                 }
619                 else {
620                         current_value &= enum_value;
621                 }
622                 RNA_property_enum_set(&but->rnapoin, but->rnaprop, current_value);
623         }
624 }
625 static void ui_item_enum_expand(
626         uiLayout *layout, uiBlock *block, PointerRNA *ptr, PropertyRNA *prop,
627         const char *uiname, int h, bool icon_only)
628 {
629         /* XXX The way this function currently handles uiname parameter is insane and inconsistent with general UI API:
630          *     * uiname is the *enum property* label.
631          *     * when it is NULL or empty, we do not draw *enum items* labels, this doubles the icon_only parameter.
632          *     * we *never* draw (i.e. really use) the enum label uiname, it is just used as a mere flag!
633          *     Unfortunately, fixing this implies an API "soft break", so better to defer it for later... :/
634          *     --mont29
635          */
636
637         uiBut *but;
638         uiLayout *layout_radial = NULL;
639         const EnumPropertyItem *item, *item_array;
640         const char *name;
641         int itemw, icon, value;
642         bool free;
643         bool radial = (layout->root->type == UI_LAYOUT_PIEMENU);
644
645         if (radial)
646                 RNA_property_enum_items_gettexted_all(block->evil_C, ptr, prop, &item_array, NULL, &free);
647         else
648                 RNA_property_enum_items_gettexted(block->evil_C, ptr, prop, &item_array, NULL, &free);
649
650         /* we dont want nested rows, cols in menus */
651         if (radial) {
652                 if (layout->root->layout == layout) {
653                         layout_radial = uiLayoutRadial(layout);
654                         UI_block_layout_set_current(block, layout_radial);
655                 }
656                 else {
657                         if (layout->item.type == ITEM_LAYOUT_RADIAL) {
658                                 layout_radial = layout;
659                         }
660                         UI_block_layout_set_current(block, layout);
661                 }
662         }
663         else if (layout->root->type != UI_LAYOUT_MENU) {
664                 UI_block_layout_set_current(block, ui_item_local_sublayout(layout, layout, 1));
665         }
666         else {
667                 UI_block_layout_set_current(block, layout);
668         }
669
670         for (item = item_array; item->identifier; item++) {
671                 if (!item->identifier[0]) {
672                         if (radial && layout_radial) {
673                                 uiItemS(layout_radial);
674                         }
675                         continue;
676                 }
677
678                 name = (!uiname || uiname[0]) ? item->name : "";
679                 icon = item->icon;
680                 value = item->value;
681                 itemw = ui_text_icon_width(block->curlayout, icon_only ? "" : name, icon, 0);
682
683                 if (icon && name[0] && !icon_only)
684                         but = uiDefIconTextButR_prop(block, UI_BTYPE_ROW, 0, icon, name, 0, 0, itemw, h, ptr, prop, -1, 0, value, -1, -1, NULL);
685                 else if (icon)
686                         but = uiDefIconButR_prop(block, UI_BTYPE_ROW, 0, icon, 0, 0, itemw, h, ptr, prop, -1, 0, value, -1, -1, NULL);
687                 else
688                         but = uiDefButR_prop(block, UI_BTYPE_ROW, 0, name, 0, 0, itemw, h, ptr, prop, -1, 0, value, -1, -1, NULL);
689
690                 if (RNA_property_flag(prop) & PROP_ENUM_FLAG) {
691                         UI_but_func_set(but, ui_item_enum_expand_handle, but, SET_INT_IN_POINTER(value));
692                 }
693
694                 if (ui_layout_local_dir(layout) != UI_LAYOUT_HORIZONTAL)
695                         but->drawflag |= UI_BUT_TEXT_LEFT;
696         }
697         UI_block_layout_set_current(block, layout);
698
699         if (free) {
700                 MEM_freeN((void *)item_array);
701         }
702 }
703
704 /* callback for keymap item change button */
705 static void ui_keymap_but_cb(bContext *UNUSED(C), void *but_v, void *UNUSED(key_v))
706 {
707         uiBut *but = but_v;
708
709         RNA_boolean_set(&but->rnapoin, "shift", (but->modifier_key & KM_SHIFT) != 0);
710         RNA_boolean_set(&but->rnapoin, "ctrl", (but->modifier_key & KM_CTRL) != 0);
711         RNA_boolean_set(&but->rnapoin, "alt", (but->modifier_key & KM_ALT) != 0);
712         RNA_boolean_set(&but->rnapoin, "oskey", (but->modifier_key & KM_OSKEY) != 0);
713 }
714
715 /**
716  * Create label + button for RNA property
717  *
718  * \param w_hint: For varying width layout, this becomes the label width.
719  *                Otherwise it's used to fit both items into it.
720  **/
721 static uiBut *ui_item_with_label(
722         uiLayout *layout, uiBlock *block, const char *name, int icon,
723         PointerRNA *ptr, PropertyRNA *prop, int index,
724         int x, int y, int w_hint, int h, int flag)
725 {
726         uiLayout *sub;
727         uiBut *but = NULL;
728         PropertyType type;
729         PropertySubType subtype;
730         int prop_but_width = w_hint;
731         const bool use_prop_sep = ((layout->item.flag & UI_ITEM_PROP_SEP) != 0);
732
733         sub = uiLayoutRow(layout, layout->align);
734         UI_block_layout_set_current(block, sub);
735
736         if (name[0]) {
737                 int w_label;
738
739                 if (use_prop_sep) {
740                         w_label = (int)((w_hint * 2) * UI_ITEM_PROP_SEP_DIVIDE);
741                 }
742                 else {
743                         if (ui_layout_variable_size(layout)) {
744                                 /* w_hint is width for label in this case. Use a default width for property button(s) */
745                                 prop_but_width = UI_UNIT_X * 5;
746                                 w_label = w_hint;
747                         }
748                         else {
749                                 w_label = w_hint / 3;
750                         }
751                 }
752
753                 uiBut *but_label = uiDefBut(block, UI_BTYPE_LABEL, 0, name, x, y, w_label, h, NULL, 0.0, 0.0, 0, 0, "");
754                 if (use_prop_sep) {
755                         but_label->drawflag |= UI_BUT_TEXT_RIGHT;
756                         but_label->drawflag &= ~UI_BUT_TEXT_LEFT;
757                 }
758         }
759
760         type = RNA_property_type(prop);
761         subtype = RNA_property_subtype(prop);
762
763         if (subtype == PROP_FILEPATH || subtype == PROP_DIRPATH) {
764                 UI_block_layout_set_current(block, uiLayoutRow(sub, true));
765                 but = uiDefAutoButR(block, ptr, prop, index, "", icon, x, y, prop_but_width - UI_UNIT_X, h);
766
767                 /* BUTTONS_OT_file_browse calls UI_context_active_but_prop_get_filebrowser */
768                 uiDefIconButO(block, UI_BTYPE_BUT, subtype == PROP_DIRPATH ? "BUTTONS_OT_directory_browse" : "BUTTONS_OT_file_browse",
769                               WM_OP_INVOKE_DEFAULT, ICON_FILESEL, x, y, UI_UNIT_X, h, NULL);
770         }
771         else if (flag & UI_ITEM_R_EVENT) {
772                 but = uiDefButR_prop(block, UI_BTYPE_KEY_EVENT, 0, name, x, y, prop_but_width, h, ptr, prop, index, 0, 0, -1, -1, NULL);
773         }
774         else if (flag & UI_ITEM_R_FULL_EVENT) {
775                 if (RNA_struct_is_a(ptr->type, &RNA_KeyMapItem)) {
776                         char buf[128];
777
778                         WM_keymap_item_to_string(ptr->data, false, buf, sizeof(buf));
779
780                         but = uiDefButR_prop(block, UI_BTYPE_HOTKEY_EVENT, 0, buf, x, y, prop_but_width, h, ptr, prop, 0, 0, 0, -1, -1, NULL);
781                         UI_but_func_set(but, ui_keymap_but_cb, but, NULL);
782                         if (flag & UI_ITEM_R_IMMEDIATE)
783                                 UI_but_flag_enable(but, UI_BUT_IMMEDIATE);
784                 }
785         }
786         else {
787                 const char *str = (type == PROP_ENUM && !(flag & UI_ITEM_R_ICON_ONLY)) ? NULL : "";
788                 but = uiDefAutoButR(block, ptr, prop, index, str, icon,
789                                     x, y, prop_but_width, h);
790         }
791
792         UI_block_layout_set_current(block, layout);
793         return but;
794 }
795
796 void UI_context_active_but_prop_get_filebrowser(
797         const bContext *C,
798         PointerRNA *r_ptr, PropertyRNA **r_prop, bool *r_is_undo)
799 {
800         ARegion *ar = CTX_wm_region(C);
801         uiBlock *block;
802         uiBut *but, *prevbut;
803
804         memset(r_ptr, 0, sizeof(*r_ptr));
805         *r_prop = NULL;
806         *r_is_undo = false;
807
808         if (!ar)
809                 return;
810
811         for (block = ar->uiblocks.first; block; block = block->next) {
812                 for (but = block->buttons.first; but; but = but->next) {
813                         prevbut = but->prev;
814
815                         /* find the button before the active one */
816                         if ((but->flag & UI_BUT_LAST_ACTIVE) && prevbut && prevbut->rnapoin.data) {
817                                 if (RNA_property_type(prevbut->rnaprop) == PROP_STRING) {
818                                         *r_ptr = prevbut->rnapoin;
819                                         *r_prop = prevbut->rnaprop;
820                                         *r_is_undo = (prevbut->flag & UI_BUT_UNDO) != 0;
821                                         return;
822                                 }
823                         }
824                 }
825         }
826 }
827
828 /********************* Button Items *************************/
829
830 /**
831  * Update a buttons tip with an enum's description if possible.
832  */
833 static void ui_but_tip_from_enum_item(uiBut *but, const EnumPropertyItem *item)
834 {
835         if (but->tip == NULL || but->tip[0] == '\0') {
836                 if (item->description && item->description[0]) {
837                         but->tip = item->description;
838                 }
839         }
840 }
841
842 /* disabled item */
843 static void ui_item_disabled(uiLayout *layout, const char *name)
844 {
845         uiBlock *block = layout->root->block;
846         uiBut *but;
847         int w;
848
849         UI_block_layout_set_current(block, layout);
850
851         if (!name)
852                 name = "";
853
854         w = ui_text_icon_width(layout, name, 0, 0);
855
856         but = uiDefBut(block, UI_BTYPE_LABEL, 0, name, 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
857         but->flag |= UI_BUT_DISABLED;
858         but->disabled_info = "";
859 }
860
861 /**
862  * Operator Item
863  * \param r_opptr: Optional, initialize with operator properties when not NULL.
864  * Will always be written to even in the case of errors.
865  */
866 static uiBut *uiItemFullO_ptr_ex(
867         uiLayout *layout, wmOperatorType *ot,
868         const char *name, int icon, IDProperty *properties, int context, int flag,
869         PointerRNA *r_opptr)
870 {
871         /* Take care to fill 'r_opptr' whatever happens. */
872         uiBlock *block = layout->root->block;
873         uiBut *but;
874         int w;
875
876         if (!name) {
877                 if (ot && ot->srna && (flag & UI_ITEM_R_ICON_ONLY) == 0)
878                         name = RNA_struct_ui_name(ot->srna);
879                 else
880                         name = "";
881         }
882
883         if (layout->root->type == UI_LAYOUT_MENU && !icon)
884                 icon = ICON_BLANK1;
885
886         /* create button */
887         UI_block_layout_set_current(block, layout);
888
889         w = ui_text_icon_width(layout, name, icon, 0);
890
891         int prev_emboss = layout->emboss;
892         if (flag & UI_ITEM_R_NO_BG) {
893                 layout->emboss = UI_EMBOSS_NONE;
894         }
895
896         /* create the button */
897         if (icon) {
898                 if (name[0]) {
899                         but = uiDefIconTextButO_ptr(block, UI_BTYPE_BUT, ot, context, icon, name, 0, 0, w, UI_UNIT_Y, NULL);
900                 }
901                 else {
902                         but = uiDefIconButO_ptr(block, UI_BTYPE_BUT, ot, context, icon, 0, 0, w, UI_UNIT_Y, NULL);
903                 }
904         }
905         else {
906                 but = uiDefButO_ptr(block, UI_BTYPE_BUT, ot, context, name, 0, 0, w, UI_UNIT_Y, NULL);
907         }
908
909         assert(but->optype != NULL);
910
911         /* text alignment for toolbar buttons */
912         if ((layout->root->type == UI_LAYOUT_TOOLBAR) && !icon)
913                 but->drawflag |= UI_BUT_TEXT_LEFT;
914
915         if (flag & UI_ITEM_R_NO_BG) {
916                 layout->emboss = prev_emboss;
917         }
918
919         if (flag & UI_ITEM_O_DEPRESS) {
920                 but->flag |= UI_SELECT_DRAW;
921         }
922
923         if (layout->redalert)
924                 UI_but_flag_enable(but, UI_BUT_REDALERT);
925
926         /* assign properties */
927         if (properties || r_opptr) {
928                 PointerRNA *opptr = UI_but_operator_ptr_get(but);
929                 if (properties) {
930                         opptr->data = properties;
931                 }
932                 else {
933                         IDPropertyTemplate val = {0};
934                         opptr->data = IDP_New(IDP_GROUP, &val, "wmOperatorProperties");
935                 }
936                 if (r_opptr) {
937                         *r_opptr = *opptr;
938                 }
939         }
940
941         return but;
942 }
943
944 static void ui_item_menu_hold(struct bContext *C, ARegion *butregion, uiBut *but)
945 {
946         uiPopupMenu *pup = UI_popup_menu_begin(C, "", ICON_NONE);
947         uiLayout *layout = UI_popup_menu_layout(pup);
948         uiBlock *block = layout->root->block;
949         UI_popup_menu_but_set(pup, butregion, but);
950
951         block->flag |= UI_BLOCK_POPUP_HOLD;
952         block->flag |= UI_BLOCK_IS_FLIP;
953
954         char direction = UI_DIR_DOWN;
955         if (!but->drawstr[0]) {
956                 if (butregion->alignment == RGN_ALIGN_LEFT) {
957                         direction = UI_DIR_RIGHT;
958                 }
959                 else if (butregion->alignment == RGN_ALIGN_RIGHT) {
960                         direction = UI_DIR_LEFT;
961                 }
962                 else if (butregion->alignment == RGN_ALIGN_BOTTOM) {
963                         direction = UI_DIR_UP;
964                 }
965                 else {
966                         direction = UI_DIR_DOWN;
967                 }
968         }
969         UI_block_direction_set(block, direction);
970
971         const char *menu_id = but->hold_argN;
972         MenuType *mt = WM_menutype_find(menu_id, true);
973         if (mt) {
974                 uiLayoutSetContextFromBut(layout, but);
975                 UI_menutype_draw(C, mt, layout);
976         }
977         else {
978                 uiItemL(layout, "Menu Missing:", ICON_NONE);
979                 uiItemL(layout, menu_id, ICON_NONE);
980         }
981         UI_popup_menu_end(C, pup);
982 }
983
984 void uiItemFullO_ptr(
985         uiLayout *layout, wmOperatorType *ot,
986         const char *name, int icon, IDProperty *properties, int context, int flag,
987         PointerRNA *r_opptr)
988 {
989         uiItemFullO_ptr_ex(layout, ot, name, icon, properties, context, flag, r_opptr);
990 }
991
992 void uiItemFullOMenuHold_ptr(
993         uiLayout *layout, wmOperatorType *ot,
994         const char *name, int icon, IDProperty *properties, int context, int flag,
995         const char *menu_id,
996         PointerRNA *r_opptr)
997 {
998         uiBut *but = uiItemFullO_ptr_ex(layout, ot, name, icon, properties, context, flag, r_opptr);
999         UI_but_func_hold_set(but, ui_item_menu_hold, BLI_strdup(menu_id));
1000 }
1001
1002 void uiItemFullO(
1003         uiLayout *layout, const char *opname,
1004         const char *name, int icon, IDProperty *properties, int context, int flag,
1005         PointerRNA *r_opptr)
1006 {
1007         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1008
1009         UI_OPERATOR_ERROR_RET(
1010                 ot, opname, {
1011                     if (r_opptr) {
1012                         *r_opptr = PointerRNA_NULL;
1013                     }
1014                     return;
1015                 });
1016
1017         uiItemFullO_ptr(layout, ot, name, icon, properties, context, flag, r_opptr);
1018 }
1019
1020 static const char *ui_menu_enumpropname(uiLayout *layout, PointerRNA *ptr, PropertyRNA *prop, int retval)
1021 {
1022         const EnumPropertyItem *item;
1023         bool free;
1024         const char *name;
1025
1026         RNA_property_enum_items(layout->root->block->evil_C, ptr, prop, &item, NULL, &free);
1027         if (RNA_enum_name(item, retval, &name)) {
1028                 name = CTX_IFACE_(RNA_property_translation_context(prop), name);
1029         }
1030         else {
1031                 name = "";
1032         }
1033
1034         if (free) {
1035                 MEM_freeN((void *)item);
1036         }
1037
1038         return name;
1039 }
1040
1041 void uiItemEnumO_ptr(uiLayout *layout, wmOperatorType *ot, const char *name, int icon, const char *propname, int value)
1042 {
1043         PointerRNA ptr;
1044         PropertyRNA *prop;
1045
1046         WM_operator_properties_create_ptr(&ptr, ot);
1047
1048         if ((prop = RNA_struct_find_property(&ptr, propname))) {
1049                 /* pass */
1050         }
1051         else {
1052                 RNA_warning("%s.%s not found", RNA_struct_identifier(ptr.type), propname);
1053                 return;
1054         }
1055
1056         RNA_property_enum_set(&ptr, prop, value);
1057
1058         if (!name)
1059                 name = ui_menu_enumpropname(layout, &ptr, prop, value);
1060
1061         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1062 }
1063 void uiItemEnumO(uiLayout *layout, const char *opname, const char *name, int icon, const char *propname, int value)
1064 {
1065         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1066
1067         if (ot) {
1068                 uiItemEnumO_ptr(layout, ot, name, icon, propname, value);
1069         }
1070         else {
1071                 ui_item_disabled(layout, opname);
1072                 RNA_warning("unknown operator '%s'", opname);
1073         }
1074
1075 }
1076
1077 BLI_INLINE bool ui_layout_is_radial(const uiLayout *layout)
1078 {
1079         return (layout->item.type == ITEM_LAYOUT_RADIAL) ||
1080                ((layout->item.type == ITEM_LAYOUT_ROOT) && (layout->root->type == UI_LAYOUT_PIEMENU));
1081 }
1082
1083 /**
1084  * Create ui items for enum items in \a item_array.
1085  *
1086  * A version of #uiItemsFullEnumO that takes pre-calculated item array.
1087  */
1088 void uiItemsFullEnumO_items(
1089         uiLayout *layout, wmOperatorType *ot, PointerRNA ptr, PropertyRNA *prop, IDProperty *properties,
1090         int context, int flag,
1091         const EnumPropertyItem *item_array, int totitem)
1092 {
1093         const char *propname = RNA_property_identifier(prop);
1094         if (RNA_property_type(prop) != PROP_ENUM) {
1095                 RNA_warning("%s.%s, not an enum type", RNA_struct_identifier(ptr.type), propname);
1096                 return;
1097         }
1098
1099         uiLayout *target, *split = NULL;
1100         const EnumPropertyItem *item;
1101         uiBlock *block = layout->root->block;
1102         const bool radial = ui_layout_is_radial(layout);
1103
1104         if (radial) {
1105                 target = uiLayoutRadial(layout);
1106         }
1107         else {
1108                 split = uiLayoutSplit(layout, 0.0f, false);
1109                 target = uiLayoutColumn(split, layout->align);
1110         }
1111
1112
1113         int i;
1114         bool last_iter = false;
1115
1116         for (i = 1, item = item_array; item->identifier && !last_iter; i++, item++) {
1117                 /* handle oversized pies */
1118                 if (radial && (totitem > PIE_MAX_ITEMS) && (i >= PIE_MAX_ITEMS)) {
1119                         if (item->name) { /* only visible items */
1120                                 const EnumPropertyItem *tmp;
1121
1122                                 /* Check if there are more visible items for the next level. If not, we don't
1123                                  * add a new level and add the remaining item instead of the 'more' button. */
1124                                 for (tmp = item + 1; tmp->identifier; tmp++)
1125                                         if (tmp->name)
1126                                                 break;
1127
1128                                 if (tmp->identifier) { /* only true if loop above found item and did early-exit */
1129                                         ui_pie_menu_level_create(block, ot, propname, properties, item_array, totitem, context, flag);
1130                                         /* break since rest of items is handled in new pie level */
1131                                         break;
1132                                 }
1133                                 else {
1134                                         last_iter = true;
1135                                 }
1136                         }
1137                         else {
1138                                 continue;
1139                         }
1140                 }
1141
1142                 if (item->identifier[0]) {
1143                         PointerRNA tptr;
1144
1145                         WM_operator_properties_create_ptr(&tptr, ot);
1146                         if (properties) {
1147                                 if (tptr.data) {
1148                                         IDP_FreeProperty(tptr.data);
1149                                         MEM_freeN(tptr.data);
1150                                 }
1151                                 tptr.data = IDP_CopyProperty(properties);
1152                         }
1153                         RNA_property_enum_set(&tptr, prop, item->value);
1154
1155                         uiItemFullO_ptr(target, ot, item->name, item->icon, tptr.data, context, flag, NULL);
1156
1157                         ui_but_tip_from_enum_item(block->buttons.last, item);
1158                 }
1159                 else {
1160                         if (item->name) {
1161                                 uiBut *but;
1162
1163                                 if (item != item_array && !radial) {
1164                                         target = uiLayoutColumn(split, layout->align);
1165
1166                                         /* inconsistent, but menus with labels do not look good flipped */
1167                                         block->flag |= UI_BLOCK_NO_FLIP;
1168                                 }
1169
1170                                 if (item->icon || radial) {
1171                                         uiItemL(target, item->name, item->icon);
1172
1173                                         but = block->buttons.last;
1174                                 }
1175                                 else {
1176                                         /* Do not use uiItemL here, as our root layout is a menu one, it will add a fake blank icon! */
1177                                         but = uiDefBut(block, UI_BTYPE_LABEL, 0, item->name, 0, 0, UI_UNIT_X * 5, UI_UNIT_Y, NULL,
1178                                                        0.0, 0.0, 0, 0, "");
1179                                 }
1180                                 ui_but_tip_from_enum_item(but, item);
1181                         }
1182                         else {
1183                                 if (radial) {
1184                                         /* invisible dummy button to ensure all items are always at the same position */
1185                                         uiItemS(target);
1186                                 }
1187                                 else {
1188                                         /* XXX bug here, colums draw bottom item badly */
1189                                         uiItemS(target);
1190                                 }
1191                         }
1192                 }
1193         }
1194 }
1195
1196 void uiItemsFullEnumO(
1197         uiLayout *layout, const char *opname, const char *propname, IDProperty *properties,
1198         int context, int flag)
1199 {
1200         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1201
1202         PointerRNA ptr;
1203         PropertyRNA *prop;
1204         uiBlock *block = layout->root->block;
1205
1206         if (!ot || !ot->srna) {
1207                 ui_item_disabled(layout, opname);
1208                 RNA_warning("%s '%s'", ot ? "unknown operator" : "operator missing srna", opname);
1209                 return;
1210         }
1211
1212         WM_operator_properties_create_ptr(&ptr, ot);
1213         /* so the context is passed to itemf functions (some need it) */
1214         WM_operator_properties_sanitize(&ptr, false);
1215         prop = RNA_struct_find_property(&ptr, propname);
1216
1217         /* don't let bad properties slip through */
1218         BLI_assert((prop == NULL) || (RNA_property_type(prop) == PROP_ENUM));
1219
1220         if (prop && RNA_property_type(prop) == PROP_ENUM) {
1221                 const EnumPropertyItem *item_array = NULL;
1222                 int totitem;
1223                 bool free;
1224
1225                 if (ui_layout_is_radial(layout)) {
1226                         RNA_property_enum_items_gettexted_all(block->evil_C, &ptr, prop, &item_array, &totitem, &free);
1227                 }
1228                 else {
1229                         RNA_property_enum_items_gettexted(block->evil_C, &ptr, prop, &item_array, &totitem, &free);
1230                 }
1231
1232                 /* add items */
1233                 uiItemsFullEnumO_items(
1234                         layout, ot, ptr, prop, properties, context, flag,
1235                         item_array, totitem);
1236
1237                 if (free) {
1238                         MEM_freeN((void *)item_array);
1239                 }
1240
1241                 /* intentionally don't touch UI_BLOCK_IS_FLIP here,
1242                  * we don't know the context this is called in */
1243         }
1244         else if (prop && RNA_property_type(prop) != PROP_ENUM) {
1245                 RNA_warning("%s.%s, not an enum type", RNA_struct_identifier(ptr.type), propname);
1246                 return;
1247         }
1248         else {
1249                 RNA_warning("%s.%s not found", RNA_struct_identifier(ptr.type), propname);
1250                 return;
1251         }
1252 }
1253
1254 void uiItemsEnumO(uiLayout *layout, const char *opname, const char *propname)
1255 {
1256         uiItemsFullEnumO(layout, opname, propname, NULL, layout->root->opcontext, 0);
1257 }
1258
1259 /* for use in cases where we have */
1260 void uiItemEnumO_value(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value)
1261 {
1262         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1263         PointerRNA ptr;
1264         PropertyRNA *prop;
1265
1266         UI_OPERATOR_ERROR_RET(ot, opname, return);
1267
1268         WM_operator_properties_create_ptr(&ptr, ot);
1269
1270         /* enum lookup */
1271         if ((prop = RNA_struct_find_property(&ptr, propname))) {
1272                 /* pass */
1273         }
1274         else {
1275                 RNA_warning("%s.%s not found", RNA_struct_identifier(ptr.type), propname);
1276                 return;
1277         }
1278
1279         RNA_property_enum_set(&ptr, prop, value);
1280
1281         /* same as uiItemEnumO */
1282         if (!name)
1283                 name = ui_menu_enumpropname(layout, &ptr, prop, value);
1284
1285         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1286 }
1287
1288 void uiItemEnumO_string(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, const char *value_str)
1289 {
1290         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1291         PointerRNA ptr;
1292         PropertyRNA *prop;
1293
1294         const EnumPropertyItem *item;
1295         int value;
1296         bool free;
1297
1298         UI_OPERATOR_ERROR_RET(ot, opname, return);
1299
1300         WM_operator_properties_create_ptr(&ptr, ot);
1301
1302         /* enum lookup */
1303         if ((prop = RNA_struct_find_property(&ptr, propname))) {
1304                 /* no need for translations here */
1305                 RNA_property_enum_items(layout->root->block->evil_C, &ptr, prop, &item, NULL, &free);
1306                 if (item == NULL || RNA_enum_value_from_id(item, value_str, &value) == 0) {
1307                         if (free) {
1308                                 MEM_freeN((void *)item);
1309                         }
1310                         RNA_warning("%s.%s, enum %s not found", RNA_struct_identifier(ptr.type), propname, value_str);
1311                         return;
1312                 }
1313
1314                 if (free) {
1315                         MEM_freeN((void *)item);
1316                 }
1317         }
1318         else {
1319                 RNA_warning("%s.%s not found", RNA_struct_identifier(ptr.type), propname);
1320                 return;
1321         }
1322
1323         RNA_property_enum_set(&ptr, prop, value);
1324
1325         /* same as uiItemEnumO */
1326         if (!name)
1327                 name = ui_menu_enumpropname(layout, &ptr, prop, value);
1328
1329         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1330 }
1331
1332 void uiItemBooleanO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value)
1333 {
1334         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1335         PointerRNA ptr;
1336
1337         UI_OPERATOR_ERROR_RET(ot, opname, return);
1338
1339         WM_operator_properties_create_ptr(&ptr, ot);
1340         RNA_boolean_set(&ptr, propname, value);
1341
1342         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1343 }
1344
1345 void uiItemIntO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value)
1346 {
1347         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1348         PointerRNA ptr;
1349
1350         UI_OPERATOR_ERROR_RET(ot, opname, return);
1351
1352         WM_operator_properties_create_ptr(&ptr, ot);
1353         RNA_int_set(&ptr, propname, value);
1354
1355         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1356 }
1357
1358 void uiItemFloatO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, float value)
1359 {
1360         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1361         PointerRNA ptr;
1362
1363         UI_OPERATOR_ERROR_RET(ot, opname, return);
1364
1365         WM_operator_properties_create_ptr(&ptr, ot);
1366         RNA_float_set(&ptr, propname, value);
1367
1368         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1369 }
1370
1371 void uiItemStringO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, const char *value)
1372 {
1373         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
1374         PointerRNA ptr;
1375
1376         UI_OPERATOR_ERROR_RET(ot, opname, return);
1377
1378         WM_operator_properties_create_ptr(&ptr, ot);
1379         RNA_string_set(&ptr, propname, value);
1380
1381         uiItemFullO_ptr(layout, ot, name, icon, ptr.data, layout->root->opcontext, 0, NULL);
1382 }
1383
1384 void uiItemO(uiLayout *layout, const char *name, int icon, const char *opname)
1385 {
1386         uiItemFullO(layout, opname, name, icon, NULL, layout->root->opcontext, 0, NULL);
1387 }
1388
1389 /* RNA property items */
1390
1391 static void ui_item_rna_size(
1392         uiLayout *layout, const char *name, int icon,
1393         PointerRNA *ptr, PropertyRNA *prop,
1394         int index, bool icon_only, bool compact,
1395         int *r_w, int *r_h)
1396 {
1397         PropertyType type;
1398         PropertySubType subtype;
1399         int len, w = 0, h;
1400
1401         /* arbitrary extended width by type */
1402         type = RNA_property_type(prop);
1403         subtype = RNA_property_subtype(prop);
1404         len = RNA_property_array_length(ptr, prop);
1405
1406         if (!name[0] && !icon_only) {
1407                 if (ELEM(type, PROP_STRING, PROP_POINTER)) {
1408                         name = "non-empty text";
1409                 }
1410                 else if (type == PROP_BOOLEAN) {
1411                         icon = ICON_DOT;
1412                 }
1413                 else if (type == PROP_ENUM) {
1414                         /* Find the longest enum item name, instead of using a dummy text! */
1415                         const EnumPropertyItem *item, *item_array;
1416                         bool free;
1417
1418                         RNA_property_enum_items_gettexted(layout->root->block->evil_C, ptr, prop, &item_array, NULL, &free);
1419                         for (item = item_array; item->identifier; item++) {
1420                                 if (item->identifier[0]) {
1421                                         w = max_ii(w, ui_text_icon_width(layout, item->name, item->icon, compact));
1422                                 }
1423                         }
1424                         if (free) {
1425                                 MEM_freeN((void *)item_array);
1426                         }
1427                 }
1428         }
1429
1430         if (!w) {
1431                 if (type == PROP_ENUM && icon_only) {
1432                         w = ui_text_icon_width(layout, "", ICON_BLANK1, compact);
1433                         if (index != RNA_ENUM_VALUE)
1434                                 w += 0.6f * UI_UNIT_X;
1435                 }
1436                 else {
1437                         /* not compact for float/int buttons, looks too squashed */
1438                         w = ui_text_icon_width(layout, name, icon, ELEM(type, PROP_FLOAT, PROP_INT) ? false : compact);
1439                 }
1440         }
1441         h = UI_UNIT_Y;
1442
1443         /* increase height for arrays */
1444         if (index == RNA_NO_INDEX && len > 0) {
1445                 if (!name[0] && icon == ICON_NONE)
1446                         h = 0;
1447                 if (layout->item.flag & UI_ITEM_PROP_SEP)
1448                         h = 0;
1449                 if (ELEM(subtype, PROP_LAYER, PROP_LAYER_MEMBER))
1450                         h += 2 * UI_UNIT_Y;
1451                 else if (subtype == PROP_MATRIX)
1452                         h += ceilf(sqrtf(len)) * UI_UNIT_Y;
1453                 else
1454                         h += len * UI_UNIT_Y;
1455         }
1456         else if (ui_layout_variable_size(layout)) {
1457                 if (type == PROP_BOOLEAN && name[0])
1458                         w += UI_UNIT_X / 5;
1459                 else if (type == PROP_ENUM && !icon_only)
1460                         w += UI_UNIT_X / 4;
1461                 else if (type == PROP_FLOAT || type == PROP_INT)
1462                         w += UI_UNIT_X * 3;
1463         }
1464
1465         *r_w = w;
1466         *r_h = h;
1467 }
1468
1469 void uiItemFullR(uiLayout *layout, PointerRNA *ptr, PropertyRNA *prop, int index, int value, int flag, const char *name, int icon)
1470 {
1471         uiBlock *block = layout->root->block;
1472         uiBut *but = NULL;
1473         PropertyType type;
1474         char namestr[UI_MAX_NAME_STR];
1475         int len, w, h;
1476         bool slider, toggle, expand, icon_only, no_bg, compact;
1477         bool is_array;
1478         const bool use_prop_sep = ((layout->item.flag & UI_ITEM_PROP_SEP) != 0);
1479
1480         UI_block_layout_set_current(block, layout);
1481
1482         /* retrieve info */
1483         type = RNA_property_type(prop);
1484         is_array = RNA_property_array_check(prop);
1485         len = (is_array) ? RNA_property_array_length(ptr, prop) : 0;
1486
1487         /* set name and icon */
1488         if (!name) {
1489                 if ((flag & UI_ITEM_R_ICON_ONLY) == 0) {
1490                         name = RNA_property_ui_name(prop);
1491                 }
1492                 else {
1493                         name = "";
1494                 }
1495         }
1496
1497         if (icon == ICON_NONE)
1498                 icon = RNA_property_ui_icon(prop);
1499
1500         if (flag & UI_ITEM_R_ICON_ONLY) {
1501                 /* pass */
1502         }
1503         else if (ELEM(type, PROP_INT, PROP_FLOAT, PROP_STRING, PROP_POINTER)) {
1504                 if (use_prop_sep == false) {
1505                         name = ui_item_name_add_colon(name, namestr);
1506                 }
1507         }
1508         else if (type == PROP_BOOLEAN && is_array && index == RNA_NO_INDEX) {
1509                 if (use_prop_sep == false) {
1510                         name = ui_item_name_add_colon(name, namestr);
1511                 }
1512         }
1513         else if (type == PROP_ENUM && index != RNA_ENUM_VALUE) {
1514                 if (flag & UI_ITEM_R_COMPACT) {
1515                         name = "";
1516                 }
1517                 else {
1518                         if (use_prop_sep == false) {
1519                                 name = ui_item_name_add_colon(name, namestr);
1520                         }
1521                 }
1522         }
1523
1524         /* menus and pie-menus don't show checkbox without this */
1525         if ((layout->root->type == UI_LAYOUT_MENU) ||
1526             /* use checkboxes only as a fallback in pie-menu's, when no icon is defined */
1527             ((layout->root->type == UI_LAYOUT_PIEMENU) && (icon == ICON_NONE)))
1528         {
1529                 if (type == PROP_BOOLEAN && ((is_array == false) || (index != RNA_NO_INDEX))) {
1530                         if (is_array) icon = (RNA_property_boolean_get_index(ptr, prop, index)) ? ICON_CHECKBOX_HLT : ICON_CHECKBOX_DEHLT;
1531                         else icon = (RNA_property_boolean_get(ptr, prop)) ? ICON_CHECKBOX_HLT : ICON_CHECKBOX_DEHLT;
1532                 }
1533                 else if (type == PROP_ENUM && index == RNA_ENUM_VALUE) {
1534                         int enum_value = RNA_property_enum_get(ptr, prop);
1535                         if (RNA_property_flag(prop) & PROP_ENUM_FLAG) {
1536                                 icon = (enum_value & value) ? ICON_CHECKBOX_HLT : ICON_CHECKBOX_DEHLT;
1537                         }
1538                         else {
1539                                 icon = (enum_value == value) ? ICON_CHECKBOX_HLT : ICON_CHECKBOX_DEHLT;
1540                         }
1541                 }
1542         }
1543
1544         slider = (flag & UI_ITEM_R_SLIDER) != 0;
1545         toggle = (flag & UI_ITEM_R_TOGGLE) != 0;
1546         expand = (flag & UI_ITEM_R_EXPAND) != 0;
1547         icon_only = (flag & UI_ITEM_R_ICON_ONLY) != 0;
1548         no_bg = (flag & UI_ITEM_R_NO_BG) != 0;
1549         compact = (flag & UI_ITEM_R_COMPACT) != 0;
1550
1551         /* get size */
1552         ui_item_rna_size(layout, name, icon, ptr, prop, index, icon_only, compact, &w, &h);
1553
1554         int prev_emboss = layout->emboss;
1555         if (no_bg) {
1556                 layout->emboss = UI_EMBOSS_NONE;
1557         }
1558
1559         /* Split the label / property. */
1560         if (use_prop_sep) {
1561                 if (name[0] == '\0') {
1562                         /* Ensure we get a column when text is not set. */
1563                         layout = uiLayoutColumn(layout, true);
1564                         layout->space = 0;
1565                 }
1566                 else {
1567                         const PropertySubType subtype = RNA_property_subtype(prop);
1568                         uiLayout *layout_split = uiLayoutSplit(layout, UI_ITEM_PROP_SEP_DIVIDE, true);
1569                         layout_split->space = 0;
1570                         uiLayout *layout_sub = uiLayoutColumn(layout_split, true);
1571                         layout_sub->space = 0;
1572
1573                         if ((index == RNA_NO_INDEX && is_array) &&
1574                             ((!expand && ELEM(subtype, PROP_COLOR, PROP_COLOR_GAMMA, PROP_DIRECTION)) == 0))
1575                         {
1576                                 char name_with_suffix[UI_MAX_DRAW_STR + 2];
1577                                 char str[2] = {'\0'};
1578                                 for (int a = 0; a < len; a++) {
1579                                         str[0] = RNA_property_array_item_char(prop, a);
1580                                         const bool use_prefix = (a == 0 && name && name[0]);
1581                                         if (use_prefix) {
1582                                                 char *s = name_with_suffix;
1583                                                 s += STRNCPY_RLEN(name_with_suffix, name);
1584                                                 *s++ = ' ';
1585                                                 *s++ = str[0];
1586                                                 *s++ = '\0';
1587                                         }
1588                                         but = uiDefBut(
1589                                                 block, UI_BTYPE_LABEL, 0, use_prefix ? name_with_suffix : str,
1590                                                 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
1591                                         but->drawflag |= UI_BUT_TEXT_RIGHT;
1592                                         but->drawflag &= ~UI_BUT_TEXT_LEFT;
1593                                 }
1594                         }
1595                         else {
1596                                 if (name) {
1597                                         but = uiDefBut(
1598                                                 block, UI_BTYPE_LABEL, 0, name,
1599                                                 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
1600                                         but->drawflag |= UI_BUT_TEXT_RIGHT;
1601                                         but->drawflag &= ~UI_BUT_TEXT_LEFT;
1602                                 }
1603                         }
1604
1605                         /* Watch out! We can only write into the new column now. */
1606                         layout = uiLayoutColumn(layout_split, true);
1607                         layout->space = 0;
1608                         name = "";
1609                 }
1610         }
1611         /* End split. */
1612
1613         /* array property */
1614         if (index == RNA_NO_INDEX && is_array) {
1615                 ui_item_array(
1616                         layout, block, name, icon, ptr, prop, len, 0, 0, w, h,
1617                         expand, slider, toggle, icon_only, compact, !use_prop_sep);
1618         }
1619         /* enum item */
1620         else if (type == PROP_ENUM && index == RNA_ENUM_VALUE) {
1621                 if (icon && name[0] && !icon_only)
1622                         uiDefIconTextButR_prop(block, UI_BTYPE_ROW, 0, icon, name, 0, 0, w, h, ptr, prop, -1, 0, value, -1, -1, NULL);
1623                 else if (icon)
1624                         uiDefIconButR_prop(block, UI_BTYPE_ROW, 0, icon, 0, 0, w, h, ptr, prop, -1, 0, value, -1, -1, NULL);
1625                 else
1626                         uiDefButR_prop(block, UI_BTYPE_ROW, 0, name, 0, 0, w, h, ptr, prop, -1, 0, value, -1, -1, NULL);
1627         }
1628         /* expanded enum */
1629         else if (type == PROP_ENUM && (expand || RNA_property_flag(prop) & PROP_ENUM_FLAG))
1630                 ui_item_enum_expand(layout, block, ptr, prop, name, h, icon_only);
1631         /* property with separate label */
1632         else if (type == PROP_ENUM || type == PROP_STRING || type == PROP_POINTER) {
1633                 but = ui_item_with_label(layout, block, name, icon, ptr, prop, index, 0, 0, w, h, flag);
1634                 ui_but_add_search(but, ptr, prop, NULL, NULL);
1635
1636                 if (layout->redalert)
1637                         UI_but_flag_enable(but, UI_BUT_REDALERT);
1638         }
1639         /* single button */
1640         else {
1641                 but = uiDefAutoButR(block, ptr, prop, index, name, icon, 0, 0, w, h);
1642
1643                 if (slider && but->type == UI_BTYPE_NUM)
1644                         but->type = UI_BTYPE_NUM_SLIDER;
1645
1646                 if (toggle && but->type == UI_BTYPE_CHECKBOX)
1647                         but->type = UI_BTYPE_TOGGLE;
1648
1649                 if (layout->redalert)
1650                         UI_but_flag_enable(but, UI_BUT_REDALERT);
1651         }
1652
1653         /* Mark non-embossed textfields inside a listbox. */
1654         if (but && (block->flag & UI_BLOCK_LIST_ITEM) && (but->dt & UI_EMBOSS_NONE)) {
1655                 UI_but_flag_enable(but, UI_BUT_LIST_ITEM);
1656         }
1657
1658         if (no_bg) {
1659                 layout->emboss = prev_emboss;
1660         }
1661
1662         /* ensure text isn't added to icon_only buttons */
1663         if (but && icon_only) {
1664                 BLI_assert(but->str[0] == '\0');
1665         }
1666
1667 }
1668
1669 void uiItemR(uiLayout *layout, PointerRNA *ptr, const char *propname, int flag, const char *name, int icon)
1670 {
1671         PropertyRNA *prop = RNA_struct_find_property(ptr, propname);
1672
1673         if (!prop) {
1674                 ui_item_disabled(layout, propname);
1675                 RNA_warning("property not found: %s.%s", RNA_struct_identifier(ptr->type), propname);
1676                 return;
1677         }
1678
1679         uiItemFullR(layout, ptr, prop, RNA_NO_INDEX, 0, flag, name, icon);
1680 }
1681
1682 void uiItemEnumR_prop(uiLayout *layout, const char *name, int icon, struct PointerRNA *ptr, PropertyRNA *prop, int value)
1683 {
1684         if (RNA_property_type(prop) != PROP_ENUM) {
1685                 const char *propname = RNA_property_identifier(prop);
1686                 ui_item_disabled(layout, propname);
1687                 RNA_warning("property not an enum: %s.%s", RNA_struct_identifier(ptr->type), propname);
1688                 return;
1689         }
1690
1691         uiItemFullR(layout, ptr, prop, RNA_ENUM_VALUE, value, 0, name, icon);
1692 }
1693
1694 void uiItemEnumR(uiLayout *layout, const char *name, int icon, struct PointerRNA *ptr, const char *propname, int value)
1695 {
1696         PropertyRNA *prop = RNA_struct_find_property(ptr, propname);
1697
1698         if (prop == NULL) {
1699                 ui_item_disabled(layout, propname);
1700                 RNA_warning("property not found: %s.%s", RNA_struct_identifier(ptr->type), propname);
1701                 return;
1702         }
1703
1704         uiItemFullR(layout, ptr, prop, RNA_ENUM_VALUE, value, 0, name, icon);
1705 }
1706
1707 void uiItemEnumR_string(uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *value, const char *name, int icon)
1708 {
1709         PropertyRNA *prop = RNA_struct_find_property(ptr, propname);
1710         const EnumPropertyItem *item;
1711         int ivalue, a;
1712         bool free;
1713
1714         if (!prop || RNA_property_type(prop) != PROP_ENUM) {
1715                 ui_item_disabled(layout, propname);
1716                 RNA_warning("enum property not found: %s.%s", RNA_struct_identifier(ptr->type), propname);
1717                 return;
1718         }
1719
1720         RNA_property_enum_items(layout->root->block->evil_C, ptr, prop, &item, NULL, &free);
1721
1722         if (!RNA_enum_value_from_id(item, value, &ivalue)) {
1723                 if (free) {
1724                         MEM_freeN((void *)item);
1725                 }
1726                 ui_item_disabled(layout, propname);
1727                 RNA_warning("enum property value not found: %s", value);
1728                 return;
1729         }
1730
1731         for (a = 0; item[a].identifier; a++) {
1732                 if (item[a].value == ivalue) {
1733                         const char *item_name = name ? name : CTX_IFACE_(RNA_property_translation_context(prop), item[a].name);
1734                         const int flag = item_name[0] ? 0 : UI_ITEM_R_ICON_ONLY;
1735
1736                         uiItemFullR(layout, ptr, prop, RNA_ENUM_VALUE, ivalue, flag, item_name, icon ? icon : item[a].icon);
1737                         break;
1738                 }
1739         }
1740
1741         if (free) {
1742                 MEM_freeN((void *)item);
1743         }
1744 }
1745
1746 void uiItemsEnumR(uiLayout *layout, struct PointerRNA *ptr, const char *propname)
1747 {
1748         PropertyRNA *prop;
1749         uiBlock *block = layout->root->block;
1750         uiBut *bt;
1751
1752         prop = RNA_struct_find_property(ptr, propname);
1753
1754         if (!prop) {
1755                 ui_item_disabled(layout, propname);
1756                 RNA_warning("enum property not found: %s.%s", RNA_struct_identifier(ptr->type), propname);
1757                 return;
1758         }
1759
1760         if (RNA_property_type(prop) != PROP_ENUM) {
1761                 RNA_warning("not an enum property: %s.%s", RNA_struct_identifier(ptr->type), propname);
1762                 return;
1763         }
1764         else {
1765                 const EnumPropertyItem *item;
1766                 int totitem, i;
1767                 bool free;
1768                 uiLayout *split = uiLayoutSplit(layout, 0.0f, false);
1769                 uiLayout *column = uiLayoutColumn(split, false);
1770
1771                 RNA_property_enum_items_gettexted(block->evil_C, ptr, prop, &item, &totitem, &free);
1772
1773                 for (i = 0; i < totitem; i++) {
1774                         if (item[i].identifier[0]) {
1775                                 uiItemEnumR_prop(column, item[i].name, item[i].icon, ptr, prop, item[i].value);
1776                                 ui_but_tip_from_enum_item(block->buttons.last, &item[i]);
1777                         }
1778                         else {
1779                                 if (item[i].name) {
1780                                         if (i != 0) {
1781                                                 column = uiLayoutColumn(split, false);
1782                                                 /* inconsistent, but menus with labels do not look good flipped */
1783                                                 block->flag |= UI_BLOCK_NO_FLIP;
1784                                         }
1785
1786                                         uiItemL(column, item[i].name, ICON_NONE);
1787                                         bt = block->buttons.last;
1788                                         bt->drawflag = UI_BUT_TEXT_LEFT;
1789
1790                                         ui_but_tip_from_enum_item(bt, &item[i]);
1791                                 }
1792                                 else
1793                                         uiItemS(column);
1794                         }
1795                 }
1796
1797                 if (free) {
1798                         MEM_freeN((void *)item);
1799                 }
1800         }
1801
1802         /* intentionally don't touch UI_BLOCK_IS_FLIP here,
1803          * we don't know the context this is called in */
1804 }
1805
1806 /* Pointer RNA button with search */
1807
1808
1809 static void search_id_collection(StructRNA *ptype, PointerRNA *ptr, PropertyRNA **prop)
1810 {
1811         StructRNA *srna;
1812
1813         /* look for collection property in Main */
1814         /* Note: using global Main is OK-ish here, UI shall not access other Mains anyay... */
1815         RNA_main_pointer_create(G_MAIN, ptr);
1816
1817         *prop = NULL;
1818
1819         RNA_STRUCT_BEGIN (ptr, iprop)
1820         {
1821                 /* if it's a collection and has same pointer type, we've got it */
1822                 if (RNA_property_type(iprop) == PROP_COLLECTION) {
1823                         srna = RNA_property_pointer_type(ptr, iprop);
1824
1825                         if (ptype == srna) {
1826                                 *prop = iprop;
1827                                 break;
1828                         }
1829                 }
1830         }
1831         RNA_STRUCT_END;
1832 }
1833
1834 void ui_but_add_search(uiBut *but, PointerRNA *ptr, PropertyRNA *prop, PointerRNA *searchptr, PropertyRNA *searchprop)
1835 {
1836         StructRNA *ptype;
1837         PointerRNA sptr;
1838
1839         /* for ID's we do automatic lookup */
1840         if (!searchprop) {
1841                 if (RNA_property_type(prop) == PROP_POINTER) {
1842                         ptype = RNA_property_pointer_type(ptr, prop);
1843                         search_id_collection(ptype, &sptr, &searchprop);
1844                         searchptr = &sptr;
1845                 }
1846         }
1847
1848         /* turn button into search button */
1849         if (searchprop) {
1850                 uiRNACollectionSearch *coll_search = MEM_mallocN(sizeof(*coll_search), __func__);
1851
1852                 but->type = UI_BTYPE_SEARCH_MENU;
1853                 but->hardmax = MAX2(but->hardmax, 256.0f);
1854                 but->rnasearchpoin = *searchptr;
1855                 but->rnasearchprop = searchprop;
1856                 but->drawflag |= UI_BUT_ICON_LEFT | UI_BUT_TEXT_LEFT;
1857                 if (RNA_property_is_unlink(prop)) {
1858                         but->flag |= UI_BUT_VALUE_CLEAR;
1859                 }
1860
1861                 coll_search->target_ptr = *ptr;
1862                 coll_search->target_prop = prop;
1863                 coll_search->search_ptr = *searchptr;
1864                 coll_search->search_prop = searchprop;
1865                 coll_search->but_changed = &but->changed;
1866
1867                 if (RNA_property_type(prop) == PROP_ENUM) {
1868                         /* XXX, this will have a menu string,
1869                          * but in this case we just want the text */
1870                         but->str[0] = 0;
1871                 }
1872
1873                 UI_but_func_search_set(
1874                             but, ui_searchbox_create_generic, ui_rna_collection_search_cb,
1875                             coll_search, NULL, NULL);
1876                 but->free_search_arg = true;
1877         }
1878         else if (but->type == UI_BTYPE_SEARCH_MENU) {
1879                 /* In case we fail to find proper searchprop, so other code might have already set but->type to search menu... */
1880                 but->flag |= UI_BUT_DISABLED;
1881         }
1882 }
1883
1884 void uiItemPointerR(uiLayout *layout, struct PointerRNA *ptr, const char *propname, struct PointerRNA *searchptr, const char *searchpropname, const char *name, int icon)
1885 {
1886         PropertyRNA *prop, *searchprop;
1887         PropertyType type;
1888         uiBut *but;
1889         uiBlock *block;
1890         StructRNA *icontype;
1891         int w, h;
1892         char namestr[UI_MAX_NAME_STR];
1893         const bool use_prop_sep = ((layout->item.flag & UI_ITEM_PROP_SEP) != 0);
1894
1895         /* validate arguments */
1896         prop = RNA_struct_find_property(ptr, propname);
1897
1898         if (!prop) {
1899                 RNA_warning("property not found: %s.%s",
1900                             RNA_struct_identifier(ptr->type), propname);
1901                 return;
1902         }
1903
1904         type = RNA_property_type(prop);
1905         if (!ELEM(type, PROP_POINTER, PROP_STRING, PROP_ENUM)) {
1906                 RNA_warning("Property %s must be a pointer, string or enum", propname);
1907                 return;
1908         }
1909
1910         searchprop = RNA_struct_find_property(searchptr, searchpropname);
1911
1912
1913         if (!searchprop) {
1914                 RNA_warning("search collection property not found: %s.%s",
1915                             RNA_struct_identifier(searchptr->type), searchpropname);
1916                 return;
1917         }
1918         else if (RNA_property_type(searchprop) != PROP_COLLECTION) {
1919                 RNA_warning("search collection property is not a collection type: %s.%s",
1920                             RNA_struct_identifier(searchptr->type), searchpropname);
1921                 return;
1922         }
1923
1924         /* get icon & name */
1925         if (icon == ICON_NONE) {
1926                 if (type == PROP_POINTER)
1927                         icontype = RNA_property_pointer_type(ptr, prop);
1928                 else
1929                         icontype = RNA_property_pointer_type(searchptr, searchprop);
1930
1931                 icon = RNA_struct_ui_icon(icontype);
1932         }
1933         if (!name)
1934                 name = RNA_property_ui_name(prop);
1935
1936         if (use_prop_sep == false) {
1937                 name = ui_item_name_add_colon(name, namestr);
1938         }
1939
1940         /* create button */
1941         block = uiLayoutGetBlock(layout);
1942
1943         ui_item_rna_size(layout, name, icon, ptr, prop, 0, 0, false, &w, &h);
1944         w += UI_UNIT_X; /* X icon needs more space */
1945         but = ui_item_with_label(layout, block, name, icon, ptr, prop, 0, 0, 0, w, h, 0);
1946
1947         ui_but_add_search(but, ptr, prop, searchptr, searchprop);
1948 }
1949
1950 /* menu item */
1951 static void ui_item_menutype_func(bContext *C, uiLayout *layout, void *arg_mt)
1952 {
1953         MenuType *mt = (MenuType *)arg_mt;
1954
1955         UI_menutype_draw(C, mt, layout);
1956
1957         /* menus are created flipped (from event handling pov) */
1958         layout->root->block->flag ^= UI_BLOCK_IS_FLIP;
1959 }
1960
1961 void ui_item_paneltype_func(bContext *C, uiLayout *layout, void *arg_pt)
1962 {
1963         PanelType *pt = (PanelType *)arg_pt;
1964         UI_paneltype_draw(C, pt, layout);
1965
1966         /* panels are created flipped (from event handling pov) */
1967         layout->root->block->flag ^= UI_BLOCK_IS_FLIP;
1968 }
1969
1970 static uiBut *ui_item_menu(
1971         uiLayout *layout, const char *name, int icon, uiMenuCreateFunc func, void *arg, void *argN,
1972         const char *tip, bool force_menu)
1973 {
1974         uiBlock *block = layout->root->block;
1975         uiBut *but;
1976         int w, h;
1977
1978         UI_block_layout_set_current(block, layout);
1979
1980         if (!name)
1981                 name = "";
1982         if (layout->root->type == UI_LAYOUT_MENU && !icon)
1983                 icon = ICON_BLANK1;
1984
1985         w = ui_text_icon_width(layout, name, icon, 1);
1986         h = UI_UNIT_Y;
1987
1988         if (layout->root->type == UI_LAYOUT_HEADER) { /* ugly .. */
1989                 if (icon == ICON_NONE && force_menu) {
1990                         /* pass */
1991                 }
1992                 else if (force_menu) {
1993                         w += UI_UNIT_X;
1994                 }
1995                 else {
1996                         if (name[0]) {
1997                                 w -= UI_UNIT_X / 2;
1998                         }
1999                 }
2000         }
2001
2002         if (name[0] && icon)
2003                 but = uiDefIconTextMenuBut(block, func, arg, icon, name, 0, 0, w, h, tip);
2004         else if (icon)
2005                 but = uiDefIconMenuBut(block, func, arg, icon, 0, 0, w, h, tip);
2006         else
2007                 but = uiDefMenuBut(block, func, arg, name, 0, 0, w, h, tip);
2008
2009         if (argN) { /* ugly .. */
2010                 but->poin = (char *)but;
2011                 but->func_argN = argN;
2012         }
2013
2014         if (ELEM(layout->root->type, UI_LAYOUT_PANEL, UI_LAYOUT_TOOLBAR) ||
2015             (force_menu && layout->root->type != UI_LAYOUT_MENU))  /* We never want a dropdown in menu! */
2016         {
2017                 UI_but_type_set_menu_from_pulldown(but);
2018         }
2019
2020         return but;
2021 }
2022
2023 void uiItemM(uiLayout *layout, bContext *UNUSED(C), const char *menuname, const char *name, int icon)
2024 {
2025         MenuType *mt;
2026
2027         mt = WM_menutype_find(menuname, false);
2028
2029         if (mt == NULL) {
2030                 RNA_warning("not found %s", menuname);
2031                 return;
2032         }
2033
2034         if (!name) {
2035                 name = CTX_IFACE_(mt->translation_context, mt->label);
2036         }
2037
2038         if (layout->root->type == UI_LAYOUT_MENU && !icon)
2039                 icon = ICON_BLANK1;
2040
2041         ui_item_menu(layout, name, icon, ui_item_menutype_func, mt, NULL, TIP_(mt->description), false);
2042 }
2043
2044 /* popover */
2045 void uiItemPopoverPanel_ptr(uiLayout *layout, bContext *C, PanelType *pt, const char *name, int icon)
2046 {
2047         if (!name) {
2048                 name = CTX_IFACE_(pt->translation_context, pt->label);
2049         }
2050
2051         if (layout->root->type == UI_LAYOUT_MENU && !icon) {
2052                 icon = ICON_BLANK1;
2053         }
2054
2055         const bool ok = (pt->poll == NULL) || pt->poll(C, pt);
2056         if (ok && (pt->draw_header != NULL)) {
2057                 layout = uiLayoutRow(layout, true);
2058                 Panel panel = {
2059                         .type = pt,
2060                         .layout = layout,
2061                         .flag = PNL_POPOVER,
2062                 };
2063                 pt->draw_header(C, &panel);
2064         }
2065         uiBut *but = ui_item_menu(layout, name, icon, ui_item_paneltype_func, pt, NULL, NULL, true);
2066         but->type = UI_BTYPE_POPOVER;
2067         if (!ok) {
2068                 but->flag |= UI_BUT_DISABLED;
2069         }
2070 }
2071
2072 void uiItemPopoverPanel(
2073         uiLayout *layout, bContext *C,
2074         int space_id, int region_id, const char *panel_type,
2075         const char *name, int icon)
2076 {
2077         SpaceType *st = BKE_spacetype_from_id(space_id);
2078         if (st == NULL) {
2079                 RNA_warning("space type not found %d", space_id);
2080                 return;
2081         }
2082         ARegionType *art = BKE_regiontype_from_id(st, region_id);
2083         if (art == NULL) {
2084                 RNA_warning("region type not found %d", region_id);
2085                 return;
2086         }
2087
2088         PanelType *pt;
2089         for (pt = art->paneltypes.first; pt; pt = pt->next) {
2090                 if (STREQ(pt->idname, panel_type)) {
2091                         break;
2092                 }
2093         }
2094
2095         if (pt == NULL) {
2096                 RNA_warning("area type not found %s", panel_type);
2097                 return;
2098         }
2099
2100         uiItemPopoverPanel_ptr(layout, C, pt, name, icon);
2101 }
2102
2103 void uiItemPopoverPanelFromGroup(
2104         uiLayout *layout, bContext *C,
2105         int space_id, int region_id, const char *context, const char *category)
2106 {
2107         SpaceType *st = BKE_spacetype_from_id(space_id);
2108         if (st == NULL) {
2109                 RNA_warning("space type not found %d", space_id);
2110                 return;
2111         }
2112         ARegionType *art = BKE_regiontype_from_id(st, region_id);
2113         if (art == NULL) {
2114                 RNA_warning("region type not found %d", region_id);
2115                 return;
2116         }
2117
2118         for (PanelType *pt = art->paneltypes.first; pt; pt = pt->next) {
2119                 /* Causes too many panels, check context. */
2120                 if (pt->parent_id[0] == '\0') {
2121                         if (/* (*context == '\0') || */ STREQ(pt->context, context)) {
2122                                 if ((*category == '\0') || STREQ(pt->category, category)) {
2123                                         if (pt->poll == NULL || pt->poll(C, pt)) {
2124                                                 uiItemPopoverPanel_ptr(layout, C, pt, NULL, ICON_NONE);
2125                                         }
2126                                 }
2127                         }
2128                 }
2129         }
2130 }
2131
2132
2133 /* label item */
2134 static uiBut *uiItemL_(uiLayout *layout, const char *name, int icon)
2135 {
2136         uiBlock *block = layout->root->block;
2137         uiBut *but;
2138         int w;
2139
2140         UI_block_layout_set_current(block, layout);
2141
2142         if (!name)
2143                 name = "";
2144         if (layout->root->type == UI_LAYOUT_MENU && !icon)
2145                 icon = ICON_BLANK1;
2146
2147         w = ui_text_icon_width(layout, name, icon, 0);
2148
2149         if (icon && name[0])
2150                 but = uiDefIconTextBut(block, UI_BTYPE_LABEL, 0, icon, name, 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
2151         else if (icon)
2152                 but = uiDefIconBut(block, UI_BTYPE_LABEL, 0, icon, 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
2153         else
2154                 but = uiDefBut(block, UI_BTYPE_LABEL, 0, name, 0, 0, w, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
2155
2156         /* to compensate for string size padding in ui_text_icon_width,
2157          * make text aligned right if the layout is aligned right.
2158          */
2159         if (uiLayoutGetAlignment(layout) == UI_LAYOUT_ALIGN_RIGHT) {
2160                 but->drawflag &= ~UI_BUT_TEXT_LEFT;     /* default, needs to be unset */
2161                 but->drawflag |= UI_BUT_TEXT_RIGHT;
2162         }
2163
2164         /* Mark as a label inside a listbox. */
2165         if (block->flag & UI_BLOCK_LIST_ITEM) {
2166                 but->flag |= UI_BUT_LIST_ITEM;
2167         }
2168
2169         return but;
2170 }
2171
2172 void uiItemL(uiLayout *layout, const char *name, int icon)
2173 {
2174         uiItemL_(layout, name, icon);
2175 }
2176
2177 void uiItemLDrag(uiLayout *layout, PointerRNA *ptr, const char *name, int icon)
2178 {
2179         uiBut *but = uiItemL_(layout, name, icon);
2180
2181         if (ptr && ptr->type)
2182                 if (RNA_struct_is_ID(ptr->type))
2183                         UI_but_drag_set_id(but, ptr->id.data);
2184 }
2185
2186
2187 /* value item */
2188 void uiItemV(uiLayout *layout, const char *name, int icon, int argval)
2189 {
2190         /* label */
2191         uiBlock *block = layout->root->block;
2192         int *retvalue = (block->handle) ? &block->handle->retvalue : NULL;
2193         int w;
2194
2195         UI_block_layout_set_current(block, layout);
2196
2197         if (!name)
2198                 name = "";
2199         if (layout->root->type == UI_LAYOUT_MENU && !icon)
2200                 icon = ICON_BLANK1;
2201
2202         w = ui_text_icon_width(layout, name, icon, 0);
2203
2204         if (icon && name[0])
2205                 uiDefIconTextButI(block, UI_BTYPE_BUT, argval, icon, name, 0, 0, w, UI_UNIT_Y, retvalue, 0.0, 0.0, 0, -1, "");
2206         else if (icon)
2207                 uiDefIconButI(block, UI_BTYPE_BUT, argval, icon, 0, 0, w, UI_UNIT_Y, retvalue, 0.0, 0.0, 0, -1, "");
2208         else
2209                 uiDefButI(block, UI_BTYPE_BUT, argval, name, 0, 0, w, UI_UNIT_Y, retvalue, 0.0, 0.0, 0, -1, "");
2210 }
2211
2212 /* separator item */
2213 void uiItemS(uiLayout *layout)
2214 {
2215         uiBlock *block = layout->root->block;
2216         bool is_menu = ui_block_is_menu(block);
2217         int space = (is_menu) ? 0.45f * UI_UNIT_X : 0.3f * UI_UNIT_X;
2218
2219         UI_block_layout_set_current(block, layout);
2220         uiDefBut(block, (is_menu) ? UI_BTYPE_SEPR_LINE : UI_BTYPE_SEPR, 0, "", 0, 0, space, space, NULL, 0.0, 0.0, 0, 0, "");
2221 }
2222
2223 /* Flexible spacing. */
2224 void uiItemSpacer(uiLayout *layout)
2225 {
2226         uiBlock *block = layout->root->block;
2227         bool is_menu = ui_block_is_menu(block);
2228
2229         if (is_menu) {
2230                 printf("Error: separator_spacer() not supported in menus.\n");
2231                 return;
2232         }
2233
2234         if (block->direction & UI_DIR_RIGHT) {
2235                 printf("Error: separator_spacer() only supported in horizontal blocks.\n");
2236                 return;
2237         }
2238
2239         UI_block_layout_set_current(block, layout);
2240         uiDefBut(block, UI_BTYPE_SEPR_SPACER, 0, "", 0, 0, 0.3f * UI_UNIT_X, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, "");
2241 }
2242
2243 /* level items */
2244 void uiItemMenuF(uiLayout *layout, const char *name, int icon, uiMenuCreateFunc func, void *arg)
2245 {
2246         if (!func)
2247                 return;
2248
2249         ui_item_menu(layout, name, icon, func, arg, NULL, "", false);
2250 }
2251
2252 typedef struct MenuItemLevel {
2253         int opcontext;
2254         /* don't use pointers to the strings because python can dynamically
2255          * allocate strings and free before the menu draws, see [#27304] */
2256         char opname[OP_MAX_TYPENAME];
2257         char propname[MAX_IDPROP_NAME];
2258         PointerRNA rnapoin;
2259 } MenuItemLevel;
2260
2261 static void menu_item_enum_opname_menu(bContext *UNUSED(C), uiLayout *layout, void *arg)
2262 {
2263         MenuItemLevel *lvl = (MenuItemLevel *)(((uiBut *)arg)->func_argN);
2264
2265         uiLayoutSetOperatorContext(layout, lvl->opcontext);
2266         uiItemsEnumO(layout, lvl->opname, lvl->propname);
2267
2268         layout->root->block->flag |= UI_BLOCK_IS_FLIP;
2269
2270         /* override default, needed since this was assumed pre 2.70 */
2271         UI_block_direction_set(layout->root->block, UI_DIR_DOWN);
2272 }
2273
2274 void uiItemMenuEnumO_ptr(
2275         uiLayout *layout, bContext *C, wmOperatorType *ot, const char *propname,
2276         const char *name, int icon)
2277 {
2278         MenuItemLevel *lvl;
2279         uiBut *but;
2280
2281         /* Caller must check */
2282         BLI_assert(ot->srna != NULL);
2283
2284         if (name == NULL) {
2285                 name = RNA_struct_ui_name(ot->srna);
2286         }
2287
2288         if (layout->root->type == UI_LAYOUT_MENU && !icon)
2289                 icon = ICON_BLANK1;
2290
2291         lvl = MEM_callocN(sizeof(MenuItemLevel), "MenuItemLevel");
2292         BLI_strncpy(lvl->opname, ot->idname, sizeof(lvl->opname));
2293         BLI_strncpy(lvl->propname, propname, sizeof(lvl->propname));
2294         lvl->opcontext = layout->root->opcontext;
2295
2296         but = ui_item_menu(layout, name, icon, menu_item_enum_opname_menu, NULL, lvl,
2297                            RNA_struct_ui_description(ot->srna), true);
2298
2299         /* add hotkey here, lower UI code can't detect it */
2300         if ((layout->root->block->flag & UI_BLOCK_LOOP) &&
2301             (ot->prop && ot->invoke))
2302         {
2303                 char keybuf[128];
2304                 if (WM_key_event_operator_string(
2305                         C, ot->idname, layout->root->opcontext, NULL, false,
2306                         keybuf, sizeof(keybuf)))
2307                 {
2308                         ui_but_add_shortcut(but, keybuf, false);
2309                 }
2310         }
2311 }
2312
2313 void uiItemMenuEnumO(
2314         uiLayout *layout, bContext *C, const char *opname, const char *propname,
2315         const char *name, int icon)
2316 {
2317         wmOperatorType *ot = WM_operatortype_find(opname, 0); /* print error next */
2318
2319         UI_OPERATOR_ERROR_RET(ot, opname, return);
2320
2321         if (!ot->srna) {
2322                 ui_item_disabled(layout, opname);
2323                 RNA_warning("operator missing srna '%s'", opname);
2324                 return;
2325         }
2326
2327         uiItemMenuEnumO_ptr(layout, C, ot, propname, name, icon);
2328 }
2329
2330 static void menu_item_enum_rna_menu(bContext *UNUSED(C), uiLayout *layout, void *arg)
2331 {
2332         MenuItemLevel *lvl = (MenuItemLevel *)(((uiBut *)arg)->func_argN);
2333
2334         uiLayoutSetOperatorContext(layout, lvl->opcontext);
2335         uiItemsEnumR(layout, &lvl->rnapoin, lvl->propname);
2336         layout->root->block->flag |= UI_BLOCK_IS_FLIP;
2337 }
2338
2339 void uiItemMenuEnumR_prop(uiLayout *layout, struct PointerRNA *ptr, PropertyRNA *prop, const char *name, int icon)
2340 {
2341         MenuItemLevel *lvl;
2342
2343         if (!name)
2344                 name = RNA_property_ui_name(prop);
2345         if (layout->root->type == UI_LAYOUT_MENU && !icon)
2346                 icon = ICON_BLANK1;
2347
2348         lvl = MEM_callocN(sizeof(MenuItemLevel), "MenuItemLevel");
2349         lvl->rnapoin = *ptr;
2350         BLI_strncpy(lvl->propname, RNA_property_identifier(prop), sizeof(lvl->propname));
2351         lvl->opcontext = layout->root->opcontext;
2352
2353         ui_item_menu(layout, name, icon, menu_item_enum_rna_menu, NULL, lvl, RNA_property_description(prop), false);
2354 }
2355
2356 void uiItemMenuEnumR(uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *name, int icon)
2357 {
2358         PropertyRNA *prop;
2359
2360         prop = RNA_struct_find_property(ptr, propname);
2361         if (!prop) {
2362                 ui_item_disabled(layout, propname);
2363                 RNA_warning("property not found: %s.%s", RNA_struct_identifier(ptr->type), propname);
2364                 return;
2365         }
2366
2367         uiItemMenuEnumR_prop(layout, ptr, prop, name, icon);
2368 }
2369
2370 /**************************** Layout Items ***************************/
2371
2372 /* single-row layout */
2373 static void ui_litem_estimate_row(uiLayout *litem)
2374 {
2375         uiItem *item;
2376         int itemw, itemh;
2377         bool min_size_flag = true;
2378
2379         litem->w = 0;
2380         litem->h = 0;
2381
2382         for (item = litem->items.first; item; item = item->next) {
2383                 ui_item_size(item, &itemw, &itemh);
2384
2385                 min_size_flag = min_size_flag && (item->flag & UI_ITEM_MIN);
2386
2387                 litem->w += itemw;
2388                 litem->h = MAX2(itemh, litem->h);
2389
2390                 if (item->next)
2391                         litem->w += litem->space;
2392         }
2393
2394         if (min_size_flag) {
2395                 litem->item.flag |= UI_ITEM_MIN;
2396         }
2397 }
2398
2399 static int ui_litem_min_width(int itemw)
2400 {
2401         return MIN2(2 * UI_UNIT_X, itemw);
2402 }
2403
2404 static void ui_litem_layout_row(uiLayout *litem)
2405 {
2406         uiItem *item, *last_free_item = NULL;
2407         int x, y, w, tot, totw, neww, newtotw, itemw, minw, itemh, offset;
2408         int fixedw, freew, fixedx, freex, flag = 0, lastw = 0;
2409         float extra_pixel;
2410
2411         /* x = litem->x; */ /* UNUSED */
2412         y = litem->y;
2413         w = litem->w;
2414         totw = 0;
2415         tot = 0;
2416
2417         for (item = litem->items.first; item; item = item->next) {
2418                 ui_item_size(item, &itemw, &itemh);
2419                 totw += itemw;
2420                 tot++;
2421         }
2422
2423         if (totw == 0)
2424                 return;
2425
2426         if (w != 0)
2427                 w -= (tot - 1) * litem->space;
2428         fixedw = 0;
2429
2430         /* keep clamping items to fixed minimum size until all are done */
2431         do {
2432                 freew = 0;
2433                 x = 0;
2434                 flag = 0;
2435                 newtotw = totw;
2436                 extra_pixel = 0.0f;
2437
2438                 for (item = litem->items.first; item; item = item->next) {
2439                         if (item->flag & UI_ITEM_FIXED)
2440                                 continue;
2441
2442                         ui_item_size(item, &itemw, &itemh);
2443                         minw = ui_litem_min_width(itemw);
2444
2445                         if (w - lastw > 0)
2446                                 neww = ui_item_fit(itemw, x, totw, w - lastw, !item->next, litem->alignment, &extra_pixel);
2447                         else
2448                                 neww = 0;  /* no space left, all will need clamping to minimum size */
2449
2450                         x += neww;
2451
2452                         bool min_flag = item->flag & UI_ITEM_MIN;
2453                         /* ignore min flag for rows with right or center alignment */
2454                         if (item->type != ITEM_BUTTON &&
2455                             ELEM(((uiLayout *)item)->alignment, UI_LAYOUT_ALIGN_RIGHT, UI_LAYOUT_ALIGN_CENTER) &&
2456                             litem->alignment == UI_LAYOUT_ALIGN_EXPAND &&
2457                             ((uiItem *)litem)->flag & UI_ITEM_MIN)
2458                         {
2459                                 min_flag = false;
2460                         }
2461
2462                         if ((neww < minw || min_flag) && w != 0) {
2463                                 /* fixed size */
2464                                 item->flag |= UI_ITEM_FIXED;
2465                                 if (item->type != ITEM_BUTTON && item->flag & UI_ITEM_MIN) {
2466                                         minw = itemw;
2467                                 }
2468                                 fixedw += minw;
2469                                 flag = 1;
2470                                 newtotw -= itemw;
2471                         }
2472                         else {
2473                                 /* keep free size */
2474                                 item->flag &= ~UI_ITEM_FIXED;
2475                                 freew += itemw;
2476                         }
2477                 }
2478
2479                 totw = newtotw;
2480                 lastw = fixedw;
2481         } while (flag);
2482
2483         freex = 0;
2484         fixedx = 0;
2485         extra_pixel = 0.0f;
2486         x = litem->x;
2487
2488         for (item = litem->items.first; item; item = item->next) {
2489                 ui_item_size(item, &itemw, &itemh);
2490                 minw = ui_litem_min_width(itemw);
2491
2492                 if (item->flag & UI_ITEM_FIXED) {
2493                         /* fixed minimum size items */
2494                         if (item->type != ITEM_BUTTON && item->flag & UI_ITEM_MIN) {
2495                                 minw = itemw;
2496                         }
2497                         itemw = ui_item_fit(minw, fixedx, fixedw, min_ii(w, fixedw), !item->next, litem->alignment, &extra_pixel);
2498                         fixedx += itemw;
2499                 }
2500                 else {
2501                         /* free size item */
2502                         itemw = ui_item_fit(itemw, freex, freew, w - fixedw, !item->next, litem->alignment, &extra_pixel);
2503                         freex += itemw;
2504                         last_free_item = item;
2505                 }
2506
2507                 /* align right/center */
2508                 offset = 0;
2509                 if (litem->alignment == UI_LAYOUT_ALIGN_RIGHT) {
2510                         if (freew + fixedw > 0 && freew + fixedw < w)
2511                                 offset = w - (fixedw + freew);
2512                 }
2513                 else if (litem->alignment == UI_LAYOUT_ALIGN_CENTER) {
2514                         if (freew + fixedw > 0 && freew + fixedw < w)
2515                                 offset = (w - (fixedw + freew)) / 2;
2516                 }
2517
2518                 /* position item */
2519                 ui_item_position(item, x + offset, y - itemh, itemw, itemh);
2520
2521                 x += itemw;
2522                 if (item->next)
2523                         x += litem->space;
2524         }
2525
2526         /* add extra pixel */
2527         uiItem *last_item = litem->items.last;
2528         extra_pixel = litem->w - (x - litem->x);
2529         if (extra_pixel > 0 && litem->alignment == UI_LAYOUT_ALIGN_EXPAND &&
2530             last_free_item && last_item && last_item->flag & UI_ITEM_FIXED)
2531         {
2532                 ui_item_move(last_free_item, 0, extra_pixel);
2533                 for (item = last_free_item->next; item; item = item->next)
2534                         ui_item_move(item, extra_pixel, extra_pixel);
2535         }
2536
2537         litem->w = x - litem->x;
2538         litem->h = litem->y - y;
2539         litem->x = x;
2540         litem->y = y;
2541 }
2542
2543 /* single-column layout */
2544 static void ui_litem_estimate_column(uiLayout *litem, bool is_box)
2545 {
2546         uiItem *item;
2547         int itemw, itemh;
2548         bool min_size_flag = true;
2549
2550         litem->w = 0;
2551         litem->h = 0;
2552
2553         for (item = litem->items.first; item; item = item->next) {
2554                 ui_item_size(item, &itemw, &itemh);
2555
2556                 min_size_flag = min_size_flag && (item->flag & UI_ITEM_MIN);
2557
2558                 litem->w = MAX2(litem->w, itemw);
2559                 litem->h += itemh;
2560
2561                 if (item->next && (!is_box || item != litem->items.first))
2562                         litem->h += litem->space;
2563         }
2564
2565         if (min_size_flag) {
2566                 litem->item.flag |= UI_ITEM_MIN;
2567         }
2568 }
2569
2570 static void ui_litem_layout_column(uiLayout *litem, bool is_box)
2571 {
2572         uiItem *item;
2573         int itemh, x, y;
2574
2575         x = litem->x;
2576         y = litem->y;
2577
2578         for (item = litem->items.first; item; item = item->next) {
2579                 ui_item_size(item, NULL, &itemh);
2580
2581                 y -= itemh;
2582                 ui_item_position(item, x, y, litem->w, itemh);
2583
2584                 if (item->next && (!is_box || item != litem->items.first))
2585                         y -= litem->space;
2586
2587                 if (is_box) {
2588                         item->flag |= UI_ITEM_BOX_ITEM;
2589                 }
2590         }
2591
2592         litem->h = litem->y - y;
2593         litem->x = x;
2594         litem->y = y;
2595 }
2596
2597 /* calculates the angle of a specified button in a radial menu,
2598  * stores a float vector in unit circle */
2599 static RadialDirection ui_get_radialbut_vec(float vec[2], short itemnum)
2600 {
2601         RadialDirection dir;
2602
2603         if (itemnum >= PIE_MAX_ITEMS) {
2604                 itemnum %= PIE_MAX_ITEMS;
2605                 printf("Warning: Pie menus with more than %i items are currently unsupported\n", PIE_MAX_ITEMS);
2606         }
2607
2608         dir = ui_radial_dir_order[itemnum];
2609         ui_but_pie_dir(dir, vec);
2610
2611         return dir;
2612 }
2613
2614 static bool ui_item_is_radial_displayable(uiItem *item)
2615 {
2616
2617         if ((item->type == ITEM_BUTTON) && (((uiButtonItem *)item)->but->type == UI_BTYPE_LABEL))
2618                 return false;
2619
2620         return true;
2621 }
2622
2623 static bool ui_item_is_radial_drawable(uiButtonItem *bitem)
2624 {
2625
2626         if (ELEM(bitem->but->type, UI_BTYPE_SEPR, UI_BTYPE_SEPR_LINE, UI_BTYPE_SEPR_SPACER))
2627                 return false;
2628
2629         return true;
2630 }
2631
2632 static void ui_litem_layout_radial(uiLayout *litem)
2633 {
2634         uiItem *item;
2635         int itemh, itemw, x, y;
2636         int itemnum = 0;
2637         int totitems = 0;
2638
2639         /* For the radial layout we will use Matt Ebb's design
2640          * for radiation, see http://mattebb.com/weblog/radiation/
2641          * also the old code at http://developer.blender.org/T5103
2642          */
2643
2644         int pie_radius = U.pie_menu_radius * UI_DPI_FAC;
2645
2646         x = litem->x;
2647         y = litem->y;
2648
2649         int minx = x, miny = y, maxx = x, maxy = y;
2650
2651         /* first count total items */
2652         for (item = litem->items.first; item; item = item->next)
2653                 totitems++;
2654
2655         if (totitems < 5)
2656                 litem->root->block->pie_data.flags |= UI_PIE_DEGREES_RANGE_LARGE;
2657
2658         for (item = litem->items.first; item; item = item->next) {
2659                 /* not all button types are drawn in a radial menu, do filtering here */
2660                 if (ui_item_is_radial_displayable(item)) {
2661                         RadialDirection dir;
2662                         float vec[2];
2663                         float factor[2];
2664
2665                         dir = ui_get_radialbut_vec(vec, itemnum);
2666                         factor[0] = (vec[0] > 0.01f) ? 0.0f : ((vec[0] < -0.01f) ? -1.0f : -0.5f);
2667                         factor[1] = (vec[1] > 0.99f) ? 0.0f : ((vec[1] < -0.99f) ? -1.0f : -0.5f);
2668
2669                         itemnum++;
2670
2671                         if (item->type == ITEM_BUTTON) {
2672                                 uiButtonItem *bitem = (uiButtonItem *) item;
2673
2674                                 bitem->but->pie_dir = dir;
2675                                 /* scale the buttons */
2676                                 bitem->but->rect.ymax *= 1.5f;
2677                                 /* add a little bit more here to include number */
2678                                 bitem->but->rect.xmax += 1.5f * UI_UNIT_X;
2679                                 /* enable drawing as pie item if supported by widget */
2680                                 if (ui_item_is_radial_drawable(bitem)) {
2681                                         bitem->but->dt = UI_EMBOSS_RADIAL;
2682                                         bitem->but->drawflag |= UI_BUT_ICON_LEFT;
2683                                 }
2684                         }
2685
2686                         ui_item_size(item, &itemw, &itemh);
2687
2688                         ui_item_position(item, x + vec[0] * pie_radius + factor[0] * itemw, y + vec[1] * pie_radius + factor[1] * itemh, itemw, itemh);
2689
2690                         minx = min_ii(minx, x + vec[0] * pie_radius - itemw / 2);
2691                         maxx = max_ii(maxx, x + vec[0] * pie_radius + itemw / 2);
2692                         miny = min_ii(miny, y + vec[1] * pie_radius - itemh / 2);
2693                         maxy = max_ii(maxy, y + vec[1] * pie_radius + itemh / 2);
2694                 }
2695         }
2696
2697         litem->x = minx;
2698         litem->y = miny;
2699         litem->w = maxx - minx;
2700         litem->h = maxy - miny;
2701 }
2702
2703 /* root layout */
2704 static void ui_litem_estimate_root(uiLayout *UNUSED(litem))
2705 {
2706         /* nothing to do */
2707 }
2708
2709 static void ui_litem_layout_root_radial(uiLayout *litem)
2710 {
2711         /* first item is pie menu title, align on center of menu */
2712         uiItem *item = litem->items.first;
2713
2714         if (item->type == ITEM_BUTTON) {
2715                 int itemh, itemw, x, y;
2716                 x = litem->x;
2717                 y = litem->y;
2718
2719                 ui_item_size(item, &itemw, &itemh);
2720
2721                 ui_item_position(item, x - itemw / 2, y + U.pixelsize * (U.pie_menu_threshold + 9.0f), itemw, itemh);
2722         }
2723 }
2724
2725 static void ui_litem_layout_root(uiLayout *litem)
2726 {
2727         if (litem->root->type == UI_LAYOUT_HEADER)
2728                 ui_litem_layout_row(litem);
2729         else if (litem->root->type == UI_LAYOUT_PIEMENU)
2730                 ui_litem_layout_root_radial(litem);
2731         else
2732                 ui_litem_layout_column(litem, false);
2733 }
2734
2735 /* box layout */
2736 static void ui_litem_estimate_box(uiLayout *litem)
2737 {
2738         uiStyle *style = litem->root->style;
2739
2740         ui_litem_estimate_column(litem, true);
2741         litem->w += 2 * style->boxspace;
2742         litem->h += 2 * style->boxspace;
2743 }
2744
2745 static void ui_litem_layout_box(uiLayout *litem)
2746 {
2747         uiLayoutItemBx *box = (uiLayoutItemBx *)litem;
2748         uiStyle *style = litem->root->style;
2749         uiBut *but;
2750         int w, h;
2751
2752         w = litem->w;
2753         h = litem->h;
2754
2755         litem->x += style->boxspace;
2756         litem->y -= style->boxspace;
2757
2758         if (w != 0) litem->w -= 2 * style->boxspace;
2759         if (h != 0) litem->h -= 2 * style->boxspace;
2760
2761         ui_litem_layout_column(litem, true);
2762
2763         litem->x -= style->boxspace;
2764         litem->y -= style->boxspace;
2765
2766         if (w != 0) litem->w += 2 * style->boxspace;
2767         if (h != 0) litem->h += 2 * style->boxspace;
2768
2769         /* roundbox around the sublayout */
2770         but = box->roundbox;
2771         but->rect.xmin = litem->x;
2772         but->rect.ymin = litem->y;
2773         but->rect.xmax = litem->x + litem->w;
2774         but->rect.ymax = litem->y + litem->h;
2775 }
2776
2777 /* multi-column layout, automatically flowing to the next */
2778 static void ui_litem_estimate_column_flow(uiLayout *litem)
2779 {
2780         uiStyle *style = litem->root->style;
2781         uiLayoutItemFlow *flow = (uiLayoutItemFlow *)litem;
2782         uiItem *item;
2783         int col, x, y, emh, emy, miny, itemw, itemh, maxw = 0;
2784         int toth, totitem;
2785
2786         /* compute max needed width and total height */
2787         toth = 0;
2788         totitem = 0;
2789         for (item = litem->items.first; item; item = item->next) {
2790                 ui_item_size(item, &itemw, &itemh);
2791                 maxw = MAX2(maxw, itemw);
2792                 toth += itemh;
2793                 totitem++;
2794         }
2795
2796         if (flow->number <= 0) {
2797                 /* auto compute number of columns, not very good */
2798                 if (maxw == 0) {
2799                         flow->totcol = 1;
2800                         return;
2801                 }
2802
2803                 flow->totcol = max_ii(litem->root->emw / maxw, 1);
2804                 flow->totcol = min_ii(flow->totcol, totitem);
2805         }
2806         else
2807                 flow->totcol = flow->number;
2808
2809         /* compute sizes */
2810         x = 0;
2811         y = 0;
2812         emy = 0;
2813         miny = 0;
2814
2815         maxw = 0;
2816         emh = toth / flow->totcol;
2817
2818         /* create column per column */
2819         col = 0;
2820         for (item = litem->items.first; item; item = item->next) {
2821                 ui_item_size(item, &itemw, &itemh);
2822
2823                 y -= itemh + style->buttonspacey;
2824                 miny = min_ii(miny, y);
2825                 emy -= itemh;
2826                 maxw = max_ii(itemw, maxw);
2827
2828                 /* decide to go to next one */
2829                 if (col < flow->totcol - 1 && emy <= -emh) {
2830                         x += maxw + litem->space;
2831                         maxw = 0;
2832                         y = 0;
2833                         emy = 0; /* need to reset height again for next column */
2834                         col++;
2835                 }
2836         }
2837
2838         litem->w = x;
2839         litem->h = litem->y - miny;
2840 }
2841
2842 static void ui_litem_layout_column_flow(uiLayout *litem)
2843 {
2844         uiStyle *style = litem->root->style;
2845         uiLayoutItemFlow *flow = (uiLayoutItemFlow *)litem;
2846         uiItem *item;
2847         int col, x, y, w, emh, emy, miny, itemw, itemh;
2848         int toth, totitem;
2849
2850         /* compute max needed width and total height */
2851         toth = 0;
2852         totitem = 0;
2853         for (item = litem->items.first; item; item = item->next) {
2854                 ui_item_size(item, &itemw, &itemh);
2855                 toth += itemh;
2856                 totitem++;
2857         }
2858
2859         /* compute sizes */
2860         x = litem->x;
2861         y = litem->y;
2862         emy = 0;
2863         miny = 0;
2864
2865         w = litem->w - (flow->totcol - 1) * style->columnspace;
2866         emh = toth / flow->totcol;
2867
2868         /* create column per column */
2869         col = 0;
2870         w = (litem->w - (flow->totcol - 1) * style->columnspace) / flow->totcol;
2871         for (item = litem->items.first; item; item = item->next) {
2872                 ui_item_size(item, &itemw, &itemh);
2873
2874                 itemw = (litem->alignment == UI_LAYOUT_ALIGN_EXPAND) ? w : min_ii(w, itemw);
2875
2876                 y -= itemh;
2877                 emy -= itemh;
2878                 ui_item_position(item, x, y, itemw, itemh);
2879                 y -= style->buttonspacey;
2880                 miny = min_ii(miny, y);
2881
2882                 /* decide to go to next one */
2883                 if (col < flow->totcol - 1 && emy <= -emh) {
2884                         x += w + style->columnspace;
2885                         y = litem->y;
2886                         emy = 0; /* need to reset height again for next column */
2887                         col++;
2888
2889                         /*  (<     remaining width     > - <      space between remaining columns      >) / <remamining columns > */
2890                         w = ((litem->w - (x - litem->x)) - (flow->totcol - col - 1) * style->columnspace) / (flow->totcol - col);
2891                 }
2892         }
2893
2894         litem->h = litem->y - miny;
2895         litem->x = x;
2896         litem->y = miny;
2897 }
2898
2899 /* multi-column and multi-row layout. */
2900 typedef struct UILayoutGridFlowInput {
2901         /* General layout controll settings. */
2902         const bool row_major : 1;  /* Fill rows before columns */
2903         const bool even_columns : 1;  /* All columns will have same width. */
2904         const bool even_rows : 1;  /* All rows will have same height. */
2905         const int space_x;  /* Space between columns. */
2906         const int space_y;  /* Space between rows. */
2907         /* Real data about current position and size of this layout item (either estimated, or final values). */
2908         const int litem_w;  /* Layout item width. */
2909         const int litem_x;  /* Layout item X position. */
2910         const int litem_y;  /* Layout item Y position. */
2911         /* Actual number of columns and rows to generate (computed from first pass usually). */
2912         const int tot_columns;  /* Number of columns. */
2913         const int tot_rows;  /* Number of rows. */
2914 } UILayoutGridFlowInput;
2915
2916 typedef struct UILayoutGridFlowOutput {
2917         int *tot_items;  /* Total number of items in this grid layout. */
2918         /* Width / X pos data. */
2919         float *global_avg_w;  /* Computed average width of the columns. */
2920         int *cos_x_array;  /* Computed X coordinate of each column. */
2921         int *widths_array;  /* Computed width of each column. */
2922         int *tot_w;  /* Computed total width. */
2923         /* Height / Y pos data. */
2924         int *global_max_h;  /* Computed height of the tallest item in the grid. */
2925         int *cos_y_array;  /* Computed Y coordinate of each column. */
2926         int *heights_array;  /* Computed height of each column. */
2927         int *tot_h;  /* Computed total height. */
2928 } UILayoutGridFlowOutput;
2929
2930 static void ui_litem_grid_flow_compute(
2931         ListBase *items, UILayoutGridFlowInput *parameters, UILayoutGridFlowOutput *results)
2932 {
2933         uiItem *item;
2934         int i;
2935
2936         float tot_w = 0.0f, tot_h = 0.0f;
2937         float global_avg_w = 0.0f, global_totweight_w = 0.0f;
2938         int global_max_h = 0;
2939
2940         float *avg_w = NULL, *totweight_w = NULL;
2941         int *max_h = NULL;
2942
2943         BLI_assert(parameters->tot_columns != 0 || (results->cos_x_array == NULL && results->widths_array == NULL && results->tot_w == NULL));
2944         BLI_assert(parameters->tot_rows != 0 || (results->cos_y_array == NULL && results->heights_array == NULL && results->tot_h == NULL));
2945
2946         if (results->tot_items) {
2947                 *results->tot_items = 0;
2948         }
2949
2950         if (items->first == NULL) {
2951                 if (results->global_avg_w) {
2952                         *results->global_avg_w = 0.0f;
2953                 }
2954                 if (results->global_max_h) {
2955                         *results->global_max_h = 0;
2956                 }
2957                 return;
2958         }
2959
2960         if (parameters->tot_columns != 0) {
2961                 avg_w = BLI_array_alloca(avg_w, parameters->tot_columns);
2962                 totweight_w = BLI_array_alloca(totweight_w, parameters->tot_columns);
2963                 memset(avg_w, 0, sizeof(*avg_w) * parameters->tot_columns);
2964                 memset(totweight_w, 0, sizeof(*totweight_w) * parameters->tot_columns);
2965         }
2966         if (parameters->tot_rows != 0) {
2967                 max_h = BLI_array_alloca(max_h, parameters->tot_rows);
2968                 memset(max_h, 0, sizeof(*max_h) * parameters->tot_rows);
2969         }
2970
2971         for (i = 0, item = items->first; item; item = item->next, i++) {
2972                 int item_w, item_h;
2973                 ui_item_size(item, &item_w, &item_h);
2974
2975                 global_avg_w += (float)(item_w * item_w);
2976                 global_totweight_w += (float)item_w;
2977                 global_max_h = max_ii(global_max_h, item_h);
2978
2979                 if (parameters->tot_rows != 0 && parameters->tot_columns != 0) {
2980                         const int index_col = parameters->row_major ? i % parameters->tot_columns : i / parameters->tot_rows;
2981                         const int index_row = parameters->row_major ? i / parameters->tot_columns : i % parameters->tot_rows;
2982
2983                         avg_w[index_col] += (float)(item_w * item_w);
2984                         totweight_w[index_col] += (float)item_w;
2985
2986                         max_h[index_row] = max_ii(max_h[index_row], item_h);
2987                 }
2988
2989                 if (results->tot_items) {
2990                         (*results->tot_items)++;
2991                 }
2992         }
2993
2994         /* Finalize computing of column average sizes */
2995         global_avg_w /= global_totweight_w;
2996         if (parameters->tot_columns != 0) {
2997                 for (i = 0; i < parameters->tot_columns; i++) {
2998                         avg_w[i] /= totweight_w[i];
2999                         tot_w += avg_w[i];
3000                 }
3001                 if (parameters->even_columns) {
3002                         tot_w = ceilf(global_avg_w) * parameters->tot_columns;
3003                 }
3004         }
3005         /* Finalize computing of rows max sizes */
3006         if (parameters->tot_rows != 0) {
3007                 for (i = 0; i < parameters->tot_rows; i++) {
3008                         tot_h += max_h[i];
3009                 }
3010                 if (parameters->even_rows) {
3011                         tot_h = global_max_h * parameters->tot_columns;
3012                 }
3013         }
3014
3015         /* Compute positions and sizes of all cells. */
3016         if (results->cos_x_array != NULL && results->widths_array != NULL) {
3017                 /* We enlarge/narrow columns evenly to match available width. */
3018                 const float wfac = (float)(parameters->litem_w - (parameters->tot_columns - 1) * parameters->space_x) / tot_w;
3019
3020                 for (int col = 0; col < parameters->tot_columns; col++) {
3021                         results->cos_x_array[col] = (
3022                                 col ?
3023                                 results->cos_x_array[col - 1] + results->widths_array[col - 1] + parameters->space_x :
3024                                 parameters->litem_x
3025                         );
3026                         if (parameters->even_columns) {
3027                                 /* (< remaining width > - < space between remaining columns >) / < remaining columns > */
3028                                 results->widths_array[col] = (
3029                                         ((parameters->litem_w - (results->cos_x_array[col] - parameters->litem_x)) -
3030                                          (parameters->tot_columns - col - 1) * parameters->space_x) / (parameters->tot_columns - col));
3031                         }
3032                         else if (col == parameters->tot_columns - 1) {
3033                                 /* Last column copes width rounding errors... */
3034                                 results->widths_array[col] = parameters->litem_w - (results->cos_x_array[col] - parameters->litem_x);
3035                         }
3036                         else {
3037                                 results->widths_array[col] = (int)(avg_w[col] * wfac);
3038                         }
3039                 }
3040         }
3041         if (results->cos_y_array != NULL && results->heights_array != NULL) {
3042                 for (int row = 0; row < parameters->tot_rows; row++) {
3043                         if (parameters->even_rows) {
3044                                 results->heights_array[row] = global_max_h;
3045                         }
3046                         else {
3047                                 results->heights_array[row] = max_h[row];
3048                         }
3049                         results->cos_y_array[row] = (
3050                                 row ?
3051                                 results->cos_y_array[row - 1] - parameters->space_y - results->heights_array[row] :
3052                                 parameters->litem_y - results->heights_array[row]);
3053                 }
3054         }
3055
3056         if (results->global_avg_w) {
3057                 *results->global_avg_w = global_avg_w;
3058         }
3059         if (results->global_max_h) {
3060                 *results->global_max_h = global_max_h;
3061         }
3062         if (results->tot_w) {
3063                 *results->tot_w = (int)tot_w + parameters->space_x * (parameters->tot_columns - 1);
3064         }
3065         if (results->tot_h) {
3066                 *results->tot_h = tot_h + parameters->space_y * (parameters->tot_rows - 1);
3067         }
3068 }
3069
3070 static void ui_litem_estimate_grid_flow(uiLayout *litem)
3071 {
3072         uiStyle *style = litem->root->style;
3073         uiLayoutItemGridFlow *gflow = (uiLayoutItemGridFlow *)litem;
3074
3075         const int space_x = style->columnspace;
3076         const int space_y = style->buttonspacey;
3077
3078         /* Estimate average needed width and height per item. */
3079         {
3080                 float avg_w;
3081                 int max_h;
3082
3083                 ui_litem_grid_flow_compute(
3084                         &litem->items,
3085                         &((UILayoutGridFlowInput) {
3086                               .row_major = gflow->row_major,
3087                               .even_columns = gflow->even_columns,
3088                               .even_rows = gflow->even_rows,
3089                               .litem_w = litem->w,
3090                               .litem_x = litem->x,
3091                               .litem_y = litem->y,
3092                               .space_x = space_x,
3093                               .space_y = space_y,
3094                           }),
3095                         &((UILayoutGridFlowOutput) {
3096                               .tot_items = &gflow->tot_items,
3097                               .global_avg_w = &avg_w,
3098                               .global_max_h = &max_h,
3099                           }));
3100
3101                 if (gflow->tot_items == 0) {
3102                         litem->w = litem->h = 0;
3103                         gflow->tot_columns = gflow->tot_rows = 0;
3104                         return;
3105                 }
3106
3107                 /* Even in varying column width case, we fix our columns number from weighted average width of items,
3108                  * a proper solving of required width would be too costly, and this should give reasonably good results
3109                  * in all resonable cases... */
3110                 if (gflow->num_columns > 0) {
3111                         gflow->tot_columns = gflow->num_columns;
3112                 }
3113                 else {
3114                         if (avg_w == 0.0f) {
3115                                 gflow->tot_columns = 1;
3116                         }
3117                         else {
3118                                 gflow->tot_columns = min_ii(max_ii((int)(litem->w / avg_w), 1), gflow->tot_items);
3119                         }
3120                 }
3121                 gflow->tot_rows = (int)ceilf((float)gflow->tot_items / gflow->tot_columns);
3122
3123                 /* Try to tweak number of columns and rows to get better filling of last column or row,
3124                  * and apply 'modulo' value to number of columns or rows.
3125                  * Note that modulo does not prevent ending with fewer columns/rows than modulo, if mandatory
3126<