378fe2310915ce1455045d250c89d726f3987f00
[blender.git] / release / scripts / startup / bl_ui / space_userpref_keymap.py
1 # ##### BEGIN GPL LICENSE BLOCK #####
2 #
3 #  This program is free software; you can redistribute it and/or
4 #  modify it under the terms of the GNU General Public License
5 #  as published by the Free Software Foundation; either version 2
6 #  of the License, or (at your option) any later version.
7 #
8 #  This program is distributed in the hope that it will be useful,
9 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
10 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11 #  GNU General Public License for more details.
12 #
13 #  You should have received a copy of the GNU General Public License
14 #  along with this program; if not, write to the Free Software Foundation,
15 #  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 #
17 # ##### END GPL LICENSE BLOCK #####
18
19 # <pep8 compliant>
20 import bpy
21 import os
22
23
24 KM_HIERARCHY = [
25     ('Window', 'EMPTY', 'WINDOW', []),  # file save, window change, exit
26     ('Screen', 'EMPTY', 'WINDOW', [     # full screen, undo, screenshot
27         ('Screen Editing', 'EMPTY', 'WINDOW', []),    # resizing, action corners
28         ]),
29
30     ('View2D', 'EMPTY', 'WINDOW', []),    # view 2d navigation (per region)
31     ('View2D Buttons List', 'EMPTY', 'WINDOW', []),  # view 2d with buttons navigation
32     ('Header', 'EMPTY', 'WINDOW', []),    # header stuff (per region)
33     ('Grease Pencil', 'EMPTY', 'WINDOW', []),  # grease pencil stuff (per region)
34
35     ('3D View', 'VIEW_3D', 'WINDOW', [  # view 3d navigation and generic stuff (select, transform)
36         ('Object Mode', 'EMPTY', 'WINDOW', []),
37         ('Mesh', 'EMPTY', 'WINDOW', []),
38         ('Curve', 'EMPTY', 'WINDOW', []),
39         ('Armature', 'EMPTY', 'WINDOW', []),
40         ('Metaball', 'EMPTY', 'WINDOW', []),
41         ('Lattice', 'EMPTY', 'WINDOW', []),
42         ('Font', 'EMPTY', 'WINDOW', []),
43
44         ('Pose', 'EMPTY', 'WINDOW', []),
45
46         ('Vertex Paint', 'EMPTY', 'WINDOW', []),
47         ('Weight Paint', 'EMPTY', 'WINDOW', []),
48         ('Face Mask', 'EMPTY', 'WINDOW', []),
49         ('Image Paint', 'EMPTY', 'WINDOW', []),  # image and view3d
50         ('Sculpt', 'EMPTY', 'WINDOW', []),
51
52         ('Armature Sketch', 'EMPTY', 'WINDOW', []),
53         ('Particle', 'EMPTY', 'WINDOW', []),
54
55         ('Object Non-modal', 'EMPTY', 'WINDOW', []),  # mode change
56
57         ('3D View Generic', 'VIEW_3D', 'WINDOW', [])    # toolbar and properties
58         ]),
59
60     ('Frames', 'EMPTY', 'WINDOW', []),    # frame navigation (per region)
61     ('Markers', 'EMPTY', 'WINDOW', []),    # markers (per region)
62     ('Animation', 'EMPTY', 'WINDOW', []),    # frame change on click, preview range (per region)
63     ('Animation Channels', 'EMPTY', 'WINDOW', []),
64     ('Graph Editor', 'GRAPH_EDITOR', 'WINDOW', [
65         ('Graph Editor Generic', 'GRAPH_EDITOR', 'WINDOW', [])
66         ]),
67     ('Dopesheet', 'DOPESHEET_EDITOR', 'WINDOW', []),
68     ('NLA Editor', 'NLA_EDITOR', 'WINDOW', [
69         ('NLA Channels', 'NLA_EDITOR', 'WINDOW', []),
70         ('NLA Generic', 'NLA_EDITOR', 'WINDOW', [])
71         ]),
72
73     ('Image', 'IMAGE_EDITOR', 'WINDOW', [
74         ('UV Editor', 'EMPTY', 'WINDOW', []),  # image (reverse order, UVEdit before Image
75         ('Image Paint', 'EMPTY', 'WINDOW', []),  # image and view3d
76         ('Image Generic', 'IMAGE_EDITOR', 'WINDOW', [])
77         ]),
78
79     ('Timeline', 'TIMELINE', 'WINDOW', []),
80     ('Outliner', 'OUTLINER', 'WINDOW', []),
81
82     ('Node Editor', 'NODE_EDITOR', 'WINDOW', [
83         ('Node Generic', 'NODE_EDITOR', 'WINDOW', [])
84         ]),
85     ('Sequencer', 'SEQUENCE_EDITOR', 'WINDOW', []),
86     ('Logic Editor', 'LOGIC_EDITOR', 'WINDOW', []),
87
88     ('File Browser', 'FILE_BROWSER', 'WINDOW', [
89         ('File Browser Main', 'FILE_BROWSER', 'WINDOW', []),
90         ('File Browser Buttons', 'FILE_BROWSER', 'WINDOW', [])
91         ]),
92
93     ('Property Editor', 'PROPERTIES', 'WINDOW', []),  # align context menu
94
95     ('Script', 'SCRIPTS_WINDOW', 'WINDOW', []),
96     ('Text', 'TEXT_EDITOR', 'WINDOW', []),
97     ('Console', 'CONSOLE', 'WINDOW', []),
98
99     ('View3D Gesture Circle', 'EMPTY', 'WINDOW', []),
100     ('Gesture Border', 'EMPTY', 'WINDOW', []),
101     ('Standard Modal Map', 'EMPTY', 'WINDOW', []),
102     ('Transform Modal Map', 'EMPTY', 'WINDOW', []),
103     ('View3D Fly Modal', 'EMPTY', 'WINDOW', []),
104     ('View3D Rotate Modal', 'EMPTY', 'WINDOW', []),
105     ('View3D Move Modal', 'EMPTY', 'WINDOW', []),
106     ('View3D Zoom Modal', 'EMPTY', 'WINDOW', []),
107     ]
108
109
110 def _km_exists_in(km, export_keymaps):
111     for km2, kc in export_keymaps:
112         if km2.name == km.name:
113             return True
114     return False
115
116
117 def _merge_keymaps(kc1, kc2):
118     """ note: kc1 takes priority over kc2
119     """
120     merged_keymaps = [(km, kc1) for km in kc1.keymaps]
121     if kc1 != kc2:
122         merged_keymaps.extend((km, kc2) for km in kc2.keymaps if not _km_exists_in(km, merged_keymaps))
123
124     return merged_keymaps
125
126
127 class USERPREF_MT_keyconfigs(bpy.types.Menu):
128     bl_label = "KeyPresets"
129     preset_subdir = "keyconfig"
130     preset_operator = "wm.keyconfig_activate"
131
132     def draw(self, context):
133         props = self.layout.operator("wm.context_set_value", text="Blender (default)")
134         props.data_path = "window_manager.keyconfigs.active"
135         props.value = "context.window_manager.keyconfigs.default"
136
137         # now draw the presets
138         bpy.types.Menu.draw_preset(self, context)
139
140
141 class InputKeyMapPanel(bpy.types.Panel):
142     bl_space_type = 'USER_PREFERENCES'
143     bl_label = "Input"
144     bl_region_type = 'WINDOW'
145     bl_options = {'HIDE_HEADER'}
146
147     def draw_entry(self, display_keymaps, entry, col, level=0):
148         idname, spaceid, regionid, children = entry
149
150         for km, kc in display_keymaps:
151             if km.name == idname and km.space_type == spaceid and km.region_type == regionid:
152                 self.draw_km(display_keymaps, kc, km, children, col, level)
153
154         '''
155         km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
156         if not km:
157             kc = defkc
158             km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
159
160         if km:
161             self.draw_km(kc, km, children, col, level)
162         '''
163
164     def indented_layout(self, layout, level):
165         indentpx = 16
166         if level == 0:
167             level = 0.0001   # Tweak so that a percentage of 0 won't split by half
168         indent = level * indentpx / bpy.context.region.width
169
170         split = layout.split(percentage=indent)
171         col = split.column()
172         col = split.column()
173         return col
174
175     def draw_km(self, display_keymaps, kc, km, children, layout, level):
176         km = km.active()
177
178         layout.context_pointer_set("keymap", km)
179
180         col = self.indented_layout(layout, level)
181
182         row = col.row()
183         row.prop(km, "show_expanded_children", text="", emboss=False)
184         row.label(text=km.name)
185
186         row.label()
187         row.label()
188
189         if km.is_modal:
190             row.label(text="", icon='LINKED')
191         if km.is_user_defined:
192             op = row.operator("wm.keymap_restore", text="Restore")
193         else:
194             op = row.operator("wm.keymap_edit", text="Edit")
195
196         if km.show_expanded_children:
197             if children:
198                 # Put the Parent key map's entries in a 'global' sub-category
199                 # equal in hierarchy to the other children categories
200                 subcol = self.indented_layout(col, level + 1)
201                 subrow = subcol.row()
202                 subrow.prop(km, "show_expanded_items", text="", emboss=False)
203                 subrow.label(text="%s (Global)" % km.name)
204             else:
205                 km.show_expanded_items = True
206
207             # Key Map items
208             if km.show_expanded_items:
209                 for kmi in km.keymap_items:
210                     self.draw_kmi(display_keymaps, kc, km, kmi, col, level + 1)
211
212                 # "Add New" at end of keymap item list
213                 col = self.indented_layout(col, level + 1)
214                 subcol = col.split(percentage=0.2).column()
215                 subcol.enabled = km.is_user_defined
216                 op = subcol.operator("wm.keyitem_add", text="Add New", icon='ZOOMIN')
217
218             col.separator()
219
220             # Child key maps
221             if children:
222                 subcol = col.column()
223                 row = subcol.row()
224
225                 for entry in children:
226                     self.draw_entry(display_keymaps, entry, col, level + 1)
227
228     @staticmethod
229     def draw_kmi_properties(box, properties, title=None):
230         box.separator()
231         if title:
232             box.label(text=title)
233         flow = box.column_flow(columns=2)
234         for pname, value in properties.bl_rna.properties.items():
235             if pname != "rna_type" and not properties.is_property_hidden(pname):
236                 if isinstance(value, bpy.types.OperatorProperties):
237                     __class__.draw_kmi_properties(box, value, title=pname)
238                 else:
239                     flow.prop(properties, pname)
240
241     def draw_kmi(self, display_keymaps, kc, km, kmi, layout, level):
242         map_type = kmi.map_type
243
244         col = self.indented_layout(layout, level)
245
246         if km.is_user_defined:
247             col = col.column(align=True)
248             box = col.box()
249         else:
250             box = col.column()
251
252         split = box.split(percentage=0.05)
253
254         # header bar
255         row = split.row()
256         row.prop(kmi, "show_expanded", text="", emboss=False)
257
258         row = split.row()
259         row.enabled = km.is_user_defined
260         row.prop(kmi, "active", text="", emboss=False)
261
262         if km.is_modal:
263             row.prop(kmi, "propvalue", text="")
264         else:
265             row.label(text=kmi.name)
266
267         row = split.row()
268         row.enabled = km.is_user_defined
269         row.prop(kmi, "map_type", text="")
270         if map_type == 'KEYBOARD':
271             row.prop(kmi, "type", text="", full_event=True)
272         elif map_type == 'MOUSE':
273             row.prop(kmi, "type", text="", full_event=True)
274         elif map_type == 'TWEAK':
275             subrow = row.row()
276             subrow.prop(kmi, "type", text="")
277             subrow.prop(kmi, "value", text="")
278         elif map_type == 'TIMER':
279             row.prop(kmi, "type", text="")
280         else:
281             row.label()
282
283         if not kmi.is_user_defined:
284             op = row.operator("wm.keyitem_restore", text="", icon='BACK')
285             op.item_id = kmi.id
286         op = row.operator("wm.keyitem_remove", text="", icon='X')
287         op.item_id = kmi.id
288
289         # Expanded, additional event settings
290         if kmi.show_expanded:
291             box = col.box()
292
293             box.enabled = km.is_user_defined
294
295             if map_type not in {'TEXTINPUT', 'TIMER'}:
296                 split = box.split(percentage=0.4)
297                 sub = split.row()
298
299                 if km.is_modal:
300                     sub.prop(kmi, "propvalue", text="")
301                 else:
302                     # One day...
303                     # sub.prop_search(kmi, "idname", bpy.context.window_manager, "operators_all", text="")
304                     sub.prop(kmi, "idname", text="")
305
306                 sub = split.column()
307                 subrow = sub.row(align=True)
308
309                 if map_type == 'KEYBOARD':
310                     subrow.prop(kmi, "type", text="", event=True)
311                     subrow.prop(kmi, "value", text="")
312                 elif map_type == 'MOUSE':
313                     subrow.prop(kmi, "type", text="")
314                     subrow.prop(kmi, "value", text="")
315
316                 subrow = sub.row()
317                 subrow.scale_x = 0.75
318                 subrow.prop(kmi, "any")
319                 subrow.prop(kmi, "shift")
320                 subrow.prop(kmi, "ctrl")
321                 subrow.prop(kmi, "alt")
322                 subrow.prop(kmi, "oskey", text="Cmd")
323                 subrow.prop(kmi, "key_modifier", text="", event=True)
324
325             # Operator properties
326             props = kmi.properties
327             if props is not None:
328                 __class__.draw_kmi_properties(box, props)
329
330             # Modal key maps attached to this operator
331             if not km.is_modal:
332                 kmm = kc.keymaps.find_modal(kmi.idname)
333                 if kmm:
334                     self.draw_km(display_keymaps, kc, kmm, None, layout, level + 1)
335                     layout.context_pointer_set("keymap", km)
336
337     def draw_filtered(self, display_keymaps, filter_text, layout):
338         for km, kc in display_keymaps:
339             km = km.active()
340             layout.context_pointer_set("keymap", km)
341
342             filtered_items = [kmi for kmi in km.keymap_items if filter_text in kmi.name.lower()]
343
344             if len(filtered_items) != 0:
345                 col = layout.column()
346
347                 row = col.row()
348                 row.label(text=km.name, icon="DOT")
349
350                 row.label()
351                 row.label()
352
353                 if km.is_user_defined:
354                     op = row.operator("wm.keymap_restore", text="Restore")
355                 else:
356                     op = row.operator("wm.keymap_edit", text="Edit")
357
358                 for kmi in filtered_items:
359                     self.draw_kmi(display_keymaps, kc, km, kmi, col, 1)
360
361                 # "Add New" at end of keymap item list
362                 col = self.indented_layout(layout, 1)
363                 subcol = col.split(percentage=0.2).column()
364                 subcol.enabled = km.is_user_defined
365                 op = subcol.operator("wm.keyitem_add", text="Add New", icon='ZOOMIN')
366
367     def draw_hierarchy(self, display_keymaps, layout):
368         for entry in KM_HIERARCHY:
369             self.draw_entry(display_keymaps, entry, layout)
370
371     def draw_keymaps(self, context, layout):
372         wm = context.window_manager
373         kc = wm.keyconfigs.active
374         defkc = wm.keyconfigs.default
375
376         col = layout.column()
377         sub = col.column()
378
379         subsplit = sub.split()
380         subcol = subsplit.column()
381
382         row = subcol.row(align=True)
383
384         #row.prop_search(wm.keyconfigs, "active", wm, "keyconfigs", text="Key Config:")
385         text = bpy.path.display_name(context.window_manager.keyconfigs.active.name)
386         if not text:
387             text = "Blender (default)"
388         row.menu("USERPREF_MT_keyconfigs", text=text)
389         row.operator("wm.keyconfig_preset_add", text="", icon="ZOOMIN")
390         row.operator("wm.keyconfig_preset_add", text="", icon="ZOOMOUT").remove_active = True
391
392 #        layout.context_pointer_set("keyconfig", wm.keyconfigs.active)
393 #        row.operator("wm.keyconfig_remove", text="", icon='X')
394
395         row.prop(context.space_data, "filter_text", icon="VIEWZOOM")
396
397         col.separator()
398
399         display_keymaps = _merge_keymaps(kc, defkc)
400         if context.space_data.filter_text != "":
401             filter_text = context.space_data.filter_text.lower()
402             self.draw_filtered(display_keymaps, filter_text, col)
403         else:
404             self.draw_hierarchy(display_keymaps, col)
405
406
407 from bpy.props import StringProperty, BoolProperty, IntProperty
408
409
410 def export_properties(prefix, properties, lines=None):
411     if lines is None:
412         lines = []
413
414     for pname in properties.keys():
415         if not properties.is_property_hidden(pname):
416             value = getattr(properties, pname)
417             if isinstance(value, bpy.types.OperatorProperties):
418                 export_properties(prefix + "." + pname, value, lines)
419             elif properties.is_property_set(pname):
420                 value = _string_value(value)
421                 if value != "":
422                     lines.append("%s.%s = %s\n" % (prefix, pname, value))
423     return lines
424
425
426 class WM_OT_keyconfig_test(bpy.types.Operator):
427     "Test keyconfig for conflicts"
428     bl_idname = "wm.keyconfig_test"
429     bl_label = "Test Key Configuration for Conflicts"
430
431     def testEntry(self, kc, entry, src=None, parent=None):
432         result = False
433
434         def kmistr(kmi):
435             if km.is_modal:
436                 s = ["kmi = km.keymap_items.new_modal(\'%s\', \'%s\', \'%s\'" % (kmi.propvalue, kmi.type, kmi.value)]
437             else:
438                 s = ["kmi = km.keymap_items.new(\'%s\', \'%s\', \'%s\'" % (kmi.idname, kmi.type, kmi.value)]
439
440             if kmi.any:
441                 s.append(", any=True")
442             else:
443                 if kmi.shift:
444                     s.append(", shift=True")
445                 if kmi.ctrl:
446                     s.append(", ctrl=True")
447                 if kmi.alt:
448                     s.append(", alt=True")
449                 if kmi.oskey:
450                     s.append(", oskey=True")
451             if kmi.key_modifier and kmi.key_modifier != 'NONE':
452                 s.append(", key_modifier=\'%s\'" % kmi.key_modifier)
453
454             s.append(")\n")
455
456             props = kmi.properties
457
458             if props is not None:
459                 export_properties("kmi.properties", props, s)
460
461             return "".join(s).strip()
462
463         idname, spaceid, regionid, children = entry
464
465         km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
466
467         if km:
468             km = km.active()
469
470             if src:
471                 for item in km.keymap_items:
472                     if src.compare(item):
473                         print("===========")
474                         print(parent.name)
475                         print(kmistr(src))
476                         print(km.name)
477                         print(kmistr(item))
478                         result = True
479
480                 for child in children:
481                     if self.testEntry(kc, child, src, parent):
482                         result = True
483             else:
484                 for i in range(len(km.keymap_items)):
485                     src = km.keymap_items[i]
486
487                     for child in children:
488                         if self.testEntry(kc, child, src, km):
489                             result = True
490
491                     for j in range(len(km.keymap_items) - i - 1):
492                         item = km.keymap_items[j + i + 1]
493                         if src.compare(item):
494                             print("===========")
495                             print(km.name)
496                             print(kmistr(src))
497                             print(kmistr(item))
498                             result = True
499
500                 for child in children:
501                     if self.testEntry(kc, child):
502                         result = True
503
504         return result
505
506     def testConfig(self, kc):
507         result = False
508         for entry in KM_HIERARCHY:
509             if self.testEntry(kc, entry):
510                 result = True
511         return result
512
513     def execute(self, context):
514         wm = context.window_manager
515         kc = wm.keyconfigs.default
516
517         if self.testConfig(kc):
518             print("CONFLICT")
519
520         return {'FINISHED'}
521
522
523 def _string_value(value):
524     if isinstance(value, str) or isinstance(value, bool) or isinstance(value, float) or isinstance(value, int):
525         result = repr(value)
526     elif getattr(value, '__len__', False):
527         return repr(list(value))
528     else:
529         print("Export key configuration: can't write ", value)
530
531     return result
532
533
534 class WM_OT_keyconfig_import(bpy.types.Operator):
535     "Import key configuration from a python script"
536     bl_idname = "wm.keyconfig_import"
537     bl_label = "Import Key Configuration..."
538
539     filepath = StringProperty(name="File Path", description="Filepath to write file to", default="keymap.py")
540     filter_folder = BoolProperty(name="Filter folders", description="", default=True, options={'HIDDEN'})
541     filter_text = BoolProperty(name="Filter text", description="", default=True, options={'HIDDEN'})
542     filter_python = BoolProperty(name="Filter python", description="", default=True, options={'HIDDEN'})
543
544     keep_original = BoolProperty(name="Keep original", description="Keep original file after copying to configuration folder", default=True)
545
546     def execute(self, context):
547         from os.path import basename
548         import shutil
549         if not self.filepath:
550             raise Exception("Filepath not set")
551
552         f = open(self.filepath, "r")
553         if not f:
554             raise Exception("Could not open file")
555
556         config_name = basename(self.filepath)
557
558         path = bpy.utils.user_resource('SCRIPTS', os.path.join("presets", "keyconfig"), create=True)
559         path = os.path.join(path, config_name)
560
561         if self.keep_original:
562             shutil.copy(self.filepath, path)
563         else:
564             shutil.move(self.filepath, path)
565
566         # sneaky way to check we're actually running the code.
567         bpy.utils.keyconfig_set(path)
568
569         return {'FINISHED'}
570
571     def invoke(self, context, event):
572         wm = context.window_manager
573         wm.fileselect_add(self)
574         return {'RUNNING_MODAL'}
575
576 # This operator is also used by interaction presets saving - AddPresetBase
577
578
579 class WM_OT_keyconfig_export(bpy.types.Operator):
580     "Export key configuration to a python script"
581     bl_idname = "wm.keyconfig_export"
582     bl_label = "Export Key Configuration..."
583
584     filepath = StringProperty(name="File Path", description="Filepath to write file to", default="keymap.py")
585     filter_folder = BoolProperty(name="Filter folders", description="", default=True, options={'HIDDEN'})
586     filter_text = BoolProperty(name="Filter text", description="", default=True, options={'HIDDEN'})
587     filter_python = BoolProperty(name="Filter python", description="", default=True, options={'HIDDEN'})
588
589     def execute(self, context):
590         if not self.filepath:
591             raise Exception("Filepath not set")
592
593         f = open(self.filepath, "w")
594         if not f:
595             raise Exception("Could not open file")
596
597         wm = context.window_manager
598         kc = wm.keyconfigs.active
599
600         f.write("import bpy\n")
601         f.write("import os\n\n")
602         f.write("wm = bpy.context.window_manager\n")
603         f.write("kc = wm.keyconfigs.new(os.path.splitext(os.path.basename(__file__))[0])\n\n")  # keymap must be created by caller
604
605         # Generate a list of keymaps to export:
606         #
607         # First add all user_defined keymaps (found in inputs.edited_keymaps list),
608         # then add all remaining keymaps from the currently active custom keyconfig.
609         #
610         # This will create a final list of keymaps that can be used as a 'diff' against
611         # the default blender keyconfig, recreating the current setup from a fresh blender
612         # without needing to export keymaps which haven't been edited.
613
614         class FakeKeyConfig():
615             keymaps = []
616         edited_kc = FakeKeyConfig()
617         edited_kc.keymaps.extend(context.user_preferences.inputs.edited_keymaps)
618         # merge edited keymaps with non-default keyconfig, if it exists
619         if kc != wm.keyconfigs.default:
620             export_keymaps = _merge_keymaps(edited_kc, kc)
621         else:
622             export_keymaps = _merge_keymaps(edited_kc, edited_kc)
623
624         for km, kc_x in export_keymaps:
625
626             km = km.active()
627
628             f.write("# Map %s\n" % km.name)
629             f.write("km = kc.keymaps.new('%s', space_type='%s', region_type='%s', modal=%s)\n\n" % (km.name, km.space_type, km.region_type, km.is_modal))
630             for kmi in km.keymap_items:
631                 if km.is_modal:
632                     f.write("kmi = km.keymap_items.new_modal('%s', '%s', '%s'" % (kmi.propvalue, kmi.type, kmi.value))
633                 else:
634                     f.write("kmi = km.keymap_items.new('%s', '%s', '%s'" % (kmi.idname, kmi.type, kmi.value))
635                 if kmi.any:
636                     f.write(", any=True")
637                 else:
638                     if kmi.shift:
639                         f.write(", shift=True")
640                     if kmi.ctrl:
641                         f.write(", ctrl=True")
642                     if kmi.alt:
643                         f.write(", alt=True")
644                     if kmi.oskey:
645                         f.write(", oskey=True")
646                 if kmi.key_modifier and kmi.key_modifier != 'NONE':
647                     f.write(", key_modifier='%s'" % kmi.key_modifier)
648                 f.write(")\n")
649
650                 props = kmi.properties
651
652                 if props is not None:
653                     f.write("".join(export_properties("kmi.properties", props)))
654
655             f.write("\n")
656
657         f.close()
658
659         return {'FINISHED'}
660
661     def invoke(self, context, event):
662         wm = context.window_manager
663         wm.fileselect_add(self)
664         return {'RUNNING_MODAL'}
665
666
667 class WM_OT_keymap_edit(bpy.types.Operator):
668     "Edit stored key map"
669     bl_idname = "wm.keymap_edit"
670     bl_label = "Edit Key Map"
671
672     def execute(self, context):
673         km = context.keymap
674         km.copy_to_user()
675         return {'FINISHED'}
676
677
678 class WM_OT_keymap_restore(bpy.types.Operator):
679     "Restore key map(s)"
680     bl_idname = "wm.keymap_restore"
681     bl_label = "Restore Key Map(s)"
682
683     all = BoolProperty(name="All Keymaps", description="Restore all keymaps to default")
684
685     def execute(self, context):
686         wm = context.window_manager
687
688         if self.all:
689             for km in wm.keyconfigs.default.keymaps:
690                 km.restore_to_default()
691         else:
692             km = context.keymap
693             km.restore_to_default()
694
695         return {'FINISHED'}
696
697
698 class WM_OT_keyitem_restore(bpy.types.Operator):
699     "Restore key map item"
700     bl_idname = "wm.keyitem_restore"
701     bl_label = "Restore Key Map Item"
702
703     item_id = IntProperty(name="Item Identifier", description="Identifier of the item to remove")
704
705     @classmethod
706     def poll(cls, context):
707         keymap = getattr(context, "keymap", None)
708         return keymap and keymap.is_user_defined
709
710     def execute(self, context):
711         km = context.keymap
712         kmi = km.keymap_items.from_id(self.item_id)
713
714         if not kmi.is_user_defined:
715             km.restore_item_to_default(kmi)
716
717         return {'FINISHED'}
718
719
720 class WM_OT_keyitem_add(bpy.types.Operator):
721     "Add key map item"
722     bl_idname = "wm.keyitem_add"
723     bl_label = "Add Key Map Item"
724
725     def execute(self, context):
726         wm = context.window_manager
727         km = context.keymap
728         kc = wm.keyconfigs.default
729
730         if km.is_modal:
731             km.keymap_items.new_modal("", 'A', 'PRESS')  # kmi
732         else:
733             km.keymap_items.new("none", 'A', 'PRESS')  # kmi
734
735         # clear filter and expand keymap so we can see the newly added item
736         if context.space_data.filter_text != "":
737             context.space_data.filter_text = ""
738             km.show_expanded_items = True
739             km.show_expanded_children = True
740
741         return {'FINISHED'}
742
743
744 class WM_OT_keyitem_remove(bpy.types.Operator):
745     "Remove key map item"
746     bl_idname = "wm.keyitem_remove"
747     bl_label = "Remove Key Map Item"
748
749     item_id = IntProperty(name="Item Identifier", description="Identifier of the item to remove")
750
751     @classmethod
752     def poll(cls, context):
753         return hasattr(context, "keymap") and context.keymap.is_user_defined
754
755     def execute(self, context):
756         km = context.keymap
757         kmi = km.keymap_items.from_id(self.item_id)
758         km.keymap_items.remove(kmi)
759         return {'FINISHED'}
760
761
762 class WM_OT_keyconfig_remove(bpy.types.Operator):
763     "Remove key config"
764     bl_idname = "wm.keyconfig_remove"
765     bl_label = "Remove Key Config"
766
767     @classmethod
768     def poll(cls, context):
769         wm = context.window_manager
770         keyconf = wm.keyconfigs.active
771         return keyconf and keyconf.is_user_defined
772
773     def execute(self, context):
774         wm = context.window_manager
775         keyconfig = wm.keyconfigs.active
776         wm.keyconfigs.remove(keyconfig)
777         return {'FINISHED'}
778
779 if __name__ == "__main__":  # only for live edit.
780     bpy.utils.register_module(__name__)