/* * 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 blender/editors/interface/interface_intern.h * \ingroup edinterface */ #ifndef __INTERFACE_INTERN_H__ #define __INTERFACE_INTERN_H__ #include "BLI_compiler_attrs.h" #include "UI_resources.h" #include "RNA_types.h" #include "DNA_listBase.h" struct ARegion; struct ID; struct ImBuf; struct Scene; struct bContext; struct bContextStore; struct uiHandleButtonData; struct uiLayout; struct uiStyle; struct uiWidgetColors; struct wmEvent; struct wmKeyConfig; struct wmOperatorType; struct wmTimer; /* ****************** general defines ************** */ #define RNA_NO_INDEX -1 #define RNA_ENUM_VALUE -2 /* visual types for drawing */ /* for time being separated from functional types */ typedef enum { /* default */ UI_WTYPE_REGULAR, /* standard set */ UI_WTYPE_LABEL, UI_WTYPE_TOGGLE, UI_WTYPE_CHECKBOX, UI_WTYPE_RADIO, UI_WTYPE_NUMBER, UI_WTYPE_SLIDER, UI_WTYPE_EXEC, UI_WTYPE_TOOLBAR_ITEM, UI_WTYPE_TAB, UI_WTYPE_TOOLTIP, /* strings */ UI_WTYPE_NAME, UI_WTYPE_NAME_LINK, UI_WTYPE_POINTER_LINK, UI_WTYPE_FILENAME, /* menus */ UI_WTYPE_MENU_RADIO, UI_WTYPE_MENU_ICON_RADIO, UI_WTYPE_MENU_POINTER_LINK, UI_WTYPE_MENU_NODE_LINK, UI_WTYPE_PULLDOWN, UI_WTYPE_MENU_ITEM, UI_WTYPE_MENU_ITEM_RADIAL, UI_WTYPE_MENU_BACK, /* specials */ UI_WTYPE_ICON, UI_WTYPE_ICON_LABEL, UI_WTYPE_SWATCH, UI_WTYPE_RGB_PICKER, UI_WTYPE_UNITVEC, UI_WTYPE_BOX, UI_WTYPE_SCROLL, UI_WTYPE_LISTITEM, UI_WTYPE_PROGRESSBAR, } uiWidgetTypeEnum; #define UI_MENU_WIDTH_MIN (UI_UNIT_Y * 9) /* some extra padding added to menus containing submenu icons */ #define UI_MENU_SUBMENU_PADDING (6 * UI_DPI_FAC) /* menu scrolling */ #define UI_MENU_SCROLL_ARROW 12 #define UI_MENU_SCROLL_MOUSE (UI_MENU_SCROLL_ARROW + 2) #define UI_MENU_SCROLL_PAD 4 /* panel limits */ #define UI_PANEL_MINX 100 #define UI_PANEL_MINY 70 /* popover width (multiplied by 'U.widget_unit') */ #define UI_POPOVER_WIDTH_UNITS 10 /* uiBut->flag */ enum { UI_SELECT = (1 << 0), /* use when the button is pressed */ UI_SCROLLED = (1 << 1), /* temp hidden, scrolled away */ UI_ACTIVE = (1 << 2), UI_HAS_ICON = (1 << 3), UI_HIDDEN = (1 << 4), UI_SELECT_DRAW = (1 << 5), /* Display selected, doesn't impact interaction. */ /* warn: rest of uiBut->flag in UI_interface.h */ }; /* some buttons display icons only under special conditions * (e.g. 'x' icon in search menu) - used with ui_but_icon_extra_get */ typedef enum uiButExtraIconType { UI_BUT_ICONEXTRA_NONE = 1, UI_BUT_ICONEXTRA_CLEAR, UI_BUT_ICONEXTRA_EYEDROPPER, } uiButExtraIconType; /* uiBut->dragflag */ enum { UI_BUT_DRAGPOIN_FREE = (1 << 0), }; /* but->pie_dir */ typedef enum RadialDirection { UI_RADIAL_NONE = -1, UI_RADIAL_N = 0, UI_RADIAL_NE = 1, UI_RADIAL_E = 2, UI_RADIAL_SE = 3, UI_RADIAL_S = 4, UI_RADIAL_SW = 5, UI_RADIAL_W = 6, UI_RADIAL_NW = 7, } RadialDirection; extern const char ui_radial_dir_order[8]; extern const char ui_radial_dir_to_numpad[8]; extern const short ui_radial_dir_to_angle[8]; /* internal panel drawing defines */ #define PNL_GRID (UI_UNIT_Y / 5) /* 4 default */ #define PNL_HEADER (UI_UNIT_Y * 1.2) /* 24 default */ /* bit button defines */ /* Bit operations */ #define UI_BITBUT_TEST(a, b) ( ( (a) & 1 << (b) ) != 0) #define UI_BITBUT_SET(a, b) ( (a) | 1 << (b) ) #define UI_BITBUT_CLR(a, b) ( (a) & ~(1 << (b)) ) /* bit-row */ #define UI_BITBUT_ROW(min, max) (((max) >= 31 ? 0xFFFFFFFF : (1 << ((max) + 1)) - 1) - ((min) ? ((1 << (min)) - 1) : 0) ) /* split numbuts by ':' and align l/r */ #define USE_NUMBUTS_LR_ALIGN /* Use new 'align' computation code. */ #define USE_UIBUT_SPATIAL_ALIGN /* PieMenuData->flags */ enum { /** pie menu item collision is detected at 90 degrees */ UI_PIE_DEGREES_RANGE_LARGE = (1 << 0), /** use initial center of pie menu to calculate direction */ UI_PIE_INITIAL_DIRECTION = (1 << 1), /** pie menu is drag style */ UI_PIE_DRAG_STYLE = (1 << 2), /** mouse not far enough from center position */ UI_PIE_INVALID_DIR = (1 << 3), /** pie menu changed to click style, click to confirm */ UI_PIE_CLICK_STYLE = (1 << 4), /** pie animation finished, do not calculate any more motion */ UI_PIE_ANIMATION_FINISHED = (1 << 5), /** pie gesture selection has been done, now wait for mouse motion to end */ UI_PIE_GESTURE_END_WAIT = (1 << 6), }; #define PIE_CLICK_THRESHOLD_SQ 50.0f /* max amount of items a radial menu (pie menu) can contain */ #define PIE_MAX_ITEMS 8 struct uiBut { struct uiBut *next, *prev; int flag, drawflag; eButType type; eButPointerType pointype; short bit, bitnr, retval, strwidth, alignnr; short ofs, pos, selsta, selend; char *str; char strdata[UI_MAX_NAME_STR]; char drawstr[UI_MAX_DRAW_STR]; rctf rect; /* block relative coords */ char *poin; float hardmin, hardmax, softmin, softmax; /* both these values use depends on the button type * (polymorphic struct or union would be nicer for this stuff) */ /* (type == UI_BTYPE_HSVCUBE), Use UI_GRAD_* values. * (type == UI_BTYPE_NUM), Use to store RNA 'step' value, for dragging and click-step. * (type == UI_BTYPE_LABEL), Use (a1 == 1.0f) to use a2 as a blending factor (wow, this is imaginative!). * (type == UI_BTYPE_SCROLL) Use as scroll size. * (type == UI_BTYPE_SEARCH_MENU) Use as number or rows. * (type == UI_BTYPE_COLOR) Use as indication of color palette * (type == UI_BTYPE_PROGRESS_BAR) Use to store progress (0..1). */ float a1; /* (type == UI_BTYPE_HSVCIRCLE ), Use to store the luminosity. * (type == UI_BTYPE_NUM), Use to store RNA 'precision' value, for dragging and click-step. * (type == UI_BTYPE_LABEL), If (a1 == 1.0f) use a2 as a blending factor. * (type == UI_BTYPE_SEARCH_MENU) Use as number or columns. * (type == UI_BTYPE_COLOR) Use as index in palette (not so good, needs refactor) */ float a2; uchar col[4]; uiButHandleFunc func; void *func_arg1; void *func_arg2; uiButHandleNFunc funcN; void *func_argN; struct bContextStore *context; uiButCompleteFunc autocomplete_func; void *autofunc_arg; uiButSearchCreateFunc search_create_func; uiButSearchFunc search_func; bool free_search_arg; void *search_arg; uiButHandleRenameFunc rename_func; void *rename_arg1; void *rename_orig; /** Run an action when holding the button down. */ uiButHandleHoldFunc hold_func; void *hold_argN; const char *tip; uiButToolTipFunc tip_func; void *tip_argN; /** info on why button is disabled, displayed in tooltip */ const char *disabled_info; BIFIconID icon; /** drawtype: UI_EMBOSS, UI_EMBOSS_NONE ... etc, copied from the block */ char dt; /** direction in a pie menu, used for collision detection (RadialDirection) */ signed char pie_dir; /** could be made into a single flag */ bool changed; /** so buttons can support unit systems which are not RNA */ uchar unit_type; short modifier_key; short iconadd; /* UI_BTYPE_BLOCK data */ uiBlockCreateFunc block_create_func; /* UI_BTYPE_PULLDOWN/UI_BTYPE_MENU data */ uiMenuCreateFunc menu_create_func; uiMenuStepFunc menu_step_func; /* RNA data */ struct PointerRNA rnapoin; struct PropertyRNA *rnaprop; int rnaindex; struct PointerRNA rnasearchpoin; struct PropertyRNA *rnasearchprop; /* Operator data */ struct wmOperatorType *optype; struct PointerRNA *opptr; short opcontext; uchar menu_key; /* 'a'-'z', always lower case */ /* Draggable data, type is WM_DRAG_... */ char dragtype; short dragflag; void *dragpoin; struct ImBuf *imb; float imb_scale; /* active button data */ struct uiHandleButtonData *active; /* Custom button data. */ void *custom_data; char *editstr; double *editval; float *editvec; void *editcoba; void *editcumap; /* pointer back */ uiBlock *block; }; typedef struct uiButTab { uiBut but; struct MenuType *menu; } uiButTab; typedef struct ColorPicker { struct ColorPicker *next, *prev; /** Color data, may be HSV or HSL. */ float color_data[3]; /** Initial color data (detect changes). */ float color_data_init[3]; bool is_init; } ColorPicker; typedef struct ColorPickerData { ListBase list; } ColorPickerData; struct PieMenuData { /** store title and icon to allow access when pie levels are created */ const char *title; int icon; float pie_dir[2]; float pie_center_init[2]; float pie_center_spawned[2]; float last_pos[2]; double duration_gesture; int flags; /** initial event used to fire the pie menu, store here so we can query for release */ int event; float alphafac; }; /* uiBlock.content_hints */ enum eBlockContentHints { /** In a menu block, if there is a single sub-menu button, we add some * padding to the right to put nicely aligned triangle icons there. */ UI_BLOCK_CONTAINS_SUBMENU_BUT = (1 << 0), }; struct uiBlock { uiBlock *next, *prev; ListBase buttons; Panel *panel; uiBlock *oldblock; ListBase butstore; /* UI_butstore_* runtime function */ ListBase layouts; struct uiLayout *curlayout; ListBase contexts; char name[UI_MAX_NAME_STR]; float winmat[4][4]; rctf rect; float aspect; uint puphash; /* popup menu hash for memory */ uiButHandleFunc func; void *func_arg1; void *func_arg2; uiButHandleNFunc funcN; void *func_argN; uiMenuHandleFunc butm_func; void *butm_func_arg; uiBlockHandleFunc handle_func; void *handle_func_arg; /* custom extra handling */ int (*block_event_func)(const struct bContext *C, struct uiBlock *, const struct wmEvent *); /* extra draw function for custom blocks */ void (*drawextra)(const struct bContext *C, void *idv, void *arg1, void *arg2, rcti *rect); void *drawextra_arg1; void *drawextra_arg2; int flag; short alignnr; /** Hints about the buttons of this block. Used to avoid iterating over * buttons to find out if some criteria is met by any. Instead, check this * criteria when adding the button and set a flag here if it's met. */ short content_hints; /* eBlockContentHints */ char direction; /** UI_BLOCK_THEME_STYLE_* */ char theme_style; /** drawtype: UI_EMBOSS, UI_EMBOSS_NONE ... etc, copied to buttons */ char dt; bool auto_open; char _pad[5]; double auto_open_last; const char *lockstr; char lock; /** to keep blocks while drawing and free them afterwards */ char active; /** to avoid tooltip after click */ char tooltipdisabled; /** UI_block_end done? */ char endblock; /** for doing delayed */ eBlockBoundsCalc bounds_type; int mx, my; /** for doing delayed */ int bounds, minbounds; /** pulldowns, to detect outside, can differ per case how it is created */ rctf safety; /** uiSafetyRct list */ ListBase saferct; uiPopupBlockHandle *handle; /* handle */ /** use so presets can find the operator, * across menus and from nested popups which fail for operator context. */ struct wmOperator *ui_operator; /** XXX hack for dynamic operator enums */ void *evil_C; /** unit system, used a lot for numeric buttons so include here * rather then fetching through the scene every time. */ struct UnitSettings *unit; /** \note only accessed by color picker templates. */ ColorPickerData color_pickers; bool is_color_gamma_picker; /* Block for color picker with gamma baked in. */ /** display device name used to display this block, * used by color widgets to transform colors from/to scene linear */ char display_device[64]; struct PieMenuData pie_data; }; typedef struct uiSafetyRct { struct uiSafetyRct *next, *prev; rctf parent; rctf safety; } uiSafetyRct; /* interface.c */ void ui_fontscale(short *points, float aspect); extern void ui_block_to_window_fl(const struct ARegion *ar, uiBlock *block, float *x, float *y); extern void ui_block_to_window(const struct ARegion *ar, uiBlock *block, int *x, int *y); extern void ui_block_to_window_rctf(const struct ARegion *ar, uiBlock *block, rctf *rct_dst, const rctf *rct_src); extern void ui_window_to_block_fl(const struct ARegion *ar, uiBlock *block, float *x, float *y); extern void ui_window_to_block(const struct ARegion *ar, uiBlock *block, int *x, int *y); extern void ui_window_to_region(const ARegion *ar, int *x, int *y); extern void ui_region_to_window(const struct ARegion *ar, int *x, int *y); extern void ui_region_winrct_get_no_margin(const struct ARegion *ar, struct rcti *r_rect); extern double ui_but_value_get(uiBut *but); extern void ui_but_value_set(uiBut *but, double value); extern void ui_but_hsv_set(uiBut *but); extern void ui_but_v3_get(uiBut *but, float vec[3]); extern void ui_but_v3_set(uiBut *but, const float vec[3]); extern void ui_hsvcircle_vals_from_pos( float *val_rad, float *val_dist, const rcti *rect, const float mx, const float my); extern void ui_hsvcircle_pos_from_vals(struct uiBut *but, const rcti *rect, float *hsv, float *xpos, float *ypos); extern void ui_hsvcube_pos_from_vals(struct uiBut *but, const rcti *rect, float *hsv, float *xp, float *yp); extern 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) ATTR_NONNULL(1, 2); extern void ui_but_string_get(uiBut *but, char *str, const size_t maxlen) ATTR_NONNULL(); extern char *ui_but_string_get_dynamic(uiBut *but, int *r_str_size); extern void ui_but_convert_to_unit_alt_name(uiBut *but, char *str, size_t maxlen) ATTR_NONNULL(); extern bool ui_but_string_set(struct bContext *C, uiBut *but, const char *str) ATTR_NONNULL(); extern bool ui_but_string_set_eval_num(struct bContext *C, uiBut *but, const char *str, double *value) ATTR_NONNULL(); extern int ui_but_string_get_max_length(uiBut *but); extern uiBut *ui_but_drag_multi_edit_get(uiBut *but); void ui_def_but_icon(uiBut *but, const int icon, const int flag); extern uiButExtraIconType ui_but_icon_extra_get(uiBut *but); extern void ui_but_default_set(struct bContext *C, const bool all, const bool use_afterfunc); extern void ui_but_update_ex(uiBut *but, const bool validate); extern void ui_but_update(uiBut *but); extern void ui_but_update_edited(uiBut *but); extern bool ui_but_is_float(const uiBut *but) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_is_bool(const uiBut *but) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_is_unit(const uiBut *but) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_is_compatible(const uiBut *but_a, const uiBut *but_b) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_is_rna_valid(uiBut *but) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_is_utf8(const uiBut *but) ATTR_WARN_UNUSED_RESULT; extern bool ui_but_supports_cycling(const uiBut *but) ATTR_WARN_UNUSED_RESULT; extern int ui_but_is_pushed_ex(uiBut *but, double *value) ATTR_WARN_UNUSED_RESULT; extern int ui_but_is_pushed(uiBut *but) ATTR_WARN_UNUSED_RESULT; void ui_but_override_flag(uiBut *but); extern void ui_block_bounds_calc(uiBlock *block); extern struct ColorManagedDisplay *ui_block_cm_display_get(uiBlock *block); void ui_block_cm_to_display_space_v3(uiBlock *block, float pixel[3]); /* interface_regions.c */ struct uiKeyNavLock { /* set when we're using keyinput */ bool is_keynav; /* only used to check if we've moved the cursor */ int event_xy[2]; }; typedef uiBlock * (*uiBlockHandleCreateFunc)(struct bContext *C, struct uiPopupBlockHandle *handle, void *arg1); typedef void (*uiBlockHandleFreeFunc)(struct uiPopupBlockHandle *handle, void *arg1); struct uiPopupBlockCreate { uiBlockCreateFunc create_func; uiBlockHandleCreateFunc handle_create_func; uiBlockHandleFreeFunc free_func; void *arg; int event_xy[2]; /* when popup is initialized from a button */ ARegion *butregion; uiBut *but; }; struct uiPopupBlockHandle { /* internal */ struct ARegion *region; /* use only for 'UI_BLOCK_MOVEMOUSE_QUIT' popups */ float towards_xy[2]; double towardstime; bool dotowards; bool popup; void (*popup_func)(struct bContext *C, void *arg, int event); void (*cancel_func)(struct bContext *C, void *arg); void *popup_arg; /* store data for refreshing popups */ struct uiPopupBlockCreate popup_create_vars; /* true if we can re-create the popup using 'popup_create_vars' */ bool can_refresh; bool refresh; struct wmTimer *scrolltimer; float scrolloffset; struct uiKeyNavLock keynav_state; /* for operator popups */ struct wmOperator *popup_op; struct wmOperatorType *optype; ScrArea *ctx_area; ARegion *ctx_region; int opcontext; /* return values */ int butretval; int menuretval; int retvalue; float retvec[4]; /* menu direction */ int direction; /* Previous values so we don't resize or reposition on refresh. */ rctf prev_block_rect; rctf prev_butrct; short prev_dir1, prev_dir2; int prev_mx, prev_my; /* Maximum estimated size to avoid having to reposition on refresh. */ float max_size_x, max_size_y; /* #ifdef USE_DRAG_POPUP */ bool is_grab; int grab_xy_prev[2]; /* #endif */ }; /* -------------------------------------------------------------------- */ /* interface_region_*.c */ /* interface_region_tooltip.c */ /* exposed as public API in UI_interface.h */ /* interface_region_color_picker.c */ void ui_rgb_to_color_picker_compat_v(const float rgb[3], float r_cp[3]); void ui_rgb_to_color_picker_v(const float rgb[3], float r_cp[3]); void ui_color_picker_to_rgb_v(const float r_cp[3], float rgb[3]); void ui_color_picker_to_rgb(float r_cp0, float r_cp1, float r_cp2, float *r, float *g, float *b); bool ui_but_is_color_gamma(uiBut *but); void ui_scene_linear_to_color_picker_space(uiBut *but, float rgb[3]); void ui_color_picker_to_scene_linear_space(uiBut *but, float rgb[3]); uiBlock *ui_block_func_COLOR(struct bContext *C, uiPopupBlockHandle *handle, void *arg_but); ColorPicker *ui_block_colorpicker_create(struct uiBlock *block); /* interface_region_search.c */ /* Searchbox for string button */ ARegion *ui_searchbox_create_generic(struct bContext *C, struct ARegion *butregion, uiBut *but); ARegion *ui_searchbox_create_operator(struct bContext *C, struct ARegion *butregion, uiBut *but); bool ui_searchbox_inside(struct ARegion *ar, int x, int y); int ui_searchbox_find_index(struct ARegion *ar, const char *name); void ui_searchbox_update(struct bContext *C, struct ARegion *ar, uiBut *but, const bool reset); int ui_searchbox_autocomplete(struct bContext *C, struct ARegion *ar, uiBut *but, char *str); void ui_searchbox_event(struct bContext *C, struct ARegion *ar, uiBut *but, const struct wmEvent *event); bool ui_searchbox_apply(uiBut *but, struct ARegion *ar); void ui_searchbox_free(struct bContext *C, struct ARegion *ar); void ui_but_search_refresh(uiBut *but); /* interface_region_menu_popup.c */ int ui_but_menu_step(uiBut *but, int step); bool ui_but_menu_step_poll(const uiBut *but); uiBut *ui_popup_menu_memory_get(struct uiBlock *block); void ui_popup_menu_memory_set(uiBlock *block, struct uiBut *but); uiBlock *ui_popup_block_refresh( struct bContext *C, uiPopupBlockHandle *handle, ARegion *butregion, uiBut *but); uiPopupBlockHandle *ui_popup_block_create( struct bContext *C, struct ARegion *butregion, uiBut *but, uiBlockCreateFunc create_func, uiBlockHandleCreateFunc handle_create_func, void *arg); uiPopupBlockHandle *ui_popup_menu_create( struct bContext *C, struct ARegion *butregion, uiBut *but, uiMenuCreateFunc create_func, void *arg); /* interface_region_popover.c */ uiPopupBlockHandle *ui_popover_panel_create( struct bContext *C, struct ARegion *butregion, uiBut *but, uiMenuCreateFunc create_func, void *arg); /* interface_region_menu_pie.c */ void ui_pie_menu_level_create( uiBlock *block, struct wmOperatorType *ot, const char *propname, IDProperty *properties, const EnumPropertyItem *items, int totitem, int context, int flag); /* interface_region_popup.c */ void ui_popup_translate(struct ARegion *ar, const int mdiff[2]); void ui_popup_block_free(struct bContext *C, uiPopupBlockHandle *handle); void ui_popup_block_scrolltest(struct uiBlock *block); /* end interface_region_*.c */ /* interface_panel.c */ extern int ui_handler_panel_region( struct bContext *C, const struct wmEvent *event, struct ARegion *ar, const uiBut *active_but); extern void ui_draw_aligned_panel( struct uiStyle *style, uiBlock *block, const rcti *rect, const bool show_pin, const bool show_background); /* interface_draw.c */ extern void ui_draw_dropshadow(const rctf *rct, float radius, float aspect, float alpha, int select); void ui_draw_gradient(const rcti *rect, const float hsv[3], const int type, const float alpha); void ui_draw_but_TAB_outline(const rcti *rect, float rad, uchar highlight[3], uchar highlight_fade[3]); void ui_draw_but_HISTOGRAM(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_WAVEFORM(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_VECTORSCOPE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_COLORBAND(uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_UNITVEC(uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_CURVE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_IMAGE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_TRACKPREVIEW(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); void ui_draw_but_NODESOCKET(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect); /* interface_handlers.c */ PointerRNA *ui_handle_afterfunc_add_operator(struct wmOperatorType *ot, int opcontext, bool create_props); extern void ui_pan_to_scroll(const struct wmEvent *event, int *type, int *val); extern void ui_but_activate_event(struct bContext *C, struct ARegion *ar, uiBut *but); extern void ui_but_activate_over(struct bContext *C, struct ARegion *ar, uiBut *but); extern void ui_but_execute_begin(struct bContext *C, struct ARegion *ar, uiBut *but, void **active_back); extern void ui_but_execute_end(struct bContext *C, struct ARegion *ar, uiBut *but, void *active_back); extern void ui_but_active_free(const struct bContext *C, uiBut *but); extern bool ui_but_is_active(struct ARegion *ar) ATTR_WARN_UNUSED_RESULT; extern int ui_but_menu_direction(uiBut *but); extern void ui_but_text_password_hide(char password_str[UI_MAX_DRAW_STR], uiBut *but, const bool restore); extern uiBut *ui_but_find_select_in_enum(uiBut *but, int direction); extern uiBut *ui_but_find_active_in_region(struct ARegion *ar); extern uiBut *ui_but_find_mouse_over(struct ARegion *ar, const struct wmEvent *event); void ui_but_pie_dir(RadialDirection dir, float vec[2]); float ui_block_calc_pie_segment(struct uiBlock *block, const float event_xy[2]); void ui_but_add_shortcut(uiBut *but, const char *key_str, const bool do_strip); void ui_but_clipboard_free(void); uiBut *ui_but_find_old(uiBlock *block_old, const uiBut *but_new); uiBut *ui_but_find_new(uiBlock *block_old, const uiBut *but_new); #ifdef WITH_INPUT_IME void ui_but_ime_reposition(uiBut *but, int x, int y, bool complete); struct wmIMEData *ui_but_ime_data_get(uiBut *but); #endif /* interface_widgets.c */ /* Widget shader parameters, must match the shader layout. */ typedef struct uiWidgetBaseParameters { rctf recti, rect; float radi, rad; float facxi, facyi; float round_corners[4]; float color_inner1[4], color_inner2[4]; float color_outline[4], color_emboss[4]; float color_tria[4]; float tria1_center[2], tria2_center[2]; float tria1_size, tria2_size; float shade_dir; /* We pack alpha check and discard factor in alpha_discard. * If the value is negative then we do alpha check. * The absolute value itself is the discard factor. * Initialize value to 1.0.f if you don't want discard */ float alpha_discard; } uiWidgetBaseParameters; enum { ROUNDBOX_TRIA_NONE = 0, ROUNDBOX_TRIA_ARROWS, ROUNDBOX_TRIA_SCROLL, ROUNDBOX_TRIA_MENU, ROUNDBOX_TRIA_CHECK, ROUNDBOX_TRIA_HOLD_ACTION_ARROW, ROUNDBOX_TRIA_MAX, /* don't use */ }; struct GPUBatch *ui_batch_roundbox_get(bool filled, bool antialiased); struct GPUBatch *ui_batch_roundbox_widget_get(int tria); struct GPUBatch *ui_batch_roundbox_shadow_get(void); void ui_draw_anti_tria_rect(const rctf *rect, char dir, const float color[4]); void ui_draw_menu_back(struct uiStyle *style, uiBlock *block, rcti *rect); void ui_draw_popover_back(ARegion *ar, struct uiStyle *style, uiBlock *block, rcti *rect); void ui_draw_pie_center(uiBlock *block); const struct uiWidgetColors *ui_tooltip_get_theme(void); void ui_draw_widget_back_color( uiWidgetTypeEnum type, bool use_shadow, const rcti *rect, const float color[4]); void ui_draw_widget_back( uiWidgetTypeEnum type, bool use_shadow, const rcti *rect); void ui_draw_tooltip_background(struct uiStyle *UNUSED(style), uiBlock *block, rcti *rect); extern void ui_draw_but(const struct bContext *C, ARegion *ar, struct uiStyle *style, uiBut *but, rcti *rect); void ui_draw_menu_item(const struct uiFontStyle *fstyle, rcti *rect, const char *name, int iconid, int state, bool use_sep); void ui_draw_preview_item(const struct uiFontStyle *fstyle, rcti *rect, const char *name, int iconid, int state); #define UI_TEXT_MARGIN_X 0.4f #define UI_POPUP_MARGIN (UI_DPI_FAC * 12) /* margin at top of screen for popups */ #define UI_POPUP_MENU_TOP (int)(8 * UI_DPI_FAC) #define UI_PIXEL_AA_JITTER 8 extern const float ui_pixel_jitter[UI_PIXEL_AA_JITTER][2]; /* interface_style.c */ void uiStyleInit(void); /* interface_icons.c */ void ui_icon_ensure_deferred(const struct bContext *C, const int icon_id, const bool big); int ui_id_icon_get(const struct bContext *C, struct ID *id, const bool big); /* interface_icons_event.c */ void icon_draw_rect_input( float x, float y, int w, int h, float alpha, short event_type, short event_value); /* resources.c */ void init_userdef_do_versions(struct Main *bmain); void ui_theme_init_default(void); void ui_style_init_default(void); void ui_resources_init(void); void ui_resources_free(void); /* interface_layout.c */ void ui_layout_add_but(uiLayout *layout, uiBut *but); void ui_but_add_search(uiBut *but, PointerRNA *ptr, PropertyRNA *prop, PointerRNA *searchptr, PropertyRNA *searchprop); void ui_layout_list_set_labels_active(uiLayout *layout); /* menu callback */ void ui_item_paneltype_func(struct bContext *C, struct uiLayout *layout, void *arg_pt); /* interface_align.c */ bool ui_but_can_align(const uiBut *but) ATTR_WARN_UNUSED_RESULT; int ui_but_align_opposite_to_area_align_get(const ARegion *ar) ATTR_WARN_UNUSED_RESULT; void ui_block_align_calc(uiBlock *block, const ARegion *region); /* interface_anim.c */ void ui_but_anim_flag(uiBut *but, float cfra); void ui_but_anim_copy_driver(struct bContext *C); void ui_but_anim_paste_driver(struct bContext *C); bool ui_but_anim_expression_get(uiBut *but, char *str, size_t maxlen); bool ui_but_anim_expression_set(uiBut *but, const char *str); bool ui_but_anim_expression_create(uiBut *but, const char *str); void ui_but_anim_autokey(struct bContext *C, uiBut *but, struct Scene *scene, float cfra); void ui_but_anim_decorate_cb(struct bContext *C, void *arg_but, void *arg_dummy); void ui_but_anim_decorate_update_from_flag(uiBut *but); /* interface_query.c */ bool ui_but_is_editable(const uiBut *but); bool ui_but_is_editable_as_text(const uiBut *but); bool ui_but_is_toggle(const uiBut *but); bool ui_but_is_popover_once_compat(const uiBut *but); extern bool ui_block_is_menu(const uiBlock *block) ATTR_WARN_UNUSED_RESULT; extern bool ui_block_is_popover(const uiBlock *block) ATTR_WARN_UNUSED_RESULT; extern bool ui_block_is_pie_menu(const uiBlock *block) ATTR_WARN_UNUSED_RESULT; extern bool ui_block_is_popup_any(const uiBlock *block) ATTR_WARN_UNUSED_RESULT; /* interface_context_menu.c */ bool ui_popup_context_menu_for_button(struct bContext *C, uiBut *but); void ui_popup_context_menu_for_panel(struct bContext *C, struct ARegion *ar, struct Panel *pa); /* interface_eyedropper.c */ struct wmKeyMap *eyedropper_modal_keymap(struct wmKeyConfig *keyconf); struct wmKeyMap *eyedropper_colorband_modal_keymap(struct wmKeyConfig *keyconf); /* interface_eyedropper_color.c */ void UI_OT_eyedropper_color(struct wmOperatorType *ot); /* interface_eyedropper_colorband.c */ void UI_OT_eyedropper_colorband(struct wmOperatorType *ot); void UI_OT_eyedropper_colorband_point(struct wmOperatorType *ot); /* interface_eyedropper_datablock.c */ void UI_OT_eyedropper_id(struct wmOperatorType *ot); /* interface_eyedropper_depth.c */ void UI_OT_eyedropper_depth(struct wmOperatorType *ot); /* interface_eyedropper_driver.c */ void UI_OT_eyedropper_driver(struct wmOperatorType *ot); /* interface_util.c */ /** * For use with #ui_rna_collection_search_cb. */ typedef struct uiRNACollectionSearch { PointerRNA target_ptr; PropertyRNA *target_prop; PointerRNA search_ptr; PropertyRNA *search_prop; bool *but_changed; /* pointer to uiBut.changed */ } uiRNACollectionSearch; void ui_rna_collection_search_cb(const struct bContext *C, void *arg, const char *str, uiSearchItems *items); #endif /* __INTERFACE_INTERN_H__ */