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