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