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