Wm Operators

bpy.ops.wm.addon_disable(module="")

Disable an addon

Parameters:module (string, (optional, never None)) – Module, Module name of the addon to disable File :startup/bl_operators/wm.py:1602

bpy.ops.wm.addon_enable(module="")

Enable an addon

Parameters:module (string, (optional, never None)) – Module, Module name of the addon to enable File :startup/bl_operators/wm.py:1571

bpy.ops.wm.addon_expand(module="")

Display more information on this addon

Parameters:module (string, (optional, never None)) – Module, Module name of the addon to expand File :startup/bl_operators/wm.py:1902

bpy.ops.wm.addon_install(overwrite=True, target='DEFAULT', filepath="", filter_folder=True, filter_python=True, filter_glob="*.py;*.zip")

Install an addon

Parameters:

• overwrite (boolean, (optional)) – Overwrite, Remove existing addons with the same ID
• target (enum in [‘DEFAULT’, ‘PREFS’], (optional)) – Target Path
• filepath (string, (optional, never None)) – filepath
• filter_folder (boolean, (optional)) – Filter folders
• filter_python (boolean, (optional)) – Filter python
• filter_glob (string, (optional, never None)) – filter_glob

File :

startup/bl_operators/wm.py:1716

bpy.ops.wm.addon_remove(module="")

Disable an addon

Parameters:module (string, (optional, never None)) – Module, Module name of the addon to remove File :startup/bl_operators/wm.py:1860

bpy.ops.wm.appconfig_activate(filepath="")

Undocumented (contribute)

Parameters:filepath (string, (optional, never None)) – filepath File :startup/bl_operators/wm.py:1202

bpy.ops.wm.appconfig_default()

Undocumented (contribute)

File :startup/bl_operators/wm.py:1181

bpy.ops.wm.blenderplayer_start()

Launch the blender-player with the current blend-file

File :startup/bl_operators/wm.py:1267

bpy.ops.wm.call_menu(name="")

Undocumented (contribute)

Parameters:name (string, (optional, never None)) – Name, Name of the menu

bpy.ops.wm.collada_export(filepath="", check_existing=True, filter_blender=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=True, filter_folder=True, filemode=8, display_type='FILE_DEFAULTDISPLAY', apply_modifiers=False, export_mesh_type=0, export_mesh_type_selection='view', selected=False, include_children=False, include_armatures=False, deform_bones_only=False, active_uv_only=False, include_uv_textures=False, include_material_textures=False, use_texture_copies=True, use_object_instantiation=True, sort_by_name=False, second_life=False)

Save a Collada file

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
• apply_modifiers (boolean, (optional)) – Apply Modifiers, Apply modifiers to exported mesh (non destructive))
• export_mesh_type (int in [-inf, inf], (optional)) – Resolution, Modifier resolution for export
• export_mesh_type_selection (enum in [‘view’, ‘render’], (optional)) –

  Resolution, Modifier resolution for export

  • view View, Apply modifier’s view settings.
  • render Render, Apply modifier’s render settings.
• selected (boolean, (optional)) – Selection Only, Export only selected elements
• include_children (boolean, (optional)) – Include Children, Export all children of selected objects (even if not selected)
• include_armatures (boolean, (optional)) – Include Armatures, Export related armatures (even if not selected)
• deform_bones_only (boolean, (optional)) – Deform Bones only, Only export deforming bones with armatures
• active_uv_only (boolean, (optional)) – Only Active UV layer, Export textures assigned to the object UV maps
• include_uv_textures (boolean, (optional)) – Include UV Textures, Export textures assigned to the object UV maps
• include_material_textures (boolean, (optional)) – Include Material Textures, Export textures assigned to the object Materials
• use_texture_copies (boolean, (optional)) – Copy, Copy textures to same folder where the .dae file is exported
• use_object_instantiation (boolean, (optional)) – Use Object Instances, Instantiate multiple Objects from same Data
• sort_by_name (boolean, (optional)) – Sort by Object name, Sort exported data by Object name
• second_life (boolean, (optional)) – Export for Second Life, Compatibility mode for Second Life

bpy.ops.wm.collada_import(filepath="", filter_blender=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=True, filter_folder=True, filemode=8, display_type='FILE_DEFAULTDISPLAY')

Load a Collada file

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.

bpy.ops.wm.context_collection_boolean_set(data_path_iter="", data_path_item="", type='TOGGLE')

