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