diff options
Diffstat (limited to 'source/blender/editors/include/UI_interface.h')
| -rw-r--r-- | source/blender/editors/include/UI_interface.h | 2340 |
1 files changed, 1651 insertions, 689 deletions
diff --git a/source/blender/editors/include/UI_interface.h b/source/blender/editors/include/UI_interface.h index b862f36337c..d3cce4a5dde 100644 --- a/source/blender/editors/include/UI_interface.h +++ b/source/blender/editors/include/UI_interface.h @@ -78,7 +78,7 @@ typedef struct uiPopupBlockHandle uiPopupBlockHandle; /* Defines */ /* char for splitting strings, aligning shortcuts in menus, users never see */ -#define UI_SEP_CHAR '|' +#define UI_SEP_CHAR '|' #define UI_SEP_CHAR_S "|" /* names */ @@ -91,135 +91,135 @@ typedef struct uiPopupBlockHandle uiPopupBlockHandle; /* uiBlock->dt and uiBut->dt */ enum { - UI_EMBOSS = 0, /* use widget style for drawing */ - UI_EMBOSS_NONE = 1, /* Nothing, only icon and/or text */ - UI_EMBOSS_PULLDOWN = 2, /* Pulldown menu style */ - UI_EMBOSS_RADIAL = 3, /* Pie Menu */ + UI_EMBOSS = 0, /* use widget style for drawing */ + UI_EMBOSS_NONE = 1, /* Nothing, only icon and/or text */ + UI_EMBOSS_PULLDOWN = 2, /* Pulldown menu style */ + UI_EMBOSS_RADIAL = 3, /* Pie Menu */ - UI_EMBOSS_UNDEFINED = 255, /* For layout engine, use emboss from block. */ + UI_EMBOSS_UNDEFINED = 255, /* For layout engine, use emboss from block. */ }; /* uiBlock->direction */ enum { - UI_DIR_UP = 1 << 0, - UI_DIR_DOWN = 1 << 1, - UI_DIR_LEFT = 1 << 2, - UI_DIR_RIGHT = 1 << 3, - UI_DIR_CENTER_X = 1 << 4, - UI_DIR_CENTER_Y = 1 << 5, - - UI_DIR_ALL = UI_DIR_UP | UI_DIR_DOWN | UI_DIR_LEFT | UI_DIR_RIGHT, + UI_DIR_UP = 1 << 0, + UI_DIR_DOWN = 1 << 1, + UI_DIR_LEFT = 1 << 2, + UI_DIR_RIGHT = 1 << 3, + UI_DIR_CENTER_X = 1 << 4, + UI_DIR_CENTER_Y = 1 << 5, + + UI_DIR_ALL = UI_DIR_UP | UI_DIR_DOWN | UI_DIR_LEFT | UI_DIR_RIGHT, }; #if 0 /* uiBlock->autofill (not yet used) */ -#define UI_BLOCK_COLLUMNS 1 -#define UI_BLOCK_ROWS 2 +# define UI_BLOCK_COLLUMNS 1 +# define UI_BLOCK_ROWS 2 #endif /** #uiBlock.flag (controls) */ enum { - UI_BLOCK_LOOP = 1 << 0, - UI_BLOCK_IS_FLIP = 1 << 1, - UI_BLOCK_NO_FLIP = 1 << 2, - UI_BLOCK_NUMSELECT = 1 << 3, - /** Don't apply window clipping. */ - UI_BLOCK_NO_WIN_CLIP = 1 << 4, - UI_BLOCK_CLIPBOTTOM = 1 << 5, - UI_BLOCK_CLIPTOP = 1 << 6, - UI_BLOCK_MOVEMOUSE_QUIT = 1 << 7, - UI_BLOCK_KEEP_OPEN = 1 << 8, - UI_BLOCK_POPUP = 1 << 9, - UI_BLOCK_OUT_1 = 1 << 10, - UI_BLOCK_SEARCH_MENU = 1 << 11, - UI_BLOCK_POPUP_MEMORY = 1 << 12, - /* Stop handling mouse events. */ - UI_BLOCK_CLIP_EVENTS = 1 << 13, - - /* block->flag bits 14-17 are identical to but->drawflag bits */ - - UI_BLOCK_POPUP_HOLD = 1 << 18, - UI_BLOCK_LIST_ITEM = 1 << 19, - UI_BLOCK_RADIAL = 1 << 20, - UI_BLOCK_POPOVER = 1 << 21, - UI_BLOCK_POPOVER_ONCE = 1 << 22, - /** Always show keymaps, even for non-menus. */ - UI_BLOCK_SHOW_SHORTCUT_ALWAYS = 1 << 23, + UI_BLOCK_LOOP = 1 << 0, + UI_BLOCK_IS_FLIP = 1 << 1, + UI_BLOCK_NO_FLIP = 1 << 2, + UI_BLOCK_NUMSELECT = 1 << 3, + /** Don't apply window clipping. */ + UI_BLOCK_NO_WIN_CLIP = 1 << 4, + UI_BLOCK_CLIPBOTTOM = 1 << 5, + UI_BLOCK_CLIPTOP = 1 << 6, + UI_BLOCK_MOVEMOUSE_QUIT = 1 << 7, + UI_BLOCK_KEEP_OPEN = 1 << 8, + UI_BLOCK_POPUP = 1 << 9, + UI_BLOCK_OUT_1 = 1 << 10, + UI_BLOCK_SEARCH_MENU = 1 << 11, + UI_BLOCK_POPUP_MEMORY = 1 << 12, + /* Stop handling mouse events. */ + UI_BLOCK_CLIP_EVENTS = 1 << 13, + + /* block->flag bits 14-17 are identical to but->drawflag bits */ + + UI_BLOCK_POPUP_HOLD = 1 << 18, + UI_BLOCK_LIST_ITEM = 1 << 19, + UI_BLOCK_RADIAL = 1 << 20, + UI_BLOCK_POPOVER = 1 << 21, + UI_BLOCK_POPOVER_ONCE = 1 << 22, + /** Always show keymaps, even for non-menus. */ + UI_BLOCK_SHOW_SHORTCUT_ALWAYS = 1 << 23, }; /** #uiPopupBlockHandle.menuretval */ enum { - /** Cancel all menus cascading. */ - UI_RETURN_CANCEL = 1 << 0, - /** Choice made. */ - UI_RETURN_OK = 1 << 1, - /** Left the menu. */ - UI_RETURN_OUT = 1 << 2, - /** Let the parent handle this event. */ - UI_RETURN_OUT_PARENT = 1 << 3, - /** Update the button that opened. */ - UI_RETURN_UPDATE = 1 << 4, - /** Popup is ok to be handled. */ - UI_RETURN_POPUP_OK = 1 << 5, + /** Cancel all menus cascading. */ + UI_RETURN_CANCEL = 1 << 0, + /** Choice made. */ + UI_RETURN_OK = 1 << 1, + /** Left the menu. */ + UI_RETURN_OUT = 1 << 2, + /** Let the parent handle this event. */ + UI_RETURN_OUT_PARENT = 1 << 3, + /** Update the button that opened. */ + UI_RETURN_UPDATE = 1 << 4, + /** Popup is ok to be handled. */ + UI_RETURN_POPUP_OK = 1 << 5, }; /* panel controls */ enum { - UI_PNL_SOLID = 1 << 1, - UI_PNL_CLOSE = 1 << 5, - UI_PNL_SCALE = 1 << 9, + UI_PNL_SOLID = 1 << 1, + UI_PNL_CLOSE = 1 << 5, + UI_PNL_SCALE = 1 << 9, }; /* but->flag - general state flags. */ enum { - /** Warning, the first 6 flags are internal. */ - UI_BUT_ICON_SUBMENU = 1 << 6, - UI_BUT_ICON_PREVIEW = 1 << 7, - - UI_BUT_NODE_LINK = 1 << 8, - UI_BUT_NODE_ACTIVE = 1 << 9, - UI_BUT_DRAG_LOCK = 1 << 10, - /** Grayed out and un-editable. */ - UI_BUT_DISABLED = 1 << 11, - - UI_BUT_ANIMATED = 1 << 13, - UI_BUT_ANIMATED_KEY = 1 << 14, - UI_BUT_DRIVEN = 1 << 15, - UI_BUT_REDALERT = 1 << 16, - /** Grayed out but still editable. */ - UI_BUT_INACTIVE = 1 << 17, - UI_BUT_LAST_ACTIVE = 1 << 18, - UI_BUT_UNDO = 1 << 19, - UI_BUT_IMMEDIATE = 1 << 20, - UI_BUT_NO_UTF8 = 1 << 21, - - /** For popups, pressing return activates this button, overriding the highlighted button. - * For non-popups this is just used as a display hint for the user to let them - * know the action which is activated when pressing return (file selector for eg). */ - UI_BUT_ACTIVE_DEFAULT = 1 << 23, - - /** This but is "inside" a list item (currently used to change theme colors). */ - UI_BUT_LIST_ITEM = 1 << 24, - /** edit this button as well as the active button (not just dragging) */ - UI_BUT_DRAG_MULTI = 1 << 25, - /** Use for popups to start editing the button on initialization. */ - UI_BUT_ACTIVATE_ON_INIT = 1 << 26, - - /** #uiBut.str contains #UI_SEP_CHAR, used for key shortcuts */ - UI_BUT_HAS_SEP_CHAR = 1 << 27, - /** Don't run updates while dragging (needed in rare cases). */ - UI_BUT_UPDATE_DELAY = 1 << 28, - /** When widget is in textedit mode, update value on each char stroke */ - UI_BUT_TEXTEDIT_UPDATE = 1 << 29, - /** Show 'x' icon to clear/unlink value of text or search button. */ - UI_BUT_VALUE_CLEAR = 1 << 30, - - /** RNA property of the button is overridden from linked reference data. */ - UI_BUT_OVERRIDEN = 1u << 31u, + /** Warning, the first 6 flags are internal. */ + UI_BUT_ICON_SUBMENU = 1 << 6, + UI_BUT_ICON_PREVIEW = 1 << 7, + + UI_BUT_NODE_LINK = 1 << 8, + UI_BUT_NODE_ACTIVE = 1 << 9, + UI_BUT_DRAG_LOCK = 1 << 10, + /** Grayed out and un-editable. */ + UI_BUT_DISABLED = 1 << 11, + + UI_BUT_ANIMATED = 1 << 13, + UI_BUT_ANIMATED_KEY = 1 << 14, + UI_BUT_DRIVEN = 1 << 15, + UI_BUT_REDALERT = 1 << 16, + /** Grayed out but still editable. */ + UI_BUT_INACTIVE = 1 << 17, + UI_BUT_LAST_ACTIVE = 1 << 18, + UI_BUT_UNDO = 1 << 19, + UI_BUT_IMMEDIATE = 1 << 20, + UI_BUT_NO_UTF8 = 1 << 21, + + /** For popups, pressing return activates this button, overriding the highlighted button. + * For non-popups this is just used as a display hint for the user to let them + * know the action which is activated when pressing return (file selector for eg). */ + UI_BUT_ACTIVE_DEFAULT = 1 << 23, + + /** This but is "inside" a list item (currently used to change theme colors). */ + UI_BUT_LIST_ITEM = 1 << 24, + /** edit this button as well as the active button (not just dragging) */ + UI_BUT_DRAG_MULTI = 1 << 25, + /** Use for popups to start editing the button on initialization. */ + UI_BUT_ACTIVATE_ON_INIT = 1 << 26, + + /** #uiBut.str contains #UI_SEP_CHAR, used for key shortcuts */ + UI_BUT_HAS_SEP_CHAR = 1 << 27, + /** Don't run updates while dragging (needed in rare cases). */ + UI_BUT_UPDATE_DELAY = 1 << 28, + /** When widget is in textedit mode, update value on each char stroke */ + UI_BUT_TEXTEDIT_UPDATE = 1 << 29, + /** Show 'x' icon to clear/unlink value of text or search button. */ + UI_BUT_VALUE_CLEAR = 1 << 30, + + /** RNA property of the button is overridden from linked reference data. */ + UI_BUT_OVERRIDEN = 1u << 31u, }; -#define UI_PANEL_WIDTH 340 -#define UI_COMPACT_PANEL_WIDTH 160 +#define UI_PANEL_WIDTH 340 +#define UI_COMPACT_PANEL_WIDTH 160 #define UI_NAVIGATION_REGION_WIDTH UI_COMPACT_PANEL_WIDTH #define UI_NARROW_NAVIGATION_REGION_WIDTH 100 @@ -230,48 +230,48 @@ enum { * (except for the 'align' ones)! */ enum { - /** Text and icon alignment (by default, they are centered). */ - UI_BUT_TEXT_LEFT = 1 << 1, - UI_BUT_ICON_LEFT = 1 << 2, - UI_BUT_TEXT_RIGHT = 1 << 3, - /** Prevent the button to show any tooltip. */ - UI_BUT_NO_TOOLTIP = 1 << 4, - - /* Button align flag, for drawing groups together. - * Used in 'uiBlock.flag', take care! */ - UI_BUT_ALIGN_TOP = 1 << 14, - UI_BUT_ALIGN_LEFT = 1 << 15, - UI_BUT_ALIGN_RIGHT = 1 << 16, - UI_BUT_ALIGN_DOWN = 1 << 17, - UI_BUT_ALIGN = UI_BUT_ALIGN_TOP | UI_BUT_ALIGN_LEFT | UI_BUT_ALIGN_RIGHT | UI_BUT_ALIGN_DOWN, - /* end bits shared with 'uiBlock.flag' */ - - /** - * Warning - HACK! - * Needed for buttons which are not TOP/LEFT aligned, - * but have some top/left corner stitched to some other TOP/LEFT-aligned button, - * because of 'corrective' hack in widget_roundbox_set()... */ - UI_BUT_ALIGN_STITCH_TOP = 1 << 18, - UI_BUT_ALIGN_STITCH_LEFT = 1 << 19, - UI_BUT_ALIGN_ALL = UI_BUT_ALIGN | UI_BUT_ALIGN_STITCH_TOP | UI_BUT_ALIGN_STITCH_LEFT, - - /** This but is "inside" a box item (currently used to change theme colors). */ - UI_BUT_BOX_ITEM = 1 << 20, - - /** Active left part of number button */ - UI_BUT_ACTIVE_LEFT = 1 << 21, - /** Active right part of number button */ - UI_BUT_ACTIVE_RIGHT = 1 << 22, - - /* (also used by search buttons to enforce shortcut display for their items). */ - /** Button has shortcut text. */ - UI_BUT_HAS_SHORTCUT = 1 << 23, - - /** Reverse order of consecutive off/on icons */ - UI_BUT_ICON_REVERSE = 1 << 24, - - /** Value is animated, but the current value differs from the animated one. */ - UI_BUT_ANIMATED_CHANGED = 1 << 25, + /** Text and icon alignment (by default, they are centered). */ + UI_BUT_TEXT_LEFT = 1 << 1, + UI_BUT_ICON_LEFT = 1 << 2, + UI_BUT_TEXT_RIGHT = 1 << 3, + /** Prevent the button to show any tooltip. */ + UI_BUT_NO_TOOLTIP = 1 << 4, + + /* Button align flag, for drawing groups together. + * Used in 'uiBlock.flag', take care! */ + UI_BUT_ALIGN_TOP = 1 << 14, + UI_BUT_ALIGN_LEFT = 1 << 15, + UI_BUT_ALIGN_RIGHT = 1 << 16, + UI_BUT_ALIGN_DOWN = 1 << 17, + UI_BUT_ALIGN = UI_BUT_ALIGN_TOP | UI_BUT_ALIGN_LEFT | UI_BUT_ALIGN_RIGHT | UI_BUT_ALIGN_DOWN, + /* end bits shared with 'uiBlock.flag' */ + + /** + * Warning - HACK! + * Needed for buttons which are not TOP/LEFT aligned, + * but have some top/left corner stitched to some other TOP/LEFT-aligned button, + * because of 'corrective' hack in widget_roundbox_set()... */ + UI_BUT_ALIGN_STITCH_TOP = 1 << 18, + UI_BUT_ALIGN_STITCH_LEFT = 1 << 19, + UI_BUT_ALIGN_ALL = UI_BUT_ALIGN | UI_BUT_ALIGN_STITCH_TOP | UI_BUT_ALIGN_STITCH_LEFT, + + /** This but is "inside" a box item (currently used to change theme colors). */ + UI_BUT_BOX_ITEM = 1 << 20, + + /** Active left part of number button */ + UI_BUT_ACTIVE_LEFT = 1 << 21, + /** Active right part of number button */ + UI_BUT_ACTIVE_RIGHT = 1 << 22, + + /* (also used by search buttons to enforce shortcut display for their items). */ + /** Button has shortcut text. */ + UI_BUT_HAS_SHORTCUT = 1 << 23, + + /** Reverse order of consecutive off/on icons */ + UI_BUT_ICON_REVERSE = 1 << 24, + + /** Value is animated, but the current value differs from the animated one. */ + UI_BUT_ANIMATED_CHANGED = 1 << 25, }; /* scale fixed button widths by this to account for DPI */ @@ -287,12 +287,12 @@ enum { * - bit 9-15: button type (now 6 bits, 64 types) * */ typedef enum { - UI_BUT_POIN_CHAR = 32, - UI_BUT_POIN_SHORT = 64, - UI_BUT_POIN_INT = 96, - UI_BUT_POIN_FLOAT = 128, -/* UI_BUT_POIN_FUNCTION = 192, */ /*UNUSED*/ - UI_BUT_POIN_BIT = 256, /* OR'd with a bit index*/ + UI_BUT_POIN_CHAR = 32, + UI_BUT_POIN_SHORT = 64, + UI_BUT_POIN_INT = 96, + UI_BUT_POIN_FLOAT = 128, + /* UI_BUT_POIN_FUNCTION = 192, */ /*UNUSED*/ + UI_BUT_POIN_BIT = 256, /* OR'd with a bit index*/ } eButPointerType; /* requires (but->poin != NULL) */ @@ -300,77 +300,77 @@ typedef enum { /* assigned to but->type, OR'd with the flags above when passing args */ typedef enum { - UI_BTYPE_BUT = 1 << 9, - UI_BTYPE_ROW = 2 << 9, - UI_BTYPE_TEXT = 3 << 9, - /** dropdown list */ - UI_BTYPE_MENU = 4 << 9, - UI_BTYPE_BUT_MENU = 5 << 9, - /** number button */ - UI_BTYPE_NUM = 6 << 9, - /** number slider */ - UI_BTYPE_NUM_SLIDER = 7 << 9, - UI_BTYPE_TOGGLE = 8 << 9, - UI_BTYPE_TOGGLE_N = 9 << 9, - UI_BTYPE_ICON_TOGGLE = 10 << 9, - UI_BTYPE_ICON_TOGGLE_N = 11 << 9, - /** same as regular toggle, but no on/off state displayed */ - UI_BTYPE_BUT_TOGGLE = 12 << 9, - /** similar to toggle, display a 'tick' */ - UI_BTYPE_CHECKBOX = 13 << 9, - UI_BTYPE_CHECKBOX_N = 14 << 9, - UI_BTYPE_COLOR = 15 << 9, - UI_BTYPE_TAB = 16 << 9, - UI_BTYPE_POPOVER = 17 << 9, - UI_BTYPE_SCROLL = 18 << 9, - UI_BTYPE_BLOCK = 19 << 9, - UI_BTYPE_LABEL = 20 << 9, - UI_BTYPE_KEY_EVENT = 24 << 9, - UI_BTYPE_HSVCUBE = 26 << 9, - /** menu (often used in headers), **_MENU /w different draw-type */ - UI_BTYPE_PULLDOWN = 27 << 9, - UI_BTYPE_ROUNDBOX = 28 << 9, - UI_BTYPE_COLORBAND = 30 << 9, - /** sphere widget (used to input a unit-vector, aka normal) */ - UI_BTYPE_UNITVEC = 31 << 9, - UI_BTYPE_CURVE = 32 << 9, - UI_BTYPE_LISTBOX = 36 << 9, - UI_BTYPE_LISTROW = 37 << 9, - UI_BTYPE_HSVCIRCLE = 38 << 9, - UI_BTYPE_TRACK_PREVIEW = 40 << 9, - - /** Buttons with value >= #UI_BTYPE_SEARCH_MENU don't get undo pushes. */ - UI_BTYPE_SEARCH_MENU = 41 << 9, - UI_BTYPE_EXTRA = 42 << 9, - UI_BTYPE_HOTKEY_EVENT = 46 << 9, - /** Non-interactive image, used for splash screen */ - UI_BTYPE_IMAGE = 47 << 9, - UI_BTYPE_HISTOGRAM = 48 << 9, - UI_BTYPE_WAVEFORM = 49 << 9, - UI_BTYPE_VECTORSCOPE = 50 << 9, - UI_BTYPE_PROGRESS_BAR = 51 << 9, - UI_BTYPE_NODE_SOCKET = 53 << 9, - UI_BTYPE_SEPR = 54 << 9, - UI_BTYPE_SEPR_LINE = 55 << 9, - /** Dynamically fill available space. */ - UI_BTYPE_SEPR_SPACER = 56 << 9, - /** Resize handle (resize uilist). */ - UI_BTYPE_GRIP = 57 << 9, + UI_BTYPE_BUT = 1 << 9, + UI_BTYPE_ROW = 2 << 9, + UI_BTYPE_TEXT = 3 << 9, + /** dropdown list */ + UI_BTYPE_MENU = 4 << 9, + UI_BTYPE_BUT_MENU = 5 << 9, + /** number button */ + UI_BTYPE_NUM = 6 << 9, + /** number slider */ + UI_BTYPE_NUM_SLIDER = 7 << 9, + UI_BTYPE_TOGGLE = 8 << 9, + UI_BTYPE_TOGGLE_N = 9 << 9, + UI_BTYPE_ICON_TOGGLE = 10 << 9, + UI_BTYPE_ICON_TOGGLE_N = 11 << 9, + /** same as regular toggle, but no on/off state displayed */ + UI_BTYPE_BUT_TOGGLE = 12 << 9, + /** similar to toggle, display a 'tick' */ + UI_BTYPE_CHECKBOX = 13 << 9, + UI_BTYPE_CHECKBOX_N = 14 << 9, + UI_BTYPE_COLOR = 15 << 9, + UI_BTYPE_TAB = 16 << 9, + UI_BTYPE_POPOVER = 17 << 9, + UI_BTYPE_SCROLL = 18 << 9, + UI_BTYPE_BLOCK = 19 << 9, + UI_BTYPE_LABEL = 20 << 9, + UI_BTYPE_KEY_EVENT = 24 << 9, + UI_BTYPE_HSVCUBE = 26 << 9, + /** menu (often used in headers), **_MENU /w different draw-type */ + UI_BTYPE_PULLDOWN = 27 << 9, + UI_BTYPE_ROUNDBOX = 28 << 9, + UI_BTYPE_COLORBAND = 30 << 9, + /** sphere widget (used to input a unit-vector, aka normal) */ + UI_BTYPE_UNITVEC = 31 << 9, + UI_BTYPE_CURVE = 32 << 9, + UI_BTYPE_LISTBOX = 36 << 9, + UI_BTYPE_LISTROW = 37 << 9, + UI_BTYPE_HSVCIRCLE = 38 << 9, + UI_BTYPE_TRACK_PREVIEW = 40 << 9, + + /** Buttons with value >= #UI_BTYPE_SEARCH_MENU don't get undo pushes. */ + UI_BTYPE_SEARCH_MENU = 41 << 9, + UI_BTYPE_EXTRA = 42 << 9, + UI_BTYPE_HOTKEY_EVENT = 46 << 9, + /** Non-interactive image, used for splash screen */ + UI_BTYPE_IMAGE = 47 << 9, + UI_BTYPE_HISTOGRAM = 48 << 9, + UI_BTYPE_WAVEFORM = 49 << 9, + UI_BTYPE_VECTORSCOPE = 50 << 9, + UI_BTYPE_PROGRESS_BAR = 51 << 9, + UI_BTYPE_NODE_SOCKET = 53 << 9, + UI_BTYPE_SEPR = 54 << 9, + UI_BTYPE_SEPR_LINE = 55 << 9, + /** Dynamically fill available space. */ + UI_BTYPE_SEPR_SPACER = 56 << 9, + /** Resize handle (resize uilist). */ + UI_BTYPE_GRIP = 57 << 9, } eButType; -#define BUTTYPE (63 << 9) +#define BUTTYPE (63 << 9) /** Gradient types, for color picker #UI_BTYPE_HSVCUBE etc. */ enum { - UI_GRAD_SV = 0, - UI_GRAD_HV = 1, - UI_GRAD_HS = 2, - UI_GRAD_H = 3, - UI_GRAD_S = 4, - UI_GRAD_V = 5, - - UI_GRAD_V_ALT = 9, - UI_GRAD_L_ALT = 10, + UI_GRAD_SV = 0, + UI_GRAD_HV = 1, + UI_GRAD_HS = 2, + UI_GRAD_H = 3, + UI_GRAD_S = 4, + UI_GRAD_V = 5, + + UI_GRAD_V_ALT = 9, + UI_GRAD_L_ALT = 10, }; #define UI_PALETTE_COLOR 20 @@ -380,15 +380,40 @@ enum { * Functions to draw various shapes, taking theme settings into account. * Used for code that draws its own UI style elements. */ -void UI_draw_anti_tria(float x1, float y1, float x2, float y2, float x3, float y3, const float color[4]); +void UI_draw_anti_tria( + float x1, float y1, float x2, float y2, float x3, float y3, const float color[4]); void UI_draw_anti_fan(float tri_array[][2], unsigned int length, const float color[4]); void UI_draw_roundbox_corner_set(int type); -void UI_draw_roundbox_aa(bool filled, float minx, float miny, float maxx, float maxy, float rad, const float color[4]); -void UI_draw_roundbox_4fv(bool filled, float minx, float miny, float maxx, float maxy, float rad, const float col[4]); -void UI_draw_roundbox_3ubAlpha(bool filled, float minx, float miny, float maxx, float maxy, float rad, const unsigned char col[3], unsigned char alpha); -void UI_draw_roundbox_3fvAlpha(bool filled, float minx, float miny, float maxx, float maxy, float rad, const float col[3], float alpha); -void UI_draw_roundbox_shade_x(bool filled, float minx, float miny, float maxx, float maxy, float rad, float shadetop, float shadedown, const float col[4]); +void UI_draw_roundbox_aa( + bool filled, float minx, float miny, float maxx, float maxy, float rad, const float color[4]); +void UI_draw_roundbox_4fv( + bool filled, float minx, float miny, float maxx, float maxy, float rad, const float col[4]); +void UI_draw_roundbox_3ubAlpha(bool filled, + float minx, + float miny, + float maxx, + float maxy, + float rad, + const unsigned char col[3], + unsigned char alpha); +void UI_draw_roundbox_3fvAlpha(bool filled, + float minx, + float miny, + float maxx, + float maxy, + float rad, + const float col[3], + float alpha); +void UI_draw_roundbox_shade_x(bool filled, + float minx, + float miny, + float maxx, + float maxy, + float rad, + float shadetop, + float shadedown, + const float col[4]); #if 0 /* unused */ int UI_draw_roundbox_corner_get(void); @@ -398,21 +423,32 @@ void UI_draw_roundbox_shade_y(bool filled, float minx, float miny, float maxx, f void UI_draw_box_shadow(unsigned char alpha, float minx, float miny, float maxx, float maxy); void UI_draw_text_underline(int pos_x, int pos_y, int len, int height, const float color[4]); -void UI_draw_safe_areas(uint pos, float x1, float x2, float y1, float y2, - const float title_aspect[2], const float action_aspect[2]); +void UI_draw_safe_areas(uint pos, + float x1, + float x2, + float y1, + float y2, + const float title_aspect[2], + const float action_aspect[2]); /** State for scrolldrawing. */ enum { - UI_SCROLL_PRESSED = 1 << 0, - UI_SCROLL_ARROWS = 1 << 1, - UI_SCROLL_NO_OUTLINE = 1 << 2, + UI_SCROLL_PRESSED = 1 << 0, + UI_SCROLL_ARROWS = 1 << 1, + UI_SCROLL_NO_OUTLINE = 1 << 2, }; -void UI_draw_widget_scroll(struct uiWidgetColors *wcol, const struct rcti *rect, const struct rcti *slider, int state); +void UI_draw_widget_scroll(struct uiWidgetColors *wcol, + const struct rcti *rect, + const struct rcti *slider, + int state); /* Shortening string helper. */ -float UI_text_clip_middle_ex( - const struct uiFontStyle *fstyle, char *str, float okwidth, const float minwidth, - const size_t max_len, const char rpart_sep); +float UI_text_clip_middle_ex(const struct uiFontStyle *fstyle, + char *str, + float okwidth, + const float minwidth, + const size_t max_len, + const char rpart_sep); /** * Callbacks @@ -437,8 +473,13 @@ typedef void (*uiButHandleRenameFunc)(struct bContext *C, void *arg, char *origs typedef void (*uiButHandleNFunc)(struct bContext *C, void *argN, void *arg2); typedef void (*uiButHandleHoldFunc)(struct bContext *C, struct ARegion *butregion, uiBut *but); typedef int (*uiButCompleteFunc)(struct bContext *C, char *str, void *arg); -typedef struct ARegion *(*uiButSearchCreateFunc)(struct bContext *C, struct ARegion *butregion, uiBut *but); -typedef void (*uiButSearchFunc)(const struct bContext *C, void *arg, const char *str, uiSearchItems *items); +typedef struct ARegion *(*uiButSearchCreateFunc)(struct bContext *C, + struct ARegion *butregion, + uiBut *but); +typedef void (*uiButSearchFunc)(const struct bContext *C, + void *arg, + const char *str, + uiSearchItems *items); /* Must return allocated string. */ typedef char *(*uiButToolTipFunc)(struct bContext *C, void *argN, const char *tip); typedef int (*uiButPushedStateFunc)(struct bContext *C, void *arg); @@ -457,16 +498,13 @@ typedef void (*uiMenuHandleFunc)(struct bContext *C, void *arg, int event); */ typedef bool (*uiMenuStepFunc)(struct bContext *C, int direction, void *arg1); - /* interface_query.c */ bool UI_but_has_tooltip_label(const uiBut *but); bool UI_but_is_tool(const uiBut *but); -#define UI_but_is_decorator(but) \ - ((but)->func == ui_but_anim_decorate_cb) +#define UI_but_is_decorator(but) ((but)->func == ui_but_anim_decorate_cb) bool UI_block_is_empty(const uiBlock *block); - /* interface_region_menu_popup.c */ /** * Popup Menus @@ -478,17 +516,18 @@ bool UI_block_is_empty(const uiBlock *block); */ typedef struct uiPopupMenu uiPopupMenu; -uiPopupMenu *UI_popup_menu_begin( - struct bContext *C, const char *title, int icon) ATTR_NONNULL(); -uiPopupMenu *UI_popup_menu_begin_ex( - struct bContext *C, const char *title, const char *block_name, - int icon) ATTR_NONNULL(); +uiPopupMenu *UI_popup_menu_begin(struct bContext *C, const char *title, int icon) ATTR_NONNULL(); +uiPopupMenu *UI_popup_menu_begin_ex(struct bContext *C, + const char *title, + const char *block_name, + int icon) ATTR_NONNULL(); void UI_popup_menu_end(struct bContext *C, struct uiPopupMenu *head); bool UI_popup_menu_end_or_cancel(struct bContext *C, struct uiPopupMenu *head); struct uiLayout *UI_popup_menu_layout(uiPopupMenu *head); void UI_popup_menu_reports(struct bContext *C, struct ReportList *reports) ATTR_NONNULL(); -int UI_popup_menu_invoke(struct bContext *C, const char *idname, struct ReportList *reports) ATTR_NONNULL(1, 2); +int UI_popup_menu_invoke(struct bContext *C, const char *idname, struct ReportList *reports) + ATTR_NONNULL(1, 2); void UI_popup_menu_retval_set(const uiBlock *block, const int retval, const bool enable); void UI_popup_menu_but_set(uiPopupMenu *pup, struct ARegion *butregion, uiBut *but); @@ -497,9 +536,10 @@ void UI_popup_menu_but_set(uiPopupMenu *pup, struct ARegion *butregion, uiBut *b typedef struct uiPopover uiPopover; -int UI_popover_panel_invoke( - struct bContext *C, const char *idname, - bool keep_open, struct ReportList *reports); +int UI_popover_panel_invoke(struct bContext *C, + const char *idname, + bool keep_open, + struct ReportList *reports); uiPopover *UI_popover_begin(struct bContext *C, int menu_width) ATTR_NONNULL(1); void UI_popover_end(struct bContext *C, struct uiPopover *head, struct wmKeyMap *keymap); @@ -511,16 +551,20 @@ void UI_popover_once_clear(uiPopover *pup); typedef struct uiPieMenu uiPieMenu; int UI_pie_menu_invoke(struct bContext *C, const char *idname, const struct wmEvent *event); -int UI_pie_menu_invoke_from_operator_enum( - struct bContext *C, const char *title, const char *opname, - const char *propname, const struct wmEvent *event); -int UI_pie_menu_invoke_from_rna_enum( - struct bContext *C, const char *title, - const char *path, const struct wmEvent *event); - -struct uiPieMenu *UI_pie_menu_begin( - struct bContext *C, const char *title, int icon, - const struct wmEvent *event) ATTR_NONNULL(); +int UI_pie_menu_invoke_from_operator_enum(struct bContext *C, + const char *title, + const char *opname, + const char *propname, + const struct wmEvent *event); +int UI_pie_menu_invoke_from_rna_enum(struct bContext *C, + const char *title, + const char *path, + const struct wmEvent *event); + +struct uiPieMenu *UI_pie_menu_begin(struct bContext *C, + const char *title, + int icon, + const struct wmEvent *event) ATTR_NONNULL(); void UI_pie_menu_end(struct bContext *C, uiPieMenu *pie); struct uiLayout *UI_pie_menu_layout(struct uiPieMenu *pie); @@ -530,13 +574,19 @@ struct uiLayout *UI_pie_menu_layout(struct uiPieMenu *pie); * * Functions used to create popup blocks. These are like popup menus * but allow using all button types and creating an own layout. */ -typedef uiBlock * (*uiBlockCreateFunc)(struct bContext *C, struct ARegion *ar, void *arg1); +typedef uiBlock *(*uiBlockCreateFunc)(struct bContext *C, struct ARegion *ar, void *arg1); typedef void (*uiBlockCancelFunc)(struct bContext *C, void *arg1); void UI_popup_block_invoke(struct bContext *C, uiBlockCreateFunc func, void *arg); -void UI_popup_block_invoke_ex(struct bContext *C, uiBlockCreateFunc func, void *arg, const char *opname, int opcontext); -void UI_popup_block_ex(struct bContext *C, uiBlockCreateFunc func, uiBlockHandleFunc popup_func, uiBlockCancelFunc cancel_func, void *arg, struct wmOperator *op); -#if 0 /* UNUSED */ +void UI_popup_block_invoke_ex( + struct bContext *C, uiBlockCreateFunc func, void *arg, const char *opname, int opcontext); +void UI_popup_block_ex(struct bContext *C, + uiBlockCreateFunc func, + uiBlockHandleFunc popup_func, + uiBlockCancelFunc cancel_func, + void *arg, + struct wmOperator *op); +#if 0 /* UNUSED */ void uiPupBlockOperator(struct bContext *C, uiBlockCreateFunc func, struct wmOperator *op, int opcontext); #endif @@ -555,7 +605,10 @@ bool UI_popup_block_name_exists(struct bContext *C, const char *name); * * */ -uiBlock *UI_block_begin(const struct bContext *C, struct ARegion *region, const char *name, short dt); +uiBlock *UI_block_begin(const struct bContext *C, + struct ARegion *region, + const char *name, + short dt); void UI_block_end_ex(const struct bContext *C, uiBlock *block, const int xy[2], int r_xy[2]); void UI_block_end(const struct bContext *C, uiBlock *block); void UI_block_draw(const struct bContext *C, struct uiBlock *block); @@ -564,8 +617,8 @@ void UI_blocklist_draw(const struct bContext *C, const struct ListBase *lb); void UI_block_update_from_old(const struct bContext *C, struct uiBlock *block); enum { - UI_BLOCK_THEME_STYLE_REGULAR = 0, - UI_BLOCK_THEME_STYLE_POPUP = 1, + UI_BLOCK_THEME_STYLE_REGULAR = 0, + UI_BLOCK_THEME_STYLE_POPUP = 1, }; void UI_block_theme_style_set(uiBlock *block, char theme_style); void UI_block_emboss_set(uiBlock *block, char dt); @@ -586,13 +639,13 @@ void UI_block_align_end(uiBlock *block); /* block bounds/position calculation */ typedef enum { - UI_BLOCK_BOUNDS_NONE = 0, - UI_BLOCK_BOUNDS = 1, - UI_BLOCK_BOUNDS_TEXT, - UI_BLOCK_BOUNDS_POPUP_MOUSE, - UI_BLOCK_BOUNDS_POPUP_MENU, - UI_BLOCK_BOUNDS_POPUP_CENTER, - UI_BLOCK_BOUNDS_PIE_CENTER, + UI_BLOCK_BOUNDS_NONE = 0, + UI_BLOCK_BOUNDS = 1, + UI_BLOCK_BOUNDS_TEXT, + UI_BLOCK_BOUNDS_POPUP_MOUSE, + UI_BLOCK_BOUNDS_POPUP_MENU, + UI_BLOCK_BOUNDS_POPUP_CENTER, + UI_BLOCK_BOUNDS_PIE_CENTER, } eBlockBoundsCalc; void UI_block_bounds_set_normal(struct uiBlock *block, int addval); @@ -602,50 +655,50 @@ void UI_block_bounds_set_menu(uiBlock *block, int addval, const int bounds_offse void UI_block_bounds_set_centered(uiBlock *block, int addval); void UI_block_bounds_set_explicit(uiBlock *block, int minx, int miny, int maxx, int maxy); -int UI_blocklist_min_y_get(struct ListBase *lb); +int UI_blocklist_min_y_get(struct ListBase *lb); -void UI_block_direction_set(uiBlock *block, char direction); -void UI_block_order_flip(uiBlock *block); -void UI_block_flag_enable(uiBlock *block, int flag); -void UI_block_flag_disable(uiBlock *block, int flag); -void UI_block_translate(uiBlock *block, int x, int y); +void UI_block_direction_set(uiBlock *block, char direction); +void UI_block_order_flip(uiBlock *block); +void UI_block_flag_enable(uiBlock *block, int flag); +void UI_block_flag_disable(uiBlock *block, int flag); +void UI_block_translate(uiBlock *block, int x, int y); -int UI_but_return_value_get(uiBut *but); +int UI_but_return_value_get(uiBut *but); -void UI_but_drag_set_id(uiBut *but, struct ID *id); -void UI_but_drag_set_rna(uiBut *but, struct PointerRNA *ptr); -void UI_but_drag_set_path(uiBut *but, const char *path, const bool use_free); -void UI_but_drag_set_name(uiBut *but, const char *name); -void UI_but_drag_set_value(uiBut *but); -void UI_but_drag_set_image( - uiBut *but, const char *path, int icon, struct ImBuf *ima, float scale, const bool use_free); +void UI_but_drag_set_id(uiBut *but, struct ID *id); +void UI_but_drag_set_rna(uiBut *but, struct PointerRNA *ptr); +void UI_but_drag_set_path(uiBut *but, const char *path, const bool use_free); +void UI_but_drag_set_name(uiBut *but, const char *name); +void UI_but_drag_set_value(uiBut *but); +void UI_but_drag_set_image( + uiBut *but, const char *path, int icon, struct ImBuf *ima, float scale, const bool use_free); -bool UI_but_active_drop_name(struct bContext *C); -bool UI_but_active_drop_color(struct bContext *C); +bool UI_but_active_drop_name(struct bContext *C); +bool UI_but_active_drop_color(struct bContext *C); -void UI_but_flag_enable(uiBut *but, int flag); -void UI_but_flag_disable(uiBut *but, int flag); -bool UI_but_flag_is_set(uiBut *but, int flag); +void UI_but_flag_enable(uiBut *but, int flag); +void UI_but_flag_disable(uiBut *but, int flag); +bool UI_but_flag_is_set(uiBut *but, int flag); -void UI_but_drawflag_enable(uiBut *but, int flag); -void UI_but_drawflag_disable(uiBut *but, int flag); +void UI_but_drawflag_enable(uiBut *but, int flag); +void UI_but_drawflag_disable(uiBut *but, int flag); -void UI_but_type_set_menu_from_pulldown(uiBut *but); +void UI_but_type_set_menu_from_pulldown(uiBut *but); /* special button case, only draw it when used actively, for outliner etc */ -bool UI_but_active_only(const struct bContext *C, struct ARegion *ar, uiBlock *block, uiBut *but); -bool UI_block_active_only_flagged_buttons(const struct bContext *C, struct ARegion *ar, struct uiBlock *block); +bool UI_but_active_only(const struct bContext *C, struct ARegion *ar, uiBlock *block, uiBut *but); +bool UI_block_active_only_flagged_buttons(const struct bContext *C, + struct ARegion *ar, + struct uiBlock *block); -void UI_but_execute(const struct bContext *C, uiBut *but); +void UI_but_execute(const struct bContext *C, uiBut *but); -bool UI_but_online_manual_id( - const uiBut *but, - char *r_str, size_t maxlength) - ATTR_WARN_UNUSED_RESULT; -bool UI_but_online_manual_id_from_active( - const struct bContext *C, - char *r_str, size_t maxlength) - ATTR_WARN_UNUSED_RESULT; +bool UI_but_online_manual_id(const uiBut *but, + char *r_str, + size_t maxlength) ATTR_WARN_UNUSED_RESULT; +bool UI_but_online_manual_id_from_active(const struct bContext *C, + char *r_str, + size_t maxlength) ATTR_WARN_UNUSED_RESULT; /* Buttons * @@ -657,68 +710,567 @@ bool UI_but_online_manual_id_from_active( * - R: RNA * - O: operator */ -uiBut *uiDefBut( - uiBlock *block, - int type, int retval, const char *str, - int x1, int y1, - short x2, short y2, - void *poin, - float min, float max, - float a1, float a2, const char *tip); -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); -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); -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); -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); -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); -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); -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); -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); -uiBut *uiDefButR(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, struct PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip); -uiBut *uiDefButR_prop(uiBlock *block, int type, int retval, const char *str, int x, int y, short width, short height, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip); -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); -uiBut *uiDefButO_ptr(uiBlock *block, int type, struct wmOperatorType *ot, int opcontext, const char *str, int x, int y, short width, short height, const char *tip); - -uiBut *uiDefIconBut( - uiBlock *block, - int type, int retval, int icon, - int x1, int y1, - short x2, short y2, - void *poin, - float min, float max, - float a1, float a2, const char *tip); -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); -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); -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); -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); -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); -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); -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); -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); -uiBut *uiDefIconButR(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, struct PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip); -uiBut *uiDefIconButR_prop(uiBlock *block, int type, int retval, int icon, int x, int y, short width, short height, struct PointerRNA *ptr, PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip); -uiBut *uiDefIconButO(uiBlock *block, int type, const char *opname, int opcontext, int icon, int x, int y, short width, short height, const char *tip); -uiBut *uiDefIconButO_ptr(uiBlock *block, int type, struct wmOperatorType *ot, int opcontext, int icon, int x, int y, short width, short height, const char *tip); - -uiBut *uiDefIconTextBut( - uiBlock *block, - int type, int retval, int icon, const char *str, - int x1, int y1, - short x2, short y2, - void *poin, - float min, float max, - float a1, float a2, const char *tip); -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); -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); -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); -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); -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); -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); -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); -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); -uiBut *uiDefIconTextButR(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, struct PointerRNA *ptr, const char *propname, int index, float min, float max, float a1, float a2, const char *tip); -uiBut *uiDefIconTextButR_prop(uiBlock *block, int type, int retval, int icon, const char *str, int x, int y, short width, short height, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, float min, float max, float a1, float a2, const char *tip); -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); -uiBut *uiDefIconTextButO_ptr(uiBlock *block, int type, struct wmOperatorType *ot, int opcontext, int icon, const char *str, int x, int y, short width, short height, const char *tip); +uiBut *uiDefBut(uiBlock *block, + int type, + int retval, + const char *str, + int x1, + int y1, + short x2, + short y2, + void *poin, + float min, + float max, + float a1, + float a2, + const char *tip); +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); +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); +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); +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); +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); +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); +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); +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); +uiBut *uiDefButR(uiBlock *block, + int type, + int retval, + const char *str, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + const char *propname, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +uiBut *uiDefButR_prop(uiBlock *block, + int type, + int retval, + const char *str, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +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); +uiBut *uiDefButO_ptr(uiBlock *block, + int type, + struct wmOperatorType *ot, + int opcontext, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); + +uiBut *uiDefIconBut(uiBlock *block, + int type, + int retval, + int icon, + int x1, + int y1, + short x2, + short y2, + void *poin, + float min, + float max, + float a1, + float a2, + const char *tip); +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); +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); +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); +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); +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); +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); +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); +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); +uiBut *uiDefIconButR(uiBlock *block, + int type, + int retval, + int icon, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + const char *propname, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +uiBut *uiDefIconButR_prop(uiBlock *block, + int type, + int retval, + int icon, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + PropertyRNA *prop, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +uiBut *uiDefIconButO(uiBlock *block, + int type, + const char *opname, + int opcontext, + int icon, + int x, + int y, + short width, + short height, + const char *tip); +uiBut *uiDefIconButO_ptr(uiBlock *block, + int type, + struct wmOperatorType *ot, + int opcontext, + int icon, + int x, + int y, + short width, + short height, + const char *tip); + +uiBut *uiDefIconTextBut(uiBlock *block, + int type, + int retval, + int icon, + const char *str, + int x1, + int y1, + short x2, + short y2, + void *poin, + float min, + float max, + float a1, + float a2, + const char *tip); +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); +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); +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); +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); +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); +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); +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); +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); +uiBut *uiDefIconTextButR(uiBlock *block, + int type, + int retval, + int icon, + const char *str, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + const char *propname, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +uiBut *uiDefIconTextButR_prop(uiBlock *block, + int type, + int retval, + int icon, + const char *str, + int x, + int y, + short width, + short height, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + float min, + float max, + float a1, + float a2, + const char *tip); +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); +uiBut *uiDefIconTextButO_ptr(uiBlock *block, + int type, + struct wmOperatorType *ot, + int opcontext, + int icon, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); /* for passing inputs to ButO buttons */ struct PointerRNA *UI_but_operator_ptr_get(uiBut *but); @@ -727,23 +1279,23 @@ void UI_but_unit_type_set(uiBut *but, const int unit_type); int UI_but_unit_type_get(const uiBut *but); enum { - BUT_GET_RNAPROP_IDENTIFIER = 1, - BUT_GET_RNASTRUCT_IDENTIFIER, - BUT_GET_RNAENUM_IDENTIFIER, - BUT_GET_LABEL, - BUT_GET_RNA_LABEL, - BUT_GET_RNAENUM_LABEL, - BUT_GET_RNA_LABEL_CONTEXT, /* Context specified in CTX_XXX_ macros are just unreachable! */ - BUT_GET_TIP, - BUT_GET_RNA_TIP, - BUT_GET_RNAENUM_TIP, - BUT_GET_OP_KEYMAP, - BUT_GET_PROP_KEYMAP, + BUT_GET_RNAPROP_IDENTIFIER = 1, + BUT_GET_RNASTRUCT_IDENTIFIER, + BUT_GET_RNAENUM_IDENTIFIER, + BUT_GET_LABEL, + BUT_GET_RNA_LABEL, + BUT_GET_RNAENUM_LABEL, + BUT_GET_RNA_LABEL_CONTEXT, /* Context specified in CTX_XXX_ macros are just unreachable! */ + BUT_GET_TIP, + BUT_GET_RNA_TIP, + BUT_GET_RNAENUM_TIP, + BUT_GET_OP_KEYMAP, + BUT_GET_PROP_KEYMAP, }; typedef struct uiStringInfo { - int type; - char *strinfo; + int type; + char *strinfo; } uiStringInfo; /* Note: Expects pointers to uiStringInfo structs as parameters. @@ -767,19 +1319,20 @@ void UI_but_string_info_get(struct bContext *C, uiBut *but, ...) ATTR_SENTINEL(0 * - AutoButR: RNA property button with type automatically defined. */ enum { - UI_ID_RENAME = 1 << 0, - UI_ID_BROWSE = 1 << 1, - UI_ID_ADD_NEW = 1 << 2, - UI_ID_ALONE = 1 << 4, - UI_ID_OPEN = 1 << 3, - UI_ID_DELETE = 1 << 5, - UI_ID_LOCAL = 1 << 6, - UI_ID_AUTO_NAME = 1 << 7, - UI_ID_FAKE_USER = 1 << 8, - UI_ID_PIN = 1 << 9, - UI_ID_PREVIEWS = 1 << 10, - UI_ID_OVERRIDE = 1 << 11, - UI_ID_FULL = UI_ID_RENAME | UI_ID_BROWSE | UI_ID_ADD_NEW | UI_ID_OPEN | UI_ID_ALONE | UI_ID_DELETE | UI_ID_LOCAL, + UI_ID_RENAME = 1 << 0, + UI_ID_BROWSE = 1 << 1, + UI_ID_ADD_NEW = 1 << 2, + UI_ID_ALONE = 1 << 4, + UI_ID_OPEN = 1 << 3, + UI_ID_DELETE = 1 << 5, + UI_ID_LOCAL = 1 << 6, + UI_ID_AUTO_NAME = 1 << 7, + UI_ID_FAKE_USER = 1 << 8, + UI_ID_PIN = 1 << 9, + UI_ID_PREVIEWS = 1 << 10, + UI_ID_OVERRIDE = 1 << 11, + UI_ID_FULL = UI_ID_RENAME | UI_ID_BROWSE | UI_ID_ADD_NEW | UI_ID_OPEN | UI_ID_ALONE | + UI_ID_DELETE | UI_ID_LOCAL, }; /** @@ -787,8 +1340,8 @@ enum { * \note We may want to add LOCAL, LIBRARY ... as needed. */ enum { - UI_TEMPLATE_ID_FILTER_ALL = 0, - UI_TEMPLATE_ID_FILTER_AVAILABLE = 1, + UI_TEMPLATE_ID_FILTER_ALL = 0, + UI_TEMPLATE_ID_FILTER_AVAILABLE = 1, }; int UI_icon_from_id(struct ID *id); @@ -797,89 +1350,212 @@ int UI_icon_from_report_type(int type); int UI_icon_from_event_type(short event_type, short event_value); int UI_icon_from_keymap_item(const struct wmKeyMapItem *kmi, int r_icon_mod[4]); -uiBut *uiDefPulldownBut(uiBlock *block, uiBlockCreateFunc func, void *arg, const char *str, int x, int y, short width, short height, const char *tip); -uiBut *uiDefMenuBut(uiBlock *block, uiMenuCreateFunc func, void *arg, const char *str, int x, int y, short width, short height, const char *tip); -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 *uiDefIconMenuBut(uiBlock *block, uiMenuCreateFunc func, void *arg, int icon, int x, int y, short width, short height, const char *tip); - -uiBut *uiDefBlockBut(uiBlock *block, uiBlockCreateFunc func, void *func_arg1, const char *str, int x, int y, short width, short height, const char *tip); -uiBut *uiDefBlockButN(uiBlock *block, uiBlockCreateFunc func, void *argN, const char *str, int x, int y, short width, short height, const char *tip); - -uiBut *uiDefIconBlockBut(uiBlock *block, uiBlockCreateFunc func, void *arg, int retval, int icon, int x, int y, short width, short height, const char *tip); -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 *uiDefKeyevtButS(uiBlock *block, int retval, const char *str, int x, int y, short width, short height, short *spoin, const char *tip); -uiBut *uiDefHotKeyevtButS(uiBlock *block, int retval, const char *str, int x, int y, short width, short height, short *keypoin, short *modkeypoin, const char *tip); - -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 *uiDefSearchButO_ptr( - uiBlock *block, struct wmOperatorType *ot, struct 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 *uiDefPulldownBut(uiBlock *block, + uiBlockCreateFunc func, + void *arg, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); +uiBut *uiDefMenuBut(uiBlock *block, + uiMenuCreateFunc func, + void *arg, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); +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 *uiDefIconMenuBut(uiBlock *block, + uiMenuCreateFunc func, + void *arg, + int icon, + int x, + int y, + short width, + short height, + const char *tip); + +uiBut *uiDefBlockBut(uiBlock *block, + uiBlockCreateFunc func, + void *func_arg1, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); +uiBut *uiDefBlockButN(uiBlock *block, + uiBlockCreateFunc func, + void *argN, + const char *str, + int x, + int y, + short width, + short height, + const char *tip); + +uiBut *uiDefIconBlockBut(uiBlock *block, + uiBlockCreateFunc func, + void *arg, + int retval, + int icon, + int x, + int y, + short width, + short height, + const char *tip); +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 *uiDefKeyevtButS(uiBlock *block, + int retval, + const char *str, + int x, + int y, + short width, + short height, + short *spoin, + const char *tip); +uiBut *uiDefHotKeyevtButS(uiBlock *block, + int retval, + const char *str, + int x, + int y, + short width, + short height, + short *keypoin, + short *modkeypoin, + const char *tip); + +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 *uiDefSearchButO_ptr(uiBlock *block, + struct wmOperatorType *ot, + struct 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); /* For uiDefAutoButsRNA */ typedef enum { - /* Keep current layout for aligning label with property button. */ - UI_BUT_LABEL_ALIGN_NONE, - /* Align label and property button vertically. */ - UI_BUT_LABEL_ALIGN_COLUMN, - /* Split layout into a column for the label and one for property button. */ - UI_BUT_LABEL_ALIGN_SPLIT_COLUMN, + /* Keep current layout for aligning label with property button. */ + UI_BUT_LABEL_ALIGN_NONE, + /* Align label and property button vertically. */ + UI_BUT_LABEL_ALIGN_COLUMN, + /* Split layout into a column for the label and one for property button. */ + UI_BUT_LABEL_ALIGN_SPLIT_COLUMN, } eButLabelAlign; /* Return info for uiDefAutoButsRNA */ typedef enum { - /* Returns when no buttons were added */ - UI_PROP_BUTS_NONE_ADDED = 1 << 0, - /* Returned when any property failed the custom check callback (check_prop) */ - UI_PROP_BUTS_ANY_FAILED_CHECK = 1 << 1, + /* Returns when no buttons were added */ + UI_PROP_BUTS_NONE_ADDED = 1 << 0, + /* Returned when any property failed the custom check callback (check_prop) */ + UI_PROP_BUTS_ANY_FAILED_CHECK = 1 << 1, } eAutoPropButsReturn; -uiBut *uiDefAutoButR(uiBlock *block, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, const char *name, int icon, int x1, int y1, int x2, int y2); -eAutoPropButsReturn uiDefAutoButsRNA( - uiLayout *layout, struct PointerRNA *ptr, - bool (*check_prop)(struct PointerRNA *ptr, struct PropertyRNA *prop, void *user_data), void *user_data, - struct PropertyRNA *prop_activate_init, - eButLabelAlign label_align, const bool compact); +uiBut *uiDefAutoButR(uiBlock *block, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + const char *name, + int icon, + int x1, + int y1, + int x2, + int y2); +eAutoPropButsReturn uiDefAutoButsRNA(uiLayout *layout, + struct PointerRNA *ptr, + bool (*check_prop)(struct PointerRNA *ptr, + struct PropertyRNA *prop, + void *user_data), + void *user_data, + struct PropertyRNA *prop_activate_init, + eButLabelAlign label_align, + const bool compact); /* use inside searchfunc to add items */ -bool UI_search_item_add(uiSearchItems *items, const char *name, void *poin, int iconid); +bool UI_search_item_add(uiSearchItems *items, const char *name, void *poin, int iconid); /* bfunc gets search item *poin as arg2, or if NULL the old string */ -void UI_but_func_search_set( - uiBut *but, uiButSearchCreateFunc cfunc, uiButSearchFunc sfunc, - void *arg, bool free_arg, uiButHandleFunc bfunc, void *active); +void UI_but_func_search_set(uiBut *but, + uiButSearchCreateFunc cfunc, + uiButSearchFunc sfunc, + void *arg, + bool free_arg, + uiButHandleFunc bfunc, + void *active); /* height in pixels, it's using hardcoded values still */ -int UI_searchbox_size_y(void); -int UI_searchbox_size_x(void); +int UI_searchbox_size_y(void); +int UI_searchbox_size_x(void); /* check if a string is in an existing search box */ -int UI_search_items_find_index(uiSearchItems *items, const char *name); +int UI_search_items_find_index(uiSearchItems *items, const char *name); -void UI_block_func_handle_set(uiBlock *block, uiBlockHandleFunc func, void *arg); -void UI_block_func_butmenu_set(uiBlock *block, uiMenuHandleFunc func, void *arg); -void UI_block_func_set(uiBlock *block, uiButHandleFunc func, void *arg1, void *arg2); -void UI_block_funcN_set(uiBlock *block, uiButHandleNFunc funcN, void *argN, void *arg2); +void UI_block_func_handle_set(uiBlock *block, uiBlockHandleFunc func, void *arg); +void UI_block_func_butmenu_set(uiBlock *block, uiMenuHandleFunc func, void *arg); +void UI_block_func_set(uiBlock *block, uiButHandleFunc func, void *arg1, void *arg2); +void UI_block_funcN_set(uiBlock *block, uiButHandleNFunc funcN, void *argN, void *arg2); -void UI_but_func_rename_set(uiBut *but, uiButHandleRenameFunc func, void *arg1); -void UI_but_func_set(uiBut *but, uiButHandleFunc func, void *arg1, void *arg2); -void UI_but_funcN_set(uiBut *but, uiButHandleNFunc funcN, void *argN, void *arg2); +void UI_but_func_rename_set(uiBut *but, uiButHandleRenameFunc func, void *arg1); +void UI_but_func_set(uiBut *but, uiButHandleFunc func, void *arg1, void *arg2); +void UI_but_funcN_set(uiBut *but, uiButHandleNFunc funcN, void *argN, void *arg2); -void UI_but_func_complete_set(uiBut *but, uiButCompleteFunc func, void *arg); +void UI_but_func_complete_set(uiBut *but, uiButCompleteFunc func, void *arg); -void UI_but_func_drawextra_set( - uiBlock *block, - void (*func)(const struct bContext *C, void *, void *, void *, struct rcti *rect), - void *arg1, void *arg2); +void UI_but_func_drawextra_set( + uiBlock *block, + void (*func)(const struct bContext *C, void *, void *, void *, struct rcti *rect), + void *arg1, + void *arg2); -void UI_but_func_menu_step_set(uiBut *but, uiMenuStepFunc func); +void UI_but_func_menu_step_set(uiBut *but, uiMenuStepFunc func); -void UI_but_func_tooltip_set(uiBut *but, uiButToolTipFunc func, void *argN); -void UI_but_tooltip_refresh(struct bContext *C, uiBut *but); -void UI_but_tooltip_timer_remove(struct bContext *C, uiBut *but); +void UI_but_func_tooltip_set(uiBut *but, uiButToolTipFunc func, void *argN); +void UI_but_tooltip_refresh(struct bContext *C, uiBut *but); +void UI_but_tooltip_timer_remove(struct bContext *C, uiBut *but); -bool UI_textbutton_activate_rna( - const struct bContext *C, struct ARegion *ar, - const void *rna_poin_data, const char *rna_prop_id); +bool UI_textbutton_activate_rna(const struct bContext *C, + struct ARegion *ar, + const void *rna_poin_data, + const char *rna_prop_id); bool UI_textbutton_activate_but(const struct bContext *C, uiBut *but); void UI_but_focus_on_enter_event(struct wmWindow *win, uiBut *but); @@ -915,25 +1591,31 @@ void UI_panels_end(const struct bContext *C, struct ARegion *ar, int *r_x, int * void UI_panels_draw(const struct bContext *C, struct ARegion *ar); struct Panel *UI_panel_find_by_type(struct ListBase *lb, struct PanelType *pt); -struct Panel *UI_panel_begin( - struct ScrArea *sa, struct ARegion *ar, struct ListBase *lb, - uiBlock *block, struct PanelType *pt, struct Panel *pa, - bool *r_open); +struct Panel *UI_panel_begin(struct ScrArea *sa, + struct ARegion *ar, + struct ListBase *lb, + uiBlock *block, + struct PanelType *pt, + struct Panel *pa, + bool *r_open); void UI_panel_end(uiBlock *block, int width, int height); void UI_panels_scale(struct ARegion *ar, float new_width); void UI_panel_label_offset(struct uiBlock *block, int *r_x, int *r_y); int UI_panel_size_y(const struct Panel *pa); -bool UI_panel_category_is_visible(struct ARegion *ar); -void UI_panel_category_add(struct ARegion *ar, const char *name); -struct PanelCategoryDyn *UI_panel_category_find(struct ARegion *ar, const char *idname); +bool UI_panel_category_is_visible(struct ARegion *ar); +void UI_panel_category_add(struct ARegion *ar, const char *name); +struct PanelCategoryDyn *UI_panel_category_find(struct ARegion *ar, const char *idname); struct PanelCategoryStack *UI_panel_category_active_find(struct ARegion *ar, const char *idname); -const char *UI_panel_category_active_get(struct ARegion *ar, bool set_fallback); -void UI_panel_category_active_set(struct ARegion *ar, const char *idname); -struct PanelCategoryDyn *UI_panel_category_find_mouse_over_ex(struct ARegion *ar, const int x, const int y); -struct PanelCategoryDyn *UI_panel_category_find_mouse_over(struct ARegion *ar, const struct wmEvent *event); -void UI_panel_category_clear_all(struct ARegion *ar); -void UI_panel_category_draw_all(struct ARegion *ar, const char *category_id_active); +const char *UI_panel_category_active_get(struct ARegion *ar, bool set_fallback); +void UI_panel_category_active_set(struct ARegion *ar, const char *idname); +struct PanelCategoryDyn *UI_panel_category_find_mouse_over_ex(struct ARegion *ar, + const int x, + const int y); +struct PanelCategoryDyn *UI_panel_category_find_mouse_over(struct ARegion *ar, + const struct wmEvent *event); +void UI_panel_category_clear_all(struct ARegion *ar); +void UI_panel_category_draw_all(struct ARegion *ar, const char *category_id_active); struct PanelType *UI_paneltype_find(int space_id, int region_id, const char *idname); @@ -944,7 +1626,10 @@ struct PanelType *UI_paneltype_find(int space_id, int region_id, const char *idn * as screen/ if ED_KEYMAP_UI is set, or internally in popup functions. */ void UI_region_handlers_add(struct ListBase *handlers); -void UI_popup_handlers_add(struct bContext *C, struct ListBase *handlers, uiPopupBlockHandle *popup, const char flag); +void UI_popup_handlers_add(struct bContext *C, + struct ListBase *handlers, + uiPopupBlockHandle *popup, + const char flag); void UI_popup_handlers_remove(struct ListBase *handlers, uiPopupBlockHandle *popup); void UI_popup_handlers_remove_all(struct bContext *C, struct ListBase *handlers); @@ -970,51 +1655,51 @@ void UI_exit(void); /* layout */ enum { - UI_LAYOUT_HORIZONTAL = 0, - UI_LAYOUT_VERTICAL = 1, + UI_LAYOUT_HORIZONTAL = 0, + UI_LAYOUT_VERTICAL = 1, }; enum { - UI_LAYOUT_PANEL = 0, - UI_LAYOUT_HEADER = 1, - UI_LAYOUT_MENU = 2, - UI_LAYOUT_TOOLBAR = 3, - UI_LAYOUT_PIEMENU = 4, - UI_LAYOUT_VERT_BAR = 5, + UI_LAYOUT_PANEL = 0, + UI_LAYOUT_HEADER = 1, + UI_LAYOUT_MENU = 2, + UI_LAYOUT_TOOLBAR = 3, + UI_LAYOUT_PIEMENU = 4, + UI_LAYOUT_VERT_BAR = 5, }; -#define UI_UNIT_X ((void)0, U.widget_unit) -#define UI_UNIT_Y ((void)0, U.widget_unit) +#define UI_UNIT_X ((void)0, U.widget_unit) +#define UI_UNIT_Y ((void)0, U.widget_unit) enum { - UI_LAYOUT_ALIGN_EXPAND = 0, - UI_LAYOUT_ALIGN_LEFT = 1, - UI_LAYOUT_ALIGN_CENTER = 2, - UI_LAYOUT_ALIGN_RIGHT = 3, + UI_LAYOUT_ALIGN_EXPAND = 0, + UI_LAYOUT_ALIGN_LEFT = 1, + UI_LAYOUT_ALIGN_CENTER = 2, + UI_LAYOUT_ALIGN_RIGHT = 3, }; enum { - UI_ITEM_O_RETURN_PROPS = 1 << 0, - UI_ITEM_R_EXPAND = 1 << 1, - UI_ITEM_R_SLIDER = 1 << 2, - UI_ITEM_R_TOGGLE = 1 << 3, - UI_ITEM_R_ICON_ONLY = 1 << 4, - UI_ITEM_R_EVENT = 1 << 5, - UI_ITEM_R_FULL_EVENT = 1 << 6, - UI_ITEM_R_NO_BG = 1 << 7, - UI_ITEM_R_IMMEDIATE = 1 << 8, - UI_ITEM_O_DEPRESS = 1 << 9, - UI_ITEM_R_COMPACT = 1 << 10, + UI_ITEM_O_RETURN_PROPS = 1 << 0, + UI_ITEM_R_EXPAND = 1 << 1, + UI_ITEM_R_SLIDER = 1 << 2, + UI_ITEM_R_TOGGLE = 1 << 3, + UI_ITEM_R_ICON_ONLY = 1 << 4, + UI_ITEM_R_EVENT = 1 << 5, + UI_ITEM_R_FULL_EVENT = 1 << 6, + UI_ITEM_R_NO_BG = 1 << 7, + UI_ITEM_R_IMMEDIATE = 1 << 8, + UI_ITEM_O_DEPRESS = 1 << 9, + UI_ITEM_R_COMPACT = 1 << 10, }; #define UI_HEADER_OFFSET ((void)0, 0.4f * UI_UNIT_X) /* uiLayoutOperatorButs flags */ enum { - UI_TEMPLATE_OP_PROPS_SHOW_TITLE = 1 << 0, - UI_TEMPLATE_OP_PROPS_SHOW_EMPTY = 1 << 1, - UI_TEMPLATE_OP_PROPS_COMPACT = 1 << 2, - UI_TEMPLATE_OP_PROPS_HIDE_ADVANCED = 1 << 3, + UI_TEMPLATE_OP_PROPS_SHOW_TITLE = 1 << 0, + UI_TEMPLATE_OP_PROPS_SHOW_EMPTY = 1 << 1, + UI_TEMPLATE_OP_PROPS_COMPACT = 1 << 2, + UI_TEMPLATE_OP_PROPS_HIDE_ADVANCED = 1 << 3, }; /* used for transp checkers */ @@ -1028,16 +1713,24 @@ enum { * 8------4 */ enum { - UI_CNR_TOP_LEFT = 1 << 0, - UI_CNR_TOP_RIGHT = 1 << 1, - UI_CNR_BOTTOM_RIGHT = 1 << 2, - UI_CNR_BOTTOM_LEFT = 1 << 3, - /* just for convenience */ - UI_CNR_NONE = 0, - UI_CNR_ALL = (UI_CNR_TOP_LEFT | UI_CNR_TOP_RIGHT | UI_CNR_BOTTOM_RIGHT | UI_CNR_BOTTOM_LEFT), + UI_CNR_TOP_LEFT = 1 << 0, + UI_CNR_TOP_RIGHT = 1 << 1, + UI_CNR_BOTTOM_RIGHT = 1 << 2, + UI_CNR_BOTTOM_LEFT = 1 << 3, + /* just for convenience */ + UI_CNR_NONE = 0, + UI_CNR_ALL = (UI_CNR_TOP_LEFT | UI_CNR_TOP_RIGHT | UI_CNR_BOTTOM_RIGHT | UI_CNR_BOTTOM_LEFT), }; -uiLayout *UI_block_layout(uiBlock *block, int dir, int type, int x, int y, int size, int em, int padding, struct uiStyle *style); +uiLayout *UI_block_layout(uiBlock *block, + int dir, + int type, + int x, + int y, + int size, + int em, + int padding, + struct uiStyle *style); void UI_block_layout_set_current(uiBlock *block, uiLayout *layout); void UI_block_layout_resolve(uiBlock *block, int *r_x, int *r_y); @@ -1094,12 +1787,19 @@ bool uiLayoutGetPropDecorate(uiLayout *layout); uiLayout *uiLayoutRow(uiLayout *layout, bool align); uiLayout *uiLayoutColumn(uiLayout *layout, bool align); uiLayout *uiLayoutColumnFlow(uiLayout *layout, int number, bool align); -uiLayout *uiLayoutGridFlow( - uiLayout *layout, bool row_major, int columns_len, bool even_columns, bool even_rows, bool align); +uiLayout *uiLayoutGridFlow(uiLayout *layout, + bool row_major, + int columns_len, + bool even_columns, + bool even_rows, + bool align); uiLayout *uiLayoutBox(uiLayout *layout); -uiLayout *uiLayoutListBox( - uiLayout *layout, struct uiList *ui_list, struct PointerRNA *ptr, struct PropertyRNA *prop, - struct PointerRNA *actptr, struct PropertyRNA *actprop); +uiLayout *uiLayoutListBox(uiLayout *layout, + struct uiList *ui_list, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + struct PointerRNA *actptr, + struct PropertyRNA *actprop); uiLayout *uiLayoutAbsolute(uiLayout *layout, bool align); uiLayout *uiLayoutSplit(uiLayout *layout, float percentage, bool align); uiLayout *uiLayoutOverlap(uiLayout *layout); @@ -1108,169 +1808,397 @@ uiLayout *uiLayoutRadial(uiLayout *layout); /* templates */ void uiTemplateHeader(uiLayout *layout, struct bContext *C); -void uiTemplateID( - uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, - const char *newop, const char *openop, const char *unlinkop, - int filter, const bool live_icon); -void uiTemplateIDBrowse( - uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, - const char *newop, const char *openop, const char *unlinkop, int filter); -void uiTemplateIDPreview( - uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, - const char *newop, const char *openop, const char *unlinkop, int rows, int cols, - int filter, const bool hide_buttons); -void uiTemplateIDTabs( - uiLayout *layout, struct bContext *C, - PointerRNA *ptr, const char *propname, - const char *newop, const char *menu, - int filter); -void uiTemplateAnyID( - uiLayout *layout, struct PointerRNA *ptr, const char *propname, - const char *proptypename, const char *text); -void uiTemplateSearch( - uiLayout *layout, struct bContext *C, - struct PointerRNA *ptr, const char *propname, - struct PointerRNA *searchptr, const char *searchpropname, - const char *newop, const char *unlinkop); -void uiTemplateSearchPreview( - uiLayout *layout, struct bContext *C, - struct PointerRNA *ptr, const char *propname, - struct PointerRNA *searchptr, const char *searchpropname, - const char *newop, const char *unlinkop, - const int rows, const int cols); -void uiTemplatePathBuilder( - uiLayout *layout, struct PointerRNA *ptr, const char *propname, - struct PointerRNA *root_ptr, const char *text); +void uiTemplateID(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + const char *newop, + const char *openop, + const char *unlinkop, + int filter, + const bool live_icon); +void uiTemplateIDBrowse(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + const char *newop, + const char *openop, + const char *unlinkop, + int filter); +void uiTemplateIDPreview(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + const char *newop, + const char *openop, + const char *unlinkop, + int rows, + int cols, + int filter, + const bool hide_buttons); +void uiTemplateIDTabs(uiLayout *layout, + struct bContext *C, + PointerRNA *ptr, + const char *propname, + const char *newop, + const char *menu, + int filter); +void uiTemplateAnyID(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + const char *proptypename, + const char *text); +void uiTemplateSearch(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *searchptr, + const char *searchpropname, + const char *newop, + const char *unlinkop); +void uiTemplateSearchPreview(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *searchptr, + const char *searchpropname, + const char *newop, + const char *unlinkop, + const int rows, + const int cols); +void uiTemplatePathBuilder(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *root_ptr, + const char *text); uiLayout *uiTemplateModifier(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr); uiLayout *uiTemplateGpencilModifier(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr); -void uiTemplateGpencilColorPreview( - uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, - int rows, int cols, float scale, int filter); +void uiTemplateGpencilColorPreview(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + int rows, + int cols, + float scale, + int filter); uiLayout *uiTemplateShaderFx(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr); void uiTemplateOperatorRedoProperties(uiLayout *layout, const struct bContext *C); uiLayout *uiTemplateConstraint(uiLayout *layout, struct PointerRNA *ptr); -void uiTemplatePreview( - uiLayout *layout, struct bContext *C, struct ID *id, bool show_buttons, struct ID *parent, - struct MTex *slot, const char *preview_id); -void uiTemplateColorRamp(uiLayout *layout, struct PointerRNA *ptr, const char *propname, bool expand); +void uiTemplatePreview(uiLayout *layout, + struct bContext *C, + struct ID *id, + bool show_buttons, + struct ID *parent, + struct MTex *slot, + const char *preview_id); +void uiTemplateColorRamp(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + bool expand); void uiTemplateIcon(uiLayout *layout, int icon_value, float icon_scale); -void uiTemplateIconView( - uiLayout *layout, struct PointerRNA *ptr, const char *propname, bool show_labels, - float icon_scale, float icon_scale_popup); +void uiTemplateIconView(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + bool show_labels, + float icon_scale, + float icon_scale_popup); void uiTemplateHistogram(uiLayout *layout, struct PointerRNA *ptr, const char *propname); void uiTemplateWaveform(uiLayout *layout, struct PointerRNA *ptr, const char *propname); void uiTemplateVectorscope(uiLayout *layout, struct PointerRNA *ptr, const char *propname); -void uiTemplateCurveMapping( - uiLayout *layout, struct PointerRNA *ptr, const char *propname, int type, - bool levels, bool brush, bool neg_slope, bool tone); -void uiTemplateColorPicker(uiLayout *layout, struct PointerRNA *ptr, const char *propname, bool value_slider, bool lock, bool lock_luminosity, bool cubic); +void uiTemplateCurveMapping(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + int type, + bool levels, + bool brush, + bool neg_slope, + bool tone); +void uiTemplateColorPicker(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + bool value_slider, + bool lock, + bool lock_luminosity, + bool cubic); void uiTemplatePalette(uiLayout *layout, struct PointerRNA *ptr, const char *propname, bool color); void uiTemplateCryptoPicker(uiLayout *layout, struct PointerRNA *ptr, const char *propname); -void uiTemplateLayers( - uiLayout *layout, struct PointerRNA *ptr, const char *propname, - PointerRNA *used_ptr, const char *used_propname, int active_layer); -void uiTemplateImage(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, struct PointerRNA *userptr, bool compact, bool multiview); +void uiTemplateLayers(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + PointerRNA *used_ptr, + const char *used_propname, + int active_layer); +void uiTemplateImage(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *userptr, + bool compact, + bool multiview); void uiTemplateImageSettings(uiLayout *layout, struct PointerRNA *imfptr, bool color_management); void uiTemplateImageStereo3d(uiLayout *layout, struct PointerRNA *stereo3d_format_ptr); void uiTemplateImageViews(uiLayout *layout, struct PointerRNA *imaptr); void uiTemplateImageFormatViews(uiLayout *layout, PointerRNA *imfptr, PointerRNA *ptr); -void uiTemplateImageLayers(uiLayout *layout, struct bContext *C, struct Image *ima, struct ImageUser *iuser); -void uiTemplateImageInfo(uiLayout *layout, struct bContext *C, struct Image *ima, struct ImageUser *iuser); +void uiTemplateImageLayers(uiLayout *layout, + struct bContext *C, + struct Image *ima, + struct ImageUser *iuser); +void uiTemplateImageInfo(uiLayout *layout, + struct bContext *C, + struct Image *ima, + struct ImageUser *iuser); void uiTemplateRunningJobs(uiLayout *layout, struct bContext *C); void UI_but_func_operator_search(uiBut *but); void uiTemplateOperatorSearch(uiLayout *layout); -eAutoPropButsReturn uiTemplateOperatorPropertyButs( - const struct bContext *C, uiLayout *layout, struct wmOperator *op, - const eButLabelAlign label_align, const short flag); +eAutoPropButsReturn uiTemplateOperatorPropertyButs(const struct bContext *C, + uiLayout *layout, + struct wmOperator *op, + const eButLabelAlign label_align, + const short flag); void uiTemplateHeader3D_mode(uiLayout *layout, struct bContext *C); void uiTemplateHeader3D(uiLayout *layout, struct bContext *C); void uiTemplateEditModeSelection(uiLayout *layout, struct bContext *C); void uiTemplateReportsBanner(uiLayout *layout, struct bContext *C); void uiTemplateInputStatus(uiLayout *layout, struct bContext *C); void uiTemplateKeymapItemProperties(uiLayout *layout, struct PointerRNA *ptr); -void uiTemplateComponentMenu(uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *name); +void uiTemplateComponentMenu(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + const char *name); void uiTemplateNodeSocket(uiLayout *layout, struct bContext *C, float *color); -void uiTemplateCacheFile(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname); +void uiTemplateCacheFile(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname); struct ColorBand *UI_block_get_colorband_from_template_menu(struct uiBlock *block); /* Default UIList class name, keep in sync with its declaration in bl_ui/__init__.py */ #define UI_UL_DEFAULT_CLASS_NAME "UI_UL_list" -void uiTemplateList( - uiLayout *layout, struct bContext *C, const char *listtype_name, const char *list_id, - struct PointerRNA *dataptr, const char *propname, struct PointerRNA *active_dataptr, - const char *active_propname, const char *item_dyntip_propname, - int rows, int maxrows, int layout_type, int columns, bool sort_reverse, bool sort_lock); -void uiTemplateNodeLink(uiLayout *layout, struct bNodeTree *ntree, struct bNode *node, struct bNodeSocket *input); -void uiTemplateNodeView(uiLayout *layout, struct bContext *C, struct bNodeTree *ntree, struct bNode *node, struct bNodeSocket *input); +void uiTemplateList(uiLayout *layout, + struct bContext *C, + const char *listtype_name, + const char *list_id, + struct PointerRNA *dataptr, + const char *propname, + struct PointerRNA *active_dataptr, + const char *active_propname, + const char *item_dyntip_propname, + int rows, + int maxrows, + int layout_type, + int columns, + bool sort_reverse, + bool sort_lock); +void uiTemplateNodeLink(uiLayout *layout, + struct bNodeTree *ntree, + struct bNode *node, + struct bNodeSocket *input); +void uiTemplateNodeView(uiLayout *layout, + struct bContext *C, + struct bNodeTree *ntree, + struct bNode *node, + struct bNodeSocket *input); void uiTemplateTextureUser(uiLayout *layout, struct bContext *C); -void uiTemplateTextureShow(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, struct PropertyRNA *prop); - -void uiTemplateMovieClip(struct uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname, bool compact); +void uiTemplateTextureShow(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + struct PropertyRNA *prop); + +void uiTemplateMovieClip(struct uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname, + bool compact); void uiTemplateTrack(struct uiLayout *layout, struct PointerRNA *ptr, const char *propname); -void uiTemplateMarker(struct uiLayout *layout, struct PointerRNA *ptr, const char *propname, PointerRNA *userptr, PointerRNA *trackptr, bool compact); -void uiTemplateMovieclipInformation(struct uiLayout *layout, struct PointerRNA *ptr, const char *propname, struct PointerRNA *userptr); - -void uiTemplateColorspaceSettings(struct uiLayout *layout, struct PointerRNA *ptr, const char *propname); -void uiTemplateColormanagedViewSettings(struct uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, const char *propname); +void uiTemplateMarker(struct uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + PointerRNA *userptr, + PointerRNA *trackptr, + bool compact); +void uiTemplateMovieclipInformation(struct uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *userptr); + +void uiTemplateColorspaceSettings(struct uiLayout *layout, + struct PointerRNA *ptr, + const char *propname); +void uiTemplateColormanagedViewSettings(struct uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + const char *propname); int uiTemplateRecentFiles(struct uiLayout *layout, int rows); /* items */ void uiItemO(uiLayout *layout, const char *name, int icon, const char *opname); -void uiItemEnumO_ptr(uiLayout *layout, struct wmOperatorType *ot, const char *name, int icon, const char *propname, int value); -void uiItemEnumO(uiLayout *layout, const char *opname, const char *name, int icon, const char *propname, int value); -void uiItemEnumO_value(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value); -void uiItemEnumO_string(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, const char *value); +void uiItemEnumO_ptr(uiLayout *layout, + struct wmOperatorType *ot, + const char *name, + int icon, + const char *propname, + int value); +void uiItemEnumO(uiLayout *layout, + const char *opname, + const char *name, + int icon, + const char *propname, + int value); +void uiItemEnumO_value(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + int value); +void uiItemEnumO_string(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + const char *value); void uiItemsEnumO(uiLayout *layout, const char *opname, const char *propname); -void uiItemBooleanO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value); -void uiItemIntO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, int value); -void uiItemFloatO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, float value); -void uiItemStringO(uiLayout *layout, const char *name, int icon, const char *opname, const char *propname, const char *value); - -void uiItemFullO_ptr( - uiLayout *layout, struct wmOperatorType *ot, const char *name, int icon, - struct IDProperty *properties, int context, int flag, - PointerRNA *r_opptr); -void uiItemFullO( - uiLayout *layout, const char *idname, const char *name, int icon, - struct IDProperty *properties, int context, int flag, - PointerRNA *r_opptr); -void uiItemFullOMenuHold_ptr( - uiLayout *layout, struct wmOperatorType *ot, const char *name, int icon, - struct IDProperty *properties, int context, int flag, - const char *menu_id, /* extra menu arg. */ - PointerRNA *r_opptr); - -void uiItemR(uiLayout *layout, struct PointerRNA *ptr, const char *propname, int flag, const char *name, int icon); -void uiItemFullR( - uiLayout *layout, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, int value, int flag, - const char *name, int icon); -void uiItemFullR_with_popover( - uiLayout *layout, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, int value, int flag, - const char *name, int icon, - const char *panel_type); -void uiItemFullR_with_menu( - uiLayout *layout, struct PointerRNA *ptr, struct PropertyRNA *prop, int index, int value, int flag, - const char *name, int icon, - const char *menu_type); -void uiItemEnumR_prop(uiLayout *layout, const char *name, int icon, struct PointerRNA *ptr, PropertyRNA *prop, int value); -void uiItemEnumR(uiLayout *layout, const char *name, int icon, struct PointerRNA *ptr, const char *propname, int value); -void uiItemEnumR_string_prop(uiLayout *layout, struct PointerRNA *ptr, PropertyRNA *prop, const char *value, const char *name, int icon); -void uiItemEnumR_string(uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *value, const char *name, int icon); +void uiItemBooleanO(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + int value); +void uiItemIntO(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + int value); +void uiItemFloatO(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + float value); +void uiItemStringO(uiLayout *layout, + const char *name, + int icon, + const char *opname, + const char *propname, + const char *value); + +void uiItemFullO_ptr(uiLayout *layout, + struct wmOperatorType *ot, + const char *name, + int icon, + struct IDProperty *properties, + int context, + int flag, + PointerRNA *r_opptr); +void uiItemFullO(uiLayout *layout, + const char *idname, + const char *name, + int icon, + struct IDProperty *properties, + int context, + int flag, + PointerRNA *r_opptr); +void uiItemFullOMenuHold_ptr(uiLayout *layout, + struct wmOperatorType *ot, + const char *name, + int icon, + struct IDProperty *properties, + int context, + int flag, + const char *menu_id, /* extra menu arg. */ + PointerRNA *r_opptr); + +void uiItemR(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + int flag, + const char *name, + int icon); +void uiItemFullR(uiLayout *layout, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + int value, + int flag, + const char *name, + int icon); +void uiItemFullR_with_popover(uiLayout *layout, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + int value, + int flag, + const char *name, + int icon, + const char *panel_type); +void uiItemFullR_with_menu(uiLayout *layout, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + int index, + int value, + int flag, + const char *name, + int icon, + const char *menu_type); +void uiItemEnumR_prop(uiLayout *layout, + const char *name, + int icon, + struct PointerRNA *ptr, + PropertyRNA *prop, + int value); +void uiItemEnumR(uiLayout *layout, + const char *name, + int icon, + struct PointerRNA *ptr, + const char *propname, + int value); +void uiItemEnumR_string_prop(uiLayout *layout, + struct PointerRNA *ptr, + PropertyRNA *prop, + const char *value, + const char *name, + int icon); +void uiItemEnumR_string(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + const char *value, + const char *name, + int icon); void uiItemsEnumR(uiLayout *layout, struct PointerRNA *ptr, const char *propname); -void uiItemPointerR_prop(uiLayout *layout, struct PointerRNA *ptr, PropertyRNA *prop, struct PointerRNA *searchptr, PropertyRNA *searchprop, const char *name, int icon); -void uiItemPointerR(uiLayout *layout, struct PointerRNA *ptr, const char *propname, struct PointerRNA *searchptr, const char *searchpropname, const char *name, int icon); -void uiItemsFullEnumO( - uiLayout *layout, const char *opname, const char *propname, - struct IDProperty *properties, int context, int flag); -void uiItemsFullEnumO_items( - uiLayout *layout, struct wmOperatorType *ot, PointerRNA ptr, PropertyRNA *prop, - struct IDProperty *properties, int context, int flag, - const EnumPropertyItem *item_array, int totitem); +void uiItemPointerR_prop(uiLayout *layout, + struct PointerRNA *ptr, + PropertyRNA *prop, + struct PointerRNA *searchptr, + PropertyRNA *searchprop, + const char *name, + int icon); +void uiItemPointerR(uiLayout *layout, + struct PointerRNA *ptr, + const char *propname, + struct PointerRNA *searchptr, + const char *searchpropname, + const char *name, + int icon); +void uiItemsFullEnumO(uiLayout *layout, + const char *opname, + const char *propname, + struct IDProperty *properties, + int context, + int flag); +void uiItemsFullEnumO_items(uiLayout *layout, + struct wmOperatorType *ot, + PointerRNA ptr, + PropertyRNA *prop, + struct IDProperty *properties, + int context, + int flag, + const EnumPropertyItem *item_array, + int totitem); void uiItemL(uiLayout *layout, const char *name, int icon); /* label */ /* label icon for dragging */ @@ -1288,98 +2216,129 @@ void uiItemS_ex(uiLayout *layout, float factor); void uiItemSpacer(uiLayout *layout); void uiItemPopoverPanel_ptr( - uiLayout *layout, struct bContext *C, - struct PanelType *pt, - const char *name, int icon); + uiLayout *layout, struct bContext *C, struct PanelType *pt, const char *name, int icon); void uiItemPopoverPanel( - uiLayout *layout, struct bContext *C, - const char *panelname, - const char *name, int icon); -void uiItemPopoverPanelFromGroup( - uiLayout *layout, struct bContext *C, - int space_id, int region_id, - const char *context, const char *category); + uiLayout *layout, struct bContext *C, const char *panelname, const char *name, int icon); +void uiItemPopoverPanelFromGroup(uiLayout *layout, + struct bContext *C, + int space_id, + int region_id, + const char *context, + const char *category); void uiItemMenuF(uiLayout *layout, const char *name, int icon, uiMenuCreateFunc func, void *arg); void uiItemMenuFN(uiLayout *layout, const char *name, int icon, uiMenuCreateFunc func, void *argN); -void uiItemMenuEnumO_ptr(uiLayout *layout, struct bContext *C, struct wmOperatorType *ot, const char *propname, const char *name, int icon); -void uiItemMenuEnumO(uiLayout *layout, struct bContext *C, const char *opname, const char *propname, const char *name, int icon); -void uiItemMenuEnumR_prop(uiLayout *layout, struct PointerRNA *ptr, PropertyRNA *prop, const char *name, int icon); -void uiItemMenuEnumR(uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *name, int icon); -void uiItemTabsEnumR_prop(uiLayout *layout, struct bContext *C, struct PointerRNA *ptr, PropertyRNA *prop, bool icon_only); +void uiItemMenuEnumO_ptr(uiLayout *layout, + struct bContext *C, + struct wmOperatorType *ot, + const char *propname, + const char *name, + int icon); +void uiItemMenuEnumO(uiLayout *layout, + struct bContext *C, + const char *opname, + const char *propname, + const char *name, + int icon); +void uiItemMenuEnumR_prop( + uiLayout *layout, struct PointerRNA *ptr, PropertyRNA *prop, const char *name, int icon); +void uiItemMenuEnumR( + uiLayout *layout, struct PointerRNA *ptr, const char *propname, const char *name, int icon); +void uiItemTabsEnumR_prop(uiLayout *layout, + struct bContext *C, + struct PointerRNA *ptr, + PropertyRNA *prop, + bool icon_only); /* UI Operators */ typedef struct uiDragColorHandle { - float color[3]; - bool gamma_corrected; + float color[3]; + bool gamma_corrected; } uiDragColorHandle; void ED_operatortypes_ui(void); void ED_keymap_ui(struct wmKeyConfig *keyconf); void UI_drop_color_copy(struct wmDrag *drag, struct wmDropBox *drop); -bool UI_drop_color_poll(struct bContext *C, struct wmDrag *drag, const struct wmEvent *event, const char **tooltip); - -bool UI_context_copy_to_selected_list( - struct bContext *C, struct PointerRNA *ptr, struct PropertyRNA *prop, - struct ListBase *r_lb, bool *r_use_path_from_id, char **r_path); +bool UI_drop_color_poll(struct bContext *C, + struct wmDrag *drag, + const struct wmEvent *event, + const char **tooltip); + +bool UI_context_copy_to_selected_list(struct bContext *C, + struct PointerRNA *ptr, + struct PropertyRNA *prop, + struct ListBase *r_lb, + bool *r_use_path_from_id, + char **r_path); /* Helpers for Operators */ uiBut *UI_context_active_but_get(const struct bContext *C); -uiBut *UI_context_active_but_prop_get( - const struct bContext *C, - struct PointerRNA *r_ptr, struct PropertyRNA **r_prop, int *r_index); +uiBut *UI_context_active_but_prop_get(const struct bContext *C, + struct PointerRNA *r_ptr, + struct PropertyRNA **r_prop, + int *r_index); void UI_context_active_but_prop_handle(struct bContext *C); struct wmOperator *UI_context_active_operator_get(const struct bContext *C); void UI_context_update_anim_flag(const struct bContext *C); -void UI_context_active_but_prop_get_filebrowser( - const struct bContext *C, - struct PointerRNA *r_ptr, struct PropertyRNA **r_prop, bool *r_is_undo); -void UI_context_active_but_prop_get_templateID( - struct bContext *C, - struct PointerRNA *r_ptr, struct PropertyRNA **r_prop); +void UI_context_active_but_prop_get_filebrowser(const struct bContext *C, + struct PointerRNA *r_ptr, + struct PropertyRNA **r_prop, + bool *r_is_undo); +void UI_context_active_but_prop_get_templateID(struct bContext *C, + struct PointerRNA *r_ptr, + struct PropertyRNA **r_prop); struct ID *UI_context_active_but_get_tab_ID(struct bContext *C); uiBut *UI_region_active_but_get(struct ARegion *ar); /* uiFontStyle.align */ typedef enum eFontStyle_Align { - UI_STYLE_TEXT_LEFT = 0, - UI_STYLE_TEXT_CENTER = 1, - UI_STYLE_TEXT_RIGHT = 2, + UI_STYLE_TEXT_LEFT = 0, + UI_STYLE_TEXT_CENTER = 1, + UI_STYLE_TEXT_RIGHT = 2, } eFontStyle_Align; struct uiFontStyleDraw_Params { - eFontStyle_Align align; - uint word_wrap : 1; + eFontStyle_Align align; + uint word_wrap : 1; }; /* Styled text draw */ void UI_fontstyle_set(const struct uiFontStyle *fs); -void UI_fontstyle_draw_ex( - const struct uiFontStyle *fs, const struct rcti *rect, const char *str, - const uchar col[4], const struct uiFontStyleDraw_Params *fs_params, - size_t len, float *r_xofs, float *r_yofs); -void UI_fontstyle_draw( - const struct uiFontStyle *fs, const struct rcti *rect, const char *str, - const uchar col[4], const struct uiFontStyleDraw_Params *fs_params); -void UI_fontstyle_draw_rotated( - const struct uiFontStyle *fs, const struct rcti *rect, const char *str, - const uchar col[4]); +void UI_fontstyle_draw_ex(const struct uiFontStyle *fs, + const struct rcti *rect, + const char *str, + const uchar col[4], + const struct uiFontStyleDraw_Params *fs_params, + size_t len, + float *r_xofs, + float *r_yofs); +void UI_fontstyle_draw(const struct uiFontStyle *fs, + const struct rcti *rect, + const char *str, + const uchar col[4], + const struct uiFontStyleDraw_Params *fs_params); +void UI_fontstyle_draw_rotated(const struct uiFontStyle *fs, + const struct rcti *rect, + const char *str, + const uchar col[4]); void UI_fontstyle_draw_simple( - const struct uiFontStyle *fs, float x, float y, const char *str, - const uchar col[4]); -void UI_fontstyle_draw_simple_backdrop( - const struct uiFontStyle *fs, float x, float y, const char *str, - const float col_fg[4], const float col_bg[4]); + const struct uiFontStyle *fs, float x, float y, const char *str, const uchar col[4]); +void UI_fontstyle_draw_simple_backdrop(const struct uiFontStyle *fs, + float x, + float y, + const char *str, + const float col_fg[4], + const float col_bg[4]); int UI_fontstyle_string_width(const struct uiFontStyle *fs, const char *str); int UI_fontstyle_height_max(const struct uiFontStyle *fs); void UI_draw_icon_tri(float x, float y, char dir, const float[4]); -struct uiStyle *UI_style_get(void); /* use for fonts etc */ -struct uiStyle *UI_style_get_dpi(void); /* DPI scaled settings for drawing */ +struct uiStyle *UI_style_get(void); /* use for fonts etc */ +struct uiStyle *UI_style_get_dpi(void); /* DPI scaled settings for drawing */ /* linker workaround ack! */ void UI_template_fix_linking(void); @@ -1403,7 +2362,10 @@ bool UI_butstore_register_update(uiBlock *block, uiBut *but_dst, const uiBut *bu void UI_butstore_unregister(uiButStore *bs_handle, uiBut **but_p); /* ui_interface_region_tooltip.c */ -struct ARegion *UI_tooltip_create_from_button(struct bContext *C, struct ARegion *butregion, uiBut *but, bool is_label); +struct ARegion *UI_tooltip_create_from_button(struct bContext *C, + struct ARegion *butregion, + uiBut *but, + bool is_label); struct ARegion *UI_tooltip_create_from_gizmo(struct bContext *C, struct wmGizmo *gz); void UI_tooltip_free(struct bContext *C, struct bScreen *sc, struct ARegion *ar); @@ -1436,4 +2398,4 @@ void UI_style_init_default(void); /* Support click-drag motion which presses the button and closes a popover (like a menu). */ #define USE_UI_POPOVER_ONCE -#endif /* __UI_INTERFACE_H__ */ +#endif /* __UI_INTERFACE_H__ */ |