Set boolean values for a collection of items

Parameters:

• data_path_iter (string, (optional, never None)) – data_path_iter, The data path relative to the context, must point to an iterable
• data_path_item (string, (optional, never None)) – data_path_item, The data path from each iterable to the value (int or float)
• type (enum in [‘TOGGLE’, ‘ENABLE’, ‘DISABLE’], (optional)) – Type

File :

startup/bl_operators/wm.py:598

bpy.ops.wm.context_cycle_array(data_path="", reverse=False)

Set a context array value (useful for cycling the active mesh edit mode)

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• reverse (boolean, (optional)) – Reverse, Cycle backwards

File :

startup/bl_operators/wm.py:474

bpy.ops.wm.context_cycle_enum(data_path="", reverse=False)

Toggle a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• reverse (boolean, (optional)) – Reverse, Cycle backwards

File :

startup/bl_operators/wm.py:421

bpy.ops.wm.context_cycle_int(data_path="", reverse=False)

Set a context value (useful for cycling active material, vertex keys, groups, etc.)

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• reverse (boolean, (optional)) – Reverse, Cycle backwards

File :

startup/bl_operators/wm.py:387

bpy.ops.wm.context_menu_enum(data_path="")

Undocumented (contribute)

Parameters:data_path (string, (optional, never None)) – Context Attributes, RNA context string File :startup/bl_operators/wm.py:518

bpy.ops.wm.context_modal_mouse(data_path_iter="", data_path_item="", header_text="", input_scale=0.01, invert=False, initial_x=0)

Adjust arbitrary values with mouse input

Parameters:

• data_path_iter (string, (optional, never None)) – data_path_iter, The data path relative to the context, must point to an iterable
• data_path_item (string, (optional, never None)) – data_path_item, The data path from each iterable to the value (int or float)
• header_text (string, (optional, never None)) – Header Text, Text to display in header during scale
• input_scale (float in [-inf, inf], (optional)) – input_scale, Scale the mouse movement by this value before applying the delta
• invert (boolean, (optional)) – invert, Invert the mouse input
• initial_x (int in [-inf, inf], (optional)) – initial_x

File :

startup/bl_operators/wm.py:733

bpy.ops.wm.context_scale_int(data_path="", value=1.0, always_step=True)

Scale an int context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (float in [-inf, inf], (optional)) – Value, Assign value
• always_step (boolean, (optional)) – Always Step, Always adjust the value by a minimum of 1 when ‘value’ is not 1.0

File :

startup/bl_operators/wm.py:230

bpy.ops.wm.context_set_boolean(data_path="", value=True)

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (boolean, (optional)) – Value, Assignment value

File :

startup/bl_operators/wm.py:131

bpy.ops.wm.context_set_enum(data_path="", value="")

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (string, (optional, never None)) – Value, Assignment value (as a string)

File :

startup/bl_operators/wm.py:131

bpy.ops.wm.context_set_float(data_path="", value=0.0, relative=False)

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (float in [-inf, inf], (optional)) – Value, Assignment value
• relative (boolean, (optional)) – Relative, Apply relative to the current value (delta)

File :

startup/bl_operators/wm.py:131

bpy.ops.wm.context_set_id(data_path="", value="")

Toggle a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (string, (optional, never None)) – Value, Assign value

File :

startup/bl_operators/wm.py:538

bpy.ops.wm.context_set_int(data_path="", value=0, relative=False)

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (int in [-inf, inf], (optional)) – Value, Assign value
• relative (boolean, (optional)) – Relative, Apply relative to the current value (delta)

File :

startup/bl_operators/wm.py:131

bpy.ops.wm.context_set_string(data_path="", value="")

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (string, (optional, never None)) – Value, Assign value

File :

startup/bl_operators/wm.py:131

bpy.ops.wm.context_set_value(data_path="", value="")

Set a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value (string, (optional, never None)) – Value, Assignment value (as a string)

File :

startup/bl_operators/wm.py:317

bpy.ops.wm.context_toggle(data_path="")

Toggle a context value

Parameters:data_path (string, (optional, never None)) – Context Attributes, RNA context string File :startup/bl_operators/wm.py:333

bpy.ops.wm.context_toggle_enum(data_path="", value_1="", value_2="")

Toggle a context value

Parameters:

• data_path (string, (optional, never None)) – Context Attributes, RNA context string
• value_1 (string, (optional, never None)) – Value, Toggle enum
• value_2 (string, (optional, never None)) – Value, Toggle enum

