/* * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software Foundation, * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV. * All rights reserved. */ /** \file * \ingroup edinterface */ #include #include #include #include #include /* offsetof() */ #include #include "MEM_guardedalloc.h" #include "DNA_object_types.h" #include "DNA_scene_types.h" #include "DNA_screen_types.h" #include "DNA_userdef_types.h" #include "DNA_workspace_types.h" #include "BLI_listbase.h" #include "BLI_math.h" #include "BLI_rect.h" #include "BLI_string.h" #include "BLI_string_utf8.h" #include "BLI_utildefines.h" #include "BKE_animsys.h" #include "BKE_context.h" #include "BKE_idprop.h" #include "BKE_main.h" #include "BKE_scene.h" #include "BKE_screen.h" #include "BKE_unit.h" #include "GPU_matrix.h" #include "GPU_state.h" #include "BLF_api.h" #include "BLT_translation.h" #include "UI_interface.h" #include "UI_interface_icons.h" #include "IMB_imbuf.h" #include "WM_api.h" #include "WM_message.h" #include "WM_types.h" #include "RNA_access.h" #include "BPY_extern.h" #include "ED_numinput.h" #include "ED_screen.h" #include "IMB_colormanagement.h" #include "DEG_depsgraph_query.h" #include "interface_intern.h" /* prototypes. */ static void ui_but_to_pixelrect(struct rcti *rect, const struct ARegion *region, struct uiBlock *block, struct uiBut *but); static void ui_def_but_rna__menu(bContext *UNUSED(C), uiLayout *layout, void *but_p); static void ui_def_but_rna__panel_type(bContext *UNUSED(C), uiLayout *layout, void *but_p); static void ui_def_but_rna__menu_type(bContext *UNUSED(C), uiLayout *layout, void *but_p); /* avoid unneeded calls to ui_but_value_get */ #define UI_BUT_VALUE_UNSET DBL_MAX #define UI_GET_BUT_VALUE_INIT(_but, _value) \ if (_value == DBL_MAX) { \ (_value) = ui_but_value_get(_but); \ } \ ((void)0) #define B_NOP -1 /** * a full doc with API notes can be found in 'blender/doc/guides/interface_API.txt' * * `uiBlahBlah()` external function. * `ui_blah_blah()` internal function. */ static void ui_but_free(const bContext *C, uiBut *but); static bool ui_but_is_unit_radians_ex(UnitSettings *unit, const int unit_type) { return (unit->system_rotation == USER_UNIT_ROT_RADIANS && unit_type == PROP_UNIT_ROTATION); } static bool ui_but_is_unit_radians(const uiBut *but) { UnitSettings *unit = but->block->unit; const int unit_type = UI_but_unit_type_get(but); return ui_but_is_unit_radians_ex(unit, unit_type); } /* ************* window matrix ************** */ void ui_block_to_window_fl(const ARegion *region, uiBlock *block, float *x, float *y) { float gx, gy; int sx, sy, getsizex, getsizey; getsizex = BLI_rcti_size_x(®ion->winrct) + 1; getsizey = BLI_rcti_size_y(®ion->winrct) + 1; sx = region->winrct.xmin; sy = region->winrct.ymin; gx = *x; gy = *y; if (block->panel) { gx += block->panel->ofsx; gy += block->panel->ofsy; } *x = ((float)sx) + ((float)getsizex) * (0.5f + 0.5f * (gx * block->winmat[0][0] + gy * block->winmat[1][0] + block->winmat[3][0])); *y = ((float)sy) + ((float)getsizey) * (0.5f + 0.5f * (gx * block->winmat[0][1] + gy * block->winmat[1][1] + block->winmat[3][1])); } void ui_block_to_window(const ARegion *region, uiBlock *block, int *x, int *y) { float fx, fy; fx = *x; fy = *y; ui_block_to_window_fl(region, block, &fx, &fy); *x = (int)(fx + 0.5f); *y = (int)(fy + 0.5f); } void ui_block_to_window_rctf(const ARegion *region, uiBlock *block, rctf *rct_dst, const rctf *rct_src) { *rct_dst = *rct_src; ui_block_to_window_fl(region, block, &rct_dst->xmin, &rct_dst->ymin); ui_block_to_window_fl(region, block, &rct_dst->xmax, &rct_dst->ymax); } float ui_block_to_window_scale(const ARegion *region, uiBlock *block) { /* We could have function for this to avoid dummy arg. */ float dummy_x; float min_y = 0, max_y = 1; dummy_x = 0.0f; ui_block_to_window_fl(region, block, &dummy_x, &min_y); dummy_x = 0.0f; ui_block_to_window_fl(region, block, &dummy_x, &max_y); return max_y - min_y; } /* for mouse cursor */ void ui_window_to_block_fl(const ARegion *region, uiBlock *block, float *x, float *y) { float a, b, c, d, e, f, px, py; int sx, sy, getsizex, getsizey; getsizex = BLI_rcti_size_x(®ion->winrct) + 1; getsizey = BLI_rcti_size_y(®ion->winrct) + 1; sx = region->winrct.xmin; sy = region->winrct.ymin; a = 0.5f * ((float)getsizex) * block->winmat[0][0]; b = 0.5f * ((float)getsizex) * block->winmat[1][0]; c = 0.5f * ((float)getsizex) * (1.0f + block->winmat[3][0]); d = 0.5f * ((float)getsizey) * block->winmat[0][1]; e = 0.5f * ((float)getsizey) * block->winmat[1][1]; f = 0.5f * ((float)getsizey) * (1.0f + block->winmat[3][1]); px = *x - sx; py = *y - sy; *y = (a * (py - f) + d * (c - px)) / (a * e - d * b); *x = (px - b * (*y) - c) / a; if (block->panel) { *x -= block->panel->ofsx; *y -= block->panel->ofsy; } } void ui_window_to_block_rctf(const struct ARegion *region, uiBlock *block, rctf *rct_dst, const rctf *rct_src) { *rct_dst = *rct_src; ui_window_to_block_fl(region, block, &rct_dst->xmin, &rct_dst->ymin); ui_window_to_block_fl(region, block, &rct_dst->xmax, &rct_dst->ymax); } void ui_window_to_block(const ARegion *region, uiBlock *block, int *x, int *y) { float fx, fy; fx = *x; fy = *y; ui_window_to_block_fl(region, block, &fx, &fy); *x = (int)(fx + 0.5f); *y = (int)(fy + 0.5f); } void ui_window_to_region(const ARegion *region, int *x, int *y) { *x -= region->winrct.xmin; *y -= region->winrct.ymin; } void ui_window_to_region_rcti(const ARegion *region, rcti *rect_dst, const rcti *rct_src) { rect_dst->xmin = rct_src->xmin - region->winrct.xmin; rect_dst->xmax = rct_src->xmax - region->winrct.xmin; rect_dst->ymin = rct_src->ymin - region->winrct.ymin; rect_dst->ymax = rct_src->ymax - region->winrct.ymin; } void ui_region_to_window(const ARegion *region, int *x, int *y) { *x += region->winrct.xmin; *y += region->winrct.ymin; } static void ui_update_flexible_spacing(const ARegion *region, uiBlock *block) { int sepr_flex_len = 0; LISTBASE_FOREACH (uiBut *, but, &block->buttons) { if (but->type == UI_BTYPE_SEPR_SPACER) { sepr_flex_len++; } } if (sepr_flex_len == 0) { return; } rcti rect; ui_but_to_pixelrect(&rect, region, block, block->buttons.last); const float buttons_width = (float)rect.xmax + UI_HEADER_OFFSET; const float region_width = (float)region->sizex * U.dpi_fac; if (region_width <= buttons_width) { return; } /* We could get rid of this loop if we agree on a max number of spacer */ int *spacers_pos = alloca(sizeof(*spacers_pos) * (size_t)sepr_flex_len); int i = 0; LISTBASE_FOREACH (uiBut *, but, &block->buttons) { if (but->type == UI_BTYPE_SEPR_SPACER) { ui_but_to_pixelrect(&rect, region, block, but); spacers_pos[i] = rect.xmax + UI_HEADER_OFFSET; i++; } } const float segment_width = region_width / (float)sepr_flex_len; float offset = 0, remaining_space = region_width - buttons_width; i = 0; LISTBASE_FOREACH (uiBut *, but, &block->buttons) { BLI_rctf_translate(&but->rect, offset, 0); if (but->type == UI_BTYPE_SEPR_SPACER) { /* How much the next block overlap with the current segment */ int overlap = ((i == sepr_flex_len - 1) ? buttons_width - spacers_pos[i] : (spacers_pos[i + 1] - spacers_pos[i]) / 2); int segment_end = segment_width * (i + 1); int spacer_end = segment_end - overlap; int spacer_sta = spacers_pos[i] + offset; if (spacer_end > spacer_sta) { float step = min_ff(remaining_space, spacer_end - spacer_sta); remaining_space -= step; offset += step; } i++; } } ui_block_bounds_calc(block); } static void ui_update_window_matrix(const wmWindow *window, const ARegion *region, uiBlock *block) { /* window matrix and aspect */ if (region && region->visible) { /* Get projection matrix which includes View2D translation and zoom. */ GPU_matrix_projection_get(block->winmat); block->aspect = 2.0f / fabsf(region->winx * block->winmat[0][0]); } else { /* No subwindow created yet, for menus for example, so we use the main * window instead, since buttons are created there anyway. */ int width = WM_window_pixels_x(window); int height = WM_window_pixels_y(window); rcti winrct = {0, width - 1, 0, height - 1}; wmGetProjectionMatrix(block->winmat, &winrct); block->aspect = 2.0f / fabsf(width * block->winmat[0][0]); } } /** * Popups will add a margin to #ARegion.winrct for shadow, * for interactivity (point-inside tests for eg), we want the winrct without the margin added. */ void ui_region_winrct_get_no_margin(const struct ARegion *region, struct rcti *r_rect) { uiBlock *block = region->uiblocks.first; if (block && (block->flag & UI_BLOCK_LOOP) && (block->flag & UI_BLOCK_RADIAL) == 0) { BLI_rcti_rctf_copy_floor(r_rect, &block->rect); BLI_rcti_translate(r_rect, region->winrct.xmin, region->winrct.ymin); } else { *r_rect = region->winrct; } } /* ******************* block calc ************************* */ void UI_block_translate(uiBlock *block, int x, int y) { uiBut *but; for (but = block->buttons.first; but; but = but->next) { BLI_rctf_translate(&but->rect, x, y); } BLI_rctf_translate(&block->rect, x, y); } static void ui_block_bounds_calc_text(uiBlock *block, float offset) { const uiStyle *style = UI_style_get(); uiBut *bt, *init_col_bt, *col_bt; int i = 0, j, x1addval = offset; UI_fontstyle_set(&style->widget); for (init_col_bt = bt = block->buttons.first; bt; bt = bt->next) { if (!ELEM(bt->type, UI_BTYPE_SEPR, UI_BTYPE_SEPR_LINE, UI_BTYPE_SEPR_SPACER)) { j = BLF_width(style->widget.uifont_id, bt->drawstr, sizeof(bt->drawstr)); if (j > i) { i = j; } } if (bt->next && bt->rect.xmin < bt->next->rect.xmin) { /* End of this column, and it's not the last one. */ for (col_bt = init_col_bt; col_bt->prev != bt; col_bt = col_bt->next) { col_bt->rect.xmin = x1addval; col_bt->rect.xmax = x1addval + i + block->bounds; ui_but_update(col_bt); /* clips text again */ } /* And we prepare next column. */ x1addval += i + block->bounds; i = 0; init_col_bt = col_bt; } } /* Last column. */ for (col_bt = init_col_bt; col_bt; col_bt = col_bt->next) { col_bt->rect.xmin = x1addval; col_bt->rect.xmax = max_ff(x1addval + i + block->bounds, offset + block->minbounds); ui_but_update(col_bt); /* clips text again */ } } void ui_block_bounds_calc(uiBlock *block) { uiBut *bt; int xof; if (BLI_listbase_is_empty(&block->buttons)) { if (block->panel) { block->rect.xmin = 0.0; block->rect.xmax = block->panel->sizex; block->rect.ymin = 0.0; block->rect.ymax = block->panel->sizey; } } else { BLI_rctf_init_minmax(&block->rect); for (bt = block->buttons.first; bt; bt = bt->next) { BLI_rctf_union(&block->rect, &bt->rect); } block->rect.xmin -= block->bounds; block->rect.ymin -= block->bounds; block->rect.xmax += block->bounds; block->rect.ymax += block->bounds; } block->rect.xmax = block->rect.xmin + max_ff(BLI_rctf_size_x(&block->rect), block->minbounds); /* hardcoded exception... but that one is annoying with larger safety */ bt = block->buttons.first; if (bt && STREQLEN(bt->str, "ERROR", 5)) { xof = 10; } else { xof = 40; } block->safety.xmin = block->rect.xmin - xof; block->safety.ymin = block->rect.ymin - xof; block->safety.xmax = block->rect.xmax + xof; block->safety.ymax = block->rect.ymax + xof; } static void ui_block_bounds_calc_centered(wmWindow *window, uiBlock *block) { int xmax, ymax; int startx, starty; int width, height; /* note: this is used for the splash where window bounds event has not been * updated by ghost, get the window bounds from ghost directly */ xmax = WM_window_pixels_x(window); ymax = WM_window_pixels_y(window); ui_block_bounds_calc(block); width = BLI_rctf_size_x(&block->rect); height = BLI_rctf_size_y(&block->rect); startx = (xmax * 0.5f) - (width * 0.5f); starty = (ymax * 0.5f) - (height * 0.5f); UI_block_translate(block, startx - block->rect.xmin, starty - block->rect.ymin); /* now recompute bounds and safety */ ui_block_bounds_calc(block); } static void ui_block_bounds_calc_centered_pie(uiBlock *block) { const int xy[2] = { block->pie_data.pie_center_spawned[0], block->pie_data.pie_center_spawned[1], }; UI_block_translate(block, xy[0], xy[1]); /* now recompute bounds and safety */ ui_block_bounds_calc(block); } static void ui_block_bounds_calc_popup( wmWindow *window, uiBlock *block, eBlockBoundsCalc bounds_calc, const int xy[2], int r_xy[2]) { int width, height, oldwidth, oldheight; int oldbounds, xmax, ymax, raw_x, raw_y; const int margin = UI_SCREEN_MARGIN; rcti rect, rect_bounds; int ofs_dummy[2]; oldbounds = block->bounds; /* compute mouse position with user defined offset */ ui_block_bounds_calc(block); xmax = WM_window_pixels_x(window); ymax = WM_window_pixels_y(window); oldwidth = BLI_rctf_size_x(&block->rect); oldheight = BLI_rctf_size_y(&block->rect); /* first we ensure wide enough text bounds */ if (bounds_calc == UI_BLOCK_BOUNDS_POPUP_MENU) { if (block->flag & UI_BLOCK_LOOP) { block->bounds = 2.5f * UI_UNIT_X; ui_block_bounds_calc_text(block, block->rect.xmin); } } /* next we recompute bounds */ block->bounds = oldbounds; ui_block_bounds_calc(block); /* and we adjust the position to fit within window */ width = BLI_rctf_size_x(&block->rect); height = BLI_rctf_size_y(&block->rect); /* avoid divide by zero below, caused by calling with no UI, but better not crash */ oldwidth = oldwidth > 0 ? oldwidth : MAX2(1, width); oldheight = oldheight > 0 ? oldheight : MAX2(1, height); /* offset block based on mouse position, user offset is scaled * along in case we resized the block in ui_block_bounds_calc_text */ raw_x = rect.xmin = xy[0] + block->rect.xmin + (block->bounds_offset[0] * width) / oldwidth; raw_y = rect.ymin = xy[1] + block->rect.ymin + (block->bounds_offset[1] * height) / oldheight; rect.xmax = rect.xmin + width; rect.ymax = rect.ymin + height; rect_bounds.xmin = margin; rect_bounds.ymin = margin; rect_bounds.xmax = xmax - margin; rect_bounds.ymax = ymax - UI_POPUP_MENU_TOP; BLI_rcti_clamp(&rect, &rect_bounds, ofs_dummy); UI_block_translate(block, rect.xmin - block->rect.xmin, rect.ymin - block->rect.ymin); /* now recompute bounds and safety */ ui_block_bounds_calc(block); /* If given, adjust input coordinates such that they would generate real final popup position. * Needed to handle correctly floating panels once they have been dragged around, * see T52999. */ if (r_xy) { r_xy[0] = xy[0] + block->rect.xmin - raw_x; r_xy[1] = xy[1] + block->rect.ymin - raw_y; } } /* used for various cases */ void UI_block_bounds_set_normal(uiBlock *block, int addval) { if (block == NULL) { return; } block->bounds = addval; block->bounds_type = UI_BLOCK_BOUNDS; } /* used for pulldowns */ void UI_block_bounds_set_text(uiBlock *block, int addval) { block->bounds = addval; block->bounds_type = UI_BLOCK_BOUNDS_TEXT; } /* used for block popups */ void UI_block_bounds_set_popup(uiBlock *block, int addval, const int bounds_offset[2]) { block->bounds = addval; block->bounds_type = UI_BLOCK_BOUNDS_POPUP_MOUSE; if (bounds_offset != NULL) { block->bounds_offset[0] = bounds_offset[0]; block->bounds_offset[1] = bounds_offset[1]; } else { block->bounds_offset[0] = 0; block->bounds_offset[1] = 0; } } /* used for menu popups */ void UI_block_bounds_set_menu(uiBlock *block, int addval, const int bounds_offset[2]) { block->bounds = addval; block->bounds_type = UI_BLOCK_BOUNDS_POPUP_MENU; if (bounds_offset != NULL) { block->bounds_offset[0] = bounds_offset[0]; block->bounds_offset[1] = bounds_offset[1]; } else { block->bounds_offset[0] = 0; block->bounds_offset[1] = 0; } } /* used for centered popups, i.e. splash */ void UI_block_bounds_set_centered(uiBlock *block, int addval) { block->bounds = addval; block->bounds_type = UI_BLOCK_BOUNDS_POPUP_CENTER; } void UI_block_bounds_set_explicit(uiBlock *block, int minx, int miny, int maxx, int maxy) { block->rect.xmin = minx; block->rect.ymin = miny; block->rect.xmax = maxx; block->rect.ymax = maxy; block->bounds_type = UI_BLOCK_BOUNDS_NONE; } static int ui_but_calc_float_precision(uiBut *but, double value) { int prec = (int)but->a2; /* first check for various special cases: * * If button is radians, we want additional precision (see T39861). * * If prec is not set, we fallback to a simple default */ if (ui_but_is_unit_radians(but) && prec < 5) { prec = 5; } else if (prec == -1) { prec = (but->hardmax < 10.001f) ? 3 : 2; } else { CLAMP(prec, 0, UI_PRECISION_FLOAT_MAX); } return UI_calc_float_precision(prec, value); } /* ************** BLOCK ENDING FUNCTION ************* */ bool ui_but_rna_equals(const uiBut *a, const uiBut *b) { return ui_but_rna_equals_ex(a, &b->rnapoin, b->rnaprop, b->rnaindex); } bool ui_but_rna_equals_ex(const uiBut *but, const PointerRNA *ptr, const PropertyRNA *prop, int index) { if (but->rnapoin.data != ptr->data) { return false; } if (but->rnaprop != prop || but->rnaindex != index) { return false; } return true; } /* NOTE: if but->poin is allocated memory for every defbut, things fail... */ static bool ui_but_equals_old(const uiBut *but, const uiBut *oldbut) { /* various properties are being compared here, hopefully sufficient * to catch all cases, but it is simple to add more checks later */ if (but->retval != oldbut->retval) { return false; } if (!ui_but_rna_equals(but, oldbut)) { return false; } if (but->func != oldbut->func) { return false; } if (but->funcN != oldbut->funcN) { return false; } if (oldbut->func_arg1 != oldbut && but->func_arg1 != oldbut->func_arg1) { return false; } if (oldbut->func_arg2 != oldbut && but->func_arg2 != oldbut->func_arg2) { return false; } if (!but->funcN && ((but->poin != oldbut->poin && (uiBut *)oldbut->poin != oldbut) || (but->pointype != oldbut->pointype))) { return false; } if (but->optype != oldbut->optype) { return false; } return true; } uiBut *ui_but_find_old(uiBlock *block_old, const uiBut *but_new) { uiBut *but_old; for (but_old = block_old->buttons.first; but_old; but_old = but_old->next) { if (ui_but_equals_old(but_new, but_old)) { break; } } return but_old; } uiBut *ui_but_find_new(uiBlock *block_new, const uiBut *but_old) { uiBut *but_new; for (but_new = block_new->buttons.first; but_new; but_new = but_new->next) { if (ui_but_equals_old(but_new, but_old)) { break; } } return but_new; } /** * \return true when \a but_p is set (only done for active buttons). */ static bool ui_but_update_from_old_block(const bContext *C, uiBlock *block, uiBut **but_p, uiBut **but_old_p) { const int drawflag_copy = 0; /* None currently. */ uiBlock *oldblock = block->oldblock; uiBut *oldbut = NULL, *but = *but_p; bool found_active = false; #if 0 /* simple/stupid - search every time */ oldbut = ui_but_find_old(oldblock, but); (void)but_old_p; #else BLI_assert(*but_old_p == NULL || BLI_findindex(&oldblock->buttons, *but_old_p) != -1); /* Fast-path - avoid loop-in-loop, calling #ui_but_find_old * as long as old/new buttons are aligned. */ if (LIKELY(*but_old_p && ui_but_equals_old(but, *but_old_p))) { oldbut = *but_old_p; } else { /* fallback to block search */ oldbut = ui_but_find_old(oldblock, but); } (*but_old_p) = oldbut ? oldbut->next : NULL; #endif if (!oldbut) { return found_active; } if (oldbut->active) { /* flags from the buttons we want to refresh, may want to add more here... */ const int flag_copy = UI_BUT_REDALERT | UI_HAS_ICON; found_active = true; #if 0 but->flag = oldbut->flag; but->active = oldbut->active; but->pos = oldbut->pos; but->ofs = oldbut->ofs; but->editstr = oldbut->editstr; but->editval = oldbut->editval; but->editvec = oldbut->editvec; but->editcoba = oldbut->editcoba; but->editcumap = oldbut->editcumap; but->selsta = oldbut->selsta; but->selend = oldbut->selend; but->softmin = oldbut->softmin; but->softmax = oldbut->softmax; oldbut->active = NULL; #endif /* move button over from oldblock to new block */ BLI_remlink(&oldblock->buttons, oldbut); BLI_insertlinkafter(&block->buttons, but, oldbut); oldbut->block = block; *but_p = oldbut; /* still stuff needs to be copied */ oldbut->rect = but->rect; oldbut->context = but->context; /* set by Layout */ /* drawing */ oldbut->icon = but->icon; oldbut->iconadd = but->iconadd; oldbut->alignnr = but->alignnr; /* typically the same pointers, but not on undo/redo */ /* XXX some menu buttons store button itself in but->poin. Ugly */ if (oldbut->poin != (char *)oldbut) { SWAP(char *, oldbut->poin, but->poin); SWAP(void *, oldbut->func_argN, but->func_argN); } /* Move tooltip from new to old. */ SWAP(uiButToolTipFunc, oldbut->tip_func, but->tip_func); SWAP(void *, oldbut->tip_argN, but->tip_argN); oldbut->flag = (oldbut->flag & ~flag_copy) | (but->flag & flag_copy); oldbut->drawflag = (oldbut->drawflag & ~drawflag_copy) | (but->drawflag & drawflag_copy); SWAP(ListBase, but->extra_op_icons, oldbut->extra_op_icons); if (oldbut->type == UI_BTYPE_SEARCH_MENU) { uiButSearch *search_oldbut = (uiButSearch *)oldbut, *search_but = (uiButSearch *)but; SWAP(uiButSearchArgFreeFn, search_oldbut->arg_free_fn, search_but->arg_free_fn); SWAP(void *, search_oldbut->arg, search_but->arg); } /* copy hardmin for list rows to prevent 'sticking' highlight to mouse position * when scrolling without moving mouse (see [#28432]) */ if (ELEM(oldbut->type, UI_BTYPE_ROW, UI_BTYPE_LISTROW)) { oldbut->hardmax = but->hardmax; } if (oldbut->type == UI_BTYPE_PROGRESS_BAR) { uiButProgressbar *progress_oldbut = (uiButProgressbar *)oldbut; uiButProgressbar *progress_but = (uiButProgressbar *)but; progress_oldbut->progress = progress_but->progress; } if (!BLI_listbase_is_empty(&block->butstore)) { UI_butstore_register_update(block, oldbut, but); } /* move/copy string from the new button to the old */ /* needed for alt+mouse wheel over enums */ if (but->str != but->strdata) { if (oldbut->str != oldbut->strdata) { SWAP(char *, but->str, oldbut->str); } else { oldbut->str = but->str; but->str = but->strdata; } } else { if (oldbut->str != oldbut->strdata) { MEM_freeN(oldbut->str); oldbut->str = oldbut->strdata; } BLI_strncpy(oldbut->strdata, but->strdata, sizeof(oldbut->strdata)); } if (but->dragpoin && (but->dragflag & UI_BUT_DRAGPOIN_FREE)) { SWAP(void *, but->dragpoin, oldbut->dragpoin); } BLI_remlink(&block->buttons, but); ui_but_free(C, but); /* note: if layout hasn't been applied yet, it uses old button pointers... */ } else { const int flag_copy = UI_BUT_DRAG_MULTI; but->flag = (but->flag & ~flag_copy) | (oldbut->flag & flag_copy); /* ensures one button can get activated, and in case the buttons * draw are the same this gives O(1) lookup for each button */ BLI_remlink(&oldblock->buttons, oldbut); ui_but_free(C, oldbut); } return found_active; } /* needed for temporarily rename buttons, such as in outliner or file-select, * they should keep calling uiDefButs to keep them alive */ /* returns 0 when button removed */ bool UI_but_active_only_ex( const bContext *C, ARegion *region, uiBlock *block, uiBut *but, const bool remove_on_failure) { uiBlock *oldblock; uiBut *oldbut; bool activate = false, found = false, isactive = false; oldblock = block->oldblock; if (!oldblock) { activate = true; } else { oldbut = ui_but_find_old(oldblock, but); if (oldbut) { found = true; if (oldbut->active) { isactive = true; } } } if ((activate == true) || (found == false)) { /* There might still be another active button. */ uiBut *old_active = ui_region_find_active_but(region); if (old_active) { ui_but_active_free(C, old_active); } ui_but_activate_event((bContext *)C, region, but); } else if ((found == true) && (isactive == false)) { if (remove_on_failure) { BLI_remlink(&block->buttons, but); ui_but_free(C, but); } return false; } return true; } bool UI_but_active_only(const bContext *C, ARegion *region, uiBlock *block, uiBut *but) { return UI_but_active_only_ex(C, region, block, but, true); } /** * \warning This must run after other handlers have been added, * otherwise the handler wont be removed, see: T71112. */ bool UI_block_active_only_flagged_buttons(const bContext *C, ARegion *region, uiBlock *block) { bool done = false; LISTBASE_FOREACH (uiBut *, but, &block->buttons) { if (but->flag & UI_BUT_ACTIVATE_ON_INIT) { but->flag &= ~UI_BUT_ACTIVATE_ON_INIT; if (ui_but_is_editable(but)) { if (UI_but_active_only_ex(C, region, block, but, false)) { done = true; break; } } } } if (done) { /* Run this in a second pass since it's possible activating the button * removes the buttons being looped over. */ LISTBASE_FOREACH (uiBut *, but, &block->buttons) { but->flag &= ~UI_BUT_ACTIVATE_ON_INIT; } } return done; } /* simulate button click */ void UI_but_execute(const bContext *C, ARegion *region, uiBut *but) { void *active_back; ui_but_execute_begin((bContext *)C, region, but, &active_back); /* Value is applied in begin. No further action required. */ ui_but_execute_end((bContext *)C, region, but, active_back); } /* use to check if we need to disable undo, but don't make any changes * returns false if undo needs to be disabled. */ static bool ui_but_is_rna_undo(const uiBut *but) { if (but->rnapoin.owner_id) { /* avoid undo push for buttons who's ID are screen or wm level * we could disable undo for buttons with no ID too but may have * unforeseen consequences, so best check for ID's we _know_ are not * handled by undo - campbell */ ID *id = but->rnapoin.owner_id; if (ID_CHECK_UNDO(id) == false) { return false; } return true; } if (but->rnapoin.type && !RNA_struct_undo_check(but->rnapoin.type)) { return false; } return true; } /* assigns automatic keybindings to menu items for fast access * (underline key in menu) */ static void ui_menu_block_set_keyaccels(uiBlock *block) { uint menu_key_mask = 0; int tot_missing = 0; /* only do it before bounding */ if (block->rect.xmin != block->rect.xmax) { return; } for (int pass = 0; pass < 2; pass++) { /* 2 Passes, on for first letter only, second for any letter if first fails * fun first pass on all buttons so first word chars always get first priority */ LISTBASE_FOREACH (uiBut *, but, &block->buttons) { if (!ELEM(but->type, UI_BTYPE_BUT, UI_BTYPE_BUT_MENU, UI_BTYPE_MENU, UI_BTYPE_BLOCK, UI_BTYPE_PULLDOWN, /* For PIE-menus. */ UI_BTYPE_ROW) || (but->flag & UI_HIDDEN)) { /* pass */ } else if (but->menu_key == '\0') { if (but->str && but->str[0]) { const char *str_pt = but->str; uchar menu_key; do { menu_key = tolower(*str_pt); if ((menu_key >= 'a' && menu_key <= 'z') && !(menu_key_mask & 1 << (menu_key - 'a'))) { menu_key_mask |= 1 << (menu_key - 'a'); break; } if (pass == 0) { /* Skip to next delimiter on first pass (be picky) */ while (isalpha(*str_pt)) { str_pt++; } if (*str_pt) { str_pt++; } } else { /* just step over every char second pass and find first usable key */ str_pt++; } } while (*str_pt); if (*str_pt) { but->menu_key = menu_key; } else { /* run second pass */ tot_missing++; } /* if all keys have been used just exit, unlikely */ if (menu_key_mask == (1 << 26) - 1) { return; } } } } /* check if second pass is needed */ if (!tot_missing) { break; } } } /* XXX, this code will shorten any allocated string to 'UI_MAX_NAME_STR' * since this is really long its unlikely to be an issue, * but this could be supported */ void ui_but_add_shortcut(uiBut *but, const char *shortcut_str, const bool do_strip) { if (do_strip && (but->flag & UI_BUT_HAS_SEP_CHAR)) { char *cpoin = strrchr(but->str, UI_SEP_CHAR); if (cpoin) { *cpoin = '\0'; } but->flag &= ~UI_BUT_HAS_SEP_CHAR; } /* without this, just allow stripping of the shortcut */ if (shortcut_str) { char *butstr_orig; if (but->str != but->strdata) { butstr_orig = but->str; /* free after using as source buffer */ } else { butstr_orig = BLI_strdup(but->str); } BLI_snprintf( but->strdata, sizeof(but->strdata), "%s" UI_SEP_CHAR_S "%s", butstr_orig, shortcut_str); MEM_freeN(butstr_orig); but->str = but->strdata; but->flag |= UI_BUT_HAS_SEP_CHAR; but->drawflag |= UI_BUT_HAS_SHORTCUT; ui_but_update(but); } } /* -------------------------------------------------------------------- */ /** \name Find Key Shortcut for Button * * - #ui_but_event_operator_string (and helpers) * - #ui_but_event_property_operator_string * \{ */ static bool ui_but_event_operator_string_from_operator(const bContext *C, uiBut *but, char *buf, const size_t buf_len) { BLI_assert(but->optype != NULL); bool found = false; IDProperty *prop = (but->opptr) ? but->opptr->data : NULL; if (WM_key_event_operator_string( C, but->optype->idname, but->opcontext, prop, true, buf, buf_len)) { found = true; } return found; } static bool ui_but_event_operator_string_from_menu(const bContext *C, uiBut *but, char *buf, const size_t buf_len) { MenuType *mt = UI_but_menutype_get(but); BLI_assert(mt != NULL); bool found = false; IDProperty *prop_menu; /* annoying, create a property */ IDPropertyTemplate val = {0}; prop_menu = IDP_New(IDP_GROUP, &val, __func__); /* dummy, name is unimportant */ IDP_AddToGroup(prop_menu, IDP_NewString(mt->idname, "name", sizeof(mt->idname))); if (WM_key_event_operator_string( C, "WM_OT_call_menu", WM_OP_INVOKE_REGION_WIN, prop_menu, true, buf, buf_len)) { found = true; } IDP_FreeProperty(prop_menu); return found; } static bool ui_but_event_operator_string_from_panel(const bContext *C, uiBut *but, char *buf, const size_t buf_len) { /** Nearly exact copy of #ui_but_event_operator_string_from_menu */ PanelType *pt = UI_but_paneltype_get(but); BLI_assert(pt != NULL); bool found = false; IDProperty *prop_panel; /* annoying, create a property */ IDPropertyTemplate val = {0}; prop_panel = IDP_New(IDP_GROUP, &val, __func__); /* dummy, name is unimportant */ IDP_AddToGroup(prop_panel, IDP_NewString(pt->idname, "name", sizeof(pt->idname))); IDP_AddToGroup(prop_panel, IDP_New(IDP_INT, &(IDPropertyTemplate){ .i = pt->space_type, }, "space_type")); IDP_AddToGroup(prop_panel, IDP_New(IDP_INT, &(IDPropertyTemplate){ .i = pt->region_type, }, "region_type")); for (int i = 0; i < 2; i++) { /* FIXME(campbell): We can't reasonably search all configurations - long term. */ IDP_ReplaceInGroup(prop_panel, IDP_New(IDP_INT, &(IDPropertyTemplate){ .i = i, }, "keep_open")); if (WM_key_event_operator_string( C, "WM_OT_call_panel", WM_OP_INVOKE_REGION_WIN, prop_panel, true, buf, buf_len)) { found = true; break; } } IDP_FreeProperty(prop_panel); return found; } static bool ui_but_event_operator_string(const bContext *C, uiBut *but, char *buf, const size_t buf_len) { bool found = false; if (but->optype != NULL) { found = ui_but_event_operator_string_from_operator(C, but, buf, buf_len); } else if (UI_but_menutype_get(but) != NULL) { found = ui_but_event_operator_string_from_menu(C, but, buf, buf_len); } else if (UI_but_paneltype_get(but) != NULL) { found = ui_but_event_operator_string_from_panel(C, but, buf, buf_len); } return found; } static bool ui_but_event_property_operator_string(const bContext *C, uiBut *but, char *buf, const size_t buf_len) { /* context toggle operator names to check... */ /* This function could use a refactor to generalize button type to operator relationship * as well as which operators use properties. * - Campbell * */ const char *ctx_toggle_opnames[] = { "WM_OT_context_toggle", "WM_OT_context_toggle_enum", "WM_OT_context_cycle_int", "WM_OT_context_cycle_enum", "WM_OT_context_cycle_array", "WM_OT_context_menu_enum", NULL, }; const char *ctx_enum_opnames[] = { "WM_OT_context_set_enum", NULL, }; const char *ctx_enum_opnames_for_Area_ui_type[] = { "SCREEN_OT_space_type_set_or_cycle", NULL, }; const char **opnames = ctx_toggle_opnames; int opnames_len = ARRAY_SIZE(ctx_toggle_opnames); int prop_enum_value = -1; bool prop_enum_value_ok = false; bool prop_enum_value_is_int = false; const char *prop_enum_value_id = "value"; PointerRNA *ptr = &but->rnapoin; PropertyRNA *prop = but->rnaprop; if ((but->type == UI_BTYPE_BUT_MENU) && (but->block->handle != NULL)) { uiBut *but_parent = but->block->handle->popup_create_vars.but; if ((but->type == UI_BTYPE_BUT_MENU) && (but_parent && but_parent->rnaprop) && (RNA_property_type(but_parent->rnaprop) == PROP_ENUM) && ELEM(but_parent->menu_create_func, ui_def_but_rna__menu, ui_def_but_rna__panel_type, ui_def_but_rna__menu_type)) { prop_enum_value = (int)but->hardmin; ptr = &but_parent->rnapoin; prop = but_parent->rnaprop; prop_enum_value_ok = true; opnames = ctx_enum_opnames; opnames_len = ARRAY_SIZE(ctx_enum_opnames); } } bool found = false; /* Don't use the button again. */ but = NULL; /* this version is only for finding hotkeys for properties * (which get set via context using operators) */ if (prop) { /* to avoid massive slowdowns on property panels, for now, we only check the * hotkeys for Editor / Scene settings... * * TODO: userpref settings? */ char *data_path = NULL; if (ptr->owner_id) { ID *id = ptr->owner_id; if (GS(id->name) == ID_SCR) { /* screen/editor property * NOTE: in most cases, there is actually no info for backwards tracing * how to get back to ID from the editor data we may be dealing with */ if (RNA_struct_is_a(ptr->type, &RNA_Space)) { /* data should be directly on here... */ data_path = BLI_sprintfN("space_data.%s", RNA_property_identifier(prop)); } else if (RNA_struct_is_a(ptr->type, &RNA_Area)) { /* data should be directly on here... */ const char *prop_id = RNA_property_identifier(prop); /* Hack since keys access 'type', UI shows 'ui_type'. */ if (STREQ(prop_id, "ui_type")) { prop_id = "type"; prop_enum_value >>= 16; prop = RNA_struct_find_property(ptr, prop_id); opnames = ctx_enum_opnames_for_Area_ui_type; opnames_len = ARRAY_SIZE(ctx_enum_opnames_for_Area_ui_type); prop_enum_value_id = "space_type"; prop_enum_value_is_int = true; } else { data_path = BLI_sprintfN("area.%s", prop_id); } } else { /* special exceptions for common nested data in editors... */ if (RNA_struct_is_a(ptr->type, &RNA_DopeSheet)) { /* dopesheet filtering options... */ data_path = BLI_sprintfN("space_data.dopesheet.%s", RNA_property_identifier(prop)); } else if (RNA_struct_is_a(ptr->type, &RNA_FileSelectParams)) { /* Filebrowser options... */ data_path = BLI_sprintfN("space_data.params.%s", RNA_property_identifier(prop)); } } } else if (GS(id->name) == ID_SCE) { if (RNA_struct_is_a(ptr->type, &RNA_ToolSettings)) { /* Tool-settings property: * NOTE: tool-settings is usually accessed directly (i.e. not through scene). */ data_path = RNA_path_from_ID_to_property(ptr, prop); } else { /* scene property */ char *path = RNA_path_from_ID_to_property(ptr, prop); if (path) { data_path = BLI_sprintfN("scene.%s", path); MEM_freeN(path); } #if 0 else { printf("ERROR in %s(): Couldn't get path for scene property - %s\n", __func__, RNA_property_identifier(prop)); } #endif } } else { // puts("other id"); } // printf("prop shortcut: '%s' (%s)\n", RNA_property_identifier(prop), data_path); } /* we have a datapath! */ if (data_path || (prop_enum_value_ok && prop_enum_value_id)) { /* create a property to host the "datapath" property we're sending to the operators */ IDProperty *prop_path; IDPropertyTemplate val = {0}; prop_path = IDP_New(IDP_GROUP, &val, __func__); if (data_path) { IDP_AddToGroup(prop_path, IDP_NewString(data_path, "data_path", strlen(data_path) + 1)); } if (prop_enum_value_ok) { const EnumPropertyItem *item; bool free; RNA_property_enum_items((bContext *)C, ptr, prop, &item, NULL, &free); int index = RNA_enum_from_value(item, prop_enum_value); if (index != -1) { IDProperty *prop_value; if (prop_enum_value_is_int) { int value = item[index].value; prop_value = IDP_New(IDP_INT, &(IDPropertyTemplate){ .i = value, }, prop_enum_value_id); } else { const char *id = item[index].identifier; prop_value = IDP_NewString(id, prop_enum_value_id, strlen(id) + 1); } IDP_AddToGroup(prop_path, prop_value); } else { opnames_len = 0; /* Do nothing. */ } if (free) { MEM_freeN((void *)item); } } /* check each until one works... */ for (int i = 0; (i < opnames_len) && (opnames[i]); i++) { if (WM_key_event_operator_string( C, opnames[i], WM_OP_INVOKE_REGION_WIN, prop_path, false, buf, buf_len)) { found = true; break; } } /* cleanup */ IDP_FreeProperty(prop_path); if (data_path) { MEM_freeN(data_path); } } } return found; } /** \} */ /** * This goes in a seemingly weird pattern: * *
 *     4
 *  5     6
 * 1       2
 *  7     8
 *     3
 * 
