d02b2bfbdde1aee001f5e9611b8bf69d9a5e5ff0
[blender.git] / release / scripts / startup / bl_operators / wm.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
21 import bpy
22 from bpy.props import StringProperty, BoolProperty, IntProperty, FloatProperty
23 from rna_prop_ui import rna_idprop_ui_prop_get, rna_idprop_ui_prop_clear
24
25
26 class MESH_OT_delete_edgeloop(bpy.types.Operator):
27     '''Delete an edge loop by merging the faces on each side to a single face loop'''
28     bl_idname = "mesh.delete_edgeloop"
29     bl_label = "Delete Edge Loop"
30
31     def execute(self, context):
32         if 'FINISHED' in bpy.ops.transform.edge_slide(value=1.0):
33             bpy.ops.mesh.select_more()
34             bpy.ops.mesh.remove_doubles()
35             return {'FINISHED'}
36
37         return {'CANCELLED'}
38
39 rna_path_prop = StringProperty(name="Context Attributes",
40         description="rna context string", maxlen=1024, default="")
41
42 rna_reverse_prop = BoolProperty(name="Reverse",
43         description="Cycle backwards", default=False)
44
45 rna_relative_prop = BoolProperty(name="Relative",
46         description="Apply relative to the current value (delta)",
47         default=False)
48
49
50 def context_path_validate(context, data_path):
51     import sys
52     try:
53         value = eval("context.%s" % data_path) if data_path else Ellipsis
54     except AttributeError:
55         if "'NoneType'" in str(sys.exc_info()[1]):
56             # One of the items in the rna path is None, just ignore this
57             value = Ellipsis
58         else:
59             # We have a real error in the rna path, dont ignore that
60             raise
61
62     return value
63
64
65 def execute_context_assign(self, context):
66     if context_path_validate(context, self.data_path) is Ellipsis:
67         return {'PASS_THROUGH'}
68
69     if getattr(self, "relative", False):
70         exec("context.%s+=self.value" % self.data_path)
71     else:
72         exec("context.%s=self.value" % self.data_path)
73
74     return {'FINISHED'}
75
76
77 class BRUSH_OT_active_index_set(bpy.types.Operator):
78     '''Set active sculpt/paint brush from it's number'''
79     bl_idname = "brush.active_index_set"
80     bl_label = "Set Brush Number"
81
82     mode = StringProperty(name="mode",
83             description="Paint mode to set brush for", maxlen=1024)
84     index = IntProperty(name="number",
85             description="Brush number")
86
87     _attr_dict = {"sculpt": "use_paint_sculpt",
88                   "vertex_paint": "use_paint_vertex",
89                   "weight_paint": "use_paint_weight",
90                   "image_paint": "use_paint_image"}
91
92     def execute(self, context):
93         attr = self._attr_dict.get(self.mode)
94         if attr is None:
95             return {'CANCELLED'}
96
97         for i, brush in enumerate((cur for cur in bpy.data.brushes if getattr(cur, attr))):
98             if i == self.index:
99                 getattr(context.tool_settings, self.mode).brush = brush
100                 return {'FINISHED'}
101
102         return {'CANCELLED'}
103
104
105 class WM_OT_context_set_boolean(bpy.types.Operator):
106     '''Set a context value.'''
107     bl_idname = "wm.context_set_boolean"
108     bl_label = "Context Set Boolean"
109     bl_options = {'UNDO'}
110
111     data_path = rna_path_prop
112     value = BoolProperty(name="Value",
113             description="Assignment value", default=True)
114
115     execute = execute_context_assign
116
117
118 class WM_OT_context_set_int(bpy.types.Operator):  # same as enum
119     '''Set a context value.'''
120     bl_idname = "wm.context_set_int"
121     bl_label = "Context Set"
122     bl_options = {'UNDO'}
123
124     data_path = rna_path_prop
125     value = IntProperty(name="Value", description="Assign value", default=0)
126     relative = rna_relative_prop
127
128     execute = execute_context_assign
129
130
131 class WM_OT_context_scale_int(bpy.types.Operator):
132     '''Scale an int context value.'''
133     bl_idname = "wm.context_scale_int"
134     bl_label = "Context Set"
135     bl_options = {'UNDO'}
136
137     data_path = rna_path_prop
138     value = FloatProperty(name="Value", description="Assign value", default=1.0)
139     always_step = BoolProperty(name="Always Step",
140         description="Always adjust the value by a minimum of 1 when 'value' is not 1.0.",
141         default=True)
142
143     def execute(self, context):
144         if context_path_validate(context, self.data_path) is Ellipsis:
145             return {'PASS_THROUGH'}
146
147         value = self.value
148         data_path = self.data_path
149
150         if value == 1.0:  # nothing to do
151             return {'CANCELLED'}
152
153         if getattr(self, "always_step", False):
154             if value > 1.0:
155                 add = "1"
156                 func = "max"
157             else:
158                 add = "-1"
159                 func = "min"
160             exec("context.%s = %s(round(context.%s * value), context.%s + %s)" % (data_path, func, data_path, data_path, add))
161         else:
162             exec("context.%s *= value" % self.data_path)
163
164         return {'FINISHED'}
165
166
167 class WM_OT_context_set_float(bpy.types.Operator):  # same as enum
168     '''Set a context value.'''
169     bl_idname = "wm.context_set_float"
170     bl_label = "Context Set Float"
171     bl_options = {'UNDO'}
172
173     data_path = rna_path_prop
174     value = FloatProperty(name="Value",
175             description="Assignment value", default=0.0)
176     relative = rna_relative_prop
177
178     execute = execute_context_assign
179
180
181 class WM_OT_context_set_string(bpy.types.Operator):  # same as enum
182     '''Set a context value.'''
183     bl_idname = "wm.context_set_string"
184     bl_label = "Context Set String"
185     bl_options = {'UNDO'}
186
187     data_path = rna_path_prop
188     value = StringProperty(name="Value",
189             description="Assign value", maxlen=1024, default="")
190
191     execute = execute_context_assign
192
193
194 class WM_OT_context_set_enum(bpy.types.Operator):
195     '''Set a context value.'''
196     bl_idname = "wm.context_set_enum"
197     bl_label = "Context Set Enum"
198     bl_options = {'UNDO'}
199
200     data_path = rna_path_prop
201     value = StringProperty(name="Value",
202             description="Assignment value (as a string)",
203             maxlen=1024, default="")
204
205     execute = execute_context_assign
206
207
208 class WM_OT_context_set_value(bpy.types.Operator):
209     '''Set a context value.'''
210     bl_idname = "wm.context_set_value"
211     bl_label = "Context Set Value"
212     bl_options = {'UNDO'}
213
214     data_path = rna_path_prop
215     value = StringProperty(name="Value",
216             description="Assignment value (as a string)",
217             maxlen=1024, default="")
218
219     def execute(self, context):
220         if context_path_validate(context, self.data_path) is Ellipsis:
221             return {'PASS_THROUGH'}
222         exec("context.%s=%s" % (self.data_path, self.value))
223         return {'FINISHED'}
224
225
226 class WM_OT_context_toggle(bpy.types.Operator):
227     '''Toggle a context value.'''
228     bl_idname = "wm.context_toggle"
229     bl_label = "Context Toggle"
230     bl_options = {'UNDO'}
231
232     data_path = rna_path_prop
233
234     def execute(self, context):
235
236         if context_path_validate(context, self.data_path) is Ellipsis:
237             return {'PASS_THROUGH'}
238
239         exec("context.%s=not (context.%s)" %
240             (self.data_path, self.data_path))
241
242         return {'FINISHED'}
243
244
245 class WM_OT_context_toggle_enum(bpy.types.Operator):
246     '''Toggle a context value.'''
247     bl_idname = "wm.context_toggle_enum"
248     bl_label = "Context Toggle Values"
249     bl_options = {'UNDO'}
250
251     data_path = rna_path_prop
252     value_1 = StringProperty(name="Value", \
253                 description="Toggle enum", maxlen=1024, default="")
254
255     value_2 = StringProperty(name="Value", \
256                 description="Toggle enum", maxlen=1024, default="")
257
258     def execute(self, context):
259
260         if context_path_validate(context, self.data_path) is Ellipsis:
261             return {'PASS_THROUGH'}
262
263         exec("context.%s = ['%s', '%s'][context.%s!='%s']" % \
264             (self.data_path, self.value_1,\
265              self.value_2, self.data_path,
266              self.value_2))
267
268         return {'FINISHED'}
269
270
271 class WM_OT_context_cycle_int(bpy.types.Operator):
272     '''Set a context value. Useful for cycling active material, '''
273     '''vertex keys, groups' etc.'''
274     bl_idname = "wm.context_cycle_int"
275     bl_label = "Context Int Cycle"
276     bl_options = {'UNDO'}
277
278     data_path = rna_path_prop
279     reverse = rna_reverse_prop
280
281     def execute(self, context):
282         data_path = self.data_path
283         value = context_path_validate(context, data_path)
284         if value is Ellipsis:
285             return {'PASS_THROUGH'}
286
287         if self.reverse:
288             value -= 1
289         else:
290             value += 1
291
292         exec("context.%s=value" % data_path)
293
294         if value != eval("context.%s" % data_path):
295             # relies on rna clamping int's out of the range
296             if self.reverse:
297                 value = (1 << 31) - 1
298             else:
299                 value = -1 << 31
300
301             exec("context.%s=value" % data_path)
302
303         return {'FINISHED'}
304
305
306 class WM_OT_context_cycle_enum(bpy.types.Operator):
307     '''Toggle a context value.'''
308     bl_idname = "wm.context_cycle_enum"
309     bl_label = "Context Enum Cycle"
310     bl_options = {'UNDO'}
311
312     data_path = rna_path_prop
313     reverse = rna_reverse_prop
314
315     def execute(self, context):
316
317         value = context_path_validate(context, self.data_path)
318         if value is Ellipsis:
319             return {'PASS_THROUGH'}
320
321         orig_value = value
322
323         # Have to get rna enum values
324         rna_struct_str, rna_prop_str = self.data_path.rsplit('.', 1)
325         i = rna_prop_str.find('[')
326
327         # just incse we get "context.foo.bar[0]"
328         if i != -1:
329             rna_prop_str = rna_prop_str[0:i]
330
331         rna_struct = eval("context.%s.rna_type" % rna_struct_str)
332
333         rna_prop = rna_struct.properties[rna_prop_str]
334
335         if type(rna_prop) != bpy.types.EnumProperty:
336             raise Exception("expected an enum property")
337
338         enums = rna_struct.properties[rna_prop_str].enum_items.keys()
339         orig_index = enums.index(orig_value)
340
341         # Have the info we need, advance to the next item
342         if self.reverse:
343             if orig_index == 0:
344                 advance_enum = enums[-1]
345             else:
346                 advance_enum = enums[orig_index - 1]
347         else:
348             if orig_index == len(enums) - 1:
349                 advance_enum = enums[0]
350             else:
351                 advance_enum = enums[orig_index + 1]
352
353         # set the new value
354         exec("context.%s=advance_enum" % self.data_path)
355         return {'FINISHED'}
356
357
358 class WM_OT_context_cycle_array(bpy.types.Operator):
359     '''Set a context array value.
360     Useful for cycling the active mesh edit mode.'''
361     bl_idname = "wm.context_cycle_array"
362     bl_label = "Context Array Cycle"
363     bl_options = {'UNDO'}
364
365     data_path = rna_path_prop
366     reverse = rna_reverse_prop
367
368     def execute(self, context):
369         data_path = self.data_path
370         value = context_path_validate(context, data_path)
371         if value is Ellipsis:
372             return {'PASS_THROUGH'}
373
374         def cycle(array):
375             if self.reverse:
376                 array.insert(0, array.pop())
377             else:
378                 array.append(array.pop(0))
379             return array
380
381         exec("context.%s=cycle(context.%s[:])" % (data_path, data_path))
382
383         return {'FINISHED'}
384
385
386 class WM_MT_context_menu_enum(bpy.types.Menu):
387     bl_label = ""
388     data_path = ""  # BAD DESIGN, set from operator below.
389
390     def draw(self, context):
391         data_path = self.data_path
392         value = context_path_validate(bpy.context, data_path)
393         if value is Ellipsis:
394             return {'PASS_THROUGH'}
395         base_path, prop_string = data_path.rsplit(".", 1)
396         value_base = context_path_validate(context, base_path)
397
398         values = [(i.name, i.identifier) for i in value_base.bl_rna.properties[prop_string].enum_items]
399
400         for name, identifier in values:
401             prop = self.layout.operator("wm.context_set_enum", text=name)
402             prop.data_path = data_path
403             prop.value = identifier
404
405
406 class WM_OT_context_menu_enum(bpy.types.Operator):
407     bl_idname = "wm.context_menu_enum"
408     bl_label = "Context Enum Menu"
409     bl_options = {'UNDO'}
410     data_path = rna_path_prop
411
412     def execute(self, context):
413         data_path = self.data_path
414         WM_MT_context_menu_enum.data_path = data_path
415         bpy.ops.wm.call_menu(name="WM_MT_context_menu_enum")
416         return {'PASS_THROUGH'}
417
418
419 class WM_OT_context_set_id(bpy.types.Operator):
420     '''Toggle a context value.'''
421     bl_idname = "wm.context_set_id"
422     bl_label = "Set Library ID"
423     bl_options = {'UNDO'}
424
425     data_path = rna_path_prop
426     value = StringProperty(name="Value",
427             description="Assign value", maxlen=1024, default="")
428
429     def execute(self, context):
430         value = self.value
431         data_path = self.data_path
432
433         # match the pointer type from the target property to bpy.data.*
434         # so we lookup the correct list.
435         data_path_base, data_path_prop = data_path.rsplit(".", 1)
436         data_prop_rna = eval("context.%s" % data_path_base).rna_type.properties[data_path_prop]
437         data_prop_rna_type = data_prop_rna.fixed_type
438
439         id_iter = None
440
441         for prop in bpy.data.rna_type.properties:
442             if prop.rna_type.identifier == "CollectionProperty":
443                 if prop.fixed_type == data_prop_rna_type:
444                     id_iter = prop.identifier
445                     break
446
447         if id_iter:
448             value_id = getattr(bpy.data, id_iter).get(value)
449             exec("context.%s=value_id" % data_path)
450
451         return {'FINISHED'}
452
453
454 doc_id = StringProperty(name="Doc ID",
455         description="", maxlen=1024, default="", options={'HIDDEN'})
456
457 doc_new = StringProperty(name="Edit Description",
458         description="", maxlen=1024, default="")
459
460
461 class WM_OT_context_modal_mouse(bpy.types.Operator):
462     '''Adjust arbitrary values with mouse input'''
463     bl_idname = "wm.context_modal_mouse"
464     bl_label = "Context Modal Mouse"
465
466     data_path_iter = StringProperty(description="The data path relative to the context, must point to an iterable.")
467     data_path_item = StringProperty(description="The data path from each iterable to the value (int or float)")
468     input_scale = FloatProperty(default=0.01, description="Scale the mouse movement by this value before applying the delta")
469     invert = BoolProperty(default=False, description="Invert the mouse input")
470     initial_x = IntProperty(options={'HIDDEN'})
471
472     def _values_store(self, context):
473         data_path_iter = self.data_path_iter
474         data_path_item = self.data_path_item
475
476         self._values = values = {}
477
478         for item in getattr(context, data_path_iter):
479             try:
480                 value_orig = eval("item." + data_path_item)
481             except:
482                 continue
483
484             # check this can be set, maybe this is library data.
485             try:
486                 exec("item.%s = %s" % (data_path_item, value_orig))
487             except:
488                 continue
489
490             values[item] = value_orig
491
492     def _values_delta(self, delta):
493         delta *= self.input_scale
494         if self.invert:
495             delta = - delta
496
497         data_path_item = self.data_path_item
498         for item, value_orig in self._values.items():
499             if type(value_orig) == int:
500                 exec("item.%s = int(%d)" % (data_path_item, round(value_orig + delta)))
501             else:
502                 exec("item.%s = %f" % (data_path_item, value_orig + delta))
503
504     def _values_restore(self):
505         data_path_item = self.data_path_item
506         for item, value_orig in self._values.items():
507             exec("item.%s = %s" % (data_path_item, value_orig))
508
509         self._values.clear()
510
511     def _values_clear(self):
512         self._values.clear()
513
514     def modal(self, context, event):
515         event_type = event.type
516
517         if event_type == 'MOUSEMOVE':
518             delta = event.mouse_x - self.initial_x
519             self._values_delta(delta)
520
521         elif 'LEFTMOUSE' == event_type:
522             self._values_clear()
523             return {'FINISHED'}
524
525         elif event_type in ('RIGHTMOUSE', 'ESC'):
526             self._values_restore()
527             return {'FINISHED'}
528
529         return {'RUNNING_MODAL'}
530
531     def invoke(self, context, event):
532         self._values_store(context)
533
534         if not self._values:
535             self.report({'WARNING'}, "Nothing to operate on: %s[ ].%s" %
536                     (self.data_path_iter, self.data_path_item))
537
538             return {'CANCELLED'}
539         else:
540             self.initial_x = event.mouse_x
541
542             context.window_manager.modal_handler_add(self)
543             return {'RUNNING_MODAL'}
544
545
546 class WM_OT_url_open(bpy.types.Operator):
547     "Open a website in the Webbrowser"
548     bl_idname = "wm.url_open"
549     bl_label = ""
550
551     url = StringProperty(name="URL", description="URL to open")
552
553     def execute(self, context):
554         import webbrowser
555         _webbrowser_bug_fix()
556         webbrowser.open(self.url)
557         return {'FINISHED'}
558
559
560 class WM_OT_path_open(bpy.types.Operator):
561     "Open a path in a file browser"
562     bl_idname = "wm.path_open"
563     bl_label = ""
564
565     filepath = StringProperty(name="File Path", maxlen=1024, subtype='FILE_PATH')
566
567     def execute(self, context):
568         import sys
569         import os
570         import subprocess
571
572         filepath = bpy.path.abspath(self.filepath)
573         filepath = os.path.normpath(filepath)
574
575         if not os.path.exists(filepath):
576             self.report({'ERROR'}, "File '%s' not found" % filepath)
577             return {'CANCELLED'}
578
579         if sys.platform[:3] == "win":
580             subprocess.Popen(['start', filepath], shell=True)
581         elif sys.platform == 'darwin':
582             subprocess.Popen(['open', filepath])
583         else:
584             try:
585                 subprocess.Popen(['xdg-open', filepath])
586             except OSError:
587                 # xdg-open *should* be supported by recent Gnome, KDE, Xfce
588                 pass
589
590         return {'FINISHED'}
591
592
593 class WM_OT_doc_view(bpy.types.Operator):
594     '''Load online reference docs'''
595     bl_idname = "wm.doc_view"
596     bl_label = "View Documentation"
597
598     doc_id = doc_id
599     if bpy.app.version_cycle == "release":
600         _prefix = "http://www.blender.org/documentation/blender_python_api_%s%s_release" % ("_".join(str(v) for v in bpy.app.version[:2]), bpy.app.version_char)
601     else:
602         _prefix = "http://www.blender.org/documentation/blender_python_api_%s" % "_".join(str(v) for v in bpy.app.version)
603
604     def _nested_class_string(self, class_string):
605         ls = []
606         class_obj = getattr(bpy.types, class_string, None).bl_rna
607         while class_obj:
608             ls.insert(0, class_obj)
609             class_obj = class_obj.nested
610         return '.'.join(class_obj.identifier for class_obj in ls)
611
612     def execute(self, context):
613         id_split = self.doc_id.split('.')
614         if len(id_split) == 1:  # rna, class
615             url = '%s/bpy.types.%s.html' % (self._prefix, id_split[0])
616         elif len(id_split) == 2:  # rna, class.prop
617             class_name, class_prop = id_split
618
619             if hasattr(bpy.types, class_name.upper() + '_OT_' + class_prop):
620                 url = '%s/bpy.ops.%s.html#bpy.ops.%s.%s' % \
621                         (self._prefix, class_name, class_name, class_prop)
622             else:
623
624                 # detect if this is a inherited member and use that name instead
625                 rna_parent = getattr(bpy.types, class_name).bl_rna
626                 rna_prop = rna_parent.properties[class_prop]
627                 rna_parent = rna_parent.base
628                 while rna_parent and rna_prop == rna_parent.properties.get(class_prop):
629                     class_name = rna_parent.identifier
630                     rna_parent = rna_parent.base
631
632                 # It so happens that epydoc nests these, not sphinx
633                 # class_name_full = self._nested_class_string(class_name)
634                 url = '%s/bpy.types.%s.html#bpy.types.%s.%s' % \
635                         (self._prefix, class_name, class_name, class_prop)
636
637         else:
638             return {'PASS_THROUGH'}
639
640         import webbrowser
641         _webbrowser_bug_fix()
642         webbrowser.open(url)
643
644         return {'FINISHED'}
645
646
647 class WM_OT_doc_edit(bpy.types.Operator):
648     '''Load online reference docs'''
649     bl_idname = "wm.doc_edit"
650     bl_label = "Edit Documentation"
651
652     doc_id = doc_id
653     doc_new = doc_new
654
655     _url = "http://www.mindrones.com/blender/svn/xmlrpc.php"
656
657     def _send_xmlrpc(self, data_dict):
658         print("sending data:", data_dict)
659
660         import xmlrpc.client
661         user = 'blenderuser'
662         pwd = 'blender>user'
663
664         docblog = xmlrpc.client.ServerProxy(self._url)
665         docblog.metaWeblog.newPost(1, user, pwd, data_dict, 1)
666
667     def execute(self, context):
668
669         doc_id = self.doc_id
670         doc_new = self.doc_new
671
672         class_name, class_prop = doc_id.split('.')
673
674         if not doc_new:
675             self.report({'ERROR'}, "No input given for '%s'" % doc_id)
676             return {'CANCELLED'}
677
678         # check if this is an operator
679         op_name = class_name.upper() + '_OT_' + class_prop
680         op_class = getattr(bpy.types, op_name, None)
681
682         # Upload this to the web server
683         upload = {}
684
685         if op_class:
686             rna = op_class.bl_rna
687             doc_orig = rna.description
688             if doc_orig == doc_new:
689                 return {'RUNNING_MODAL'}
690
691             print("op - old:'%s' -> new:'%s'" % (doc_orig, doc_new))
692             upload["title"] = 'OPERATOR %s:%s' % (doc_id, doc_orig)
693         else:
694             rna = getattr(bpy.types, class_name).bl_rna
695             doc_orig = rna.properties[class_prop].description
696             if doc_orig == doc_new:
697                 return {'RUNNING_MODAL'}
698
699             print("rna - old:'%s' -> new:'%s'" % (doc_orig, doc_new))
700             upload["title"] = 'RNA %s:%s' % (doc_id, doc_orig)
701
702         upload["description"] = doc_new
703
704         self._send_xmlrpc(upload)
705
706         return {'FINISHED'}
707
708     def draw(self, context):
709         layout = self.layout
710         layout.label(text="Descriptor ID: '%s'" % self.doc_id)
711         layout.prop(self, "doc_new", text="")
712
713     def invoke(self, context, event):
714         wm = context.window_manager
715         return wm.invoke_props_dialog(self, width=600)
716
717
718 rna_path = StringProperty(name="Property Edit",
719     description="Property data_path edit", maxlen=1024, default="", options={'HIDDEN'})
720
721 rna_value = StringProperty(name="Property Value",
722     description="Property value edit", maxlen=1024, default="")
723
724 rna_property = StringProperty(name="Property Name",
725     description="Property name edit", maxlen=1024, default="")
726
727 rna_min = FloatProperty(name="Min", default=0.0, precision=3)
728 rna_max = FloatProperty(name="Max", default=1.0, precision=3)
729
730
731 class WM_OT_properties_edit(bpy.types.Operator):
732     '''Internal use (edit a property data_path)'''
733     bl_idname = "wm.properties_edit"
734     bl_label = "Edit Property"
735     bl_options = {'REGISTER'}  # only because invoke_props_popup requires.
736
737     data_path = rna_path
738     property = rna_property
739     value = rna_value
740     min = rna_min
741     max = rna_max
742     description = StringProperty(name="Tip", default="")
743
744     def execute(self, context):
745         data_path = self.data_path
746         value = self.value
747         prop = self.property
748
749         prop_old = getattr(self, "_last_prop", [None])[0]
750
751         if prop_old is None:
752             self.report({'ERROR'}, "Direct execution not supported")
753             return {'CANCELLED'}
754
755         try:
756             value_eval = eval(value)
757         except:
758             value_eval = value
759
760         # First remove
761         item = eval("context.%s" % data_path)
762
763         rna_idprop_ui_prop_clear(item, prop_old)
764         exec_str = "del item['%s']" % prop_old
765         # print(exec_str)
766         exec(exec_str)
767
768         # Reassign
769         exec_str = "item['%s'] = %s" % (prop, repr(value_eval))
770         # print(exec_str)
771         exec(exec_str)
772         self._last_prop[:] = [prop]
773
774         prop_type = type(item[prop])
775
776         prop_ui = rna_idprop_ui_prop_get(item, prop)
777
778         if prop_type in (float, int):
779
780             prop_ui['soft_min'] = prop_ui['min'] = prop_type(self.min)
781             prop_ui['soft_max'] = prop_ui['max'] = prop_type(self.max)
782
783         prop_ui['description'] = self.description
784
785         # otherwise existing buttons which reference freed
786         # memory may crash blender [#26510]
787         # context.area.tag_redraw()
788         for win in context.window_manager.windows:
789             for area in win.screen.areas:
790                 area.tag_redraw()
791
792         return {'FINISHED'}
793
794     def invoke(self, context, event):
795
796         if not self.data_path:
797             self.report({'ERROR'}, "Data path not set")
798             return {'CANCELLED'}
799
800         self._last_prop = [self.property]
801
802         item = eval("context.%s" % self.data_path)
803
804         # setup defaults
805         prop_ui = rna_idprop_ui_prop_get(item, self.property, False)  # dont create
806         if prop_ui:
807             self.min = prop_ui.get("min", -1000000000)
808             self.max = prop_ui.get("max", 1000000000)
809             self.description = prop_ui.get("description", "")
810
811         wm = context.window_manager
812         return wm.invoke_props_dialog(self)
813
814
815 class WM_OT_properties_add(bpy.types.Operator):
816     '''Internal use (edit a property data_path)'''
817     bl_idname = "wm.properties_add"
818     bl_label = "Add Property"
819
820     data_path = rna_path
821
822     def execute(self, context):
823         item = eval("context.%s" % self.data_path)
824
825         def unique_name(names):
826             prop = 'prop'
827             prop_new = prop
828             i = 1
829             while prop_new in names:
830                 prop_new = prop + str(i)
831                 i += 1
832
833             return prop_new
834
835         property = unique_name(item.keys())
836
837         item[property] = 1.0
838         return {'FINISHED'}
839
840 class WM_OT_properties_context_change(bpy.types.Operator):
841     "Change the context tab in a Properties Window"
842     bl_idname = "wm.properties_context_change"
843     bl_label = ""
844
845     context = StringProperty(name="Context", maxlen=32)
846
847     def execute(self, context):
848         context.space_data.context = (self.context)
849                 
850         return {'FINISHED'}
851
852
853 class WM_OT_properties_remove(bpy.types.Operator):
854     '''Internal use (edit a property data_path)'''
855     bl_idname = "wm.properties_remove"
856     bl_label = "Remove Property"
857
858     data_path = rna_path
859     property = rna_property
860
861     def execute(self, context):
862         item = eval("context.%s" % self.data_path)
863         del item[self.property]
864         return {'FINISHED'}
865
866
867 class WM_OT_keyconfig_activate(bpy.types.Operator):
868     bl_idname = "wm.keyconfig_activate"
869     bl_label = "Activate Keyconfig"
870
871     filepath = StringProperty(name="File Path", maxlen=1024)
872
873     def execute(self, context):
874         bpy.utils.keyconfig_set(self.filepath)
875         return {'FINISHED'}
876
877
878 class WM_OT_appconfig_default(bpy.types.Operator):
879     bl_idname = "wm.appconfig_default"
880     bl_label = "Default Application Configuration"
881
882     def execute(self, context):
883         import os
884
885         context.window_manager.keyconfigs.active = context.window_manager.keyconfigs.default
886
887         filepath = os.path.join(bpy.utils.preset_paths("interaction")[0], "blender.py")
888
889         if os.path.exists(filepath):
890             bpy.ops.script.execute_preset(filepath=filepath, menu_idname="USERPREF_MT_interaction_presets")
891
892         return {'FINISHED'}
893
894
895 class WM_OT_appconfig_activate(bpy.types.Operator):
896     bl_idname = "wm.appconfig_activate"
897     bl_label = "Activate Application Configuration"
898
899     filepath = StringProperty(name="File Path", maxlen=1024)
900
901     def execute(self, context):
902         import os
903         bpy.utils.keyconfig_set(self.filepath)
904
905         filepath = self.filepath.replace("keyconfig", "interaction")
906
907         if os.path.exists(filepath):
908             bpy.ops.script.execute_preset(filepath=filepath, menu_idname="USERPREF_MT_interaction_presets")
909
910         return {'FINISHED'}
911
912
913 class WM_OT_sysinfo(bpy.types.Operator):
914     '''Generate System Info'''
915     bl_idname = "wm.sysinfo"
916     bl_label = "System Info"
917
918     def execute(self, context):
919         import sys_info
920         sys_info.write_sysinfo(self)
921         return {'FINISHED'}
922
923
924 class WM_OT_copy_prev_settings(bpy.types.Operator):
925     '''Copy settings from previous version'''
926     bl_idname = "wm.copy_prev_settings"
927     bl_label = "Copy Previous Settings"
928
929     def execute(self, context):
930         import os
931         import shutil
932         ver = bpy.app.version
933         ver_old = ((ver[0] * 100) + ver[1]) - 1
934         path_src = bpy.utils.resource_path('USER', ver_old // 100, ver_old % 100)
935         path_dst = bpy.utils.resource_path('USER')
936
937         if os.path.isdir(path_dst):
938             self.report({'ERROR'}, "Target path %r exists" % path_dst)
939         elif not os.path.isdir(path_src):
940             self.report({'ERROR'}, "Source path %r exists" % path_src)
941         else:
942             shutil.copytree(path_src, path_dst)
943             # dont loose users work if they open the splash later.
944             if bpy.data.is_saved is bpy.data.is_dirty is False:
945                 bpy.ops.wm.read_homefile()
946             else:
947                 self.report({'INFO'}, "Reload Start-Up file to restore settings.")
948             return {'FINISHED'}
949
950         return {'CANCELLED'}
951
952
953 def _webbrowser_bug_fix():
954     # test for X11
955     import os
956
957     if os.environ.get("DISPLAY"):
958
959         # BSD licenced code copied from python, temp fix for bug
960         # http://bugs.python.org/issue11432, XXX == added code
961         def _invoke(self, args, remote, autoraise):
962             # XXX, added imports
963             import io
964             import subprocess
965             import time
966
967             raise_opt = []
968             if remote and self.raise_opts:
969                 # use autoraise argument only for remote invocation
970                 autoraise = int(autoraise)
971                 opt = self.raise_opts[autoraise]
972                 if opt:
973                     raise_opt = [opt]
974
975             cmdline = [self.name] + raise_opt + args
976
977             if remote or self.background:
978                 inout = io.open(os.devnull, "r+")
979             else:
980                 # for TTY browsers, we need stdin/out
981                 inout = None
982             # if possible, put browser in separate process group, so
983             # keyboard interrupts don't affect browser as well as Python
984             setsid = getattr(os, 'setsid', None)
985             if not setsid:
986                 setsid = getattr(os, 'setpgrp', None)
987
988             p = subprocess.Popen(cmdline, close_fds=True,  # XXX, stdin=inout,
989                                  stdout=(self.redirect_stdout and inout or None),
990                                  stderr=inout, preexec_fn=setsid)
991             if remote:
992                 # wait five secons. If the subprocess is not finished, the
993                 # remote invocation has (hopefully) started a new instance.
994                 time.sleep(1)
995                 rc = p.poll()
996                 if rc is None:
997                     time.sleep(4)
998                     rc = p.poll()
999                     if rc is None:
1000                         return True
1001                 # if remote call failed, open() will try direct invocation
1002                 return not rc
1003             elif self.background:
1004                 if p.poll() is None:
1005                     return True
1006                 else:
1007                     return False
1008             else:
1009                 return not p.wait()
1010
1011         import webbrowser
1012         webbrowser.UnixBrowser._invoke = _invoke