/** * $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 ***** */ #include #include "DNA_screen_types.h" #include "DNA_windowmanager_types.h" #include "MEM_guardedalloc.h" #include "BLI_blenlib.h" #include "BKE_blender.h" #include "BKE_context.h" #include "BKE_idprop.h" #include "BKE_library.h" #include "BKE_main.h" #include "BKE_utildefines.h" #include "RNA_access.h" #include "RNA_types.h" #include "RNA_enum_types.h" #include "WM_api.h" #include "WM_types.h" #include "wm_window.h" #include "wm_event_system.h" #include "wm_event_types.h" /* ***************** generic call, exported **************** */ static void keymap_event_set(wmKeymapItem *kmi, short type, short val, int modifier, short keymodifier) { kmi->type= type; kmi->val= val; kmi->keymodifier= keymodifier; if(modifier == KM_ANY) { kmi->shift= kmi->ctrl= kmi->alt= kmi->oskey= KM_ANY; } else { kmi->shift= kmi->ctrl= kmi->alt= kmi->oskey= 0; /* defines? */ if(modifier & KM_SHIFT) kmi->shift= 1; else if(modifier & KM_SHIFT2) kmi->shift= 2; if(modifier & KM_CTRL) kmi->ctrl= 1; else if(modifier & KM_CTRL2) kmi->ctrl= 2; if(modifier & KM_ALT) kmi->alt= 1; else if(modifier & KM_ALT2) kmi->alt= 2; if(modifier & KM_OSKEY) kmi->oskey= 1; else if(modifier & KM_OSKEY2) kmi->oskey= 2; } } static void keymap_properties_set(wmKeymapItem *kmi) { if(!kmi->ptr) { kmi->ptr= MEM_callocN(sizeof(PointerRNA), "wmKeymapItemPtr"); WM_operator_properties_create(kmi->ptr, kmi->idname); } } /* if item was added, then bail out */ wmKeymapItem *WM_keymap_verify_item(wmKeyMap *keymap, char *idname, short type, short val, int modifier, short keymodifier) { wmKeymapItem *kmi; for(kmi= keymap->keymap.first; kmi; kmi= kmi->next) if(strncmp(kmi->idname, idname, OP_MAX_TYPENAME)==0) break; if(kmi==NULL) { kmi= MEM_callocN(sizeof(wmKeymapItem), "keymap entry"); BLI_addtail(&keymap->keymap, kmi); BLI_strncpy(kmi->idname, idname, OP_MAX_TYPENAME); keymap_event_set(kmi, type, val, modifier, keymodifier); keymap_properties_set(kmi); } return kmi; } /* always add item */ wmKeymapItem *WM_keymap_add_item(wmKeyMap *keymap, char *idname, short type, short val, int modifier, short keymodifier) { wmKeymapItem *kmi= MEM_callocN(sizeof(wmKeymapItem), "keymap entry"); BLI_addtail(&keymap->keymap, kmi); BLI_strncpy(kmi->idname, idname, OP_MAX_TYPENAME); keymap_event_set(kmi, type, val, modifier, keymodifier); keymap_properties_set(kmi); return kmi; } /* ****************** storage in WM ************ */ /* name id's are for storing general or multiple keymaps, space/region ids are same as DNA_space_types.h */ /* gets free'd in wm.c */ wmKeyMap *WM_keymap_find(wmWindowManager *wm, const char *nameid, short spaceid, short regionid) { wmKeyMap *km; for(km= wm->keymaps.first; km; km= km->next) if(km->spaceid==spaceid && km->regionid==regionid) if(0==strncmp(nameid, km->nameid, KMAP_MAX_NAME)) return km; if(km==NULL) { km= MEM_callocN(sizeof(struct wmKeyMap), "keymap list"); BLI_strncpy(km->nameid, nameid, KMAP_MAX_NAME); km->spaceid= spaceid; km->regionid= regionid; BLI_addtail(&wm->keymaps, km); } return km; } /* ****************** modal keymaps ************ */ /* modal maps get linked to a running operator, and filter the keys before sending to modal() callback */ wmKeyMap *WM_modalkeymap_add(wmWindowManager *wm, const char *nameid, EnumPropertyItem *items) { wmKeyMap *km= WM_keymap_find(wm, nameid, 0, 0); km->is_modal= 1; km->items= items; return km; } wmKeyMap *WM_modalkeymap_get(wmWindowManager *wm, const char *nameid) { wmKeyMap *km; for(km= wm->keymaps.first; km; km= km->next) if(km->is_modal) if(0==strncmp(nameid, km->nameid, KMAP_MAX_NAME)) break; return km; } void WM_modalkeymap_add_item(wmKeyMap *km, short type, short val, int modifier, short keymodifier, short value) { wmKeymapItem *kmi= MEM_callocN(sizeof(wmKeymapItem), "keymap entry"); BLI_addtail(&km->keymap, kmi); kmi->propvalue= value; keymap_event_set(kmi, type, val, modifier, keymodifier); } void WM_modalkeymap_assign(wmKeyMap *km, const char *opname) { wmOperatorType *ot= WM_operatortype_find(opname, 0); if(ot) ot->modalkeymap= km; else printf("error: modalkeymap_assign, unknown operator %s\n", opname); } /* ***************** get string from key events **************** */ const char *WM_key_event_string(short type) { const char *name= NULL; if(RNA_enum_name(event_type_items, (int)type, &name)) return name; return ""; } static char *wm_keymap_item_to_string(wmKeymapItem *kmi, char *str, int len) { char buf[100]; buf[0]= 0; if(kmi->shift) strcat(buf, "Shift "); if(kmi->ctrl) strcat(buf, "Ctrl "); if(kmi->alt) strcat(buf, "Alt "); if(kmi->oskey) strcat(buf, "Cmd "); strcat(buf, WM_key_event_string(kmi->type)); BLI_strncpy(str, buf, len); return str; } static wmKeymapItem *wm_keymap_item_find_handlers(const bContext *C, ListBase *handlers, const char *opname, int opcontext, IDProperty *properties, int compare_props) { wmEventHandler *handler; wmKeyMap *keymap; wmKeymapItem *kmi; /* find keymap item in handlers */ for(handler=handlers->first; handler; handler=handler->next) { keymap= handler->keymap; if(keymap && (!keymap->poll || keymap->poll((bContext*)C))) { for(kmi=keymap->keymap.first; kmi; kmi=kmi->next) { if(strcmp(kmi->idname, opname) == 0 && WM_key_event_string(kmi->type)[0]) { if(compare_props) { if(kmi->ptr && IDP_EqualsProperties(properties, kmi->ptr->data)) return kmi; } else return kmi; } } } } return NULL; } static wmKeymapItem *wm_keymap_item_find(const bContext *C, const char *opname, int opcontext, IDProperty *properties, int compare_props) { wmKeymapItem *found= NULL; /* look into multiple handler lists to find the item */ if(CTX_wm_window(C)) found= wm_keymap_item_find_handlers(C, &CTX_wm_window(C)->handlers, opname, opcontext, properties, compare_props); if(CTX_wm_area(C) && found==NULL) found= wm_keymap_item_find_handlers(C, &CTX_wm_area(C)->handlers, opname, opcontext, properties, compare_props); if(found==NULL) { if(ELEM(opcontext, WM_OP_EXEC_REGION_WIN, WM_OP_INVOKE_REGION_WIN)) { if(CTX_wm_area(C)) { ARegion *ar= CTX_wm_area(C)->regionbase.first; for(; ar; ar= ar->next) if(ar->regiontype==RGN_TYPE_WINDOW) break; if(ar) found= wm_keymap_item_find_handlers(C, &ar->handlers, opname, opcontext, properties, compare_props); } } else { if(CTX_wm_region(C)) found= wm_keymap_item_find_handlers(C, &CTX_wm_region(C)->handlers, opname, opcontext, properties, compare_props); } } return found; } char *WM_key_event_operator_string(const bContext *C, const char *opname, int opcontext, IDProperty *properties, char *str, int len) { wmKeymapItem *found= wm_keymap_item_find(C, opname, opcontext, properties, 1); if(!found) found= wm_keymap_item_find(C, opname, opcontext, properties, 0); if(found) { wm_keymap_item_to_string(found, str, len); return str; } return NULL; } /* searches context and changes keymap item, if found */ void WM_key_event_operator_change(const bContext *C, const char *opname, int opcontext, IDProperty *properties, short key, short modifier) { wmKeymapItem *found= wm_keymap_item_find(C, opname, opcontext, properties, 1); if(!found) found= wm_keymap_item_find(C, opname, opcontext, properties, 0); if(found) { keymap_event_set(found, key, KM_PRESS, modifier, 0); } } /* ********************* */ int WM_key_event_is_tweak(short type) { if(type>=EVT_TWEAK_L && type<=EVT_GESTURE) return 1; return 0; }