348 lines
16 KiB
C
348 lines
16 KiB
C
/*
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* The Original Code is Copyright (C) 2007 Blender Foundation.
|
|
* All rights reserved.
|
|
*
|
|
*
|
|
* Contributor(s): Blender Foundation
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
#ifndef __WM_API_H__
|
|
#define __WM_API_H__
|
|
|
|
/** \file WM_api.h
|
|
* \ingroup wm
|
|
*
|
|
* \page wmpage windowmanager
|
|
* \section wmabout About windowmanager
|
|
* \ref wm handles events received from \ref GHOST and manages
|
|
* the screens, areas and input for Blender
|
|
* \section wmnote NOTE
|
|
* \todo document
|
|
*/
|
|
|
|
/* dna-savable wmStructs here */
|
|
#include "DNA_windowmanager_types.h"
|
|
#include "WM_keymap.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct bContext;
|
|
struct IDProperty;
|
|
struct wmEvent;
|
|
struct wmEventHandler;
|
|
struct wmGesture;
|
|
struct wmJob;
|
|
struct wmNotifier;
|
|
struct wmOperatorType;
|
|
struct wmOperator;
|
|
struct rcti;
|
|
struct PointerRNA;
|
|
struct EnumPropertyItem;
|
|
struct MenuType;
|
|
struct wmDropBox;
|
|
struct wmDrag;
|
|
struct ImBuf;
|
|
|
|
typedef struct wmJob wmJob;
|
|
|
|
/* general API */
|
|
void WM_setprefsize (int stax, int stay, int sizx, int sizy);
|
|
void WM_setinitialstate_fullscreen(void);
|
|
void WM_setinitialstate_normal(void);
|
|
|
|
void WM_init (struct bContext *C, int argc, const char **argv);
|
|
void WM_exit_ext (struct bContext *C, const short do_python);
|
|
void WM_exit (struct bContext *C);
|
|
void WM_main (struct bContext *C);
|
|
|
|
int WM_init_game (struct bContext *C);
|
|
void WM_init_splash (struct bContext *C);
|
|
|
|
|
|
void WM_check (struct bContext *C);
|
|
|
|
struct wmWindow *WM_window_open (struct bContext *C, struct rcti *rect);
|
|
|
|
/* defines for 'type' WM_window_open_temp */
|
|
#define WM_WINDOW_RENDER 0
|
|
#define WM_WINDOW_USERPREFS 1
|
|
#define WM_WINDOW_FILESEL 2
|
|
|
|
void WM_window_open_temp (struct bContext *C, struct rcti *position, int type);
|
|
|
|
|
|
|
|
/* files */
|
|
int WM_read_homefile_exec(struct bContext *C, struct wmOperator *op);
|
|
int WM_read_homefile (struct bContext *C, struct ReportList *reports, short from_memory);
|
|
int WM_write_homefile (struct bContext *C, struct wmOperator *op);
|
|
void WM_read_file (struct bContext *C, const char *filepath, struct ReportList *reports);
|
|
int WM_write_file (struct bContext *C, const char *target, int fileflags, struct ReportList *reports, int copy);
|
|
void WM_autosave_init (struct wmWindowManager *wm);
|
|
|
|
/* mouse cursors */
|
|
void WM_cursor_set (struct wmWindow *win, int curs);
|
|
void WM_cursor_modal (struct wmWindow *win, int curs);
|
|
void WM_cursor_restore (struct wmWindow *win);
|
|
void WM_cursor_wait (int val);
|
|
void WM_cursor_grab(struct wmWindow *win, int wrap, int hide, int *bounds);
|
|
void WM_cursor_ungrab(struct wmWindow *win);
|
|
void WM_timecursor (struct wmWindow *win, int nr);
|
|
|
|
void *WM_paint_cursor_activate(struct wmWindowManager *wm,
|
|
int (*poll)(struct bContext *C),
|
|
void (*draw)(struct bContext *C, int, int, void *customdata),
|
|
void *customdata);
|
|
|
|
void WM_paint_cursor_end(struct wmWindowManager *wm, void *handle);
|
|
|
|
void WM_cursor_warp (struct wmWindow *win, int x, int y);
|
|
|
|
/* event map */
|
|
int WM_userdef_event_map(int kmitype);
|
|
|
|
/* handlers */
|
|
|
|
struct wmEventHandler *WM_event_add_keymap_handler(ListBase *handlers, wmKeyMap *keymap);
|
|
/* boundbox, optional subwindow boundbox for offset */
|
|
struct wmEventHandler *WM_event_add_keymap_handler_bb(ListBase *handlers, wmKeyMap *keymap, rcti *bb, rcti *swinbb);
|
|
/* priority not implemented, it adds in begin */
|
|
struct wmEventHandler *WM_event_add_keymap_handler_priority(ListBase *handlers, wmKeyMap *keymap, int priority);
|
|
|
|
void WM_event_remove_keymap_handler(ListBase *handlers, wmKeyMap *keymap);
|
|
|
|
struct wmEventHandler *WM_event_add_ui_handler(const struct bContext *C, ListBase *handlers,
|
|
int (*func)(struct bContext *C, struct wmEvent *event, void *userdata),
|
|
void (*remove)(struct bContext *C, void *userdata), void *userdata);
|
|
void WM_event_remove_ui_handler(ListBase *handlers,
|
|
int (*func)(struct bContext *C, struct wmEvent *event, void *userdata),
|
|
void (*remove)(struct bContext *C, void *userdata), void *userdata, int postpone);
|
|
void WM_event_remove_area_handler(struct ListBase *handlers, void *area);
|
|
|
|
struct wmEventHandler *WM_event_add_modal_handler(struct bContext *C, struct wmOperator *op);
|
|
void WM_event_remove_handlers(struct bContext *C, ListBase *handlers);
|
|
|
|
struct wmEventHandler *WM_event_add_dropbox_handler(ListBase *handlers, ListBase *dropboxes);
|
|
|
|
/* mouse */
|
|
void WM_event_add_mousemove(struct bContext *C);
|
|
int WM_modal_tweak_exit(struct wmEvent *evt, int tweak_event);
|
|
|
|
/* notifiers */
|
|
void WM_event_add_notifier(const struct bContext *C, unsigned int type, void *reference);
|
|
void WM_main_add_notifier(unsigned int type, void *reference);
|
|
|
|
void wm_event_add (struct wmWindow *win, struct wmEvent *event_to_add); /* XXX only for warning */
|
|
|
|
/* at maximum, every timestep seconds it triggers event_type events */
|
|
struct wmTimer *WM_event_add_timer(struct wmWindowManager *wm, struct wmWindow *win, int event_type, double timestep);
|
|
void WM_event_remove_timer(struct wmWindowManager *wm, struct wmWindow *win, struct wmTimer *timer);
|
|
void WM_event_timer_sleep(struct wmWindowManager *wm, struct wmWindow *win, struct wmTimer *timer, int dosleep);
|
|
|
|
/* operator api, default callbacks */
|
|
/* invoke callback, uses enum property named "type" */
|
|
int WM_menu_invoke (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_enum_search_invoke(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
/* invoke callback, confirm menu + exec */
|
|
int WM_operator_confirm (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
/* invoke callback, file selector "filepath" unset + exec */
|
|
int WM_operator_filesel (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_operator_filesel_ensure_ext_imtype(wmOperator *op, const char imtype);
|
|
/* poll callback, context checks */
|
|
int WM_operator_winactive (struct bContext *C);
|
|
/* invoke callback, exec + redo popup */
|
|
int WM_operator_props_popup (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_operator_props_dialog_popup (struct bContext *C, struct wmOperator *op, int width, int height);
|
|
int WM_operator_redo_popup (struct bContext *C, struct wmOperator *op);
|
|
int WM_operator_ui_popup (struct bContext *C, struct wmOperator *op, int width, int height);
|
|
|
|
int WM_operator_confirm_message(struct bContext *C, struct wmOperator *op, const char *message);
|
|
|
|
/* operator api */
|
|
void WM_operator_free (struct wmOperator *op);
|
|
void WM_operator_stack_clear(struct wmWindowManager *wm);
|
|
|
|
struct wmOperatorType *WM_operatortype_find(const char *idnamem, int quiet);
|
|
struct GHashIterator *WM_operatortype_iter(void);
|
|
void WM_operatortype_append (void (*opfunc)(struct wmOperatorType*));
|
|
void WM_operatortype_append_ptr (void (*opfunc)(struct wmOperatorType*, void *), void *userdata);
|
|
void WM_operatortype_append_macro_ptr (void (*opfunc)(struct wmOperatorType*, void *), void *userdata);
|
|
int WM_operatortype_remove(const char *idname);
|
|
|
|
struct wmOperatorType *WM_operatortype_append_macro(const char *idname, const char *name, const char *description, int flag);
|
|
struct wmOperatorTypeMacro *WM_operatortype_macro_define(struct wmOperatorType *ot, const char *idname);
|
|
|
|
|
|
int WM_operator_poll (struct bContext *C, struct wmOperatorType *ot);
|
|
int WM_operator_poll_context(struct bContext *C, struct wmOperatorType *ot, int context);
|
|
int WM_operator_call (struct bContext *C, struct wmOperator *op);
|
|
int WM_operator_call_notest(struct bContext *C, struct wmOperator *op);
|
|
int WM_operator_repeat (struct bContext *C, struct wmOperator *op);
|
|
int WM_operator_repeat_check(const struct bContext *C, struct wmOperator *op);
|
|
int WM_operator_name_call (struct bContext *C, const char *opstring, int context, struct PointerRNA *properties);
|
|
int WM_operator_call_py(struct bContext *C, struct wmOperatorType *ot, int context, struct PointerRNA *properties, struct ReportList *reports);
|
|
|
|
void WM_operator_properties_alloc(struct PointerRNA **ptr, struct IDProperty **properties, const char *opstring); /* used for keymap and macro items */
|
|
void WM_operator_properties_sanitize(struct PointerRNA *ptr, const short no_context); /* make props context sensitive or not */
|
|
void WM_operator_properties_reset(struct wmOperator *op);
|
|
void WM_operator_properties_create(struct PointerRNA *ptr, const char *opstring);
|
|
void WM_operator_properties_create_ptr(struct PointerRNA *ptr, struct wmOperatorType *ot);
|
|
void WM_operator_properties_free(struct PointerRNA *ptr);
|
|
void WM_operator_properties_filesel(struct wmOperatorType *ot, int filter, short type, short action, short flag, short display);
|
|
void WM_operator_properties_gesture_border(struct wmOperatorType *ot, int extend);
|
|
void WM_operator_properties_gesture_straightline(struct wmOperatorType *ot, int cursor);
|
|
void WM_operator_properties_select_all(struct wmOperatorType *ot);
|
|
|
|
int WM_operator_check_ui_enabled(const struct bContext *C, const char *idname);
|
|
wmOperator *WM_operator_last_redo(const struct bContext *C);
|
|
|
|
int WM_operator_last_properties_init(struct wmOperator *op);
|
|
int WM_operator_last_properties_store(struct wmOperator *op);
|
|
|
|
/* MOVE THIS SOMEWHERE ELSE */
|
|
#define SEL_TOGGLE 0
|
|
#define SEL_SELECT 1
|
|
#define SEL_DESELECT 2
|
|
#define SEL_INVERT 3
|
|
|
|
|
|
/* flags for WM_operator_properties_filesel */
|
|
#define WM_FILESEL_RELPATH (1 << 0)
|
|
|
|
#define WM_FILESEL_DIRECTORY (1 << 1)
|
|
#define WM_FILESEL_FILENAME (1 << 2)
|
|
#define WM_FILESEL_FILEPATH (1 << 3)
|
|
#define WM_FILESEL_FILES (1 << 4)
|
|
|
|
|
|
/* operator as a python command (resultuing string must be freed) */
|
|
char *WM_operator_pystring(struct bContext *C, struct wmOperatorType *ot, struct PointerRNA *opptr, int all_args);
|
|
void WM_operator_bl_idname(char *to, const char *from);
|
|
void WM_operator_py_idname(char *to, const char *from);
|
|
|
|
/* *************** menu types ******************** */
|
|
void WM_menutype_init(void);
|
|
struct MenuType *WM_menutype_find(const char *idname, int quiet);
|
|
int WM_menutype_add(struct MenuType* mt);
|
|
void WM_menutype_freelink(struct MenuType* mt);
|
|
void WM_menutype_free(void);
|
|
|
|
/* default operator callbacks for border/circle/lasso */
|
|
int WM_border_select_invoke (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_border_select_modal (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_border_select_cancel(struct bContext *C, struct wmOperator *op);
|
|
int WM_gesture_circle_invoke(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_circle_modal(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_circle_cancel(struct bContext *C, struct wmOperator *op);
|
|
int WM_gesture_lines_invoke(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_lines_modal(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_lines_cancel(struct bContext *C, struct wmOperator *op);
|
|
int WM_gesture_lasso_invoke(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_lasso_modal(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_lasso_cancel(struct bContext *C, struct wmOperator *op);
|
|
int WM_gesture_straightline_invoke(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_straightline_modal(struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
int WM_gesture_straightline_cancel(struct bContext *C, struct wmOperator *op);
|
|
|
|
/* Gesture manager API */
|
|
struct wmGesture *WM_gesture_new(struct bContext *C, struct wmEvent *event, int type);
|
|
void WM_gesture_end(struct bContext *C, struct wmGesture *gesture);
|
|
void WM_gestures_remove(struct bContext *C);
|
|
|
|
/* fileselecting support */
|
|
void WM_event_add_fileselect(struct bContext *C, struct wmOperator *op);
|
|
void WM_event_fileselect_event(struct bContext *C, void *ophandle, int eventval);
|
|
#ifndef NDEBUG
|
|
void WM_event_print(struct wmEvent *event);
|
|
#endif
|
|
|
|
/* drag and drop */
|
|
struct wmDrag *WM_event_start_drag(struct bContext *C, int icon, int type, void *poin, double value);
|
|
void WM_event_drag_image(struct wmDrag *, struct ImBuf *, float scale, int sx, int sy);
|
|
|
|
struct wmDropBox *WM_dropbox_add(ListBase *lb, const char *idname, int (*poll)(struct bContext *, struct wmDrag *, struct wmEvent *event),
|
|
void (*copy)(struct wmDrag *, struct wmDropBox *));
|
|
ListBase *WM_dropboxmap_find(const char *idname, int spaceid, int regionid);
|
|
|
|
/* Set a subwindow active in pixelspace view, with optional scissor subset */
|
|
void wmSubWindowSet (struct wmWindow *win, int swinid);
|
|
void wmSubWindowScissorSet (struct wmWindow *win, int swinid, struct rcti *srct);
|
|
|
|
/* OpenGL utilities with safety check + working in modelview matrix mode */
|
|
void wmFrustum (float x1, float x2, float y1, float y2, float n, float f);
|
|
void wmOrtho (float x1, float x2, float y1, float y2, float n, float f);
|
|
void wmOrtho2 (float x1, float x2, float y1, float y2);
|
|
|
|
/* utilities */
|
|
void WM_set_framebuffer_index_color(int index);
|
|
int WM_framebuffer_to_index(unsigned int col);
|
|
|
|
/* threaded Jobs Manager */
|
|
#define WM_JOB_PRIORITY 1
|
|
#define WM_JOB_EXCL_RENDER 2
|
|
#define WM_JOB_PROGRESS 4
|
|
#define WM_JOB_SUSPEND 8
|
|
|
|
struct wmJob *WM_jobs_get(struct wmWindowManager *wm, struct wmWindow *win, void *owner, const char *name, int flag);
|
|
|
|
int WM_jobs_test(struct wmWindowManager *wm, void *owner);
|
|
float WM_jobs_progress(struct wmWindowManager *wm, void *owner);
|
|
char *WM_jobs_name(struct wmWindowManager *wm, void *owner);
|
|
|
|
int WM_jobs_is_running(struct wmJob *);
|
|
void* WM_jobs_get_customdata(struct wmJob *);
|
|
void WM_jobs_customdata(struct wmJob *, void *customdata, void (*free)(void *));
|
|
void WM_jobs_timer(struct wmJob *, double timestep, unsigned int note, unsigned int endnote);
|
|
void WM_jobs_callbacks(struct wmJob *,
|
|
void (*startjob)(void *, short *, short *, float *),
|
|
void (*initjob)(void *),
|
|
void (*update)(void *),
|
|
void (*endjob)(void *));
|
|
|
|
void WM_jobs_start(struct wmWindowManager *wm, struct wmJob *);
|
|
void WM_jobs_stop(struct wmWindowManager *wm, void *owner, void *startjob);
|
|
void WM_jobs_kill(struct wmWindowManager *wm, void *owner, void (*)(void *, short int *, short int *, float *));
|
|
void WM_jobs_stop_all(struct wmWindowManager *wm);
|
|
|
|
int WM_jobs_has_running(struct wmWindowManager *wm);
|
|
|
|
/* clipboard */
|
|
char *WM_clipboard_text_get(int selection);
|
|
void WM_clipboard_text_set(char *buf, int selection);
|
|
|
|
/* progress */
|
|
void WM_progress_set(struct wmWindow *win, float progress);
|
|
void WM_progress_clear(struct wmWindow *win);
|
|
|
|
/* Draw (for screenshot) */
|
|
void WM_redraw_windows(struct bContext *C);
|
|
|
|
/* debugging only, convenience function to write on crash */
|
|
int write_crash_blend(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __WM_API_H__ */
|
|
|