Ton Roosendaal
13ac9079cc
- moved from WM to Screen code (it uses active area) - less code :) result of cleaning some calls - added WM_window_open() to WM API for this - now opens new window on top of area, and leaves old screen unaffected (simple, atomic, the 'do not think for user' convention :)
187 lines
7.3 KiB
C++
187 lines
7.3 KiB
C++
/**
|
|
* $Id:
|
|
*
|
|
* ***** 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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
|
|
|
|
/* dna-savable wmStructs here */
|
|
#include "DNA_windowmanager_types.h"
|
|
|
|
struct bContext;
|
|
struct wmEvent;
|
|
struct wmEventHandler;
|
|
struct wmGesture;
|
|
struct rcti;
|
|
|
|
/* general API */
|
|
void WM_setprefsize (int stax, int stay, int sizx, int sizy);
|
|
|
|
void WM_init (struct bContext *C);
|
|
void WM_exit (struct bContext *C);
|
|
void WM_main (struct bContext *C);
|
|
|
|
wmWindow *WM_window_open (struct bContext *C, struct rcti *rect);
|
|
|
|
/* files */
|
|
int WM_read_homefile (struct bContext *C, int from_memory);
|
|
int WM_write_homefile (struct bContext *C, struct wmOperator *op);
|
|
void WM_read_file (struct bContext *C, char *name);
|
|
void WM_write_file (struct bContext *C, char *target);
|
|
void WM_read_autosavefile(struct bContext *C);
|
|
void WM_write_autosave (struct bContext *C);
|
|
|
|
/* mouse cursors */
|
|
void WM_init_cursor_data (void);
|
|
void WM_set_cursor (struct bContext *C, int curs);
|
|
void WM_waitcursor (struct bContext *C, int val);
|
|
void WM_timecursor (struct bContext *C, int nr);
|
|
|
|
/* keymap and handlers */
|
|
void WM_keymap_set_item (ListBase *lb, char *idname, short type,
|
|
short val, int modifier, short keymodifier);
|
|
void WM_keymap_verify_item(ListBase *lb, char *idname, short type,
|
|
short val, int modifier, short keymodifier);
|
|
void WM_keymap_add_item (ListBase *lb, char *idname, short type,
|
|
short val, int modifier, short keymodifier);
|
|
struct wmEventHandler *WM_event_add_keymap_handler(ListBase *handlers, ListBase *keymap);
|
|
void WM_event_remove_keymap_handler(ListBase *handlers, ListBase *keymap);
|
|
struct wmEventHandler *WM_event_add_modal_handler(ListBase *handlers, wmOperator *op);
|
|
void WM_event_remove_modal_handler(ListBase *handlers, wmOperator *op);
|
|
void WM_event_remove_handlers(ListBase *handlers);
|
|
|
|
void WM_event_add_message(wmWindowManager *wm, void *customdata,
|
|
short customdatafree);
|
|
|
|
void WM_event_add_notifier(wmWindowManager *wm, wmWindow *window,
|
|
int swinid, int type,
|
|
int value, void *data);
|
|
|
|
void wm_event_add(wmWindow *win, struct wmEvent *event_to_add); /* XXX only for warning */
|
|
|
|
/* one-shot timer, returns wmTimerData.handle */
|
|
struct wmTimerHandle *WM_event_add_window_timer(wmWindow *win, int delay_ms, int interval_ms);
|
|
void WM_event_remove_window_timer(wmWindow *wm, struct wmTimerHandle *handle);
|
|
|
|
/* operator api, default callbacks */
|
|
/* confirm menu + exec */
|
|
int WM_operator_confirm (struct bContext *C, struct wmOperator *op, struct wmEvent *event);
|
|
/* context checks */
|
|
int WM_operator_winactive (struct bContext *C);
|
|
|
|
/* operator api */
|
|
wmOperatorType *WM_operatortype_find(const char *idname);
|
|
void WM_operatortype_append(void (*opfunc)(wmOperatorType*));
|
|
|
|
int WM_operator_invoke(struct bContext *C, wmOperatorType *ot, struct wmEvent *event);
|
|
void WM_operator_cancel(struct bContext *C, ListBase *modalops, wmOperatorType *ot);
|
|
|
|
/*
|
|
* Operator property api
|
|
*
|
|
* Some notes to take care:
|
|
*
|
|
* All the OP_set_* functions append a new property to the operator,
|
|
* if the property already exist, just replace it with the new
|
|
* value in other case make a new property and append it.
|
|
*
|
|
* The OP_get_string function is a "special case", this function
|
|
* return a pointer to property data, so don't change/resize/free
|
|
* the string, because probably we get a segfault.
|
|
* I really think that is better duplicate the string, so we are
|
|
* really sure that the property data don't change.
|
|
*
|
|
* OP_get_int/float/array return 1 on success (found the property)
|
|
* or 0 if can't find the property in the operator.
|
|
* The property value are store in the "value" pointer.
|
|
*
|
|
* OP_verify_* sets the value only if it wasn't set already, and
|
|
* returns the existing or new value.
|
|
*
|
|
* Both array function copy the property data into the "array"
|
|
* pointer, but you need init the len pointer to the "array" size.
|
|
*
|
|
* For example:
|
|
* int vec[] = { 1, 2, 3, 4 };
|
|
* OP_set_int_array (op, "vector", vec, 4);
|
|
*
|
|
* ...
|
|
*
|
|
* short len;
|
|
* int vec[4];
|
|
* len= 4; <---- set the size!!
|
|
* OP_get_int_array (op, "vector", vec, &len);
|
|
*/
|
|
void OP_set_int(wmOperator *op, char *name, int value);
|
|
void OP_set_float(wmOperator *op, char *name, float value);
|
|
void OP_set_string(wmOperator *op, char *name, char *str);
|
|
void OP_set_int_array(wmOperator *op, char *name, int *array, short len);
|
|
void OP_set_float_array(wmOperator *op, char *name, float *array, short len);
|
|
|
|
int OP_get_int(wmOperator *op, char *name, int *value);
|
|
int OP_get_float(wmOperator *op, char *name, float *value);
|
|
char *OP_get_string(wmOperator *op, char *name);
|
|
int OP_get_int_array(wmOperator *op, char *name, int *array, short *len);
|
|
int OP_get_float_array(wmOperator *op, char *name, float *array, short *len);
|
|
|
|
void OP_verify_int(wmOperator *op, char *name, int value, int *result);
|
|
void OP_verify_float(wmOperator *op, char *name, float value, int *result);
|
|
char *OP_verify_string(wmOperator *op, char *name, char *str);
|
|
void OP_verify_int_array(wmOperator *op, char *name, int *array, short len, int *resultarray, short *resultlen);
|
|
void OP_verify_float_array(wmOperator *op, char *name, float *array, short len, float *resultarray, short *resultlen);
|
|
|
|
/*
|
|
* Need call this function in the "exit callback"
|
|
* of the operator, but only if you use the property system.
|
|
**/
|
|
void OP_free_property(wmOperator *op);
|
|
|
|
/* Gesture manager API */
|
|
void WM_gesture_init(struct bContext *C, int type);
|
|
void WM_gesture_update(struct bContext *C, struct wmGesture *from);
|
|
void WM_gesture_end(struct bContext *C, int type);
|
|
void WM_gesture_free(wmWindow *win);
|
|
|
|
/* Reporting information and errors */
|
|
void WM_report(struct bContext *C, int type, const char *message);
|
|
void WM_reportf(struct bContext *C, int type, const char *format, ...);
|
|
|
|
/* OpenGL wrappers, mimicing opengl syntax */
|
|
void wmLoadMatrix (wmWindow *win, float mat[][4]);
|
|
void wmGetMatrix (wmWindow *win, float mat[][4]);
|
|
void wmMultMatrix (wmWindow *win, float mat[][4]);
|
|
void wmGetSingleMatrix (wmWindow *win, float mat[][4]);
|
|
void wmScale (wmWindow *win, float x, float y, float z);
|
|
void wmLoadIdentity (wmWindow *win); /* note: old name clear_view_mat */
|
|
|
|
void wmFrustum (wmWindow *win, float x1, float x2, float y1, float y2, float n, float f);
|
|
void wmOrtho (wmWindow *win, float x1, float x2, float y1, float y2, float n, float f);
|
|
void wmOrtho2 (wmWindow *win, float x1, float x2, float y1, float y2);
|
|
|
|
|
|
#endif /* WM_API_H */
|
|
|