Merge branch 'blender2.7'
[blender.git] / source / blender / editors / interface / interface_intern.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  *
16  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
17  * All rights reserved.
18  */
19
20 /** \file
21  * \ingroup edinterface
22  */
23
24
25 #ifndef __INTERFACE_INTERN_H__
26 #define __INTERFACE_INTERN_H__
27
28 #include "BLI_compiler_attrs.h"
29 #include "UI_resources.h"
30 #include "RNA_types.h"
31 #include "DNA_listBase.h"
32
33 struct ARegion;
34 struct ID;
35 struct ImBuf;
36 struct Scene;
37 struct bContext;
38 struct bContextStore;
39 struct uiHandleButtonData;
40 struct uiLayout;
41 struct uiStyle;
42 struct uiWidgetColors;
43 struct wmEvent;
44 struct wmKeyConfig;
45 struct wmOperatorType;
46 struct wmTimer;
47
48 /* ****************** general defines ************** */
49
50 #define RNA_NO_INDEX    -1
51 #define RNA_ENUM_VALUE  -2
52
53 #define UI_MENU_PADDING (int)(0.2f * UI_UNIT_Y)
54
55 #define UI_MENU_WIDTH_MIN       (UI_UNIT_Y * 9)
56 /* some extra padding added to menus containing submenu icons */
57 #define UI_MENU_SUBMENU_PADDING (6 * UI_DPI_FAC)
58
59 /* menu scrolling */
60 #define UI_MENU_SCROLL_ARROW    12
61 #define UI_MENU_SCROLL_MOUSE    (UI_MENU_SCROLL_ARROW + 2)
62 #define UI_MENU_SCROLL_PAD              4
63
64 /* panel limits */
65 #define UI_PANEL_MINX   100
66 #define UI_PANEL_MINY   70
67
68 /* popover width (multiplied by 'U.widget_unit') */
69 #define UI_POPOVER_WIDTH_UNITS 10
70
71 /* uiBut->flag */
72 enum {
73         UI_SELECT       = (1 << 0),  /* use when the button is pressed */
74         UI_SCROLLED     = (1 << 1),  /* temp hidden, scrolled away */
75         UI_ACTIVE       = (1 << 2),
76         UI_HAS_ICON     = (1 << 3),
77         UI_HIDDEN       = (1 << 4),
78         UI_SELECT_DRAW  = (1 << 5),  /* Display selected, doesn't impact interaction. */
79         /* warn: rest of uiBut->flag in UI_interface.h */
80 };
81
82 /* some buttons display icons only under special conditions
83  * (e.g. 'x' icon in search menu) - used with ui_but_icon_extra_get */
84 typedef enum uiButExtraIconType {
85         UI_BUT_ICONEXTRA_NONE = 1,
86         UI_BUT_ICONEXTRA_CLEAR,
87         UI_BUT_ICONEXTRA_EYEDROPPER,
88 } uiButExtraIconType;
89
90 /* uiBut->dragflag */
91 enum {
92         UI_BUT_DRAGPOIN_FREE = (1 << 0),
93 };
94
95 /* but->pie_dir */
96 typedef enum RadialDirection {
97         UI_RADIAL_NONE  = -1,
98         UI_RADIAL_N     =  0,
99         UI_RADIAL_NE    =  1,
100         UI_RADIAL_E     =  2,
101         UI_RADIAL_SE    =  3,
102         UI_RADIAL_S     =  4,
103         UI_RADIAL_SW    =  5,
104         UI_RADIAL_W     =  6,
105         UI_RADIAL_NW    =  7,
106 } RadialDirection;
107
108 extern const char  ui_radial_dir_order[8];
109 extern const char  ui_radial_dir_to_numpad[8];
110 extern const short ui_radial_dir_to_angle[8];
111
112 /* internal panel drawing defines */
113 #define PNL_GRID    (UI_UNIT_Y / 5) /* 4 default */
114 #define PNL_HEADER  (UI_UNIT_Y * 1.2)  /* 24 default */
115
116 /* bit button defines */
117 /* Bit operations */
118 #define UI_BITBUT_TEST(a, b)           (((a) &  (1 << (b))) != 0)
119 #define UI_BITBUT_VALUE_TOGGLED(a, b)   ((a) ^  (1 << (b)))
120 #define UI_BITBUT_VALUE_ENABLED(a, b)   ((a) |  (1 << (b)))
121 #define UI_BITBUT_VALUE_DISABLED(a, b)  ((a) & ~(1 << (b)))
122
123 /* bit-row */
124 #define UI_BITBUT_ROW(min, max)  (((max) >= 31 ? 0xFFFFFFFF : (1 << ((max) + 1)) - 1) - ((min) ? ((1 << (min)) - 1) : 0) )
125
126 /* split numbuts by ':' and align l/r */
127 #define USE_NUMBUTS_LR_ALIGN
128
129 /* Use new 'align' computation code. */
130 #define USE_UIBUT_SPATIAL_ALIGN
131
132 /* PieMenuData->flags */
133 enum {
134         /** pie menu item collision is detected at 90 degrees */
135         UI_PIE_DEGREES_RANGE_LARGE  = (1 << 0),
136         /** use initial center of pie menu to calculate direction */
137         UI_PIE_INITIAL_DIRECTION    = (1 << 1),
138         /** pie menu is drag style */
139         UI_PIE_DRAG_STYLE           = (1 << 2),
140         /** mouse not far enough from center position  */
141         UI_PIE_INVALID_DIR          = (1 << 3),
142         /** pie menu changed to click style, click to confirm  */
143         UI_PIE_CLICK_STYLE          = (1 << 4),
144         /** pie animation finished, do not calculate any more motion  */
145         UI_PIE_ANIMATION_FINISHED   = (1 << 5),
146         /** pie gesture selection has been done, now wait for mouse motion to end */
147         UI_PIE_GESTURE_END_WAIT     = (1 << 6),
148 };
149
150 #define PIE_CLICK_THRESHOLD_SQ 50.0f
151
152 /* max amount of items a radial menu (pie menu) can contain */
153 #define PIE_MAX_ITEMS 8
154
155 struct uiBut {
156         struct uiBut *next, *prev;
157         int flag, drawflag;
158         eButType         type;
159         eButPointerType  pointype;
160         short bit, bitnr, retval, strwidth, alignnr;
161         short ofs, pos, selsta, selend;
162
163         char *str;
164         char strdata[UI_MAX_NAME_STR];
165         char drawstr[UI_MAX_DRAW_STR];
166
167         rctf rect;  /* block relative coords */
168
169         char *poin;
170         float hardmin, hardmax, softmin, softmax;
171
172         /* both these values use depends on the button type
173          * (polymorphic struct or union would be nicer for this stuff) */
174
175         /* (type == UI_BTYPE_HSVCUBE),    Use UI_GRAD_* values.
176          * (type == UI_BTYPE_NUM),        Use to store RNA 'step' value, for dragging and click-step.
177          * (type == UI_BTYPE_LABEL),      Use (a1 == 1.0f) to use a2 as a blending factor (wow, this is imaginative!).
178          * (type == UI_BTYPE_SCROLL)      Use as scroll size.
179          * (type == UI_BTYPE_SEARCH_MENU) Use as number or rows.
180          * (type == UI_BTYPE_COLOR)       Use as indication of color palette
181          * (type == UI_BTYPE_PROGRESS_BAR) Use to store progress (0..1).
182          */
183         float a1;
184
185         /* (type == UI_BTYPE_HSVCIRCLE ), Use to store the luminosity.
186          * (type == UI_BTYPE_NUM),        Use to store RNA 'precision' value, for dragging and click-step.
187          * (type == UI_BTYPE_LABEL),      If (a1 == 1.0f) use a2 as a blending factor.
188          * (type == UI_BTYPE_SEARCH_MENU) Use as number or columns.
189          * (type == UI_BTYPE_COLOR)       Use as index in palette (not so good, needs refactor)
190          */
191         float a2;
192
193         uchar col[4];
194
195         uiButHandleFunc func;
196         void *func_arg1;
197         void *func_arg2;
198
199         uiButHandleNFunc funcN;
200         void *func_argN;
201
202         struct bContextStore *context;
203
204         uiButCompleteFunc autocomplete_func;
205         void *autofunc_arg;
206
207         uiButSearchCreateFunc search_create_func;
208         uiButSearchFunc search_func;
209         bool free_search_arg;
210         void *search_arg;
211
212         uiButHandleRenameFunc rename_func;
213         void *rename_arg1;
214         void *rename_orig;
215
216         /** Run an action when holding the button down. */
217         uiButHandleHoldFunc hold_func;
218         void *hold_argN;
219
220         const char *tip;
221         uiButToolTipFunc tip_func;
222         void *tip_argN;
223
224         /** info on why button is disabled, displayed in tooltip */
225         const char *disabled_info;
226
227         BIFIconID icon;
228         /** drawtype: UI_EMBOSS, UI_EMBOSS_NONE ... etc, copied from the block */
229         char dt;
230         /** direction in a pie menu, used for collision detection (RadialDirection) */
231         signed char pie_dir;
232         /** could be made into a single flag */
233         bool changed;
234         /** so buttons can support unit systems which are not RNA */
235         uchar unit_type;
236         short modifier_key;
237         short iconadd;
238
239         /* UI_BTYPE_BLOCK data */
240         uiBlockCreateFunc block_create_func;
241
242         /* UI_BTYPE_PULLDOWN/UI_BTYPE_MENU data */
243         uiMenuCreateFunc menu_create_func;
244
245         uiMenuStepFunc menu_step_func;
246
247         /* RNA data */
248         struct PointerRNA rnapoin;
249         struct PropertyRNA *rnaprop;
250         int rnaindex;
251
252         struct PointerRNA rnasearchpoin;
253         struct PropertyRNA *rnasearchprop;
254
255         /* Operator data */
256         struct wmOperatorType *optype;
257         struct PointerRNA *opptr;
258         short opcontext;
259         uchar menu_key; /* 'a'-'z', always lower case */
260
261         /* Draggable data, type is WM_DRAG_... */
262         char dragtype;
263         short dragflag;
264         void *dragpoin;
265         struct ImBuf *imb;
266         float imb_scale;
267
268         /* active button data */
269         struct uiHandleButtonData *active;
270
271         /* Custom button data. */
272         void *custom_data;
273
274         char *editstr;
275         double *editval;
276         float *editvec;
277         void *editcoba;
278         void *editcumap;
279
280         uiButPushedStateFunc pushed_state_func;
281         void *pushed_state_arg;
282
283         /* pointer back */
284         uiBlock *block;
285 };
286
287 typedef struct uiButTab {
288         uiBut but;
289         struct MenuType *menu;
290 } uiButTab;
291
292 typedef struct ColorPicker {
293         struct ColorPicker *next, *prev;
294         /** Color data, may be HSV or HSL. */
295         float color_data[3];
296         /** Initial color data (detect changes). */
297         float color_data_init[3];
298         bool is_init;
299         /** Cubic saturation for the color wheel. */
300         bool use_color_cubic;
301         bool use_color_lock;
302         bool use_luminosity_lock;
303         float luminosity_lock_value;
304 } ColorPicker;
305
306 typedef struct ColorPickerData {
307         ListBase list;
308 } ColorPickerData;
309
310 struct PieMenuData {
311         /** store title and icon to allow access when pie levels are created */
312         const char *title;
313         int icon;
314
315         float pie_dir[2];
316         float pie_center_init[2];
317         float pie_center_spawned[2];
318         float last_pos[2];
319         double duration_gesture;
320         int flags;
321         /** initial event used to fire the pie menu, store here so we can query for release */
322         int event;
323         float alphafac;
324 };
325
326 /* uiBlock.content_hints */
327 enum eBlockContentHints {
328         /** In a menu block, if there is a single sub-menu button, we add some
329          * padding to the right to put nicely aligned triangle icons there. */
330         UI_BLOCK_CONTAINS_SUBMENU_BUT = (1 << 0),
331 };
332
333 struct uiBlock {
334         uiBlock *next, *prev;
335
336         ListBase buttons;
337         Panel *panel;
338         uiBlock *oldblock;
339
340         ListBase butstore;  /* UI_butstore_* runtime function */
341
342         ListBase layouts;
343         struct uiLayout *curlayout;
344
345         ListBase contexts;
346
347         char name[UI_MAX_NAME_STR];
348
349         float winmat[4][4];
350
351         rctf rect;
352         float aspect;
353
354         uint puphash;  /* popup menu hash for memory */
355
356         uiButHandleFunc func;
357         void *func_arg1;
358         void *func_arg2;
359
360         uiButHandleNFunc funcN;
361         void *func_argN;
362
363         uiMenuHandleFunc butm_func;
364         void *butm_func_arg;
365
366         uiBlockHandleFunc handle_func;
367         void *handle_func_arg;
368
369         /* custom extra handling */
370         int (*block_event_func)(const struct bContext *C, struct uiBlock *, const struct wmEvent *);
371
372         /* extra draw function for custom blocks */
373         void (*drawextra)(const struct bContext *C, void *idv, void *arg1, void *arg2, rcti *rect);
374         void *drawextra_arg1;
375         void *drawextra_arg2;
376
377         int flag;
378         short alignnr;
379         /** Hints about the buttons of this block. Used to avoid iterating over
380          * buttons to find out if some criteria is met by any. Instead, check this
381          * criteria when adding the button and set a flag here if it's met. */
382         short content_hints; /* eBlockContentHints */
383
384         char direction;
385         /** UI_BLOCK_THEME_STYLE_* */
386         char theme_style;
387         /** drawtype: UI_EMBOSS, UI_EMBOSS_NONE ... etc, copied to buttons */
388         char dt;
389         bool auto_open;
390         char _pad[5];
391         double auto_open_last;
392
393         const char *lockstr;
394
395         char lock;
396         /** to keep blocks while drawing and free them afterwards */
397         char active;
398         /** to avoid tooltip after click */
399         char tooltipdisabled;
400         /** UI_block_end done? */
401         char endblock;
402
403         /** for doing delayed */
404         eBlockBoundsCalc bounds_type;
405         /** Offset to use when calculating bounds (in pixels). */
406         int bounds_offset[2];
407         /** for doing delayed */
408         int bounds, minbounds;
409
410         /** pulldowns, to detect outside, can differ per case how it is created */
411         rctf safety;
412         /** uiSafetyRct list */
413         ListBase saferct;
414
415         uiPopupBlockHandle *handle; /* handle */
416
417         /** use so presets can find the operator,
418          * across menus and from nested popups which fail for operator context. */
419         struct wmOperator *ui_operator;
420
421         /** XXX hack for dynamic operator enums */
422         void *evil_C;
423
424         /** unit system, used a lot for numeric buttons so include here
425          * rather then fetching through the scene every time. */
426         struct UnitSettings *unit;
427         /** \note only accessed by color picker templates. */
428         ColorPickerData color_pickers;
429
430         bool is_color_gamma_picker; /* Block for color picker with gamma baked in. */
431
432         /** display device name used to display this block,
433          * used by color widgets to transform colors from/to scene linear
434          */
435         char display_device[64];
436
437         struct PieMenuData pie_data;
438 };
439
440 typedef struct uiSafetyRct {
441         struct uiSafetyRct *next, *prev;
442         rctf parent;
443         rctf safety;
444 } uiSafetyRct;
445
446 /* interface.c */
447
448 void ui_fontscale(short *points, float aspect);
449
450 extern void ui_block_to_window_fl(const struct ARegion *ar, uiBlock *block, float *x, float *y);
451 extern void ui_block_to_window(const struct ARegion *ar, uiBlock *block, int *x, int *y);
452 extern void ui_block_to_window_rctf(const struct ARegion *ar, uiBlock *block, rctf *rct_dst, const rctf *rct_src);
453 extern float ui_block_to_window_scale(const struct ARegion *ar, uiBlock *block);
454 extern void ui_window_to_block_fl(const struct ARegion *ar, uiBlock *block, float *x, float *y);
455 extern void ui_window_to_block(const struct ARegion *ar, uiBlock *block, int *x, int *y);
456 extern void ui_window_to_region(const ARegion *ar, int *x, int *y);
457 extern void ui_region_to_window(const struct ARegion *ar, int *x, int *y);
458 extern void ui_region_winrct_get_no_margin(const struct ARegion *ar, struct rcti *r_rect);
459
460 extern double ui_but_value_get(uiBut *but);
461 extern void ui_but_value_set(uiBut *but, double value);
462 extern void ui_but_hsv_set(uiBut *but);
463 extern void ui_but_v3_get(uiBut *but, float vec[3]);
464 extern void ui_but_v3_set(uiBut *but, const float vec[3]);
465
466 extern void ui_hsvcircle_vals_from_pos(
467         const rcti *rect, const float mx, const float my,
468         float *r_val_rad, float *r_val_dist);
469 extern void ui_hsvcircle_pos_from_vals(const ColorPicker *cpicker, const rcti *rect, const float *hsv, float *xpos, float *ypos);
470 extern void ui_hsvcube_pos_from_vals(const struct uiBut *but, const rcti *rect, const float *hsv, float *xp, float *yp);
471
472 extern void ui_but_string_get_ex(
473         uiBut *but, char *str, const size_t maxlen,
474         const int float_precision, const bool use_exp_float, bool *r_use_exp_float) ATTR_NONNULL(1, 2);
475 extern void ui_but_string_get(uiBut *but, char *str, const size_t maxlen) ATTR_NONNULL();
476 extern char *ui_but_string_get_dynamic(uiBut *but, int *r_str_size);
477 extern void ui_but_convert_to_unit_alt_name(uiBut *but, char *str, size_t maxlen) ATTR_NONNULL();
478 extern bool ui_but_string_set(struct bContext *C, uiBut *but, const char *str) ATTR_NONNULL();
479 extern bool ui_but_string_set_eval_num(struct bContext *C, uiBut *but, const char *str, double *value) ATTR_NONNULL();
480 extern int  ui_but_string_get_max_length(uiBut *but);
481 extern uiBut *ui_but_drag_multi_edit_get(uiBut *but);
482
483 void ui_def_but_icon(uiBut *but, const int icon, const int flag);
484 extern uiButExtraIconType ui_but_icon_extra_get(uiBut *but);
485
486 extern void ui_but_default_set(struct bContext *C, const bool all, const bool use_afterfunc);
487
488 extern void ui_but_rna_menu_convert_to_panel_type(struct uiBut *but, const char *panel_type);
489 extern void ui_but_rna_menu_convert_to_menu_type(struct uiBut *but, const char *menu_type);
490 extern bool ui_but_menu_draw_as_popover(const uiBut *but);
491
492 extern void ui_but_update(uiBut *but);
493 extern void ui_but_update_edited(uiBut *but);
494 extern bool ui_but_is_float(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
495 extern bool ui_but_is_bool(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
496 extern bool ui_but_is_unit(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
497 extern bool ui_but_is_compatible(const uiBut *but_a, const uiBut *but_b) ATTR_WARN_UNUSED_RESULT;
498 extern bool ui_but_is_rna_valid(uiBut *but) ATTR_WARN_UNUSED_RESULT;
499 extern bool ui_but_supports_cycling(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
500
501 extern int  ui_but_is_pushed_ex(uiBut *but, double *value) ATTR_WARN_UNUSED_RESULT;
502 extern int  ui_but_is_pushed(uiBut *but) ATTR_WARN_UNUSED_RESULT;
503
504 void ui_but_override_flag(uiBut *but);
505
506 extern void ui_block_bounds_calc(uiBlock *block);
507
508 extern struct ColorManagedDisplay *ui_block_cm_display_get(uiBlock *block);
509 void ui_block_cm_to_display_space_v3(uiBlock *block, float pixel[3]);
510
511 /* interface_regions.c */
512
513 struct uiKeyNavLock {
514         /* set when we're using keyinput */
515         bool is_keynav;
516         /* only used to check if we've moved the cursor */
517         int event_xy[2];
518 };
519
520 typedef uiBlock * (*uiBlockHandleCreateFunc)(struct bContext *C, struct uiPopupBlockHandle *handle, void *arg1);
521 typedef void (*uiBlockHandleFreeFunc)(struct uiPopupBlockHandle *handle, void *arg1);
522
523 struct uiPopupBlockCreate {
524         uiBlockCreateFunc       create_func;
525         uiBlockHandleCreateFunc handle_create_func;
526         uiBlockHandleFreeFunc   free_func;
527         void *arg;
528
529         int event_xy[2];
530
531         /* when popup is initialized from a button */
532         ARegion *butregion;
533         uiBut *but;
534 };
535
536 struct uiPopupBlockHandle {
537         /* internal */
538         struct ARegion *region;
539
540         /* use only for 'UI_BLOCK_MOVEMOUSE_QUIT' popups */
541         float towards_xy[2];
542         double towardstime;
543         bool dotowards;
544
545         bool popup;
546         void (*popup_func)(struct bContext *C, void *arg, int event);
547         void (*cancel_func)(struct bContext *C, void *arg);
548         void *popup_arg;
549
550         /* store data for refreshing popups */
551         struct uiPopupBlockCreate popup_create_vars;
552         /* true if we can re-create the popup using 'popup_create_vars' */
553         bool can_refresh;
554         bool refresh;
555
556         struct wmTimer *scrolltimer;
557         float scrolloffset;
558
559         struct uiKeyNavLock keynav_state;
560
561         /* for operator popups */
562         struct wmOperator *popup_op;
563         struct wmOperatorType *optype;
564         ScrArea *ctx_area;
565         ARegion *ctx_region;
566         int opcontext;
567
568         /* return values */
569         int butretval;
570         int menuretval;
571         int   retvalue;
572         float retvec[4];
573
574         /* menu direction */
575         int direction;
576
577         /* Previous values so we don't resize or reposition on refresh. */
578         rctf prev_block_rect;
579         rctf prev_butrct;
580         short prev_dir1, prev_dir2;
581         int prev_bounds_offset[2];
582
583         /* Maximum estimated size to avoid having to reposition on refresh. */
584         float max_size_x, max_size_y;
585
586 /* #ifdef USE_DRAG_POPUP */
587         bool is_grab;
588         int     grab_xy_prev[2];
589 /* #endif */
590 };
591
592 /* -------------------------------------------------------------------- */
593 /* interface_region_*.c */
594
595 /* interface_region_tooltip.c */
596 /* exposed as public API in UI_interface.h */
597
598 /* interface_region_color_picker.c */
599 void ui_rgb_to_color_picker_compat_v(const float rgb[3], float r_cp[3]);
600 void ui_rgb_to_color_picker_v(const float rgb[3], float r_cp[3]);
601 void ui_color_picker_to_rgb_v(const float r_cp[3], float rgb[3]);
602 void ui_color_picker_to_rgb(float r_cp0, float r_cp1, float r_cp2, float *r, float *g, float *b);
603
604 bool ui_but_is_color_gamma(uiBut *but);
605
606 void ui_scene_linear_to_color_picker_space(uiBut *but, float rgb[3]);
607 void ui_color_picker_to_scene_linear_space(uiBut *but, float rgb[3]);
608
609 uiBlock *ui_block_func_COLOR(struct bContext *C, uiPopupBlockHandle *handle, void *arg_but);
610 ColorPicker *ui_block_colorpicker_create(struct uiBlock *block);
611
612 /* interface_region_search.c */
613 /* Searchbox for string button */
614 ARegion *ui_searchbox_create_generic(struct bContext *C, struct ARegion *butregion, uiBut *but);
615 ARegion *ui_searchbox_create_operator(struct bContext *C, struct ARegion *butregion, uiBut *but);
616 bool ui_searchbox_inside(struct ARegion *ar, int x, int y);
617 int  ui_searchbox_find_index(struct ARegion *ar, const char *name);
618 void ui_searchbox_update(struct bContext *C, struct ARegion *ar, uiBut *but, const bool reset);
619 int ui_searchbox_autocomplete(struct bContext *C, struct ARegion *ar, uiBut *but, char *str);
620 void ui_searchbox_event(struct bContext *C, struct ARegion *ar, uiBut *but, const struct wmEvent *event);
621 bool ui_searchbox_apply(uiBut *but, struct ARegion *ar);
622 void ui_searchbox_free(struct bContext *C, struct ARegion *ar);
623 void ui_but_search_refresh(uiBut *but);
624
625 /* interface_region_menu_popup.c */
626 int    ui_but_menu_step(uiBut *but, int step);
627 bool   ui_but_menu_step_poll(const uiBut *but);
628 uiBut *ui_popup_menu_memory_get(struct uiBlock *block);
629 void   ui_popup_menu_memory_set(uiBlock *block, struct uiBut *but);
630
631 uiBlock *ui_popup_block_refresh(
632         struct bContext *C, uiPopupBlockHandle *handle,
633         ARegion *butregion, uiBut *but);
634
635 uiPopupBlockHandle *ui_popup_block_create(
636         struct bContext *C, struct ARegion *butregion, uiBut *but,
637         uiBlockCreateFunc create_func, uiBlockHandleCreateFunc handle_create_func,
638         void *arg);
639 uiPopupBlockHandle *ui_popup_menu_create(
640         struct bContext *C, struct ARegion *butregion, uiBut *but,
641         uiMenuCreateFunc create_func, void *arg);
642
643 /* interface_region_popover.c */
644 uiPopupBlockHandle *ui_popover_panel_create(
645         struct bContext *C, struct ARegion *butregion, uiBut *but,
646         uiMenuCreateFunc create_func, void *arg);
647
648 /* interface_region_menu_pie.c */
649 void ui_pie_menu_level_create(
650         uiBlock *block, struct wmOperatorType *ot, const char *propname, IDProperty *properties,
651         const EnumPropertyItem *items, int totitem, int context, int flag);
652
653 /* interface_region_popup.c */
654 void ui_popup_translate(struct ARegion *ar, const int mdiff[2]);
655 void ui_popup_block_free(struct bContext *C, uiPopupBlockHandle *handle);
656 void ui_popup_block_scrolltest(struct uiBlock *block);
657
658 /* end interface_region_*.c */
659
660
661 /* interface_panel.c */
662 extern int ui_handler_panel_region(
663         struct bContext *C, const struct wmEvent *event,
664         struct ARegion *ar, const uiBut *active_but);
665 extern void ui_draw_aligned_panel(
666         struct uiStyle *style, uiBlock *block, const rcti *rect,
667         const bool show_pin, const bool show_background);
668
669 /* interface_draw.c */
670 extern void ui_draw_dropshadow(const rctf *rct, float radius, float aspect, float alpha, int select);
671
672 void ui_draw_gradient(const rcti *rect, const float hsv[3], const int type, const float alpha);
673
674
675 void ui_draw_but_TAB_outline(const rcti *rect, float rad, uchar highlight[3], uchar highlight_fade[3]);
676 void ui_draw_but_HISTOGRAM(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
677 void ui_draw_but_WAVEFORM(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
678 void ui_draw_but_VECTORSCOPE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
679 void ui_draw_but_COLORBAND(uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
680 void ui_draw_but_UNITVEC(uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
681 void ui_draw_but_CURVE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
682 void ui_draw_but_IMAGE(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
683 void ui_draw_but_TRACKPREVIEW(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
684 void ui_draw_but_NODESOCKET(ARegion *ar, uiBut *but, const struct uiWidgetColors *wcol, const rcti *rect);
685
686 /* interface_handlers.c */
687 PointerRNA *ui_handle_afterfunc_add_operator(struct wmOperatorType *ot, int opcontext, bool create_props);
688 extern void ui_pan_to_scroll(const struct wmEvent *event, int *type, int *val);
689 extern void ui_but_activate_event(struct bContext *C, struct ARegion *ar, uiBut *but);
690 extern void ui_but_activate_over(struct bContext *C, struct ARegion *ar, uiBut *but);
691 extern void ui_but_execute_begin(struct bContext *C, struct ARegion *ar, uiBut *but, void **active_back);
692 extern void ui_but_execute_end(struct bContext *C, struct ARegion *ar, uiBut *but, void *active_back);
693 extern void ui_but_active_free(const struct bContext *C, uiBut *but);
694 extern int ui_but_menu_direction(uiBut *but);
695 extern void ui_but_text_password_hide(char password_str[UI_MAX_DRAW_STR], uiBut *but, const bool restore);
696 extern uiBut *ui_but_find_select_in_enum(uiBut *but, int direction);
697 bool ui_but_is_editing(const uiBut *but);
698 float ui_block_calc_pie_segment(struct uiBlock *block, const float event_xy[2]);
699
700 void ui_but_add_shortcut(uiBut *but, const char *key_str, const bool do_strip);
701 void ui_but_clipboard_free(void);
702 uiBut *ui_but_find_old(uiBlock *block_old, const uiBut *but_new);
703 uiBut *ui_but_find_new(uiBlock *block_old, const uiBut *but_new);
704
705 #ifdef WITH_INPUT_IME
706 void ui_but_ime_reposition(uiBut *but, int x, int y, bool complete);
707 struct wmIMEData *ui_but_ime_data_get(uiBut *but);
708 #endif
709
710 /* interface_widgets.c */
711
712 /* Widget shader parameters, must match the shader layout. */
713 typedef struct uiWidgetBaseParameters {
714         rctf recti, rect;
715         float radi, rad;
716         float facxi, facyi;
717         float round_corners[4];
718         float color_inner1[4], color_inner2[4];
719         float color_outline[4], color_emboss[4];
720         float color_tria[4];
721         float tria1_center[2], tria2_center[2];
722         float tria1_size, tria2_size;
723         float shade_dir;
724         /* We pack alpha check and discard factor in alpha_discard.
725          * If the value is negative then we do alpha check.
726          * The absolute value itself is the discard factor.
727          * Initialize value to 1.0.f if you don't want discard */
728         float alpha_discard;
729 } uiWidgetBaseParameters;
730
731 enum {
732         ROUNDBOX_TRIA_NONE = 0,
733         ROUNDBOX_TRIA_ARROWS,
734         ROUNDBOX_TRIA_SCROLL,
735         ROUNDBOX_TRIA_MENU,
736         ROUNDBOX_TRIA_CHECK,
737         ROUNDBOX_TRIA_HOLD_ACTION_ARROW,
738
739         ROUNDBOX_TRIA_MAX, /* don't use */
740 };
741
742 struct GPUBatch *ui_batch_roundbox_get(bool filled, bool antialiased);
743 struct GPUBatch *ui_batch_roundbox_widget_get(int tria);
744 struct GPUBatch *ui_batch_roundbox_shadow_get(void);
745
746 void ui_draw_anti_tria_rect(const rctf *rect, char dir, const float color[4]);
747 void ui_draw_menu_back(struct uiStyle *style, uiBlock *block, rcti *rect);
748 void ui_draw_popover_back(ARegion *ar, struct uiStyle *style, uiBlock *block, rcti *rect);
749 void ui_draw_pie_center(uiBlock *block);
750 const struct uiWidgetColors *ui_tooltip_get_theme(void);
751
752 void ui_draw_widget_menu_back_color(const rcti *rect, bool use_shadow, const float color[4]);
753 void ui_draw_widget_menu_back(const rcti *rect, bool use_shadow);
754 void ui_draw_tooltip_background(struct uiStyle *UNUSED(style), uiBlock *block, rcti *rect);
755
756 extern void ui_draw_but(const struct bContext *C, ARegion *ar, struct uiStyle *style, uiBut *but, rcti *rect);
757
758 void ui_draw_menu_item(const struct uiFontStyle *fstyle, rcti *rect, const char *name, int iconid, int state, bool use_sep);
759 void ui_draw_preview_item(const struct uiFontStyle *fstyle, rcti *rect, const char *name, int iconid, int state);
760
761 #define UI_TEXT_MARGIN_X 0.4f
762 #define UI_POPUP_MARGIN (UI_DPI_FAC * 12)
763 /* margin at top of screen for popups */
764 #define UI_POPUP_MENU_TOP (int)(8 * UI_DPI_FAC)
765
766 #define UI_PIXEL_AA_JITTER 8
767 extern const float ui_pixel_jitter[UI_PIXEL_AA_JITTER][2];
768
769 /* interface_style.c */
770 void uiStyleInit(void);
771
772 /* interface_icons.c */
773 void ui_icon_ensure_deferred(const struct bContext *C, const int icon_id, const bool big);
774 int ui_id_icon_get(const struct bContext *C, struct ID *id, const bool big);
775
776 /* interface_icons_event.c */
777 void icon_draw_rect_input(
778         float x, float y, int w, int h, float alpha,
779         short event_type, short event_value);
780
781 /* resources.c */
782 void init_userdef_do_versions(struct Main *bmain);
783 void ui_resources_init(void);
784 void ui_resources_free(void);
785
786 /* interface_layout.c */
787 void ui_layout_add_but(uiLayout *layout, uiBut *but);
788 void ui_but_add_search(uiBut *but, PointerRNA *ptr, PropertyRNA *prop, PointerRNA *searchptr, PropertyRNA *searchprop);
789 void ui_layout_list_set_labels_active(uiLayout *layout);
790 /* menu callback */
791 void ui_item_menutype_func(struct bContext *C, struct uiLayout *layout, void *arg_mt);
792 void ui_item_paneltype_func(struct bContext *C, struct uiLayout *layout, void *arg_pt);
793
794 /* interface_align.c */
795 bool ui_but_can_align(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
796 int  ui_but_align_opposite_to_area_align_get(const ARegion *ar) ATTR_WARN_UNUSED_RESULT;
797 void ui_block_align_calc(uiBlock *block, const ARegion *region);
798
799 /* interface_anim.c */
800 void ui_but_anim_flag(uiBut *but, float cfra);
801 void ui_but_anim_copy_driver(struct bContext *C);
802 void ui_but_anim_paste_driver(struct bContext *C);
803 bool ui_but_anim_expression_get(uiBut *but, char *str, size_t maxlen);
804 bool ui_but_anim_expression_set(uiBut *but, const char *str);
805 bool ui_but_anim_expression_create(uiBut *but, const char *str);
806 void ui_but_anim_autokey(struct bContext *C, uiBut *but, struct Scene *scene, float cfra);
807
808 void ui_but_anim_decorate_cb(struct bContext *C, void *arg_but, void *arg_dummy);
809 void ui_but_anim_decorate_update_from_flag(uiBut *but);
810
811 /* interface_query.c */
812 bool ui_but_is_editable(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
813 bool ui_but_is_editable_as_text(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
814 bool ui_but_is_toggle(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
815 bool ui_but_is_interactive(const uiBut *but, const bool labeledit) ATTR_WARN_UNUSED_RESULT;
816 bool ui_but_is_utf8(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
817 bool ui_but_is_popover_once_compat(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
818 bool ui_but_has_array_value(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
819 void ui_but_pie_dir(RadialDirection dir, float vec[2]);
820
821 bool ui_but_is_cursor_warp(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
822
823 bool ui_but_contains_pt(
824         const uiBut *but, float mx, float my) ATTR_WARN_UNUSED_RESULT;
825 bool ui_but_contains_point_px_icon(
826         const uiBut *but, struct  ARegion *ar, const struct wmEvent *event) ATTR_WARN_UNUSED_RESULT;
827 bool ui_but_contains_point_px(
828         const uiBut *but, const struct ARegion *ar, int x, int y) ATTR_WARN_UNUSED_RESULT;
829
830 uiBut *ui_list_find_mouse_over(struct ARegion *ar, const struct wmEvent *event) ATTR_WARN_UNUSED_RESULT;
831
832 uiBut *ui_but_find_mouse_over_ex(struct ARegion *ar, const int x, const int y, const bool labeledit) ATTR_WARN_UNUSED_RESULT;
833 uiBut *ui_but_find_mouse_over(struct ARegion *ar, const struct wmEvent *event) ATTR_WARN_UNUSED_RESULT;
834
835 uiBut *ui_list_find_mouse_over_ex(struct ARegion *ar, int x, int y) ATTR_WARN_UNUSED_RESULT;
836
837 bool ui_but_contains_password(const uiBut *but) ATTR_WARN_UNUSED_RESULT;
838
839 uiBut *ui_but_prev(uiBut *but) ATTR_WARN_UNUSED_RESULT;
840 uiBut *ui_but_next(uiBut *but) ATTR_WARN_UNUSED_RESULT;
841 uiBut *ui_but_first(uiBlock *block) ATTR_WARN_UNUSED_RESULT;
842 uiBut *ui_but_last(uiBlock *block) ATTR_WARN_UNUSED_RESULT;
843
844 bool ui_block_is_menu(const uiBlock *block) ATTR_WARN_UNUSED_RESULT;
845 bool ui_block_is_popover(const uiBlock *block) ATTR_WARN_UNUSED_RESULT;
846 bool ui_block_is_pie_menu(const uiBlock *block) ATTR_WARN_UNUSED_RESULT;
847 bool ui_block_is_popup_any(const uiBlock *block) ATTR_WARN_UNUSED_RESULT;
848
849 uiBut *ui_region_find_first_but_test_flag(struct ARegion *ar, int flag_include, int flag_exclude);
850 uiBut *ui_region_find_active_but(struct ARegion *ar) ATTR_WARN_UNUSED_RESULT;
851 bool ui_region_contains_point_px(
852         const struct ARegion *ar, int x, int y) ATTR_WARN_UNUSED_RESULT;
853
854 /* interface_context_menu.c */
855 bool ui_popup_context_menu_for_button(struct bContext *C, uiBut *but);
856 void ui_popup_context_menu_for_panel(struct bContext *C, struct ARegion *ar, struct Panel *pa);
857
858 /* interface_eyedropper.c */
859 struct wmKeyMap *eyedropper_modal_keymap(struct wmKeyConfig *keyconf);
860 struct wmKeyMap *eyedropper_colorband_modal_keymap(struct wmKeyConfig *keyconf);
861
862 /* interface_eyedropper_color.c */
863 void UI_OT_eyedropper_color(struct wmOperatorType *ot);
864
865 /* interface_eyedropper_colorband.c */
866 void UI_OT_eyedropper_colorramp(struct wmOperatorType *ot);
867 void UI_OT_eyedropper_colorramp_point(struct wmOperatorType *ot);
868
869 /* interface_eyedropper_datablock.c */
870 void UI_OT_eyedropper_id(struct wmOperatorType *ot);
871
872 /* interface_eyedropper_depth.c */
873 void UI_OT_eyedropper_depth(struct wmOperatorType *ot);
874
875 /* interface_eyedropper_driver.c */
876 void UI_OT_eyedropper_driver(struct wmOperatorType *ot);
877
878 /* interface_util.c */
879
880 /**
881  * For use with #ui_rna_collection_search_cb.
882  */
883 typedef struct uiRNACollectionSearch {
884         PointerRNA target_ptr;
885         PropertyRNA *target_prop;
886
887         PointerRNA search_ptr;
888         PropertyRNA *search_prop;
889
890         bool *but_changed; /* pointer to uiBut.changed */
891 } uiRNACollectionSearch;
892 void ui_rna_collection_search_cb(const struct bContext *C, void *arg, const char *str, uiSearchItems *items);
893
894 /* interface_ops.c */
895 bool ui_jump_to_target_button_poll(struct bContext *C);
896
897
898 #endif  /* __INTERFACE_INTERN_H__ */