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