File :

startup/bl_operators/wm.py:362

bpy.ops.wm.copy_prev_settings()

Copy settings from previous version

File :startup/bl_operators/wm.py:1230

bpy.ops.wm.debug_menu(debug_value=0)

Open a popup to set the debug level

Parameters:debug_value (int in [-10000, 10000], (optional)) – Debug Value

bpy.ops.wm.dependency_relations()

Print dependency graph relations to the console

bpy.ops.wm.doc_edit(doc_id="", doc_new="")

Load online reference docs

Parameters:

• doc_id (string, (optional, never None)) – Doc ID
• doc_new (string, (optional, never None)) – Edit Description

File :

startup/bl_operators/wm.py:936

bpy.ops.wm.doc_view(doc_id="")

Load online reference docs

Parameters:doc_id (string, (optional, never None)) – Doc ID File :startup/bl_operators/wm.py:905

bpy.ops.wm.doc_view_manual(doc_id="")

Load online manual

Parameters:doc_id (string, (optional, never None)) – Doc ID File :startup/bl_operators/wm.py:873

bpy.ops.wm.interaction_preset_add(remove_active=False, name="")

Add an Application Interaction Preset

Parameters:

• remove_active (boolean, (optional)) – remove_active
• name (string, (optional, never None)) – Name, Name of the preset, used to make the path name

File :

startup/bl_operators/presets.py:52

bpy.ops.wm.interface_theme_preset_add(remove_active=False, name="")

Add a theme preset

Parameters:

• remove_active (boolean, (optional)) – remove_active
• name (string, (optional, never None)) – Name, Name of the preset, used to make the path name

File :

startup/bl_operators/presets.py:52

bpy.ops.wm.keyconfig_activate(filepath="")

Undocumented (contribute)

Parameters:filepath (string, (optional, never None)) – filepath File :startup/bl_operators/wm.py:1172

bpy.ops.wm.keyconfig_export(filepath="keymap.py", filter_folder=True, filter_text=True, filter_python=True)

Export key configuration to a python script

Parameters:

• filepath (string, (optional, never None)) – filepath
• filter_folder (boolean, (optional)) – Filter folders
• filter_text (boolean, (optional)) – Filter text
• filter_python (boolean, (optional)) – Filter python

File :

startup/bl_operators/wm.py:1400

bpy.ops.wm.keyconfig_import(filepath="keymap.py", filter_folder=True, filter_text=True, filter_python=True, keep_original=True)

Import key configuration from a python script

Parameters:

• filepath (string, (optional, never None)) – filepath
• filter_folder (boolean, (optional)) – Filter folders
• filter_text (boolean, (optional)) – Filter text
• filter_python (boolean, (optional)) – Filter python
• keep_original (boolean, (optional)) – Keep original, Keep original file after copying to configuration folder

File :

startup/bl_operators/wm.py:1339

bpy.ops.wm.keyconfig_preset_add(remove_active=False, name="")

Add a Key-config Preset

Parameters:

• remove_active (boolean, (optional)) – remove_active
• name (string, (optional, never None)) – Name, Name of the preset, used to make the path name

File :

startup/bl_operators/presets.py:52

bpy.ops.wm.keyconfig_remove()

Remove key config

File :startup/bl_operators/wm.py:1526

bpy.ops.wm.keyconfig_test()

Test key-config for conflicts

File :startup/bl_operators/wm.py:1297

bpy.ops.wm.keyitem_add()

Add key map item

File :startup/bl_operators/wm.py:1477

bpy.ops.wm.keyitem_remove(item_id=0)

Remove key map item

Parameters:item_id (int in [-inf, inf], (optional)) – Item Identifier, Identifier of the item to remove File :startup/bl_operators/wm.py:1508

bpy.ops.wm.keyitem_restore(item_id=0)

Restore key map item

Parameters:item_id (int in [-inf, inf], (optional)) – Item Identifier, Identifier of the item to remove File :startup/bl_operators/wm.py:1462

bpy.ops.wm.keymap_restore(all=False)

Restore key map(s)

Parameters:all (boolean, (optional)) – All Keymaps, Restore all keymaps to default File :startup/bl_operators/wm.py:1434

bpy.ops.wm.link_append(filepath="", directory="", filename="", files=None, filter_blender=True, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=1, relative_path=True, display_type='FILE_DEFAULTDISPLAY', link=True, autoselect=True, active_layer=True, instance_groups=True)