* * but it's actually quite logical. It's designed to be 'upwards compatible' * for muscle memory so that the menu item locations are fixed and don't move * as new items are added to the menu later on. It also optimizes efficiency - * a radial menu is best kept symmetrical, with as large an angle between * items as possible, so that the gestural mouse movements can be fast and inexact. * * It starts off with two opposite sides for the first two items * then joined by the one below for the third (this way, even with three items, * the menu seems to still be 'in order' reading left to right). Then the fourth is * added to complete the compass directions. From here, it's just a matter of * subdividing the rest of the angles for the last 4 items. * * --Matt 07/2006 */ const char ui_radial_dir_order[8] = { UI_RADIAL_W, UI_RADIAL_E, UI_RADIAL_S, UI_RADIAL_N, UI_RADIAL_NW, UI_RADIAL_NE, UI_RADIAL_SW, UI_RADIAL_SE, }; const char ui_radial_dir_to_numpad[8] = {8, 9, 6, 3, 2, 1, 4, 7}; const short ui_radial_dir_to_angle[8] = {90, 45, 0, 315, 270, 225, 180, 135}; static void ui_but_pie_direction_string(uiBut *but, char *buf, int size) { BLI_assert(but->pie_dir < ARRAY_SIZE(ui_radial_dir_to_numpad)); BLI_snprintf(buf, size, "%d", ui_radial_dir_to_numpad[but->pie_dir]); } static void ui_menu_block_set_keymaps(const bContext *C, uiBlock *block) { uiBut *but; char buf[128]; BLI_assert(block->flag & (UI_BLOCK_LOOP | UI_BLOCK_SHOW_SHORTCUT_ALWAYS)); /* only do it before bounding */ if (block->rect.xmin != block->rect.xmax) { return; } if (STREQ(block->name, "splash")) { return; } if (block->flag & UI_BLOCK_RADIAL) { for (but = block->buttons.first; but; but = but->next) { if (but->pie_dir != UI_RADIAL_NONE) { ui_but_pie_direction_string(but, buf, sizeof(buf)); ui_but_add_shortcut(but, buf, false); } } } else { for (but = block->buttons.first; but; but = but->next) { if (block->flag & UI_BLOCK_SHOW_SHORTCUT_ALWAYS) { /* Skip icon-only buttons (as used in the toolbar). */ if (but->drawstr[0] == '\0') { continue; } if (((block->flag & UI_BLOCK_POPOVER) == 0) && UI_but_is_tool(but)) { /* For non-popovers, shown in shortcut only * (has special shortcut handling code). */ continue; } } else if (but->emboss != UI_EMBOSS_PULLDOWN) { continue; } if (ui_but_event_operator_string(C, but, buf, sizeof(buf))) { ui_but_add_shortcut(but, buf, false); } else if (ui_but_event_property_operator_string(C, but, buf, sizeof(buf))) { ui_but_add_shortcut(but, buf, false); } } } } void ui_but_override_flag(Main *bmain, uiBut *but) { const uint override_status = RNA_property_override_library_status( bmain, &but->rnapoin, but->rnaprop, but->rnaindex); if (override_status & RNA_OVERRIDE_STATUS_OVERRIDDEN) { but->flag |= UI_BUT_OVERRIDEN; } else { but->flag &= ~UI_BUT_OVERRIDEN; } } /** \name Button Extra Operator Icons * * Extra icons are shown on the right hand side of buttons. They can be clicked to invoke custom * operators. * There are some predefined here, which get added to buttons automatically based on button data * (type, flags, state, etc). * \{ */ /** * Predefined types for generic extra operator icons (uiButExtraOpIcon). */ typedef enum PredefinedExtraOpIconType { PREDEFINED_EXTRA_OP_ICON_NONE = 1, PREDEFINED_EXTRA_OP_ICON_CLEAR, PREDEFINED_EXTRA_OP_ICON_EYEDROPPER, } PredefinedExtraOpIconType; static PointerRNA *ui_but_extra_operator_icon_add_ptr(uiBut *but, wmOperatorType *optype, short opcontext, int icon) { uiButExtraOpIcon *extra_op_icon = MEM_mallocN(sizeof(*extra_op_icon), __func__); extra_op_icon->icon = (BIFIconID)icon; extra_op_icon->optype_params = MEM_callocN(sizeof(*extra_op_icon->optype_params), "uiButExtraOpIcon.optype_hook"); extra_op_icon->optype_params->optype = optype; extra_op_icon->optype_params->opptr = MEM_callocN(sizeof(*extra_op_icon->optype_params->opptr), "uiButExtraOpIcon.optype_hook.opptr"); WM_operator_properties_create_ptr(extra_op_icon->optype_params->opptr, extra_op_icon->optype_params->optype); extra_op_icon->optype_params->opcontext = opcontext; BLI_addtail(&but->extra_op_icons, extra_op_icon); return extra_op_icon->optype_params->opptr; } static void ui_but_extra_operator_icon_free(uiButExtraOpIcon *extra_icon) { WM_operator_properties_free(extra_icon->optype_params->opptr); MEM_freeN(extra_icon->optype_params->opptr); MEM_freeN(extra_icon->optype_params); MEM_freeN(extra_icon); } void ui_but_extra_operator_icons_free(uiBut *but) { for (uiButExtraOpIcon *op_icon = but->extra_op_icons.first, *op_icon_next; op_icon; op_icon = op_icon_next) { op_icon_next = op_icon->next; ui_but_extra_operator_icon_free(op_icon); } BLI_listbase_clear(&but->extra_op_icons); } PointerRNA *UI_but_extra_operator_icon_add(uiBut *but, const char *opname, short opcontext, int icon) { wmOperatorType *optype = WM_operatortype_find(opname, false); if (optype) { return ui_but_extra_operator_icon_add_ptr(but, optype, opcontext, icon); } return NULL; } static bool ui_but_icon_extra_is_visible_text_clear(const uiBut *but) { BLI_assert(but->type == UI_BTYPE_TEXT); return ((but->flag & UI_BUT_VALUE_CLEAR) && but->drawstr[0]); } static bool ui_but_icon_extra_is_visible_search_unlink(const uiBut *but) { BLI_assert(ELEM(but->type, UI_BTYPE_SEARCH_MENU)); return ((but->editstr == NULL) && (but->drawstr[0] != '\0') && (but->flag & UI_BUT_VALUE_CLEAR)); } static bool ui_but_icon_extra_is_visible_search_eyedropper(uiBut *but) { StructRNA *type; short idcode; BLI_assert(but->type == UI_BTYPE_SEARCH_MENU && (but->flag & UI_BUT_VALUE_CLEAR)); if (but->rnaprop == NULL) { return false; } type = RNA_property_pointer_type(&but->rnapoin, but->rnaprop); idcode = RNA_type_to_ID_code(type); return ((but->editstr == NULL) && (idcode == ID_OB || OB_DATA_SUPPORT_ID(idcode))); } static PredefinedExtraOpIconType ui_but_icon_extra_get(uiBut *but) { switch (but->type) { case UI_BTYPE_TEXT: if (ui_but_icon_extra_is_visible_text_clear(but)) { return PREDEFINED_EXTRA_OP_ICON_CLEAR; } break; case UI_BTYPE_SEARCH_MENU: if ((but->flag & UI_BUT_VALUE_CLEAR) == 0) { /* pass */ } else if (ui_but_icon_extra_is_visible_search_unlink(but)) { return PREDEFINED_EXTRA_OP_ICON_CLEAR; } else if (ui_but_icon_extra_is_visible_search_eyedropper(but)) { return PREDEFINED_EXTRA_OP_ICON_EYEDROPPER; } break; default: break; } return PREDEFINED_EXTRA_OP_ICON_NONE; } /** * While some extra operator icons have to be set explicitly upon button creating, this code adds * some generic ones based on button data. Currently these are mutually exclusive, so there's only * ever one predefined extra icon. */ static void ui_but_predefined_extra_operator_icons_add(uiBut *but) { PredefinedExtraOpIconType extra_icon = ui_but_icon_extra_get(but); wmOperatorType *optype = NULL; BIFIconID icon = ICON_NONE; switch (extra_icon) { case PREDEFINED_EXTRA_OP_ICON_EYEDROPPER: { static wmOperatorType *id_eyedropper_ot = NULL; if (!id_eyedropper_ot) { id_eyedropper_ot = WM_operatortype_find("UI_OT_eyedropper_id", false); } BLI_assert(id_eyedropper_ot); optype = id_eyedropper_ot; icon = ICON_EYEDROPPER; break; } case PREDEFINED_EXTRA_OP_ICON_CLEAR: { static wmOperatorType *clear_ot = NULL; if (!clear_ot) { clear_ot = WM_operatortype_find("UI_OT_button_string_clear", false); } BLI_assert(clear_ot); optype = clear_ot; icon = ICON_PANEL_CLOSE; break; } default: break; } if (optype) { LISTBASE_FOREACH (uiButExtraOpIcon *, op_icon, &but->extra_op_icons) { if ((op_icon->optype_params->optype == optype) && (op_icon->icon == icon)) { /* Don't add the same operator icon twice (happens if button is kept alive while active). */ return; } } ui_but_extra_operator_icon_add_ptr(but, optype, WM_OP_INVOKE_DEFAULT, (int)icon); } } /** \} */ void UI_block_update_from_old(const bContext *C, uiBlock *block) { uiBut *but_old; uiBut *but; if (!block->oldblock) { return; } but_old = block->oldblock->buttons.first; if (BLI_listbase_is_empty(&block->oldblock->butstore) == false) { UI_butstore_update(block); } for (but = block->buttons.first; but; but = but->next) { if (ui_but_update_from_old_block(C, block, &but, &but_old)) { ui_but_update(but); /* redraw dynamic tooltip if we have one open */ if (but->tip_func) { UI_but_tooltip_refresh((bContext *)C, but); } } } block->auto_open = block->oldblock->auto_open; block->auto_open_last = block->oldblock->auto_open_last; block->tooltipdisabled = block->oldblock->tooltipdisabled; BLI_movelisttolist(&block->color_pickers.list, &block->oldblock->color_pickers.list); block->oldblock = NULL; } void UI_block_end_ex(const bContext *C, uiBlock *block, const int xy[2], int r_xy[2]) { wmWindow *window = CTX_wm_window(C); Scene *scene = CTX_data_scene(C); ARegion *region = CTX_wm_region(C); Depsgraph *depsgraph = CTX_data_depsgraph_pointer(C); uiBut *but; BLI_assert(block->active); UI_block_update_from_old(C, block); /* inherit flags from 'old' buttons that was drawn here previous, based * on matching buttons, we need this to make button event handling non * blocking, while still allowing buttons to be remade each redraw as it * is expected by blender code */ for (but = block->buttons.first; but; but = but->next) { /* temp? Proper check for graying out */ if (but->optype) { wmOperatorType *ot = but->optype; if (but->context) { CTX_store_set((bContext *)C, but->context); } if (ot == NULL || WM_operator_poll_context((bContext *)C, ot, but->opcontext) == 0) { but->flag |= UI_BUT_DISABLED; } if (but->context) { CTX_store_set((bContext *)C, NULL); } } const AnimationEvalContext anim_eval_context = BKE_animsys_eval_context_construct( depsgraph, (scene) ? scene->r.cfra : 0.0f); ui_but_anim_flag(but, &anim_eval_context); ui_but_override_flag(CTX_data_main(C), but); if (UI_but_is_decorator(but)) { ui_but_anim_decorate_update_from_flag((uiButDecorator *)but); } ui_but_predefined_extra_operator_icons_add(but); } /* handle pending stuff */ if (block->layouts.first) { UI_block_layout_resolve(block, NULL, NULL); } ui_block_align_calc(block, CTX_wm_region(C)); if ((block->flag & UI_BLOCK_LOOP) && (block->flag & UI_BLOCK_NUMSELECT)) { ui_menu_block_set_keyaccels(block); /* could use a different flag to check */ } if (block->flag & (UI_BLOCK_LOOP | UI_BLOCK_SHOW_SHORTCUT_ALWAYS)) { ui_menu_block_set_keymaps(C, block); } /* after keymaps! */ switch (block->bounds_type) { case UI_BLOCK_BOUNDS_NONE: break; case UI_BLOCK_BOUNDS: ui_block_bounds_calc(block); break; case UI_BLOCK_BOUNDS_TEXT: ui_block_bounds_calc_text(block, 0.0f); break; case UI_BLOCK_BOUNDS_POPUP_CENTER: ui_block_bounds_calc_centered(window, block); break; case UI_BLOCK_BOUNDS_PIE_CENTER: ui_block_bounds_calc_centered_pie(block); break; /* fallback */ case UI_BLOCK_BOUNDS_POPUP_MOUSE: case UI_BLOCK_BOUNDS_POPUP_MENU: ui_block_bounds_calc_popup(window, block, block->bounds_type, xy, r_xy); break; } if (block->rect.xmin == 0.0f && block->rect.xmax == 0.0f) { UI_block_bounds_set_normal(block, 0); } if (block->flag & UI_BUT_ALIGN) { UI_block_align_end(block); } ui_update_flexible_spacing(region, block); block->endblock = 1; } void UI_block_end(const bContext *C, uiBlock *block) { wmWindow *window = CTX_wm_window(C); UI_block_end_ex(C, block, &window->eventstate->x, NULL); } /* ************** BLOCK DRAWING FUNCTION ************* */ void ui_fontscale(short *points, float aspect) { if (aspect < 0.9f || aspect > 1.1f) { float pointsf = *points; /* for some reason scaling fonts goes too fast compared to widget size */ /* XXX not true anymore? (ton) */ // aspect = sqrt(aspect); pointsf /= aspect; if (aspect > 1.0f) { *points = ceilf(pointsf); } else { *points = floorf(pointsf); } } } /* project button or block (but==NULL) to pixels in regionspace */ static void ui_but_to_pixelrect(rcti *rect, const ARegion *region, uiBlock *block, uiBut *but) { rctf rectf; ui_block_to_window_rctf(region, block, &rectf, (but) ? &but->rect : &block->rect); BLI_rcti_rctf_copy_round(rect, &rectf); BLI_rcti_translate(rect, -region->winrct.xmin, -region->winrct.ymin); } /* uses local copy of style, to scale things down, and allow widgets to change stuff */ void UI_block_draw(const bContext *C, uiBlock *block) { uiStyle style = *UI_style_get_dpi(); /* XXX pass on as arg */ ARegion *region; uiBut *but; rcti rect; /* get menu region or area region */ region = CTX_wm_menu(C); if (!region) { region = CTX_wm_region(C); } if (!block->endblock) { UI_block_end(C, block); } /* we set this only once */ GPU_blend_set_func_separate( GPU_SRC_ALPHA, GPU_ONE_MINUS_SRC_ALPHA, GPU_ONE, GPU_ONE_MINUS_SRC_ALPHA); /* scale fonts */ ui_fontscale(&style.paneltitle.points, block->aspect); ui_fontscale(&style.grouplabel.points, block->aspect); ui_fontscale(&style.widgetlabel.points, block->aspect); ui_fontscale(&style.widget.points, block->aspect); /* scale block min/max to rect */ ui_but_to_pixelrect(&rect, region, block, NULL); /* pixel space for AA widgets */ GPU_matrix_push_projection(); GPU_matrix_push(); GPU_matrix_identity_set(); wmOrtho2_region_pixelspace(region); /* back */ if (block->flag & UI_BLOCK_RADIAL) { ui_draw_pie_center(block); } else if (block->flag & UI_BLOCK_POPOVER) { ui_draw_popover_back(region, &style, block, &rect); } else if (block->flag & UI_BLOCK_LOOP) { ui_draw_menu_back(&style, block, &rect); } else if (block->panel) { bool show_background = region->alignment != RGN_ALIGN_FLOAT; if (show_background) { if (block->panel->type && (block->panel->type->flag & PNL_NO_HEADER)) { if (region->regiontype == RGN_TYPE_TOOLS) { /* We never want a background around active tools. */ show_background = false; } else { /* Without a header there is no background except for region overlap. */ show_background = region->overlap != 0; } } } ui_draw_aligned_panel( &style, block, &rect, UI_panel_category_is_visible(region), show_background); } BLF_batch_draw_begin(); UI_icon_draw_cache_begin(); UI_widgetbase_draw_cache_begin(); /* widgets */ for (but = block->buttons.first; but; but = but->next) { if (!(but->flag & (UI_HIDDEN | UI_SCROLLED))) { ui_but_to_pixelrect(&rect, region, block, but); /* XXX: figure out why invalid coordinates happen when closing render window */ /* and material preview is redrawn in main window (temp fix for bug #23848) */ if (rect.xmin < rect.xmax && rect.ymin < rect.ymax) { ui_draw_but(C, region, &style, but, &rect); } } } UI_widgetbase_draw_cache_end(); UI_icon_draw_cache_end(); BLF_batch_draw_end(); /* restore matrix */ GPU_matrix_pop_projection(); GPU_matrix_pop(); } static void ui_block_message_subscribe(ARegion *region, struct wmMsgBus *mbus, uiBlock *block) { uiBut *but_prev = NULL; /* possibly we should keep the region this block is contained in? */ LISTBASE_FOREACH (uiBut *, but, &block->buttons) { if (but->rnapoin.type && but->rnaprop) { /* quick check to avoid adding buttons representing a vector, multiple times. */ if ((but_prev && (but_prev->rnaprop == but->rnaprop) && (but_prev->rnapoin.type == but->rnapoin.type) && (but_prev->rnapoin.data == but->rnapoin.data) && (but_prev->rnapoin.owner_id == but->rnapoin.owner_id)) == false) { /* TODO: could make this into utility function. */ WM_msg_subscribe_rna(mbus, &but->rnapoin, but->rnaprop, &(const wmMsgSubscribeValue){ .owner = region, .user_data = region, .notify = ED_region_do_msg_notify_tag_redraw, }, __func__); but_prev = but; } } } } void UI_region_message_subscribe(ARegion *region, struct wmMsgBus *mbus) { LISTBASE_FOREACH (uiBlock *, block, ®ion->uiblocks) { ui_block_message_subscribe(region, mbus, block); } } /* ************* EVENTS ************* */ /** * Check if the button is pushed, this is only meaningful for some button types. * * \return (0 == UNSELECT), (1 == SELECT), (-1 == DO-NOTHING) */ int ui_but_is_pushed_ex(uiBut *but, double *value) { int is_push = 0; if (but->bit) { const bool state = !ELEM( but->type, UI_BTYPE_TOGGLE_N, UI_BTYPE_ICON_TOGGLE_N, UI_BTYPE_CHECKBOX_N); int lvalue; UI_GET_BUT_VALUE_INIT(but, *value); lvalue = (int)*value; if (UI_BITBUT_TEST(lvalue, (but->bitnr))) { is_push = state; } else { is_push = !state; } } else { switch (but->type) { case UI_BTYPE_BUT: case UI_BTYPE_HOTKEY_EVENT: case UI_BTYPE_KEY_EVENT: case UI_BTYPE_COLOR: case UI_BTYPE_DECORATOR: is_push = -1; break; case UI_BTYPE_BUT_TOGGLE: case UI_BTYPE_TOGGLE: case UI_BTYPE_ICON_TOGGLE: case UI_BTYPE_CHECKBOX: UI_GET_BUT_VALUE_INIT(but, *value); if (*value != (double)but->hardmin) { is_push = true; } break; case UI_BTYPE_ICON_TOGGLE_N: case UI_BTYPE_TOGGLE_N: case UI_BTYPE_CHECKBOX_N: UI_GET_BUT_VALUE_INIT(but, *value); if (*value == 0.0) { is_push = true; } break; case UI_BTYPE_ROW: case UI_BTYPE_LISTROW: case UI_BTYPE_TAB: if ((but->type == UI_BTYPE_TAB) && but->rnaprop && but->custom_data) { /* uiBut.custom_data points to data this tab represents (e.g. workspace). * uiBut.rnapoin/prop store an active value (e.g. active workspace). */ if (RNA_property_type(but->rnaprop) == PROP_POINTER) { PointerRNA active_ptr = RNA_property_pointer_get(&but->rnapoin, but->rnaprop); if (active_ptr.data == but->custom_data) { is_push = true; } } break; } else if (but->optype) { break; } UI_GET_BUT_VALUE_INIT(but, *value); /* support for rna enum buts */ if (but->rnaprop && (RNA_property_flag(but->rnaprop) & PROP_ENUM_FLAG)) { if ((int)*value & (int)but->hardmax) { is_push = true; } } else { if (*value == (double)but->hardmax) { is_push = true; } } break; default: is_push = -1; break; } } if ((but->drawflag & UI_BUT_CHECKBOX_INVERT) && (is_push != -1)) { is_push = !((bool)is_push); } return is_push; } int ui_but_is_pushed(uiBut *but) { double value = UI_BUT_VALUE_UNSET; return ui_but_is_pushed_ex(but, &value); } static void ui_but_update_select_flag(uiBut *but, double *value) { switch (ui_but_is_pushed_ex(but, value)) { case true: but->flag |= UI_SELECT; break; case false: but->flag &= ~UI_SELECT; break; } } /* ************************************************ */ void UI_block_lock_set(uiBlock *block, bool val, const char *lockstr) { if (val) { block->lock = val; block->lockstr = lockstr; } } void UI_block_lock_clear(uiBlock *block) { block->lock = false; block->lockstr = NULL; } /* *********************** data get/set *********************** * this either works with the pointed to data, or can work with * an edit override pointer while dragging for example */ /* for buttons pointing to color for example */ void ui_but_v3_get(uiBut *but, float vec[3]) { PropertyRNA *prop; int a; if (but->editvec) { copy_v3_v3(vec, but->editvec); } if (but->rnaprop) { prop = but->rnaprop; zero_v3(vec); if (RNA_property_type(prop) == PROP_FLOAT) { int tot = RNA_property_array_length(&but->rnapoin, prop); BLI_assert(tot > 0); if (tot == 3) { RNA_property_float_get_array(&but->rnapoin, prop, vec); } else { tot = min_ii(tot, 3); for (a = 0; a < tot; a++) { vec[a] = RNA_property_float_get_index(&but->rnapoin, prop, a); } } } } else if (but->pointype == UI_BUT_POIN_CHAR) { const char *cp = (char *)but->poin; vec[0] = ((float)cp[0]) / 255.0f; vec[1] = ((float)cp[1]) / 255.0f; vec[2] = ((float)cp[2]) / 255.0f; } else if (but->pointype == UI_BUT_POIN_FLOAT) { const float *fp = (float *)but->poin; copy_v3_v3(vec, fp); } else { if (but->editvec == NULL) { fprintf(stderr, "%s: can't get color, should never happen\n", __func__); zero_v3(vec); } } if (but->type == UI_BTYPE_UNITVEC) { normalize_v3(vec); } } /* for buttons pointing to color for example */ void ui_but_v3_set(uiBut *but, const float vec[3]) { PropertyRNA *prop; if (but->editvec) { copy_v3_v3(but->editvec, vec); } if (but->rnaprop) { prop = but->rnaprop; if (RNA_property_type(prop) == PROP_FLOAT) { int tot; int a; tot = RNA_property_array_length(&but->rnapoin, prop); BLI_assert(tot > 0); if (tot == 3) { RNA_property_float_set_array(&but->rnapoin, prop, vec); } else { tot = min_ii(tot, 3); for (a = 0; a < tot; a++) { RNA_property_float_set_index(&but->rnapoin, prop, a, vec[a]); } } } } else if (but->pointype == UI_BUT_POIN_CHAR) { char *cp = (char *)but->poin; cp[0] = (char)(0.5f + vec[0] * 255.0f); cp[1] = (char)(0.5f + vec[1] * 255.0f); cp[2] = (char)(0.5f + vec[2] * 255.0f); } else if (but->pointype == UI_BUT_POIN_FLOAT) { float *fp = (float *)but->poin; copy_v3_v3(fp, vec); } } bool ui_but_is_float(const uiBut *but) { if (but->pointype == UI_BUT_POIN_FLOAT && but->poin) { return true; } if (but->rnaprop && RNA_property_type(but->rnaprop) == PROP_FLOAT) { return true; } return false; } bool ui_but_is_bool(const uiBut *but) { if (ELEM(but->type, UI_BTYPE_TOGGLE, UI_BTYPE_TOGGLE_N, UI_BTYPE_ICON_TOGGLE, UI_BTYPE_ICON_TOGGLE_N, UI_BTYPE_TAB)) { return true; } if (but->rnaprop && RNA_property_type(but->rnaprop) == PROP_BOOLEAN) { return true; } if ((but->rnaprop && RNA_property_type(but->rnaprop) == PROP_ENUM) && (but->type == UI_BTYPE_ROW)) { return true; } return false; } bool ui_but_is_unit(const uiBut *but) { UnitSettings *unit = but->block->unit; const int unit_type = UI_but_unit_type_get(but); if (unit_type == PROP_UNIT_NONE) { return false; } #if 1 /* removed so angle buttons get correct snapping */ if (ui_but_is_unit_radians_ex(unit, unit_type)) { return false; } #endif /* for now disable time unit conversion */ if (unit_type == PROP_UNIT_TIME) { return false; } if (unit->system == USER_UNIT_NONE) { if (unit_type != PROP_UNIT_ROTATION) { return false; } } return true; } /** * Check if this button is similar enough to be grouped with another. */ bool ui_but_is_compatible(const uiBut *but_a, const uiBut *but_b) { if (but_a->type != but_b->type) { return false; } if (but_a->pointype != but_b->pointype) { return false; } if (but_a->rnaprop) { /* skip 'rnapoin.data', 'rnapoin.owner_id' * allow different data to have the same props edited at once */ if (but_a->rnapoin.type != but_b->rnapoin.type) { return false; } if (RNA_property_type(but_a->rnaprop) != RNA_property_type(but_b->rnaprop)) { return false; } if (RNA_property_subtype(but_a->rnaprop) != RNA_property_subtype(but_b->rnaprop)) { return false; } } return true; } bool ui_but_is_rna_valid(uiBut *but) { if (but->rnaprop == NULL || RNA_struct_contains_property(&but->rnapoin, but->rnaprop)) { return true; } printf("property removed %s: %p\n", but->drawstr, but->rnaprop); return false; } /** * Checks if the button supports cycling next/previous menu items (ctrl+mouse-wheel). */ bool ui_but_supports_cycling(const uiBut *but) { return ((ELEM(but->type, UI_BTYPE_ROW, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER, UI_BTYPE_LISTBOX)) || (but->type == UI_BTYPE_MENU && ui_but_menu_step_poll(but)) || (but->type == UI_BTYPE_COLOR && ((uiButColor *)but)->is_pallete_color) || (but->menu_step_func != NULL)); } double ui_but_value_get(uiBut *but) { PropertyRNA *prop; double value = 0.0; if (but->editval) { return *(but->editval); } if (but->poin == NULL && but->rnapoin.data == NULL) { return 0.0; } if (but->rnaprop) { prop = but->rnaprop; BLI_assert(but->rnaindex != -1); switch (RNA_property_type(prop)) { case PROP_BOOLEAN: if (RNA_property_array_check(prop)) { value = RNA_property_boolean_get_index(&but->rnapoin, prop, but->rnaindex); } else { value = RNA_property_boolean_get(&but->rnapoin, prop); } break; case PROP_INT: if (RNA_property_array_check(prop)) { value = RNA_property_int_get_index(&but->rnapoin, prop, but->rnaindex); } else { value = RNA_property_int_get(&but->rnapoin, prop); } break; case PROP_FLOAT: if (RNA_property_array_check(prop)) { value = RNA_property_float_get_index(&but->rnapoin, prop, but->rnaindex); } else { value = RNA_property_float_get(&but->rnapoin, prop); } break; case PROP_ENUM: value = RNA_property_enum_get(&but->rnapoin, prop); break; default: value = 0.0; break; } } else if (but->pointype == UI_BUT_POIN_CHAR) { value = *(char *)but->poin; } else if (but->pointype == UI_BUT_POIN_SHORT) { value = *(short *)but->poin; } else if (but->pointype == UI_BUT_POIN_INT) { value = *(int *)but->poin; } else if (but->pointype == UI_BUT_POIN_FLOAT) { value = *(float *)but->poin; } return value; } void ui_but_value_set(uiBut *but, double value) { PropertyRNA *prop; /* value is a hsv value: convert to rgb */ if (but->rnaprop) { prop = but->rnaprop; if (RNA_property_editable(&but->rnapoin, prop)) { switch (RNA_property_type(prop)) { case PROP_BOOLEAN: if (RNA_property_array_check(prop)) { RNA_property_boolean_set_index(&but->rnapoin, prop, but->rnaindex, value); } else { RNA_property_boolean_set(&but->rnapoin, prop, value); } break; case PROP_INT: if (RNA_property_array_check(prop)) { RNA_property_int_set_index(&but->rnapoin, prop, but->rnaindex, (int)value); } else { RNA_property_int_set(&but->rnapoin, prop, (int)value); } break; case PROP_FLOAT: if (RNA_property_array_check(prop)) { RNA_property_float_set_index(&but->rnapoin, prop, but->rnaindex, value); } else { RNA_property_float_set(&but->rnapoin, prop, value); } break; case PROP_ENUM: if (RNA_property_flag(prop) & PROP_ENUM_FLAG) { int ivalue = (int)value; /* toggle for enum/flag buttons */ ivalue ^= RNA_property_enum_get(&but->rnapoin, prop); RNA_property_enum_set(&but->rnapoin, prop, ivalue); } else { RNA_property_enum_set(&but->rnapoin, prop, value); } break; default: break; } } /* we can't be sure what RNA set functions actually do, * so leave this unset */ value = UI_BUT_VALUE_UNSET; } else if (but->pointype == 0) { /* pass */ } else { /* first do rounding */ if (but->pointype == UI_BUT_POIN_CHAR) { value = round_db_to_uchar_clamp(value); } else if (but->pointype == UI_BUT_POIN_SHORT) { value = round_db_to_short_clamp(value); } else if (but->pointype == UI_BUT_POIN_INT) { value = round_db_to_int_clamp(value); } else if (but->pointype == UI_BUT_POIN_FLOAT) { float fval = (float)value; if (fval >= -0.00001f && fval <= 0.00001f) { /* prevent negative zero */ fval = 0.0f; } value = fval; } /* then set value with possible edit override */ if (but->editval) { value = *but->editval = value; } else if (but->pointype == UI_BUT_POIN_CHAR) { value = *((char *)but->poin) = (char)value; } else if (but->pointype == UI_BUT_POIN_SHORT) { value = *((short *)but->poin) = (short)value; } else if (but->pointype == UI_BUT_POIN_INT) { value = *((int *)but->poin) = (int)value; } else if (but->pointype == UI_BUT_POIN_FLOAT) { value = *((float *)but->poin) = (float)value; } } ui_but_update_select_flag(but, &value); } int ui_but_string_get_max_length(uiBut *but) { if (ELEM(but->type, UI_BTYPE_TEXT, UI_BTYPE_SEARCH_MENU)) { return but->hardmax; } return UI_MAX_DRAW_STR; } uiBut *ui_but_drag_multi_edit_get(uiBut *but) { uiBut *but_iter; BLI_assert(but->flag & UI_BUT_DRAG_MULTI); for (but_iter = but->block->buttons.first; but_iter; but_iter = but_iter->next) { if (but_iter->editstr) { break; } } return but_iter; } static double ui_get_but_scale_unit(uiBut *but, double value) { UnitSettings *unit = but->block->unit; int unit_type = UI_but_unit_type_get(but); /* Time unit is a bit special, not handled by BKE_scene_unit_scale() for now. */ if (unit_type == PROP_UNIT_TIME) { /* WARNING - using evil_C :| */ Scene *scene = CTX_data_scene(but->block->evil_C); return FRA2TIME(value); } return BKE_scene_unit_scale(unit, RNA_SUBTYPE_UNIT_VALUE(unit_type), value); } /* str will be overwritten */ void ui_but_convert_to_unit_alt_name(uiBut *but, char *str, size_t maxlen) { if (ui_but_is_unit(but)) { UnitSettings *unit = but->block->unit; int unit_type = UI_but_unit_type_get(but); char *orig_str; orig_str = BLI_strdup(str); bUnit_ToUnitAltName(str, maxlen, orig_str, unit->system, RNA_SUBTYPE_UNIT_VALUE(unit_type)); MEM_freeN(orig_str); } } /** * \param float_precision: Override the button precision. */ static void ui_get_but_string_unit( uiBut *but, char *str, int len_max, double value, bool pad, int float_precision) { UnitSettings *unit = but->block->unit; int unit_type = UI_but_unit_type_get(but); int precision; if (unit->scale_length < 0.0001f) { unit->scale_length = 1.0f; // XXX do_versions } /* Use precision override? */ if (float_precision == -1) { /* Sanity checks */ precision = (int)but->a2; if (precision > UI_PRECISION_FLOAT_MAX) { precision = UI_PRECISION_FLOAT_MAX; } else if (precision == -1) { precision = 2; } } else { precision = float_precision; } bUnit_AsString2(str, len_max, ui_get_but_scale_unit(but, value), precision, RNA_SUBTYPE_UNIT_VALUE(unit_type), unit, pad); } static float ui_get_but_step_unit(uiBut *but, float step_default) { int unit_type = RNA_SUBTYPE_UNIT_VALUE(UI_but_unit_type_get(but)); const double step_orig = step_default * UI_PRECISION_FLOAT_SCALE; /* Scaling up 'step_origg ' here is a bit arbitrary, * its just giving better scales from user POV */ const double scale_step = ui_get_but_scale_unit(but, step_orig * 10); const double step = bUnit_ClosestScalar(scale_step, but->block->unit->system, unit_type); /* -1 is an error value */ if (step != -1.0) { const double scale_unit = ui_get_but_scale_unit(but, 1.0); const double step_unit = bUnit_ClosestScalar(scale_unit, but->block->unit->system, unit_type); double step_final; BLI_assert(step > 0.0); step_final = (step / scale_unit) / (double)UI_PRECISION_FLOAT_SCALE; if (step == step_unit) { /* Logic here is to scale by the original 'step_orig' * only when the unit step matches the scaled step. * * This is needed for units that don't have a wide range of scales (degrees for eg.). * Without this we can't select between a single degree, or a 10th of a degree. */ step_final *= step_orig; } return (float)step_final; } return step_default; } /** * \param float_precision: For number buttons the precision * to use or -1 to fallback to the button default. * \param use_exp_float: Use exponent representation of floats * when out of reasonable range (outside of 1e3/1e-3). */ void ui_but_string_get_ex(uiBut *but, char *str, const size_t maxlen, const int float_precision, const bool use_exp_float, bool *r_use_exp_float) { if (r_use_exp_float) { *r_use_exp_float = false; } if (but->rnaprop && ELEM(but->type, UI_BTYPE_TEXT, UI_BTYPE_SEARCH_MENU, UI_BTYPE_TAB)) { PropertyType type; const char *buf = NULL; int buf_len; type = RNA_property_type(but->rnaprop); if ((but->type == UI_BTYPE_TAB) && (but->custom_data)) { StructRNA *ptr_type = RNA_property_pointer_type(&but->rnapoin, but->rnaprop); PointerRNA ptr; /* uiBut.custom_data points to data this tab represents (e.g. workspace). * uiBut.rnapoin/prop store an active value (e.g. active workspace). */ RNA_pointer_create(but->rnapoin.owner_id, ptr_type, but->custom_data, &ptr); buf = RNA_struct_name_get_alloc(&ptr, str, maxlen, &buf_len); } else if (type == PROP_STRING) { /* RNA string */ buf = RNA_property_string_get_alloc(&but->rnapoin, but->rnaprop, str, maxlen, &buf_len); } else if (type == PROP_ENUM) { /* RNA enum */ int value = RNA_property_enum_get(&but->rnapoin, but->rnaprop); if (RNA_property_enum_name(but->block->evil_C, &but->rnapoin, but->rnaprop, value, &buf)) { BLI_strncpy(str, buf, maxlen); buf = str; } } else if (type == PROP_POINTER) { /* RNA pointer */ PointerRNA ptr = RNA_property_pointer_get(&but->rnapoin, but->rnaprop); buf = RNA_struct_name_get_alloc(&ptr, str, maxlen, &buf_len); } else { BLI_assert(0); } if (buf == NULL) { str[0] = '\0'; } else if (buf != str) { BLI_assert(maxlen <= buf_len + 1); /* string was too long, we have to truncate */ if (UI_but_is_utf8(but)) { BLI_strncpy_utf8(str, buf, maxlen); } else { BLI_strncpy(str, buf, maxlen); } MEM_freeN((void *)buf); } } else if (ELEM(but->type, UI_BTYPE_TEXT, UI_BTYPE_SEARCH_MENU)) { /* string */ BLI_strncpy(str, but->poin, maxlen); return; } else if (ui_but_anim_expression_get(but, str, maxlen)) { /* driver expression */ } else { /* number editing */ double value; value = ui_but_value_get(but); PropertySubType subtype = PROP_NONE; if (but->rnaprop) { subtype = RNA_property_subtype(but->rnaprop); } if (ui_but_is_float(but)) { int prec = (float_precision == -1) ? ui_but_calc_float_precision(but, value) : float_precision; if (ui_but_is_unit(but)) { ui_get_but_string_unit(but, str, maxlen, value, false, prec); } else if (subtype == PROP_FACTOR) { if (U.factor_display_type == USER_FACTOR_AS_FACTOR) { BLI_snprintf(str, maxlen, "%.*f", prec, value); } else { BLI_snprintf(str, maxlen, "%.*f", MAX2(0, prec - 2), value * 100); } } else { const int int_digits_num = integer_digits_f(value); if (use_exp_float) { if (int_digits_num < -6 || int_digits_num > 12) { BLI_snprintf(str, maxlen, "%.*g", prec, value); if (r_use_exp_float) { *r_use_exp_float = true; } } else { prec -= int_digits_num; CLAMP(prec, 0, UI_PRECISION_FLOAT_MAX); BLI_snprintf(str, maxlen, "%.*f", prec, value); } } else { prec -= int_digits_num; CLAMP(prec, 0, UI_PRECISION_FLOAT_MAX); BLI_snprintf(str, maxlen, "%.*f", prec, value); } } } else { BLI_snprintf(str, maxlen, "%d", (int)value); } } } void ui_but_string_get(uiBut *but, char *str, const size_t maxlen) { ui_but_string_get_ex(but, str, maxlen, -1, false, NULL); } /** * A version of #ui_but_string_get_ex for dynamic buffer sizes * (where #ui_but_string_get_max_length returns 0). * * \param r_str_size: size of the returned string (including terminator). */ char *ui_but_string_get_dynamic(uiBut *but, int *r_str_size) { char *str = NULL; *r_str_size = 1; if (but->rnaprop && ELEM(but->type, UI_BTYPE_TEXT, UI_BTYPE_SEARCH_MENU)) { PropertyType type; type = RNA_property_type(but->rnaprop); if (type == PROP_STRING) { /* RNA string */ str = RNA_property_string_get_alloc(&but->rnapoin, but->rnaprop, NULL, 0, r_str_size); (*r_str_size) += 1; } else if (type == PROP_ENUM) { /* RNA enum */ int value = RNA_property_enum_get(&but->rnapoin, but->rnaprop); const char *value_id; if (!RNA_property_enum_name( but->block->evil_C, &but->rnapoin, but->rnaprop, value, &value_id)) { value_id = ""; } *r_str_size = strlen(value_id) + 1; str = BLI_strdupn(value_id, *r_str_size); } else if (type == PROP_POINTER) { /* RNA pointer */ PointerRNA ptr = RNA_property_pointer_get(&but->rnapoin, but->rnaprop); str = RNA_struct_name_get_alloc(&ptr, NULL, 0, r_str_size); (*r_str_size) += 1; } else { BLI_assert(0); } } else { BLI_assert(0); } if (UNLIKELY(str == NULL)) { /* should never happen, paranoid check */ *r_str_size = 1; str = BLI_strdup(""); BLI_assert(0); } return str; } /** * Report a generic error prefix when evaluating a string with #BPY_execute_string_as_number * as the Python error on it's own doesn't provide enough context. */ #define UI_NUMBER_EVAL_ERROR_PREFIX IFACE_("Error evaluating number, see Info editor for details") static bool ui_number_from_string_units( bContext *C, const char *str, const int unit_type, const UnitSettings *unit, double *r_value) { return user_string_to_number(C, str, unit, unit_type, UI_NUMBER_EVAL_ERROR_PREFIX, r_value); } static bool ui_number_from_string_units_with_but(bContext *C, const char *str, const uiBut *but, double *r_value) { const int unit_type = RNA_SUBTYPE_UNIT_VALUE(UI_but_unit_type_get(but)); const UnitSettings *unit = but->block->unit; return ui_number_from_string_units(C, str, unit_type, unit, r_value); } static bool ui_number_from_string(bContext *C, const char *str, double *r_value) { bool ok; #ifdef WITH_PYTHON ok = BPY_execute_string_as_number(C, NULL, str, UI_NUMBER_EVAL_ERROR_PREFIX, r_value); #else UNUSED_VARS(C); *r_value = atof(str); ok = true; #endif return ok; } static bool ui_number_from_string_factor(bContext *C, const char *str, double *r_value) { int len = strlen(str); if (BLI_strn_endswith(str, "%", len)) { char *str_new = BLI_strdupn(str, len - 1); bool success = ui_number_from_string(C, str_new, r_value); MEM_freeN(str_new); *r_value /= 100.0; return success; } if (!ui_number_from_string(C, str, r_value)) { return false; } if (U.factor_display_type == USER_FACTOR_AS_PERCENTAGE) { *r_value /= 100.0; } return true; } static bool ui_number_from_string_percentage(bContext *C, const char *str, double *r_value) { int len = strlen(str); if (BLI_strn_endswith(str, "%", len)) { char *str_new = BLI_strdupn(str, len - 1); bool success = ui_number_from_string(C, str_new, r_value); MEM_freeN(str_new); return success; } return ui_number_from_string(C, str, r_value); } bool ui_but_string_eval_number(bContext *C, const uiBut *but, const char *str, double *r_value) { if (str[0] == '\0') { *r_value = 0.0; return true; } PropertySubType subtype = PROP_NONE; if (but->rnaprop) { subtype = RNA_property_subtype(but->rnaprop); } if (ui_but_is_float(but)) { if (ui_but_is_unit(but)) { return ui_number_from_string_units_with_but(C, str, but, r_value); } if (subtype == PROP_FACTOR) { return ui_number_from_string_factor(C, str, r_value); } if (subtype == PROP_PERCENTAGE) { return ui_number_from_string_percentage(C, str, r_value); } return ui_number_from_string(C, str, r_value); } return ui_number_from_string(C, str, r_value); } /* just the assignment/free part */ static void ui_but_string_set_internal(uiBut *but, const char *str, size_t str_len) { BLI_assert(str_len == strlen(str)); BLI_assert(but->str == NULL); str_len += 1; if (str_len > UI_MAX_NAME_STR) { but->str = MEM_mallocN(str_len, "ui_def_but str"); } else { but->str = but->strdata; } memcpy(but->str, str, str_len); } static void ui_but_string_free_internal(uiBut *but) { if (but->str) { if (but->str != but->strdata) { MEM_freeN(but->str); } /* must call 'ui_but_string_set_internal' after */ but->str = NULL; } } bool ui_but_string_set(bContext *C, uiBut *but, const char *str) { if (but->rnaprop && but->rnapoin.data && ELEM(but->type, UI_BTYPE_TEXT, UI_BTYPE_SEARCH_MENU)) { if (RNA_property_editable(&but->rnapoin, but->rnaprop)) { PropertyType type; type = RNA_property_type(but->rnaprop); if (type == PROP_STRING) { /* RNA string */ RNA_property_string_set(&but->rnapoin, but->rnaprop, str); return true; } if (type == PROP_POINTER) { if (str[0] == '\0') { RNA_property_pointer_set(&but->rnapoin, but->rnaprop, PointerRNA_NULL, NULL); return true; } uiButSearch *search_but = (but->type == UI_BTYPE_SEARCH_MENU) ? (uiButSearch *)but : NULL; /* RNA pointer */ PointerRNA rptr; /* This is kind of hackish, in theory think we could only ever use the second member of * this if/else, since ui_searchbox_apply() is supposed to always set that pointer when * we are storing pointers... But keeping str search first for now, * to try to break as little as possible existing code. All this is band-aids anyway. * Fact remains, using editstr as main 'reference' over whole search button thingy * is utterly weak and should be redesigned imho, but that's not a simple task. */ if (search_but && search_but->rnasearchprop && RNA_property_collection_lookup_string( &search_but->rnasearchpoin, search_but->rnasearchprop, str, &rptr)) { RNA_property_pointer_set(&but->rnapoin, but->rnaprop, rptr, NULL); } else if (search_but->item_active != NULL) { RNA_pointer_create(NULL, RNA_property_pointer_type(&but->rnapoin, but->rnaprop), search_but->item_active, &rptr); RNA_property_pointer_set(&but->rnapoin, but->rnaprop, rptr, NULL); } return true; } if (type == PROP_ENUM) { int value; if (RNA_property_enum_value( but->block->evil_C, &but->rnapoin, but->rnaprop, str, &value)) { RNA_property_enum_set(&but->rnapoin, but->rnaprop, value); return true; } return false; } BLI_assert(0); } } else if (but->type == UI_BTYPE_TAB) { if (but->rnaprop && but->custom_data) { StructRNA *ptr_type = RNA_property_pointer_type(&but->rnapoin, but->rnaprop); PointerRNA ptr; PropertyRNA *prop; /* uiBut.custom_data points to data this tab represents (e.g. workspace). * uiBut.rnapoin/prop store an active value (e.g. active workspace). */ RNA_pointer_create(but->rnapoin.owner_id, ptr_type, but->custom_data, &ptr); prop = RNA_struct_name_property(ptr_type); if (RNA_property_editable(&ptr, prop)) { RNA_property_string_set(&ptr, prop, str); } } } else if (but->type == UI_BTYPE_TEXT) { /* string */ if (!but->poin) { str = ""; } else if (UI_but_is_utf8(but)) { BLI_strncpy_utf8(but->poin, str, but->hardmax); } else { BLI_strncpy(but->poin, str, but->hardmax); } return true; } else if (but->type == UI_BTYPE_SEARCH_MENU) { /* string */ BLI_strncpy(but->poin, str, but->hardmax); return true; } else if (ui_but_anim_expression_set(but, str)) { /* driver expression */ return true; } else if (str[0] == '#') { /* shortcut to create new driver expression (versus immediate Py-execution) */ return ui_but_anim_expression_create(but, str + 1); } else { /* number editing */ double value; if (ui_but_string_eval_number(C, but, str, &value) == false) { WM_report_banner_show(); return false; } if (!ui_but_is_float(but)) { value = floor(value + 0.5); } /* not that we use hard limits here */ if (value < (double)but->hardmin) { value = but->hardmin; } if (value > (double)but->hardmax) { value = but->hardmax; } ui_but_value_set(but, value); return true; } return false; } void ui_but_default_set(bContext *C, const bool all, const bool use_afterfunc) { wmOperatorType *ot = WM_operatortype_find("UI_OT_reset_default_button", true); if (use_afterfunc) { PointerRNA *ptr; ptr = ui_handle_afterfunc_add_operator(ot, WM_OP_EXEC_DEFAULT, true); RNA_boolean_set(ptr, "all", all); } else { PointerRNA ptr; WM_operator_properties_create_ptr(&ptr, ot); RNA_boolean_set(&ptr, "all", all); WM_operator_name_call_ptr(C, ot, WM_OP_EXEC_DEFAULT, &ptr); WM_operator_properties_free(&ptr); } } static double soft_range_round_up(double value, double max) { /* round up to .., 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, .. * checking for 0.0 prevents floating point exceptions */ double newmax = (value != 0.0) ? pow(10.0, ceil(log(value) / M_LN10)) : 0.0; if (newmax * 0.2 >= max && newmax * 0.2 >= value) { return newmax * 0.2; } if (newmax * 0.5 >= max && newmax * 0.5 >= value) { return newmax * 0.5; } return newmax; } static double soft_range_round_down(double value, double max) { /* round down to .., 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, .. * checking for 0.0 prevents floating point exceptions */ double newmax = (value != 0.0) ? pow(10.0, floor(log(value) / M_LN10)) : 0.0; if (newmax * 5.0 <= max && newmax * 5.0 <= value) { return newmax * 5.0; } if (newmax * 2.0 <= max && newmax * 2.0 <= value) { return newmax * 2.0; } return newmax; } void ui_but_range_set_hard(uiBut *but) { if (but->rnaprop) { const PropertyType type = RNA_property_type(but->rnaprop); double hardmin, hardmax; /* clamp button range to something reasonable in case * we get -inf/inf from RNA properties */ if (type == PROP_INT) { int imin, imax; RNA_property_int_range(&but->rnapoin, but->rnaprop, &imin, &imax); hardmin = (imin == INT_MIN) ? -1e4 : imin; hardmax = (imin == INT_MAX) ? 1e4 : imax; } else if (type == PROP_FLOAT) { float fmin, fmax; RNA_property_float_range(&but->rnapoin, but->rnaprop, &fmin, &fmax); hardmin = (fmin == -FLT_MAX) ? (float)-1e4 : fmin; hardmax = (fmax == FLT_MAX) ? (float)1e4 : fmax; } else { return; } but->hardmin = hardmin; but->hardmax = hardmax; } } /* note: this could be split up into functions which handle arrays and not */ void ui_but_range_set_soft(uiBut *but) { /* ideally we would not limit this but practically, its more than * enough worst case is very long vectors wont use a smart soft-range * which isn't so bad. */ if (but->rnaprop) { const PropertyType type = RNA_property_type(but->rnaprop); double softmin, softmax /*, step, precision*/; double value_min; double value_max; /* clamp button range to something reasonable in case * we get -inf/inf from RNA properties */ if (type == PROP_INT) { const bool is_array = RNA_property_array_check(but->rnaprop); int imin, imax, istep; RNA_property_int_ui_range(&but->rnapoin, but->rnaprop, &imin, &imax, &istep); softmin = (imin == INT_MIN) ? -1e4 : imin; softmax = (imin == INT_MAX) ? 1e4 : imax; /*step = istep;*/ /*UNUSED*/ /*precision = 1;*/ /*UNUSED*/ if (is_array) { int value_range[2]; RNA_property_int_get_array_range(&but->rnapoin, but->rnaprop, value_range); value_min = (double)value_range[0]; value_max = (double)value_range[1]; } else { value_min = value_max = (double)RNA_property_int_get(&but->rnapoin, but->rnaprop); } } else if (type == PROP_FLOAT) { const bool is_array = RNA_property_array_check(but->rnaprop); float fmin, fmax, fstep, fprecision; RNA_property_float_ui_range(&but->rnapoin, but->rnaprop, &fmin, &fmax, &fstep, &fprecision); softmin = (fmin == -FLT_MAX) ? (float)-1e4 : fmin; softmax = (fmax == FLT_MAX) ? (float)1e4 : fmax; /*step = fstep;*/ /*UNUSED*/ /*precision = fprecision;*/ /*UNUSED*/ if (is_array) { float value_range[2]; RNA_property_float_get_array_range(&but->rnapoin, but->rnaprop, value_range); value_min = (double)value_range[0]; value_max = (double)value_range[1]; } else { value_min = value_max = (double)RNA_property_float_get(&but->rnapoin, but->rnaprop); } } else { return; } /* if the value goes out of the soft/max range, adapt the range */ if (value_min + 1e-10 < softmin) { if (value_min < 0.0) { softmin = -soft_range_round_up(-value_min, -softmin); } else { softmin = soft_range_round_down(value_min, softmin); } if (softmin < (double)but->hardmin) { softmin = (double)but->hardmin; } } if (value_max - 1e-10 > softmax) { if (value_max < 0.0) { softmax = -soft_range_round_down(-value_max, -softmax); } else { softmax = soft_range_round_up(value_max, softmax); } if (softmax > (double)but->hardmax) { softmax = but->hardmax; } } but->softmin = softmin; but->softmax = softmax; } else if (but->poin && (but->pointype & UI_BUT_POIN_TYPES)) { float value = ui_but_value_get(but); if (isfinite(value)) { CLAMP(value, but->hardmin, but->hardmax); but->softmin = min_ff(but->softmin, value); but->softmax = max_ff(but->softmax, value); } } else { BLI_assert(0); } } /* ******************* Free ********************/ /** * Free data specific to a certain button type. * For now just do in a switch-case, we could instead have a callback stored in #uiBut and set that * in #ui_but_alloc_info(). */ static void ui_but_free_type_specific(uiBut *but) { switch (but->type) { case UI_BTYPE_SEARCH_MENU: { uiButSearch *search_but = (uiButSearch *)but; if (search_but->arg_free_fn) { search_but->arg_free_fn(search_but->arg); search_but->arg = NULL; } break; } default: break; } } /* can be called with C==NULL */ static void ui_but_free(const bContext *C, uiBut *but) { if (but->opptr) { WM_operator_properties_free(but->opptr); MEM_freeN(but->opptr); } if (but->func_argN) { MEM_freeN(but->func_argN); } if (but->tip_argN) { MEM_freeN(but->tip_argN); } if (but->hold_argN) { MEM_freeN(but->hold_argN); } ui_but_free_type_specific(but); if (but->active) { /* XXX solve later, buttons should be free-able without context ideally, * however they may have open tooltips or popup windows, which need to * be closed using a context pointer */ if (C) { ui_but_active_free(C, but); } else { if (but->active) { MEM_freeN(but->active); } } } if (but->str && but->str != but->strdata) { MEM_freeN(but->str); } if ((but->type == UI_BTYPE_IMAGE) && but->poin) { IMB_freeImBuf((struct ImBuf *)but->poin); } if (but->dragpoin && (but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_freeN(but->dragpoin); } ui_but_extra_operator_icons_free(but); BLI_assert(UI_butstore_is_registered(but->block, but) == false); MEM_freeN(but); } /* can be called with C==NULL */ void UI_block_free(const bContext *C, uiBlock *block) { uiBut *but; UI_butstore_clear(block); while ((but = BLI_pophead(&block->buttons))) { ui_but_free(C, but); } if (block->unit) { MEM_freeN(block->unit); } if (block->func_argN) { MEM_freeN(block->func_argN); } CTX_store_free_list(&block->contexts); BLI_freelistN(&block->saferct); BLI_freelistN(&block->color_pickers.list); MEM_freeN(block); } void UI_blocklist_update_window_matrix(const bContext *C, const ListBase *lb) { ARegion *region = CTX_wm_region(C); wmWindow *window = CTX_wm_window(C); LISTBASE_FOREACH (uiBlock *, block, lb) { if (block->active) { ui_update_window_matrix(window, region, block); } } } void UI_blocklist_draw(const bContext *C, const ListBase *lb) { LISTBASE_FOREACH (uiBlock *, block, lb) { if (block->active) { UI_block_draw(C, block); } } } /* can be called with C==NULL */ void UI_blocklist_free(const bContext *C, ListBase *lb) { uiBlock *block; while ((block = BLI_pophead(lb))) { UI_block_free(C, block); } } void UI_blocklist_free_inactive(const bContext *C, ListBase *lb) { uiBlock *block, *nextblock; for (block = lb->first; block; block = nextblock) { nextblock = block->next; if (!block->handle) { if (!block->active) { BLI_remlink(lb, block); UI_block_free(C, block); } else { block->active = 0; } } } } void UI_block_region_set(uiBlock *block, ARegion *region) { ListBase *lb = ®ion->uiblocks; uiBlock *oldblock = NULL; /* each listbase only has one block with this name, free block * if is already there so it can be rebuilt from scratch */ if (lb) { oldblock = BLI_findstring(lb, block->name, offsetof(uiBlock, name)); if (oldblock) { oldblock->active = 0; oldblock->panel = NULL; oldblock->handle = NULL; } /* at the beginning of the list! for dynamical menus/blocks */ BLI_addhead(lb, block); } block->oldblock = oldblock; } uiBlock *UI_block_begin(const bContext *C, ARegion *region, const char *name, char emboss) { uiBlock *block; wmWindow *window; Scene *scn; window = CTX_wm_window(C); scn = CTX_data_scene(C); block = MEM_callocN(sizeof(uiBlock), "uiBlock"); block->active = 1; block->emboss = emboss; block->evil_C = (void *)C; /* XXX */ if (scn) { /* store display device name, don't lookup for transformations yet * block could be used for non-color displays where looking up for transformation * would slow down redraw, so only lookup for actual transform when it's indeed * needed */ STRNCPY(block->display_device, scn->display_settings.display_device); /* copy to avoid crash when scene gets deleted with ui still open */ block->unit = MEM_mallocN(sizeof(scn->unit), "UI UnitSettings"); memcpy(block->unit, &scn->unit, sizeof(scn->unit)); } else { STRNCPY(block->display_device, IMB_colormanagement_display_get_default_name()); } BLI_strncpy(block->name, name, sizeof(block->name)); if (region) { UI_block_region_set(block, region); } /* Set window matrix and aspect for region and OpenGL state. */ ui_update_window_matrix(window, region, block); /* Tag as popup menu if not created within a region. */ if (!(region && region->visible)) { block->auto_open = true; block->flag |= UI_BLOCK_LOOP; } return block; } char UI_block_emboss_get(uiBlock *block) { return block->emboss; } void UI_block_emboss_set(uiBlock *block, char emboss) { block->emboss = emboss; } void UI_block_theme_style_set(uiBlock *block, char theme_style) { block->theme_style = theme_style; } static void ui_but_build_drawstr_float(uiBut *but, double value) { size_t slen = 0; STR_CONCAT(but->drawstr, slen, but->str); PropertySubType subtype = PROP_NONE; if (but->rnaprop) { subtype = RNA_property_subtype(but->rnaprop); } if (value == (double)FLT_MAX) { STR_CONCAT(but->drawstr, slen, "inf"); } else if (value == (double)-FLT_MAX) { STR_CONCAT(but->drawstr, slen, "-inf"); } else if (subtype == PROP_PERCENTAGE) { int prec = ui_but_calc_float_precision(but, value); STR_CONCATF(but->drawstr, slen, "%.*f%%", prec, value); } else if (subtype == PROP_PIXEL) { int prec = ui_but_calc_float_precision(but, value); STR_CONCATF(but->drawstr, slen, "%.*f px", prec, value); } else if (subtype == PROP_FACTOR) { int precision = ui_but_calc_float_precision(but, value); if (U.factor_display_type == USER_FACTOR_AS_FACTOR) { STR_CONCATF(but->drawstr, slen, "%.*f", precision, value); } else { STR_CONCATF(but->drawstr, slen, "%.*f%%", MAX2(0, precision - 2), value * 100); } } else if (ui_but_is_unit(but)) { char new_str[sizeof(but->drawstr)]; ui_get_but_string_unit(but, new_str, sizeof(new_str), value, true, -1); STR_CONCAT(but->drawstr, slen, new_str); } else { int prec = ui_but_calc_float_precision(but, value); STR_CONCATF(but->drawstr, slen, "%.*f", prec, value); } } static void ui_but_build_drawstr_int(uiBut *but, int value) { size_t slen = 0; STR_CONCAT(but->drawstr, slen, but->str); PropertySubType subtype = PROP_NONE; if (but->rnaprop) { subtype = RNA_property_subtype(but->rnaprop); } STR_CONCATF(but->drawstr, slen, "%d", value); if (subtype == PROP_PERCENTAGE) { STR_CONCAT(but->drawstr, slen, "%"); } else if (subtype == PROP_PIXEL) { STR_CONCAT(but->drawstr, slen, " px"); } } /** * \param but: Button to update. * \param validate: When set, this function may change the button value. * Otherwise treat the button value as read-only. */ static void ui_but_update_ex(uiBut *but, const bool validate) { /* if something changed in the button */ double value = UI_BUT_VALUE_UNSET; ui_but_update_select_flag(but, &value); /* only update soft range while not editing */ if (!ui_but_is_editing(but)) { if ((but->rnaprop != NULL) || (but->poin && (but->pointype & UI_BUT_POIN_TYPES))) { ui_but_range_set_soft(but); } } /* test for min and max, icon sliders, etc */ switch (but->type) { case UI_BTYPE_NUM: case UI_BTYPE_SCROLL: case UI_BTYPE_NUM_SLIDER: if (validate) { UI_GET_BUT_VALUE_INIT(but, value); if (value < (double)but->hardmin) { ui_but_value_set(but, but->hardmin); } else if (value > (double)but->hardmax) { ui_but_value_set(but, but->hardmax); } /* max must never be smaller than min! Both being equal is allowed though */ BLI_assert(but->softmin <= but->softmax && but->hardmin <= but->hardmax); } break; case UI_BTYPE_ICON_TOGGLE: case UI_BTYPE_ICON_TOGGLE_N: if ((but->rnaprop == NULL) || (RNA_property_flag(but->rnaprop) & PROP_ICONS_CONSECUTIVE)) { if (but->rnaprop && RNA_property_flag(but->rnaprop) & PROP_ICONS_REVERSE) { but->drawflag |= UI_BUT_ICON_REVERSE; } but->iconadd = (but->flag & UI_SELECT) ? 1 : 0; } break; /* quiet warnings for unhandled types */ default: break; } /* safety is 4 to enable small number buttons (like 'users') */ // okwidth = -4 + (BLI_rcti_size_x(&but->rect)); // UNUSED /* name: */ switch (but->type) { case UI_BTYPE_MENU: if (BLI_rctf_size_x(&but->rect) >= (UI_UNIT_X * 2)) { /* only needed for menus in popup blocks that don't recreate buttons on redraw */ if (but->block->flag & UI_BLOCK_LOOP) { if (but->rnaprop && (RNA_property_type(but->rnaprop) == PROP_ENUM)) { int value_enum = RNA_property_enum_get(&but->rnapoin, but->rnaprop); EnumPropertyItem item; if (RNA_property_enum_item_from_value_gettexted( but->block->evil_C, &but->rnapoin, but->rnaprop, value_enum, &item)) { size_t slen = strlen(item.name); ui_but_string_free_internal(but); ui_but_string_set_internal(but, item.name, slen); but->icon = item.icon; } } } BLI_strncpy(but->drawstr, but->str, sizeof(but->drawstr)); } break; case UI_BTYPE_NUM: case UI_BTYPE_NUM_SLIDER: if (but->editstr) { break; } UI_GET_BUT_VALUE_INIT(but, value); if (ui_but_is_float(but)) { ui_but_build_drawstr_float(but, value); } else { ui_but_build_drawstr_int(but, (int)value); } break; case UI_BTYPE_LABEL: if (ui_but_is_float(but)) { int prec; UI_GET_BUT_VALUE_INIT(but, value); prec = ui_but_calc_float_precision(but, value); BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%.*f", but->str, prec, value); } else { BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR); } break; case UI_BTYPE_TEXT: case UI_BTYPE_SEARCH_MENU: if (!but->editstr) { char str[UI_MAX_DRAW_STR]; ui_but_string_get(but, str, UI_MAX_DRAW_STR); BLI_snprintf(but->drawstr, sizeof(but->drawstr), "%s%s", but->str, str); } break; case UI_BTYPE_KEY_EVENT: { const char *str; if (but->flag & UI_SELECT) { str = "Press a key"; } else { UI_GET_BUT_VALUE_INIT(but, value); str = WM_key_event_string((short)value, false); } BLI_snprintf(but->drawstr, UI_MAX_DRAW_STR, "%s%s", but->str, str); break; } case UI_BTYPE_HOTKEY_EVENT: if (but->flag & UI_SELECT) { if (but->modifier_key) { char *str = but->drawstr; but->drawstr[0] = '\0'; if (but->modifier_key & KM_SHIFT) { str += BLI_strcpy_rlen(str, "Shift "); } if (but->modifier_key & KM_CTRL) { str += BLI_strcpy_rlen(str, "Ctrl "); } if (but->modifier_key & KM_ALT) { str += BLI_strcpy_rlen(str, "Alt "); } if (but->modifier_key & KM_OSKEY) { str += BLI_strcpy_rlen(str, "Cmd "); } (void)str; /* UNUSED */ } else { BLI_strncpy(but->drawstr, "Press a key", UI_MAX_DRAW_STR); } } else { BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR); } break; case UI_BTYPE_HSVCUBE: case UI_BTYPE_HSVCIRCLE: break; default: BLI_strncpy(but->drawstr, but->str, UI_MAX_DRAW_STR); break; } /* if we are doing text editing, this will override the drawstr */ if (but->editstr) { but->drawstr[0] = '\0'; } /* text clipping moved to widget drawing code itself */ } void ui_but_update(uiBut *but) { ui_but_update_ex(but, false); } void ui_but_update_edited(uiBut *but) { ui_but_update_ex(but, true); } void UI_block_align_begin(uiBlock *block) { /* if other align was active, end it */ if (block->flag & UI_BUT_ALIGN) { UI_block_align_end(block); } block->flag |= UI_BUT_ALIGN_DOWN; block->alignnr++; /* buttons declared after this call will get this align nr */ // XXX flag? } void UI_block_align_end(uiBlock *block) { block->flag &= ~UI_BUT_ALIGN; /* all 4 flags */ } struct ColorManagedDisplay *ui_block_cm_display_get(uiBlock *block) { return IMB_colormanagement_display_get_named(block->display_device); } void ui_block_cm_to_display_space_v3(uiBlock *block, float pixel[3]) { struct ColorManagedDisplay *display = ui_block_cm_display_get(block); IMB_colormanagement_scene_linear_to_display_v3(pixel, display); } static void ui_but_alloc_info(const eButType type, size_t *r_alloc_size, const char **r_alloc_str, bool *r_has_custom_type) { size_t alloc_size; const char *alloc_str; bool has_custom_type = true; switch (type) { case UI_BTYPE_COLOR: alloc_size = sizeof(uiButColor); alloc_str = "uiButColor"; break; case UI_BTYPE_DECORATOR: alloc_size = sizeof(uiButDecorator); alloc_str = "uiButDecorator"; break; case UI_BTYPE_TAB: alloc_size = sizeof(uiButTab); alloc_str = "uiButTab"; break; case UI_BTYPE_SEARCH_MENU: alloc_size = sizeof(uiButSearch); alloc_str = "uiButSearch"; break; case UI_BTYPE_PROGRESS_BAR: alloc_size = sizeof(uiButProgressbar); alloc_str = "uiButProgressbar"; break; default: alloc_size = sizeof(uiBut); alloc_str = "uiBut"; has_custom_type = false; break; } if (r_alloc_size) { *r_alloc_size = alloc_size; } if (r_alloc_str) { *r_alloc_str = alloc_str; } if (r_has_custom_type) { *r_has_custom_type = has_custom_type; } } static uiBut *ui_but_alloc(const eButType type) { size_t alloc_size; const char *alloc_str; ui_but_alloc_info(type, &alloc_size, &alloc_str, NULL); return MEM_callocN(alloc_size, alloc_str); } /** * Reallocate the button (new address is returned) for a new button type. * This should generally be avoided and instead the correct type be created right away. * * \note Only the #uiBut data can be kept. If the old button used a derived type (e.g. #uiButTab), * the data that is not inside #uiBut will be lost. */ uiBut *ui_but_change_type(uiBut *but, eButType new_type) { if (but->type != new_type) { size_t alloc_size; const char *alloc_str; uiBut *insert_after_but = but->prev; bool new_has_custom_type, old_has_custom_type; /* Remove old button address */ BLI_remlink(&but->block->buttons, but); ui_but_alloc_info(but->type, NULL, NULL, &old_has_custom_type); ui_but_alloc_info(new_type, &alloc_size, &alloc_str, &new_has_custom_type); if (new_has_custom_type || old_has_custom_type) { const void *old_but_ptr = but; /* Button may have pointer to a member within itself, this will have to be updated. */ const bool has_str_ptr_to_self = but->str == but->strdata; but = MEM_recallocN_id(but, alloc_size, alloc_str); but->type = new_type; if (has_str_ptr_to_self) { but->str = but->strdata; } BLI_insertlinkafter(&but->block->buttons, insert_after_but, but); if (but->layout) { const bool found_layout = ui_layout_replace_but_ptr(but->layout, old_but_ptr, but); BLI_assert(found_layout); UNUSED_VARS_NDEBUG(found_layout); } } } return but; } /** * \brief ui_def_but is the function that draws many button types * * \param x, y: The lower left hand corner of the button (X axis) * \param width, height: The size of the button. * * for float buttons: * \param a1: Click Step (how much to change the value each click) * \param a2: Number of decimal point values to display. 0 defaults to 3 (0.000) * 1,2,3, and a maximum of 4, all greater values will be clamped to 4. */ static uiBut *ui_def_but(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { uiBut *but; int slen; BLI_assert(width >= 0 && height >= 0); /* we could do some more error checks here */ if ((type & BUTTYPE) == UI_BTYPE_LABEL) { BLI_assert((poin != NULL || min != 0.0f || max != 0.0f || (a1 == 0.0f && a2 != 0.0f) || (a1 != 0.0f && a1 != 1.0f)) == false); } /* Number buttons must have a click-step, * assert instead of correcting the value to ensure the caller knows what they're doing. */ if ((type & BUTTYPE) == UI_BTYPE_NUM) { if (ELEM((type & UI_BUT_POIN_TYPES), UI_BUT_POIN_CHAR, UI_BUT_POIN_SHORT, UI_BUT_POIN_INT)) { BLI_assert((int)a1 > 0); } } if (type & UI_BUT_POIN_TYPES) { /* a pointer is required */ if (poin == NULL) { BLI_assert(0); return NULL; } } but = ui_but_alloc(type & BUTTYPE); but->type = type & BUTTYPE; but->pointype = type & UI_BUT_POIN_TYPES; but->bit = type & UI_BUT_POIN_BIT; but->bitnr = type & 31; but->icon = ICON_NONE; but->iconadd = 0; but->retval = retval; slen = strlen(str); ui_but_string_set_internal(but, str, slen); but->rect.xmin = x; but->rect.ymin = y; but->rect.xmax = but->rect.xmin + width; but->rect.ymax = but->rect.ymin + height; but->poin = poin; but->hardmin = but->softmin = min; but->hardmax = but->softmax = max; but->a1 = a1; but->a2 = a2; but->tip = tip; but->disabled_info = block->lockstr; but->emboss = block->emboss; but->pie_dir = UI_RADIAL_NONE; but->block = block; /* pointer back, used for frontbuffer status, and picker */ if ((block->flag & UI_BUT_ALIGN) && ui_but_can_align(but)) { but->alignnr = block->alignnr; } but->func = block->func; but->func_arg1 = block->func_arg1; but->func_arg2 = block->func_arg2; but->funcN = block->funcN; if (block->func_argN) { but->func_argN = MEM_dupallocN(block->func_argN); } but->pos = -1; /* cursor invisible */ if (ELEM(but->type, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER)) { /* add a space to name */ /* slen remains unchanged from previous assignment, ensure this stays true */ if (slen > 0 && slen < UI_MAX_NAME_STR - 2) { if (but->str[slen - 1] != ' ') { but->str[slen] = ' '; but->str[slen + 1] = 0; } } } if (block->flag & UI_BLOCK_RADIAL) { but->drawflag |= UI_BUT_TEXT_LEFT; if (but->str && but->str[0]) { but->drawflag |= UI_BUT_ICON_LEFT; } } else if (((block->flag & UI_BLOCK_LOOP) && !ui_block_is_popover(block)) || ELEM(but->type, UI_BTYPE_MENU, UI_BTYPE_TEXT, UI_BTYPE_LABEL, UI_BTYPE_BLOCK, UI_BTYPE_BUT_MENU, UI_BTYPE_SEARCH_MENU, UI_BTYPE_PROGRESS_BAR, UI_BTYPE_POPOVER)) { but->drawflag |= (UI_BUT_TEXT_LEFT | UI_BUT_ICON_LEFT); } #ifdef USE_NUMBUTS_LR_ALIGN else if (ELEM(but->type, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER)) { if (slen != 0) { but->drawflag |= UI_BUT_TEXT_LEFT; } } #endif but->drawflag |= (block->flag & UI_BUT_ALIGN); if (block->lock == true) { but->flag |= UI_BUT_DISABLED; } /* keep track of UI_interface.h */ if (ELEM(but->type, UI_BTYPE_BLOCK, UI_BTYPE_BUT, UI_BTYPE_DECORATOR, UI_BTYPE_LABEL, UI_BTYPE_PULLDOWN, UI_BTYPE_ROUNDBOX, UI_BTYPE_LISTBOX, UI_BTYPE_BUT_MENU, UI_BTYPE_SCROLL, UI_BTYPE_GRIP, UI_BTYPE_SEPR, UI_BTYPE_SEPR_LINE, UI_BTYPE_SEPR_SPACER) || (but->type >= UI_BTYPE_SEARCH_MENU)) { /* pass */ } else { but->flag |= UI_BUT_UNDO; } BLI_addtail(&block->buttons, but); if (block->curlayout) { ui_layout_add_but(block->curlayout, but); } #ifdef WITH_PYTHON /* if the 'UI_OT_editsource' is running, extract the source info from the button */ if (UI_editsource_enable_check()) { UI_editsource_active_but_test(but); } #endif return but; } void ui_def_but_icon(uiBut *but, const int icon, const int flag) { if (icon) { ui_icon_ensure_deferred(but->block->evil_C, icon, (flag & UI_BUT_ICON_PREVIEW) != 0); } but->icon = (BIFIconID)icon; but->flag |= flag; if (but->str && but->str[0]) { but->drawflag |= UI_BUT_ICON_LEFT; } } /** * Avoid using this where possible since it's better not to ask for an icon in the first place. */ void ui_def_but_icon_clear(uiBut *but) { but->icon = ICON_NONE; but->flag &= ~UI_HAS_ICON; but->drawflag &= ~UI_BUT_ICON_LEFT; } static void ui_def_but_rna__disable(uiBut *but, const char *info) { but->flag |= UI_BUT_DISABLED; but->disabled_info = info; } static void ui_def_but_rna__menu(bContext *UNUSED(C), uiLayout *layout, void *but_p) { uiBlock *block = uiLayoutGetBlock(layout); uiPopupBlockHandle *handle = block->handle; uiBut *but = (uiBut *)but_p; /* see comment in ui_item_enum_expand, re: uiname */ const EnumPropertyItem *item, *item_array; bool free; uiLayout *split, *column = NULL; int totitems = 0; int columns, rows, a, b; int column_end = 0; int nbr_entries_nosepr = 0; UI_block_flag_enable(block, UI_BLOCK_MOVEMOUSE_QUIT); RNA_property_enum_items_gettexted( block->evil_C, &but->rnapoin, but->rnaprop, &item_array, NULL, &free); /* we dont want nested rows, cols in menus */ UI_block_layout_set_current(block, layout); for (item = item_array; item->identifier; item++, totitems++) { if (!item->identifier[0]) { /* inconsistent, but menus with categories do not look good flipped */ if (item->name) { block->flag |= UI_BLOCK_NO_FLIP; nbr_entries_nosepr++; } /* We do not want simple separators in nbr_entries_nosepr count */ continue; } nbr_entries_nosepr++; } /* Columns and row estimation. Ignore simple separators here. */ columns = (nbr_entries_nosepr + 20) / 20; if (columns < 1) { columns = 1; } if (columns > 8) { columns = (nbr_entries_nosepr + 25) / 25; } rows = totitems / columns; if (rows < 1) { rows = 1; } while (rows * columns < totitems) { rows++; } if (block->flag & UI_BLOCK_NO_FLIP) { /* Title at the top for menus with categories. */ uiDefBut(block, UI_BTYPE_LABEL, 0, RNA_property_ui_name(but->rnaprop), 0, 0, UI_UNIT_X * 5, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, ""); uiItemS(layout); } /* note, item_array[...] is reversed on access */ /* create items */ split = uiLayoutSplit(layout, 0.0f, false); for (a = 0; a < totitems; a++) { if (a == column_end) { /* start new column, and find out where it ends in advance, so we * can flip the order of items properly per column */ column_end = totitems; for (b = a + 1; b < totitems; b++) { item = &item_array[b]; /* new column on N rows or on separation label */ if (((b - a) % rows == 0) || (!item->identifier[0] && item->name)) { column_end = b; break; } } column = uiLayoutColumn(split, false); } item = &item_array[a]; if (!item->identifier[0]) { if (item->name) { if (item->icon) { uiItemL(column, item->name, item->icon); } else { /* Do not use uiItemL here, as our root layout is a menu one, * it will add a fake blank icon! */ uiDefBut(block, UI_BTYPE_LABEL, 0, item->name, 0, 0, UI_UNIT_X * 5, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, ""); } } else { uiItemS(column); } } else { if (item->icon) { uiDefIconTextButI(block, UI_BTYPE_BUT_MENU, B_NOP, item->icon, item->name, 0, 0, UI_UNIT_X * 5, UI_UNIT_Y, &handle->retvalue, item->value, 0.0, 0, -1, item->description); } else { uiDefButI(block, UI_BTYPE_BUT_MENU, B_NOP, item->name, 0, 0, UI_UNIT_X * 5, UI_UNIT_X, &handle->retvalue, item->value, 0.0, 0, -1, item->description); } } } if (!(block->flag & UI_BLOCK_NO_FLIP)) { /* Title at the bottom for menus without categories. */ uiItemS(layout); uiDefBut(block, UI_BTYPE_LABEL, 0, RNA_property_ui_name(but->rnaprop), 0, 0, UI_UNIT_X * 5, UI_UNIT_Y, NULL, 0.0, 0.0, 0, 0, ""); } UI_block_layout_set_current(block, layout); if (free) { MEM_freeN((void *)item_array); } BLI_assert((block->flag & UI_BLOCK_IS_FLIP) == 0); block->flag |= UI_BLOCK_IS_FLIP; } static void ui_def_but_rna__panel_type(bContext *C, uiLayout *layout, void *but_p) { uiBut *but = but_p; const char *panel_type = but->func_argN; PanelType *pt = WM_paneltype_find(panel_type, true); if (pt) { ui_item_paneltype_func(C, layout, pt); } else { char msg[256]; SNPRINTF(msg, "Missing Panel: %s", panel_type); uiItemL(layout, msg, ICON_NONE); } } void ui_but_rna_menu_convert_to_panel_type(uiBut *but, const char *panel_type) { BLI_assert(ELEM(but->type, UI_BTYPE_MENU, UI_BTYPE_COLOR)); // BLI_assert(but->menu_create_func == ui_def_but_rna__menu); // BLI_assert((void *)but->poin == but); but->menu_create_func = ui_def_but_rna__panel_type; but->func_argN = BLI_strdup(panel_type); } bool ui_but_menu_draw_as_popover(const uiBut *but) { return (but->menu_create_func == ui_def_but_rna__panel_type); } static void ui_def_but_rna__menu_type(bContext *C, uiLayout *layout, void *but_p) { uiBut *but = but_p; const char *menu_type = but->func_argN; MenuType *mt = WM_menutype_find(menu_type, true); if (mt) { ui_item_menutype_func(C, layout, mt); } else { char msg[256]; SNPRINTF(msg, "Missing Menu: %s", menu_type); uiItemL(layout, msg, ICON_NONE); } } void ui_but_rna_menu_convert_to_menu_type(uiBut *but, const char *menu_type) { BLI_assert(but->type == UI_BTYPE_MENU); BLI_assert(but->menu_create_func == ui_def_but_rna__menu); BLI_assert((void *)but->poin == but); but->menu_create_func = ui_def_but_rna__menu_type; but->func_argN = BLI_strdup(menu_type); } static void ui_but_submenu_enable(uiBlock *block, uiBut *but) { but->flag |= UI_BUT_ICON_SUBMENU; block->content_hints |= UI_BLOCK_CONTAINS_SUBMENU_BUT; } /** * ui_def_but_rna_propname and ui_def_but_rna * both take the same args except for propname vs prop, this is done so we can * avoid an extra lookup on 'prop' when its already available. * * When this kind of change won't disrupt branches, best look into making more * of our UI functions take prop rather then propname. */ static uiBut *ui_def_but_rna(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip) { const PropertyType proptype = RNA_property_type(prop); uiBut *but; int icon = 0; uiMenuCreateFunc func = NULL; if (ELEM(type, UI_BTYPE_COLOR, UI_BTYPE_HSVCIRCLE, UI_BTYPE_HSVCUBE)) { BLI_assert(index == -1); } /* use rna values if parameters are not specified */ if ((proptype == PROP_ENUM) && ELEM(type, UI_BTYPE_MENU, UI_BTYPE_ROW, UI_BTYPE_LISTROW)) { /* UI_BTYPE_MENU is handled a little differently here */ const EnumPropertyItem *item; int value; bool free; int i; RNA_property_enum_items(block->evil_C, ptr, prop, &item, NULL, &free); if (type == UI_BTYPE_MENU) { value = RNA_property_enum_get(ptr, prop); } else { value = (int)max; } i = RNA_enum_from_value(item, value); if (i != -1) { if (!str) { str = item[i].name; #ifdef WITH_INTERNATIONAL str = CTX_IFACE_(RNA_property_translation_context(prop), str); #endif } icon = item[i].icon; } else { if (!str) { if (type == UI_BTYPE_MENU) { str = ""; } else { str = RNA_property_ui_name(prop); } } } if (type == UI_BTYPE_MENU) { func = ui_def_but_rna__menu; } if (free) { MEM_freeN((void *)item); } } else { if (!str) { str = RNA_property_ui_name(prop); } icon = RNA_property_ui_icon(prop); } if (!tip && proptype != PROP_ENUM) { tip = RNA_property_ui_description(prop); } if (min == max || a1 == -1 || a2 == -1) { if (proptype == PROP_INT) { int hardmin, hardmax, softmin, softmax, step; RNA_property_int_range(ptr, prop, &hardmin, &hardmax); RNA_property_int_ui_range(ptr, prop, &softmin, &softmax, &step); if (!ELEM(type, UI_BTYPE_ROW, UI_BTYPE_LISTROW) && min == max) { min = hardmin; max = hardmax; } if (a1 == -1) { a1 = step; } if (a2 == -1) { a2 = 0; } } else if (proptype == PROP_FLOAT) { float hardmin, hardmax, softmin, softmax, step, precision; RNA_property_float_range(ptr, prop, &hardmin, &hardmax); RNA_property_float_ui_range(ptr, prop, &softmin, &softmax, &step, &precision); if (!ELEM(type, UI_BTYPE_ROW, UI_BTYPE_LISTROW) && min == max) { min = hardmin; max = hardmax; } if (a1 == -1) { a1 = step; } if (a2 == -1) { a2 = precision; } } else if (proptype == PROP_STRING) { min = 0; max = RNA_property_string_maxlength(prop); /* note, 'max' may be zero (code for dynamically resized array) */ } } /* now create button */ but = ui_def_but(block, type, retval, str, x, y, width, height, NULL, min, max, a1, a2, tip); but->rnapoin = *ptr; but->rnaprop = prop; if (RNA_property_array_check(but->rnaprop)) { but->rnaindex = index; } else { but->rnaindex = 0; } if (icon) { ui_def_but_icon(but, icon, UI_HAS_ICON); } if (type == UI_BTYPE_MENU) { if (but->emboss == UI_EMBOSS_PULLDOWN) { ui_but_submenu_enable(block, but); } } else if (type == UI_BTYPE_SEARCH_MENU) { if (proptype == PROP_POINTER) { /* Search buttons normally don't get undo, see: T54580. */ but->flag |= UI_BUT_UNDO; } } const char *info; if (but->rnapoin.data && !RNA_property_editable_info(&but->rnapoin, prop, &info)) { ui_def_but_rna__disable(but, info); } if (but->flag & UI_BUT_UNDO && (ui_but_is_rna_undo(but) == false)) { but->flag &= ~UI_BUT_UNDO; } /* If this button uses units, calculate the step from this */ if ((proptype == PROP_FLOAT) && ui_but_is_unit(but)) { but->a1 = ui_get_but_step_unit(but, but->a1); } if (func) { but->menu_create_func = func; but->poin = (char *)but; } return but; } static uiBut *ui_def_but_rna_propname(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip) { PropertyRNA *prop = RNA_struct_find_property(ptr, propname); uiBut *but; if (prop) { but = ui_def_but_rna( block, type, retval, str, x, y, width, height, ptr, prop, index, min, max, a1, a2, tip); } else { but = ui_def_but( block, type, retval, propname, x, y, width, height, NULL, min, max, a1, a2, tip); ui_def_but_rna__disable(but, "Unknown Property."); } return but; } static uiBut *ui_def_but_operator_ptr(uiBlock *block, int type, wmOperatorType *ot, int opcontext, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but; if (!str) { if (ot && ot->srna) { str = WM_operatortype_name(ot, NULL); } else { str = ""; } } if ((!tip || tip[0] == '\0') && ot && ot->srna && !ot->get_description) { tip = RNA_struct_ui_description(ot->srna); } but = ui_def_but(block, type, -1, str, x, y, width, height, NULL, 0, 0, 0, 0, tip); but->optype = ot; but->opcontext = opcontext; but->flag &= ~UI_BUT_UNDO; /* no need for ui_but_is_rna_undo(), we never need undo here */ if (!ot) { but->flag |= UI_BUT_DISABLED; but->disabled_info = ""; } return but; } uiBut *uiDefBut(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { uiBut *but = ui_def_but( block, type, retval, str, x, y, width, height, poin, min, max, a1, a2, tip); ui_but_update(but); return but; } uiBut *uiDefButImage( uiBlock *block, void *imbuf, int x, int y, short width, short height, const uchar color[4]) { uiBut *but = ui_def_but( block, UI_BTYPE_IMAGE, 0, "", x, y, width, height, imbuf, 0, 0, 0, 0, ""); if (color) { copy_v4_v4_uchar(but->col, color); } else { but->col[0] = 255; but->col[1] = 255; but->col[2] = 255; but->col[3] = 255; } ui_but_update(but); return but; } uiBut *uiDefButAlert(uiBlock *block, int icon, int x, int y, short width, short height) { struct ImBuf *ibuf = UI_alert_image(icon); if (icon == ALERT_ICON_BLENDER) { return uiDefButImage(block, ibuf, x, y, width, height, NULL); } uchar icon_color[4]; ThemeColorID color_id = TH_INFO_WARNING; if (icon == ALERT_ICON_ERROR) { color_id = TH_INFO_ERROR; } else if (icon == ALERT_ICON_INFO) { color_id = TH_INFO_INFO; } else if (icon == ALERT_ICON_QUESTION) { color_id = TH_INFO_PROPERTY; } UI_GetThemeColorType4ubv(color_id, SPACE_INFO, icon_color); return uiDefButImage(block, ibuf, x, y, width, height, icon_color); } /** * if \a _x_ is a power of two (only one bit) return the power, * otherwise return -1. * * for powers of two: * \code{.c} * ((1 << findBitIndex(x)) == x); * \endcode */ static int findBitIndex(uint x) { if (!x || !is_power_of_2_i(x)) { /* is_power_of_2_i(x) strips lowest bit */ return -1; } int idx = 0; if (x & 0xFFFF0000) { idx += 16; x >>= 16; } if (x & 0xFF00) { idx += 8; x >>= 8; } if (x & 0xF0) { idx += 4; x >>= 4; } if (x & 0xC) { idx += 2; x >>= 2; } if (x & 0x2) { idx += 1; } return idx; } /* autocomplete helper functions */ struct AutoComplete { size_t maxlen; int matches; char *truncate; const char *startname; }; AutoComplete *UI_autocomplete_begin(const char *startname, size_t maxlen) { AutoComplete *autocpl; autocpl = MEM_callocN(sizeof(AutoComplete), "AutoComplete"); autocpl->maxlen = maxlen; autocpl->matches = 0; autocpl->truncate = MEM_callocN(sizeof(char) * maxlen, "AutoCompleteTruncate"); autocpl->startname = startname; return autocpl; } void UI_autocomplete_update_name(AutoComplete *autocpl, const char *name) { char *truncate = autocpl->truncate; const char *startname = autocpl->startname; int a; for (a = 0; a < autocpl->maxlen - 1; a++) { if (startname[a] == 0 || startname[a] != name[a]) { break; } } /* found a match */ if (startname[a] == 0) { autocpl->matches++; /* first match */ if (truncate[0] == 0) { BLI_strncpy(truncate, name, autocpl->maxlen); } else { /* remove from truncate what is not in bone->name */ for (a = 0; a < autocpl->maxlen - 1; a++) { if (name[a] == 0) { truncate[a] = 0; break; } if (truncate[a] != name[a]) { truncate[a] = 0; } } } } } int UI_autocomplete_end(AutoComplete *autocpl, char *autoname) { int match = AUTOCOMPLETE_NO_MATCH; if (autocpl->truncate[0]) { if (autocpl->matches == 1) { match = AUTOCOMPLETE_FULL_MATCH; } else { match = AUTOCOMPLETE_PARTIAL_MATCH; } BLI_strncpy(autoname, autocpl->truncate, autocpl->maxlen); } else { if (autoname != autocpl->startname) { /* don't copy a string over its self */ BLI_strncpy(autoname, autocpl->startname, autocpl->maxlen); } } MEM_freeN(autocpl->truncate); MEM_freeN(autocpl); return match; } static void ui_but_update_and_icon_set(uiBut *but, int icon) { if (icon) { ui_def_but_icon(but, icon, UI_HAS_ICON); } ui_but_update(but); } static uiBut *uiDefButBit(uiBlock *block, int type, int bit, int retval, const char *str, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { int bitIdx = findBitIndex(bit); if (bitIdx == -1) { return NULL; } return uiDefBut(block, type | UI_BUT_POIN_BIT | bitIdx, retval, str, x, y, width, height, poin, min, max, a1, a2, tip); } uiBut *uiDefButF(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefBut(block, type | UI_BUT_POIN_FLOAT, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButBitF(uiBlock *block, int type, int bit, int retval, const char *str, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefButBit(block, type | UI_BUT_POIN_FLOAT, bit, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButI(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefBut(block, type | UI_BUT_POIN_INT, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButBitI(uiBlock *block, int type, int bit, int retval, const char *str, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefButBit(block, type | UI_BUT_POIN_INT, bit, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButS(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefBut(block, type | UI_BUT_POIN_SHORT, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButBitS(uiBlock *block, int type, int bit, int retval, const char *str, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefButBit(block, type | UI_BUT_POIN_SHORT, bit, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButC(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefBut(block, type | UI_BUT_POIN_CHAR, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButBitC(uiBlock *block, int type, int bit, int retval, const char *str, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefButBit(block, type | UI_BUT_POIN_CHAR, bit, retval, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefButR(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna_propname( block, type, retval, str, x, y, width, height, ptr, propname, index, min, max, a1, a2, tip); ui_but_update(but); return but; } uiBut *uiDefButR_prop(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna( block, type, retval, str, x, y, width, height, ptr, prop, index, min, max, a1, a2, tip); ui_but_update(but); return but; } uiBut *uiDefButO_ptr(uiBlock *block, int type, wmOperatorType *ot, int opcontext, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but; but = ui_def_but_operator_ptr(block, type, ot, opcontext, str, x, y, width, height, tip); ui_but_update(but); return but; } uiBut *uiDefButO(uiBlock *block, int type, const char *opname, int opcontext, const char *str, int x, int y, short width, short height, const char *tip) { wmOperatorType *ot = WM_operatortype_find(opname, 0); if (str == NULL && ot == NULL) { str = opname; } return uiDefButO_ptr(block, type, ot, opcontext, str, x, y, width, height, tip); } /* if a1==1.0 then a2 is an extra icon blending factor (alpha 0.0 - 1.0) */ uiBut *uiDefIconBut(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { uiBut *but = ui_def_but( block, type, retval, "", x, y, width, height, poin, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); return but; } static uiBut *uiDefIconButBit(uiBlock *block, int type, int bit, int retval, int icon, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { int bitIdx = findBitIndex(bit); if (bitIdx == -1) { return NULL; } return uiDefIconBut(block, type | UI_BUT_POIN_BIT | bitIdx, retval, icon, x, y, width, height, poin, min, max, a1, a2, tip); } uiBut *uiDefIconButF(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconBut(block, type | UI_BUT_POIN_FLOAT, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButBitF(uiBlock *block, int type, int bit, int retval, int icon, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconButBit(block, type | UI_BUT_POIN_FLOAT, bit, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButI(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconBut(block, type | UI_BUT_POIN_INT, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButBitI(uiBlock *block, int type, int bit, int retval, int icon, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconButBit(block, type | UI_BUT_POIN_INT, bit, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButS(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconBut(block, type | UI_BUT_POIN_SHORT, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButBitS(uiBlock *block, int type, int bit, int retval, int icon, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconButBit(block, type | UI_BUT_POIN_SHORT, bit, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButC(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconBut(block, type | UI_BUT_POIN_CHAR, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButBitC(uiBlock *block, int type, int bit, int retval, int icon, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconButBit(block, type | UI_BUT_POIN_CHAR, bit, retval, icon, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconButR(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna_propname( block, type, retval, "", x, y, width, height, ptr, propname, index, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); return but; } uiBut *uiDefIconButR_prop(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna( block, type, retval, "", x, y, width, height, ptr, prop, index, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); return but; } uiBut *uiDefIconButO_ptr(uiBlock *block, int type, wmOperatorType *ot, int opcontext, int icon, int x, int y, short width, short height, const char *tip) { uiBut *but; but = ui_def_but_operator_ptr(block, type, ot, opcontext, "", x, y, width, height, tip); ui_but_update_and_icon_set(but, icon); return but; } uiBut *uiDefIconButO(uiBlock *block, int type, const char *opname, int opcontext, int icon, int x, int y, short width, short height, const char *tip) { wmOperatorType *ot = WM_operatortype_find(opname, 0); return uiDefIconButO_ptr(block, type, ot, opcontext, icon, x, y, width, height, tip); } /* Button containing both string label and icon */ uiBut *uiDefIconTextBut(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { uiBut *but = ui_def_but( block, type, retval, str, x, y, width, height, poin, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); but->drawflag |= UI_BUT_ICON_LEFT; return but; } static uiBut *uiDefIconTextButBit(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x, int y, short width, short height, void *poin, float min, float max, float a1, float a2, const char *tip) { int bitIdx = findBitIndex(bit); if (bitIdx == -1) { return NULL; } return uiDefIconTextBut(block, type | UI_BUT_POIN_BIT | bitIdx, retval, icon, str, x, y, width, height, poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButF(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextBut(block, type | UI_BUT_POIN_FLOAT, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButBitF(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x, int y, short width, short height, float *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextButBit(block, type | UI_BUT_POIN_FLOAT, bit, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButI(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextBut(block, type | UI_BUT_POIN_INT, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButBitI(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x, int y, short width, short height, int *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextButBit(block, type | UI_BUT_POIN_INT, bit, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButS(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextBut(block, type | UI_BUT_POIN_SHORT, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButBitS(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x, int y, short width, short height, short *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextButBit(block, type | UI_BUT_POIN_SHORT, bit, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButC(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextBut(block, type | UI_BUT_POIN_CHAR, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButBitC(uiBlock *block, int type, int bit, int retval, int icon, const char *str, int x, int y, short width, short height, char *poin, float min, float max, float a1, float a2, const char *tip) { return uiDefIconTextButBit(block, type | UI_BUT_POIN_CHAR, bit, retval, icon, str, x, y, width, height, (void *)poin, min, max, a1, a2, tip); } uiBut *uiDefIconTextButR(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna_propname( block, type, retval, str, x, y, width, height, ptr, propname, index, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); but->drawflag |= UI_BUT_ICON_LEFT; return but; } uiBut *uiDefIconTextButR_prop(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip) { uiBut *but; but = ui_def_but_rna( block, type, retval, str, x, y, width, height, ptr, prop, index, min, max, a1, a2, tip); ui_but_update_and_icon_set(but, icon); but->drawflag |= UI_BUT_ICON_LEFT; return but; } uiBut *uiDefIconTextButO_ptr(uiBlock *block, int type, wmOperatorType *ot, int opcontext, int icon, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but; but = ui_def_but_operator_ptr(block, type, ot, opcontext, str, x, y, width, height, tip); ui_but_update_and_icon_set(but, icon); but->drawflag |= UI_BUT_ICON_LEFT; return but; } uiBut *uiDefIconTextButO(uiBlock *block, int type, const char *opname, int opcontext, int icon, const char *str, int x, int y, short width, short height, const char *tip) { wmOperatorType *ot = WM_operatortype_find(opname, 0); if (str && str[0] == '\0') { return uiDefIconButO_ptr(block, type, ot, opcontext, icon, x, y, width, height, tip); } return uiDefIconTextButO_ptr(block, type, ot, opcontext, icon, str, x, y, width, height, tip); } /* END Button containing both string label and icon */ /* cruft to make uiBlock and uiBut private */ int UI_blocklist_min_y_get(ListBase *lb) { uiBlock *block; int min = 0; for (block = lb->first; block; block = block->next) { if (block == lb->first || block->rect.ymin < min) { min = block->rect.ymin; } } return min; } void UI_block_direction_set(uiBlock *block, char direction) { block->direction = direction; } /* this call escapes if there's alignment flags */ void UI_block_order_flip(uiBlock *block) { uiBut *but; float centy, miny = 10000, maxy = -10000; if (U.uiflag & USER_MENUFIXEDORDER) { return; } if (block->flag & UI_BLOCK_NO_FLIP) { return; } for (but = block->buttons.first; but; but = but->next) { if (but->drawflag & UI_BUT_ALIGN) { return; } if (but->rect.ymin < miny) { miny = but->rect.ymin; } if (but->rect.ymax > maxy) { maxy = but->rect.ymax; } } /* mirror trick */ centy = (miny + maxy) / 2.0f; for (but = block->buttons.first; but; but = but->next) { but->rect.ymin = centy - (but->rect.ymin - centy); but->rect.ymax = centy - (but->rect.ymax - centy); SWAP(float, but->rect.ymin, but->rect.ymax); } block->flag ^= UI_BLOCK_IS_FLIP; } void UI_block_flag_enable(uiBlock *block, int flag) { block->flag |= flag; } void UI_block_flag_disable(uiBlock *block, int flag) { block->flag &= ~flag; } void UI_but_flag_enable(uiBut *but, int flag) { but->flag |= flag; } void UI_but_flag_disable(uiBut *but, int flag) { but->flag &= ~flag; } bool UI_but_flag_is_set(uiBut *but, int flag) { return (but->flag & flag) != 0; } void UI_but_drawflag_enable(uiBut *but, int flag) { but->drawflag |= flag; } void UI_but_drawflag_disable(uiBut *but, int flag) { but->drawflag &= ~flag; } void UI_but_type_set_menu_from_pulldown(uiBut *but) { BLI_assert(but->type == UI_BTYPE_PULLDOWN); but->type = UI_BTYPE_MENU; UI_but_drawflag_disable(but, UI_BUT_TEXT_RIGHT); UI_but_drawflag_enable(but, UI_BUT_TEXT_LEFT); } int UI_but_return_value_get(uiBut *but) { return but->retval; } void UI_but_drag_set_id(uiBut *but, ID *id) { but->dragtype = WM_DRAG_ID; if ((but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_SAFE_FREE(but->dragpoin); but->dragflag &= ~UI_BUT_DRAGPOIN_FREE; } but->dragpoin = (void *)id; } void UI_but_drag_set_rna(uiBut *but, PointerRNA *ptr) { but->dragtype = WM_DRAG_RNA; if ((but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_SAFE_FREE(but->dragpoin); but->dragflag &= ~UI_BUT_DRAGPOIN_FREE; } but->dragpoin = (void *)ptr; } void UI_but_drag_set_path(uiBut *but, const char *path, const bool use_free) { but->dragtype = WM_DRAG_PATH; if ((but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_SAFE_FREE(but->dragpoin); but->dragflag &= ~UI_BUT_DRAGPOIN_FREE; } but->dragpoin = (void *)path; if (use_free) { but->dragflag |= UI_BUT_DRAGPOIN_FREE; } } void UI_but_drag_set_name(uiBut *but, const char *name) { but->dragtype = WM_DRAG_NAME; if ((but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_SAFE_FREE(but->dragpoin); but->dragflag &= ~UI_BUT_DRAGPOIN_FREE; } but->dragpoin = (void *)name; } /* value from button itself */ void UI_but_drag_set_value(uiBut *but) { but->dragtype = WM_DRAG_VALUE; } void UI_but_drag_set_image( uiBut *but, const char *path, int icon, struct ImBuf *imb, float scale, const bool use_free) { but->dragtype = WM_DRAG_PATH; ui_def_but_icon(but, icon, 0); /* no flag UI_HAS_ICON, so icon doesn't draw in button */ if ((but->dragflag & UI_BUT_DRAGPOIN_FREE)) { MEM_SAFE_FREE(but->dragpoin); but->dragflag &= ~UI_BUT_DRAGPOIN_FREE; } but->dragpoin = (void *)path; if (use_free) { but->dragflag |= UI_BUT_DRAGPOIN_FREE; } but->imb = imb; but->imb_scale = scale; } PointerRNA *UI_but_operator_ptr_get(uiBut *but) { if (but->optype && !but->opptr) { but->opptr = MEM_callocN(sizeof(PointerRNA), "uiButOpPtr"); WM_operator_properties_create_ptr(but->opptr, but->optype); } return but->opptr; } void UI_but_unit_type_set(uiBut *but, const int unit_type) { but->unit_type = (uchar)(RNA_SUBTYPE_UNIT_VALUE(unit_type)); } int UI_but_unit_type_get(const uiBut *but) { int ownUnit = (int)but->unit_type; /* own unit define always takes precedence over RNA provided, allowing for overriding * default value provided in RNA in a few special cases (i.e. Active Keyframe in Graph Edit) */ /* XXX: this doesn't allow clearing unit completely, though the same could be said for icons */ if ((ownUnit != 0) || (but->rnaprop == NULL)) { return ownUnit << 16; } return RNA_SUBTYPE_UNIT(RNA_property_subtype(but->rnaprop)); } void UI_block_func_handle_set(uiBlock *block, uiBlockHandleFunc func, void *arg) { block->handle_func = func; block->handle_func_arg = arg; } void UI_block_func_butmenu_set(uiBlock *block, uiMenuHandleFunc func, void *arg) { block->butm_func = func; block->butm_func_arg = arg; } void UI_block_func_set(uiBlock *block, uiButHandleFunc func, void *arg1, void *arg2) { block->func = func; block->func_arg1 = arg1; block->func_arg2 = arg2; } void UI_block_funcN_set(uiBlock *block, uiButHandleNFunc funcN, void *argN, void *arg2) { if (block->func_argN) { MEM_freeN(block->func_argN); } block->funcN = funcN; block->func_argN = argN; block->func_arg2 = arg2; } void UI_but_func_rename_set(uiBut *but, uiButHandleRenameFunc func, void *arg1) { but->rename_func = func; but->rename_arg1 = arg1; } void UI_but_func_drawextra_set( uiBlock *block, void (*func)(const bContext *C, void *idv, void *arg1, void *arg2, rcti *rect), void *arg1, void *arg2) { block->drawextra = func; block->drawextra_arg1 = arg1; block->drawextra_arg2 = arg2; } void UI_but_func_set(uiBut *but, uiButHandleFunc func, void *arg1, void *arg2) { but->func = func; but->func_arg1 = arg1; but->func_arg2 = arg2; } void UI_but_funcN_set(uiBut *but, uiButHandleNFunc funcN, void *argN, void *arg2) { if (but->func_argN) { MEM_freeN(but->func_argN); } but->funcN = funcN; but->func_argN = argN; but->func_arg2 = arg2; } void UI_but_func_complete_set(uiBut *but, uiButCompleteFunc func, void *arg) { but->autocomplete_func = func; but->autofunc_arg = arg; } void UI_but_func_menu_step_set(uiBut *but, uiMenuStepFunc func) { but->menu_step_func = func; } void UI_but_func_tooltip_set(uiBut *but, uiButToolTipFunc func, void *argN) { but->tip_func = func; if (but->tip_argN) { MEM_freeN(but->tip_argN); } but->tip_argN = argN; } void UI_but_func_pushed_state_set(uiBut *but, uiButPushedStateFunc func, void *arg) { but->pushed_state_func = func; but->pushed_state_arg = arg; } uiBut *uiDefBlockBut(uiBlock *block, uiBlockCreateFunc func, void *arg, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_BLOCK, 0, str, x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); but->block_create_func = func; ui_but_update(but); return but; } uiBut *uiDefBlockButN(uiBlock *block, uiBlockCreateFunc func, void *argN, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_BLOCK, 0, str, x, y, width, height, NULL, 0.0, 0.0, 0.0, 0.0, tip); but->block_create_func = func; if (but->func_argN) { MEM_freeN(but->func_argN); } but->func_argN = argN; ui_but_update(but); return but; } uiBut *uiDefPulldownBut(uiBlock *block, uiBlockCreateFunc func, void *arg, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_PULLDOWN, 0, str, x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); but->block_create_func = func; ui_but_update(but); return but; } uiBut *uiDefMenuBut(uiBlock *block, uiMenuCreateFunc func, void *arg, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_PULLDOWN, 0, str, x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); but->menu_create_func = func; ui_but_update(but); return but; } uiBut *uiDefIconTextMenuBut(uiBlock *block, uiMenuCreateFunc func, void *arg, int icon, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_PULLDOWN, 0, str, x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); ui_def_but_icon(but, icon, UI_HAS_ICON); but->drawflag |= UI_BUT_ICON_LEFT; ui_but_submenu_enable(block, but); but->menu_create_func = func; ui_but_update(but); return but; } uiBut *uiDefIconMenuBut(uiBlock *block, uiMenuCreateFunc func, void *arg, int icon, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_PULLDOWN, 0, "", x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); ui_def_but_icon(but, icon, UI_HAS_ICON); but->drawflag &= ~UI_BUT_ICON_LEFT; but->menu_create_func = func; ui_but_update(but); return but; } /* Block button containing both string label and icon */ uiBut *uiDefIconTextBlockBut(uiBlock *block, uiBlockCreateFunc func, void *arg, int icon, const char *str, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_BLOCK, 0, str, x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); /* XXX temp, old menu calls pass on icon arrow, which is now UI_BUT_ICON_SUBMENU flag */ if (icon != ICON_RIGHTARROW_THIN) { ui_def_but_icon(but, icon, 0); but->drawflag |= UI_BUT_ICON_LEFT; } but->flag |= UI_HAS_ICON; ui_but_submenu_enable(block, but); but->block_create_func = func; ui_but_update(but); return but; } /* Block button containing icon */ uiBut *uiDefIconBlockBut(uiBlock *block, uiBlockCreateFunc func, void *arg, int retval, int icon, int x, int y, short width, short height, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_BLOCK, retval, "", x, y, width, height, arg, 0.0, 0.0, 0.0, 0.0, tip); ui_def_but_icon(but, icon, UI_HAS_ICON); but->drawflag |= UI_BUT_ICON_LEFT; but->block_create_func = func; ui_but_update(but); return but; } uiBut *uiDefKeyevtButS(uiBlock *block, int retval, const char *str, int x, int y, short width, short height, short *spoin, const char *tip) { uiBut *but = ui_def_but(block, UI_BTYPE_KEY_EVENT | UI_BUT_POIN_SHORT, retval, str, x, y, width, height, spoin, 0.0, 0.0, 0.0, 0.0, tip); ui_but_update(but); return but; } /* short pointers hardcoded */ /* modkeypoin will be set to KM_SHIFT, KM_ALT, KM_CTRL, KM_OSKEY bits */ uiBut *uiDefHotKeyevtButS(uiBlock *block, int retval, const char *str, int x, int y, short width, short height, short *keypoin, const short *modkeypoin, const char *tip) { uiBut *but = ui_def_but(block, UI_BTYPE_HOTKEY_EVENT | UI_BUT_POIN_SHORT, retval, str, x, y, width, height, keypoin, 0.0, 0.0, 0.0, 0.0, tip); but->modifier_key = *modkeypoin; ui_but_update(but); return but; } /* arg is pointer to string/name, use UI_but_func_search_set() below to make this work */ /* here a1 and a2, if set, control thumbnail preview rows/cols */ uiBut *uiDefSearchBut(uiBlock *block, void *arg, int retval, int icon, int maxlen, int x, int y, short width, short height, float a1, float a2, const char *tip) { uiBut *but = ui_def_but( block, UI_BTYPE_SEARCH_MENU, retval, "", x, y, width, height, arg, 0.0, maxlen, a1, a2, tip); ui_def_but_icon(but, icon, UI_HAS_ICON); but->drawflag |= UI_BUT_ICON_LEFT | UI_BUT_TEXT_LEFT; ui_but_update(but); return but; } /** * \note The item-pointer (referred to below) is a per search item user pointer * passed to #UI_search_item_add (stored in #uiSearchItems.pointers). * * \param search_create_fn: Function to create the menu. * \param search_update_fn: Function to refresh search content after the search text has changed. * \param arg: user value. * \param search_arg_free_fn: When non-null, use this function to free \a arg. * \param search_exec_fn: Function that executes the action, gets \a arg as the first argument. * The second argument as the active item-pointer * \param active: When non-null, this item-pointer item will be visible and selected, * otherwise the first item will be selected. */ void UI_but_func_search_set(uiBut *but, uiButSearchCreateFn search_create_fn, uiButSearchUpdateFn search_update_fn, void *arg, uiButSearchArgFreeFn search_arg_free_fn, uiButHandleFunc search_exec_fn, void *active) { uiButSearch *search_but = (uiButSearch *)but; BLI_assert(but->type == UI_BTYPE_SEARCH_MENU); /* needed since callers don't have access to internal functions * (as an alternative we could expose it) */ if (search_create_fn == NULL) { search_create_fn = ui_searchbox_create_generic; } if (search_but->arg_free_fn != NULL) { search_but->arg_free_fn(search_but->arg); search_but->arg = NULL; } search_but->popup_create_fn = search_create_fn; search_but->items_update_fn = search_update_fn; search_but->item_active = active; search_but->arg = arg; search_but->arg_free_fn = search_arg_free_fn; if (search_exec_fn) { #ifdef DEBUG if (search_but->but.func) { /* watch this, can be cause of much confusion, see: T47691 */ printf("%s: warning, overwriting button callback with search function callback!\n", __func__); } #endif /* Handling will pass the active item as arg2 later, so keep it NULL here. */ UI_but_func_set(but, search_exec_fn, search_but->arg, NULL); } /* search buttons show red-alert if item doesn't exist, not for menus */ if (0 == (but->block->flag & UI_BLOCK_LOOP)) { /* skip empty buttons, not all buttons need input, we only show invalid */ if (but->drawstr[0]) { ui_but_search_refresh(search_but); } } } void UI_but_func_search_set_context_menu(uiBut *but, uiButSearchContextMenuFn context_menu_fn) { uiButSearch *but_search = (uiButSearch *)but; BLI_assert(but->type == UI_BTYPE_SEARCH_MENU); but_search->item_context_menu_fn = context_menu_fn; } /** * \param search_sep_string: when not NULL, this string is used as a separator, * showing the icon and highlighted text after the last instance of this string. */ void UI_but_func_search_set_sep_string(uiBut *but, const char *search_sep_string) { uiButSearch *but_search = (uiButSearch *)but; BLI_assert(but->type == UI_BTYPE_SEARCH_MENU); but_search->item_sep_string = search_sep_string; } void UI_but_func_search_set_tooltip(uiBut *but, uiButSearchTooltipFn tooltip_fn) { uiButSearch *but_search = (uiButSearch *)but; BLI_assert(but->type == UI_BTYPE_SEARCH_MENU); but_search->item_tooltip_fn = tooltip_fn; } /* Callbacks for operator search button. */ static void operator_enum_search_update_fn(const struct bContext *C, void *but, const char *str, uiSearchItems *items) { wmOperatorType *ot = ((uiBut *)but)->optype; PropertyRNA *prop = ot->prop; if (prop == NULL) { printf("%s: %s has no enum property set\n", __func__, ot->idname); } else if (RNA_property_type(prop) != PROP_ENUM) { printf("%s: %s \"%s\" is not an enum property\n", __func__, ot->idname, RNA_property_identifier(prop)); } else { PointerRNA *ptr = UI_but_operator_ptr_get(but); /* Will create it if needed! */ const EnumPropertyItem *item, *item_array; bool do_free; RNA_property_enum_items_gettexted((bContext *)C, ptr, prop, &item_array, NULL, &do_free); for (item = item_array; item->identifier; item++) { /* note: need to give the index rather than the * identifier because the enum can be freed */ if (BLI_strcasestr(item->name, str)) { if (!UI_search_item_add( items, item->name, POINTER_FROM_INT(item->value), item->icon, 0, 0)) { break; } } } if (do_free) { MEM_freeN((void *)item_array); } } } static void operator_enum_search_exec_fn(struct bContext *UNUSED(C), void *but, void *arg2) { wmOperatorType *ot = ((uiBut *)but)->optype; PointerRNA *opptr = UI_but_operator_ptr_get(but); /* Will create it if needed! */ if (ot) { if (ot->prop) { RNA_property_enum_set(opptr, ot->prop, POINTER_AS_INT(arg2)); /* We do not call op from here, will be called by button code. * ui_apply_but_funcs_after() (in interface_handlers.c) * called this func before checking operators, * because one of its parameters is the button itself! */ } else { printf("%s: op->prop for '%s' is NULL\n", __func__, ot->idname); } } } /** * Same parameters as for uiDefSearchBut, with additional operator type and properties, * used by callback to call again the right op with the right options (properties values). */ uiBut *uiDefSearchButO_ptr(uiBlock *block, wmOperatorType *ot, IDProperty *properties, void *arg, int retval, int icon, int maxlen, int x, int y, short width, short height, float a1, float a2, const char *tip) { uiBut *but; but = uiDefSearchBut(block, arg, retval, icon, maxlen, x, y, width, height, a1, a2, tip); UI_but_func_search_set(but, ui_searchbox_create_generic, operator_enum_search_update_fn, but, NULL, operator_enum_search_exec_fn, NULL); but->optype = ot; but->opcontext = WM_OP_EXEC_DEFAULT; if (properties) { PointerRNA *ptr = UI_but_operator_ptr_get(but); /* Copy idproperties. */ ptr->data = IDP_CopyProperty(properties); } return but; } void UI_but_node_link_set(uiBut *but, bNodeSocket *socket, const float draw_color[4]) { but->flag |= UI_BUT_NODE_LINK; but->custom_data = socket; rgba_float_to_uchar(but->col, draw_color); } /** * push a new event onto event queue to activate the given button * (usually a text-field) upon entering a popup */ void UI_but_focus_on_enter_event(wmWindow *win, uiBut *but) { wmEvent event; wm_event_init_from_window(win, &event); event.type = EVT_BUT_OPEN; event.val = KM_PRESS; event.customdata = but; event.customdatafree = false; wm_event_add(win, &event); } void UI_but_func_hold_set(uiBut *but, uiButHandleHoldFunc func, void *argN) { but->hold_func = func; but->hold_argN = argN; } void UI_but_string_info_get(bContext *C, uiBut *but, ...) { va_list args; uiStringInfo *si; const EnumPropertyItem *items = NULL, *item = NULL; int totitems; bool free_items = false; va_start(args, but); while ((si = (uiStringInfo *)va_arg(args, void *))) { int type = si->type; char *tmp = NULL; if (type == BUT_GET_LABEL) { if (but->str && but->str[0]) { const char *str_sep; size_t str_len; if ((but->flag & UI_BUT_HAS_SEP_CHAR) && (str_sep = strrchr(but->str, UI_SEP_CHAR))) { str_len = (str_sep - but->str); } else { str_len = strlen(but->str); } tmp = BLI_strdupn(but->str, str_len); } else { type = BUT_GET_RNA_LABEL; /* Fail-safe solution... */ } } else if (type == BUT_GET_TIP) { if (but->tip_func) { tmp = but->tip_func(C, but->tip_argN, but->tip); } else if (but->tip && but->tip[0]) { tmp = BLI_strdup(but->tip); } else if (but->optype && but->optype->get_description) { tmp = WM_operatortype_description(C, but->optype, but->opptr); } else { type = BUT_GET_RNA_TIP; /* Fail-safe solution... */ } } if (type == BUT_GET_RNAPROP_IDENTIFIER) { if (but->rnaprop) { tmp = BLI_strdup(RNA_property_identifier(but->rnaprop)); } } else if (type == BUT_GET_RNASTRUCT_IDENTIFIER) { if (but->rnaprop && but->rnapoin.data) { tmp = BLI_strdup(RNA_struct_identifier(but->rnapoin.type)); } else if (but->optype) { tmp = BLI_strdup(but->optype->idname); } else if (ELEM(but->type, UI_BTYPE_MENU, UI_BTYPE_PULLDOWN)) { MenuType *mt = UI_but_menutype_get(but); if (mt) { tmp = BLI_strdup(mt->idname); } } else if (but->type == UI_BTYPE_POPOVER) { PanelType *pt = UI_but_paneltype_get(but); if (pt) { tmp = BLI_strdup(pt->idname); } } } else if (ELEM(type, BUT_GET_RNA_LABEL, BUT_GET_RNA_TIP)) { if (but->rnaprop) { if (type == BUT_GET_RNA_LABEL) { tmp = BLI_strdup(RNA_property_ui_name(but->rnaprop)); } else { const char *t = RNA_property_ui_description(but->rnaprop); if (t && t[0]) { tmp = BLI_strdup(t); } } } else if (but->optype) { if (type == BUT_GET_RNA_LABEL) { tmp = BLI_strdup(WM_operatortype_name(but->optype, NULL)); } else { const char *t = RNA_struct_ui_description(but->optype->srna); if (t && t[0]) { tmp = BLI_strdup(t); } } } else if (ELEM(but->type, UI_BTYPE_MENU, UI_BTYPE_PULLDOWN, UI_BTYPE_POPOVER)) { { MenuType *mt = UI_but_menutype_get(but); if (mt) { if (type == BUT_GET_RNA_LABEL) { tmp = BLI_strdup(mt->label); } else { /* Not all menus are from Python. */ if (mt->rna_ext.srna) { const char *t = RNA_struct_ui_description(mt->rna_ext.srna); if (t && t[0]) { tmp = BLI_strdup(t); } } } } } if (tmp == NULL) { PanelType *pt = UI_but_paneltype_get(but); if (pt) { if (type == BUT_GET_RNA_LABEL) { tmp = BLI_strdup(pt->label); } else { /* Not all panels are from Python. */ if (pt->rna_ext.srna) { /* Panels don't yet have descriptions, this may be added. */ } } } } } } else if (type == BUT_GET_RNA_LABEL_CONTEXT) { const char *_tmp = BLT_I18NCONTEXT_DEFAULT; if (but->rnaprop) { _tmp = RNA_property_translation_context(but->rnaprop); } else if (but->optype) { _tmp = RNA_struct_translation_context(but->optype->srna); } else if (ELEM(but->type, UI_BTYPE_MENU, UI_BTYPE_PULLDOWN)) { MenuType *mt = UI_but_menutype_get(but); if (mt) { _tmp = RNA_struct_translation_context(mt->rna_ext.srna); } } if (BLT_is_default_context(_tmp)) { _tmp = BLT_I18NCONTEXT_DEFAULT_BPYRNA; } tmp = BLI_strdup(_tmp); } else if (ELEM(type, BUT_GET_RNAENUM_IDENTIFIER, BUT_GET_RNAENUM_LABEL, BUT_GET_RNAENUM_TIP)) { PointerRNA *ptr = NULL; PropertyRNA *prop = NULL; int value = 0; /* get the enum property... */ if (but->rnaprop && RNA_property_type(but->rnaprop) == PROP_ENUM) { /* enum property */ ptr = &but->rnapoin; prop = but->rnaprop; value = (ELEM(but->type, UI_BTYPE_ROW, UI_BTYPE_TAB)) ? (int)but->hardmax : (int)ui_but_value_get(but); } else if (but->optype) { PointerRNA *opptr = UI_but_operator_ptr_get(but); wmOperatorType *ot = but->optype; /* so the context is passed to itemf functions */ WM_operator_properties_sanitize(opptr, false); /* if the default property of the operator is enum and it is set, * fetch the tooltip of the selected value so that "Snap" and "Mirror" * operator menus in the Anim Editors will show tooltips for the different * operations instead of the meaningless generic operator tooltip */ if (ot->prop && RNA_property_type(ot->prop) == PROP_ENUM) { if (RNA_struct_contains_property(opptr, ot->prop)) { ptr = opptr; prop = ot->prop; value = RNA_property_enum_get(opptr, ot->prop); } } } /* get strings from matching enum item */ if (ptr && prop) { if (!item) { int i; RNA_property_enum_items_gettexted(C, ptr, prop, &items, &totitems, &free_items); for (i = 0, item = items; i < totitems; i++, item++) { if (item->identifier[0] && item->value == value) { break; } } } if (item && item->identifier) { if (type == BUT_GET_RNAENUM_IDENTIFIER) { tmp = BLI_strdup(item->identifier); } else if (type == BUT_GET_RNAENUM_LABEL) { tmp = BLI_strdup(item->name); } else if (item->description && item->description[0]) { tmp = BLI_strdup(item->description); } } } } else if (type == BUT_GET_OP_KEYMAP) { if (!ui_block_is_menu(but->block)) { char buf[128]; if (ui_but_event_operator_string(C, but, buf, sizeof(buf))) { tmp = BLI_strdup(buf); } } } else if (type == BUT_GET_PROP_KEYMAP) { /* for properties that are bound to one of the context cycle, etc. keys... */ char buf[128]; if (ui_but_event_property_operator_string(C, but, buf, sizeof(buf))) { tmp = BLI_strdup(buf); } } si->strinfo = tmp; } va_end(args); if (free_items && items) { MEM_freeN((void *)items); } } /* Program Init/Exit */ void UI_init(void) { ui_resources_init(); } /* after reading userdef file */ void UI_init_userdef(Main *bmain) { /* fix saved themes */ init_userdef_do_versions(bmain); uiStyleInit(); } void UI_reinit_font(void) { uiStyleInit(); } void UI_exit(void) { ui_resources_free(); ui_but_clipboard_free(); } void UI_interface_tag_script_reload(void) { ui_interface_tag_script_reload_queries(); }