Link or Append from a Library .blend file

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• directory (string, (optional, never None)) – Directory, Directory of the file
• filename (string, (optional, never None)) – File Name, Name of the file
• files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• relative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
• link (boolean, (optional)) – Link, Link the objects or datablocks rather than appending
• autoselect (boolean, (optional)) – Select, Select the linked objects
• active_layer (boolean, (optional)) – Active Layer, Put the linked objects on the active layer
• instance_groups (boolean, (optional)) – Instance Groups, Create instances for each group as a DupliGroup

bpy.ops.wm.memory_statistics()

Print memory statistics to the console

bpy.ops.wm.ndof_sensitivity_change(decrease=True, fast=False)

Change NDOF sensitivity

Parameters:

• decrease (boolean, (optional)) – Decrease NDOF sensitivity, If true then action decreases NDOF sensitivity instead of increasing
• fast (boolean, (optional)) – Fast NDOF sensitivity change, If true then sensitivity changes 50%, otherwise 10%

bpy.ops.wm.open_mainfile(filepath="", filter_blender=True, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=8, display_type='FILE_DEFAULTDISPLAY', load_ui=True, use_scripts=True)

Open a Blender file

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
• load_ui (boolean, (optional)) – Load UI, Load user interface setup in the .blend file
• use_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences

bpy.ops.wm.operator_cheat_sheet()

Undocumented (contribute)

File :startup/bl_operators/wm.py:1537

bpy.ops.wm.operator_preset_add(remove_active=False, name="", operator="")

Add an Application Interaction Preset

Parameters:

• remove_active (boolean, (optional)) – remove_active
• name (string, (optional, never None)) – Name, Name of the preset, used to make the path name
• operator (string, (optional, never None)) – Operator

File :

startup/bl_operators/presets.py:52

bpy.ops.wm.path_open(filepath="")

Open a path in a file browser

Parameters:filepath (string, (optional, never None)) – filepath File :startup/bl_operators/wm.py:774

bpy.ops.wm.properties_add(data_path="")

Internal use (edit a property data_path)

Parameters:data_path (string, (optional, never None)) – Property Edit, Property data_path edit File :startup/bl_operators/wm.py:1113

bpy.ops.wm.properties_context_change(context="")

Change the context tab in a Properties Window

Parameters:context (string, (optional, never None)) – Context File :startup/bl_operators/wm.py:1143

bpy.ops.wm.properties_edit(data_path="", property="", value="", min=0.0, max=1.0, description="")

Internal use (edit a property data_path)

Parameters:

• data_path (string, (optional, never None)) – Property Edit, Property data_path edit
• property (string, (optional, never None)) – Property Name, Property name edit
• value (string, (optional, never None)) – Property Value, Property value edit
• min (float in [-inf, inf], (optional)) – Min
• max (float in [-inf, inf], (optional)) – Max
• description (string, (optional, never None)) – Tip

File :

startup/bl_operators/wm.py:1034

bpy.ops.wm.properties_remove(data_path="", property="")

Internal use (edit a property data_path)

Parameters:

• data_path (string, (optional, never None)) – Property Edit, Property data_path edit
• property (string, (optional, never None)) – Property Name, Property name edit

File :

startup/bl_operators/wm.py:1157

bpy.ops.wm.quit_blender()

Quit Blender

bpy.ops.wm.radial_control(data_path_primary="", data_path_secondary="", use_secondary="", rotation_path="", color_path="", fill_color_path="", zoom_path="", image_id="")

Set some size property (like e.g. brush size) with mouse wheel

Parameters:

• data_path_primary (string, (optional, never None)) – Primary Data Path, Primary path of property to be set by the radial control
• data_path_secondary (string, (optional, never None)) – Secondary Data Path, Secondary path of property to be set by the radial control
• use_secondary (string, (optional, never None)) – Use Secondary, Path of property to select between the primary and secondary data paths
• rotation_path (string, (optional, never None)) – Rotation Path, Path of property used to rotate the texture display
• color_path (string, (optional, never None)) – Color Path, Path of property used to set the color of the control
• fill_color_path (string, (optional, never None)) – Fill Color Path, Path of property used to set the fill color of the control
• zoom_path (string, (optional, never None)) – Zoom Path, Path of property used to set the zoom level for the control
• image_id (string, (optional, never None)) – Image ID, Path of ID that is used to generate an image for the control

bpy.ops.wm.read_factory_settings()

Load default file and user preferences

bpy.ops.wm.read_homefile()

Open the default file (doesn’t save the current file)

bpy.ops.wm.recover_auto_save(filepath="", filter_blender=True, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=False, filemode=8, display_type='FILE_LONGDISPLAY')

Open an automatically saved file to recover it

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.

bpy.ops.wm.recover_last_session()

Open the last closed file (“quit.blend”)

bpy.ops.wm.redraw_timer(type='DRAW', iterations=10)

Simple redraw timer to test the speed of updating the interface

Parameters:

• type (enum in [‘DRAW’, ‘DRAW_SWAP’, ‘DRAW_WIN’, ‘DRAW_WIN_SWAP’, ‘ANIM_STEP’, ‘ANIM_PLAY’, ‘UNDO’], (optional)) –

  Type

  • DRAW Draw Region, Draw Region.
  • DRAW_SWAP Draw Region + Swap, Draw Region and Swap.
  • DRAW_WIN Draw Window, Draw Window.
  • DRAW_WIN_SWAP Draw Window + Swap, Draw Window and Swap.
  • ANIM_STEP Anim Step, Animation Steps.
  • ANIM_PLAY Anim Play, Animation Playback.
  • UNDO Undo/Redo, Undo/Redo.
• iterations (int in [1, inf], (optional)) – Iterations, Number of times to redraw

bpy.ops.wm.save_as_mainfile(filepath="", check_existing=True, filter_blender=True, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=8, display_type='FILE_DEFAULTDISPLAY', compress=False, relative_remap=True, copy=False, use_mesh_compat=False)

Save the current file in the desired location

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
• compress (boolean, (optional)) – Compress, Write compressed .blend file
• relative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving in a different directory
• copy (boolean, (optional)) – Save Copy, Save a copy of the actual working state but does not make saved file active
• use_mesh_compat (boolean, (optional)) – Legacy Mesh Format, Save using legacy mesh format (no ngons) - WARNING: only saves tris and quads, other ngons will be lost (no implicit triangulation)

bpy.ops.wm.save_homefile()

Make the current file the default .blend file

bpy.ops.wm.save_mainfile(filepath="", check_existing=True, filter_blender=True, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=8, display_type='FILE_DEFAULTDISPLAY', compress=False, relative_remap=False)

Save the current Blender file

Parameters:

• filepath (string, (optional, never None)) – File Path, Path to file
• check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
• filter_blender (boolean, (optional)) – Filter .blend files
• filter_image (boolean, (optional)) – Filter image files
• filter_movie (boolean, (optional)) – Filter movie files
• filter_python (boolean, (optional)) – Filter python files
• filter_font (boolean, (optional)) – Filter font files
• filter_sound (boolean, (optional)) – Filter sound files
• filter_text (boolean, (optional)) – Filter text files
• filter_btx (boolean, (optional)) – Filter btx files
• filter_collada (boolean, (optional)) – Filter COLLADA files
• filter_folder (boolean, (optional)) – Filter folders
• filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
• display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

  Display Type

  • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
  • FILE_SHORTDISPLAY Short List, Display files as short list.
  • FILE_LONGDISPLAY Long List, Display files as a detailed list.
  • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
• compress (boolean, (optional)) – Compress, Write compressed .blend file
• relative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving in a different directory

bpy.ops.wm.search_menu()

Pop-up a search menu over all available operators in current context

bpy.ops.wm.splash()

Opens a blocking popup region with release info

bpy.ops.wm.sysinfo()

Generate System Info

File :startup/bl_operators/wm.py:1219

bpy.ops.wm.theme_install(overwrite=True, filepath="", filter_folder=True, filter_glob="*.xml")

Install a theme

Parameters:

• overwrite (boolean, (optional)) – Overwrite, Remove existing theme file if exists
• filepath (string, (optional, never None)) – filepath
• filter_folder (boolean, (optional)) – Filter folders
• filter_glob (string, (optional, never None)) – filter_glob

File :

startup/bl_operators/wm.py:1632

bpy.ops.wm.url_open(url="")

Open a website in the web-browser

Parameters:url (string, (optional, never None)) – URL, URL to open File :startup/bl_operators/wm.py:758

bpy.ops.wm.window_duplicate()

Duplicate the current Blender window

bpy.ops.wm.window_fullscreen_toggle()

Toggle the current window fullscreen