Wm Operators

bpy.ops.wm.append(filepath='', directory='', filename='', files=None, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=True, filemode=1, display_type='DEFAULT', sort_method='', link=False, do_reuse_local_id=False, autoselect=True, active_collection=True, instance_collections=False, instance_object_data=True, set_fake=False, use_recursive=True)

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_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
link (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending
do_reuse_local_id (boolean, (optional)) – Re-Use Local Data, Try to re-use previously matching appended data-blocks instead of appending a new copy
autoselect (boolean, (optional)) – Select, Select new objects
active_collection (boolean, (optional)) – Active Collection, Put new objects on the active collection
instance_collections (boolean, (optional)) – Instance Collections, Create instances for collections, rather than adding them directly to the scene
instance_object_data (boolean, (optional)) – Instance Object Data, Create instances for object data which are not referenced by any objects
set_fake (boolean, (optional)) – Fake User, Set “Fake User” for appended items (except objects and collections)
use_recursive (boolean, (optional)) – Localize All, Localize all appended data, including those indirectly linked from other libraries

bpy.ops.wm.batch_rename(data_type='OBJECT', data_source='SELECT', actions=None)

Rename multiple items at once

Parameters

data_type (enum in ['OBJECT', 'MATERIAL', 'MESH', 'CURVE', 'META', 'ARMATURE', 'LATTICE', 'GPENCIL', 'CAMERA', 'SPEAKER', 'LIGHT_PROBE', 'BONE', 'NODE', 'SEQUENCE_STRIP'], (optional)) – Type, Type of data to rename
data_source (enum in ['SELECT', 'ALL'], (optional)) – Source
actions (bpy_prop_collection of BatchRenameAction, (optional)) – actions

File

startup/bl_operators/wm.py:2894

bpy.ops.wm.blend_strings_utf8_validate()

Check and fix all strings in current .blend file to be valid UTF-8 Unicode (needed for some old, 2.4x area files)

File: startup/bl_operators/file.py:305

bpy.ops.wm.blenderplayer_start()

Launch the blender-player with the current blend-file

File: startup/bl_operators/wm.py:2028

bpy.ops.wm.call_menu(name='')

Open a predefined menu

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

bpy.ops.wm.call_menu_pie(name='')

Open a predefined pie menu

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

bpy.ops.wm.call_panel(name='', keep_open=True)

Open a predefined panel

Parameters

name (string, (optional, never None)) – Name, Name of the menu
keep_open (boolean, (optional)) – Keep Open

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:813

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:616

bpy.ops.wm.context_cycle_enum(data_path='', reverse=False, wrap=False)

Toggle a context value

Parameters

data_path (string, (optional, never None)) – Context Attributes, RNA context string
reverse (boolean, (optional)) – Reverse, Cycle backwards
wrap (boolean, (optional)) – Wrap, Wrap back to the first/last values

File

startup/bl_operators/wm.py:567

bpy.ops.wm.context_cycle_int(data_path='', reverse=False, wrap=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
wrap (boolean, (optional)) – Wrap, Wrap back to the first/last values

File

startup/bl_operators/wm.py:527

bpy.ops.wm.context_menu_enum(data_path='')

Undocumented, consider contributing.

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

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:950

bpy.ops.wm.context_pie_enum(data_path='')

Undocumented, consider contributing.

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

bpy.ops.wm.context_scale_float(data_path='', value=1.0)

Scale a float context value

Parameters

data_path (string, (optional, never None)) – Context Attributes, RNA context string
value (float in [-inf, inf], (optional)) – Value, Assign value

File

startup/bl_operators/wm.py:286

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:324

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:215

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:215

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:215

bpy.ops.wm.context_set_id(data_path='', value='')

Set a context value to an ID data-block

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:757

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:215

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:215

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:427

bpy.ops.wm.context_toggle(data_path='', module='')

Toggle a context value

Parameters

data_path (string, (optional, never None)) – Context Attributes, RNA context string
module (string, (optional, never None)) – Module, Optionally override the context with a module

File

startup/bl_operators/wm.py:451

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:492

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

Open a popup to set the debug level

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

bpy.ops.wm.doc_view(doc_id='')

Open online reference docs in a web browser

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

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:1224

bpy.ops.wm.doc_view_manual_ui_context(): View a context based online manual in a web browser

bpy.ops.wm.drop_blend_file(filepath='')

Undocumented, consider contributing.

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

bpy.ops.wm.gpencil_import_svg(filepath='', filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=False, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='', resolution=10, scale=10.0)

Import SVG into grease pencil

Parameters

filepath (string, (optional, never None)) – File Path, Path to file
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
resolution (int in [1, 30], (optional)) – Resolution, Resolution of the generated strokes
scale (float in [0.001, 100], (optional)) – Scale, Scale of the final strokes

bpy.ops.wm.interface_theme_preset_add(name='', remove_name=False, remove_active=False)

Add or remove a theme preset

Parameters

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

File

startup/bl_operators/presets.py:86

bpy.ops.wm.keyconfig_preset_add(name='', remove_name=False, remove_active=False)

Add or remove a Key-config Preset

Parameters

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

File

startup/bl_operators/presets.py:86

bpy.ops.wm.lib_reload(library='', filepath='', directory='', filename='', hide_props_region=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='')

Reload the given library

Parameters

library (string, (optional, never None)) – Library, Library to reload
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
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode

bpy.ops.wm.lib_relocate(library='', filepath='', directory='', filename='', files=None, hide_props_region=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='')

Relocate the given library to one or several others

Parameters

library (string, (optional, never None)) – Library, Library to relocate
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
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode

bpy.ops.wm.link(filepath='', directory='', filename='', files=None, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=True, filemode=1, relative_path=True, display_type='DEFAULT', sort_method='', link=True, do_reuse_local_id=False, autoselect=True, active_collection=True, instance_collections=True, instance_object_data=True)

Link 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_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
link (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending
do_reuse_local_id (boolean, (optional)) – Re-Use Local Data, Try to re-use previously matching appended data-blocks instead of appending a new copy
autoselect (boolean, (optional)) – Select, Select new objects
active_collection (boolean, (optional)) – Active Collection, Put new objects on the active collection
instance_collections (boolean, (optional)) – Instance Collections, Create instances for collections, rather than adding them directly to the scene
instance_object_data (boolean, (optional)) – Instance Object Data, Create instances for object data which are not referenced by any objects

bpy.ops.wm.memory_statistics(): Print memory statistics to the console

bpy.ops.wm.open_mainfile(filepath='', hide_props_region=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', load_ui=True, use_scripts=True, display_file_selector=True, state=0)

Open a Blender file

Parameters

filepath (string, (optional, never None)) – File Path, Path to file
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
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
display_file_selector (boolean, (optional)) – Display File Selector
state (int in [-inf, inf], (optional)) – State

bpy.ops.wm.operator_cheat_sheet()

List all the operators in a text-block, useful for scripting

File: startup/bl_operators/wm.py:2078

bpy.ops.wm.operator_defaults(): Set the active operator to its default values

bpy.ops.wm.operator_pie_enum(data_path='', prop_string='')

Undocumented, consider contributing.

Parameters

data_path (string, (optional, never None)) – Operator, Operator name (in python as string)
prop_string (string, (optional, never None)) – Property, Property name (as a string)

File

startup/bl_operators/wm.py:717

bpy.ops.wm.operator_preset_add(name='', remove_name=False, remove_active=False, operator='')

Add or remove an Operator Preset

Parameters

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

File

startup/bl_operators/presets.py:86

bpy.ops.wm.owner_disable(owner_id='')

Enable workspace owner ID

Parameters: owner_id (string, (optional, never None)) – UI Tag
File: startup/bl_operators/wm.py:2126

bpy.ops.wm.owner_enable(owner_id='')

Enable workspace owner ID

Parameters: owner_id (string, (optional, never None)) – UI Tag
File: startup/bl_operators/wm.py:2111

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:1077

bpy.ops.wm.previews_batch_clear(files=None, directory='', filter_blender=True, filter_folder=True, use_scenes=True, use_collections=True, use_objects=True, use_intern_data=True, use_trusted=False, use_backups=True)

Clear selected .blend file’s previews

Parameters

files (bpy_prop_collection of OperatorFileListElement, (optional)) – files
directory (string, (optional, never None)) – directory
filter_blender (boolean, (optional)) – filter_blender
filter_folder (boolean, (optional)) – filter_folder
use_scenes (boolean, (optional)) – Scenes, Clear scenes’ previews
use_collections (boolean, (optional)) – Collections, Clear collections’ previews
use_objects (boolean, (optional)) – Objects, Clear objects’ previews
use_intern_data (boolean, (optional)) – Materials & Textures, Clear ‘internal’ previews (materials, textures, images, etc.)
use_trusted (boolean, (optional)) – Trusted Blend Files, Enable python evaluation for selected files
use_backups (boolean, (optional)) – Save Backups, Keep a backup (.blend1) version of the files when saving with cleared previews

File

startup/bl_operators/file.py:220

bpy.ops.wm.previews_batch_generate(files=None, directory='', filter_blender=True, filter_folder=True, use_scenes=True, use_collections=True, use_objects=True, use_intern_data=True, use_trusted=False, use_backups=True)

Generate selected .blend file’s previews

Parameters

files (bpy_prop_collection of OperatorFileListElement, (optional)) – Collection of file paths with common directory root
directory (string, (optional, never None)) – Root path of all files listed in files collection
filter_blender (boolean, (optional)) – Show Blender files in the File Browser
filter_folder (boolean, (optional)) – Show folders in the File Browser
use_scenes (boolean, (optional)) – Scenes, Generate scenes’ previews
use_collections (boolean, (optional)) – Collections, Generate collections’ previews
use_objects (boolean, (optional)) – Objects, Generate objects’ previews
use_intern_data (boolean, (optional)) – Materials & Textures, Generate ‘internal’ previews (materials, textures, images, etc.)
use_trusted (boolean, (optional)) – Trusted Blend Files, Enable python evaluation for selected files
use_backups (boolean, (optional)) – Save Backups, Keep a backup (.blend1) version of the files when saving with generated previews

File

startup/bl_operators/file.py:110

bpy.ops.wm.previews_clear(id_type={})

Clear data-block previews (only for some types like objects, materials, textures, etc.)

Parameters

id_type (enum set in {'ALL', 'GEOMETRY', 'SHADING', 'SCENE', 'COLLECTION', 'OBJECT', 'MATERIAL', 'LIGHT', 'WORLD', 'TEXTURE', 'IMAGE'}, (optional)) –

Data-Block Type, Which data-block previews to clear

ALL All Types.
GEOMETRY All Geometry Types – Clear previews for scenes, collections and objects.
SHADING All Shading Types – Clear previews for materials, lights, worlds, textures and images.
SCENE Scenes.
COLLECTION Collections.
OBJECT Objects.
MATERIAL Materials.
LIGHT Lights.
WORLD Worlds.
TEXTURE Textures.
IMAGE Images.

bpy.ops.wm.previews_ensure(): Ensure data-block previews are available and up-to-date (to be saved in .blend file, only for some types like materials, textures, etc.)

bpy.ops.wm.properties_add(data_path='')

Add your own property to the data-block

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

bpy.ops.wm.properties_context_change(context='')

Jump to a different tab inside the properties editor

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

bpy.ops.wm.properties_edit(data_path='', property_name='', property_type='FLOAT', is_overridable_library=False, description='', use_soft_limits=False, array_length=3, default_int=(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), min_int=- 10000, max_int=10000, soft_min_int=- 10000, soft_max_int=10000, step_int=1, default_float=(0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), min_float=- 10000, max_float=- 10000, soft_min_float=- 10000, soft_max_float=- 10000, precision=3, step_float=0.1, subtype='', default_string='', eval_string='')

Change a custom property’s type, or adjust how it is displayed in the interface

Parameters

data_path (string, (optional, never None)) – Property Edit, Property data_path edit
property_name (string, (optional, never None)) – Property Name, Property name edit
property_type (enum in ['FLOAT', 'FLOAT_ARRAY', 'INT', 'INT_ARRAY', 'STRING', 'PYTHON'], (optional)) –
Type
- FLOAT Float – A single floating-point value.
- FLOAT_ARRAY Float Array – An array of floating-point values.
- INT Integer – A single integer.
- INT_ARRAY Integer Array – An array of integers.
- STRING String – A string value.
- PYTHON Python – Edit a python value directly, for unsupported property types.
is_overridable_library (boolean, (optional)) – Is Library Overridable, Allow the property to be overridden when the data-block is linked
description (string, (optional, never None)) – Description
use_soft_limits (boolean, (optional)) – Use Soft Limits, Limits the Property Value slider to a range, values outside the range must be inputted numerically
array_length (int in [1, 32], (optional)) – Array Length
default_int (int array of 32 items in [-inf, inf], (optional)) – Default Value
min_int (int in [-inf, inf], (optional)) – Min
max_int (int in [-inf, inf], (optional)) – Max
soft_min_int (int in [-inf, inf], (optional)) – Soft Min
soft_max_int (int in [-inf, inf], (optional)) – Soft Max
step_int (int in [1, inf], (optional)) – Step
default_float (float array of 32 items in [-inf, inf], (optional)) – Default Value
min_float (float in [-inf, inf], (optional)) – Min
max_float (float in [-inf, inf], (optional)) – Max
soft_min_float (float in [-inf, inf], (optional)) – Soft Min
soft_max_float (float in [-inf, inf], (optional)) – Soft Max
precision (int in [0, 8], (optional)) – Precision
step_float (float in [0.001, inf], (optional)) – Step
subtype (enum in [], (optional)) – Subtype
default_string (string, (optional, never None)) – Default Value
eval_string (string, (optional, never None)) – Value, Python value for unsupported custom property types

File

startup/bl_operators/wm.py:1669

bpy.ops.wm.properties_edit_value(data_path='', property_name='', eval_string='')

Edit the value of a custom property

Parameters

data_path (string, (optional, never None)) – Property Edit, Property data_path edit
property_name (string, (optional, never None)) – Property Name, Property name edit
eval_string (string, (optional, never None)) – Value, Value for custom property types that can only be edited as a Python expression

File

startup/bl_operators/wm.py:1876

bpy.ops.wm.properties_remove(data_path='', property_name='')

Internal use (edit a property data_path)

Parameters

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

File

startup/bl_operators/wm.py:1977

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='', fill_color_override_path='', fill_color_override_test_path='', zoom_path='', image_id='', secondary_tex=False, release_confirm=False)

Set some size property (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
fill_color_override_path (string, (optional, never None)) – Fill Color Override Path
fill_color_override_test_path (string, (optional, never None)) – Fill Color Override Test
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
secondary_tex (boolean, (optional)) – Secondary Texture, Tweak brush secondary/mask texture
release_confirm (boolean, (optional)) – Confirm On Release, Finish operation on key release

bpy.ops.wm.read_factory_settings(app_template='Template', use_empty=False)

Load factory default startup file and preferences. To make changes permanent, use “Save Startup File” and “Save Preferences”

Parameters: use_empty (boolean, (optional)) – Empty

bpy.ops.wm.read_factory_userpref(): Load factory default preferences. To make changes to preferences permanent, use “Save Preferences”

bpy.ops.wm.read_history(): Reloads history and bookmarks

bpy.ops.wm.read_homefile(filepath='', load_ui=True, use_splash=False, use_factory_startup=False, app_template='Template', use_empty=False)

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

Parameters

filepath (string, (optional, never None)) – File Path, Path to an alternative start-up file
load_ui (boolean, (optional)) – Load UI, Load user interface setup from the .blend file
use_splash (boolean, (optional)) – Splash
use_factory_startup (boolean, (optional)) – Factory Startup
use_empty (boolean, (optional)) – Empty

bpy.ops.wm.read_userpref(): Load last saved preferences

bpy.ops.wm.recover_auto_save(filepath='', hide_props_region=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=False, filter_blenlib=False, filemode=8, display_type='LIST_VERTICAL', sort_method='', use_scripts=True)

Open an automatically saved file to recover it

Parameters

filepath (string, (optional, never None)) – File Path, Path to file
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
use_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences

bpy.ops.wm.recover_last_session(use_scripts=True)

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

Parameters: use_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences

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

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 Animation Step – Animation steps.
- ANIM_PLAY Animation Play – Animation playback.
- UNDO Undo/Redo – Undo and redo.
iterations (int in [1, inf], (optional)) – Iterations, Number of times to redraw
time_limit (float in [0, inf], (optional)) – Time Limit, Seconds to run the test for (override iterations)

bpy.ops.wm.revert_mainfile(use_scripts=True)

Reload the saved file

Parameters: use_scripts (boolean, (optional)) – Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences

bpy.ops.wm.save_as_mainfile(filepath='', hide_props_region=True, check_existing=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', compress=False, relative_remap=True, copy=False)

Save the current file in the desired location

Parameters

filepath (string, (optional, never None)) – File Path, Path to file
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
compress (boolean, (optional)) – Compress, Write compressed .blend file
relative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving to a different directory
copy (boolean, (optional)) – Save Copy, Save a copy of the actual working state but does not make saved file active

bpy.ops.wm.save_homefile(): Make the current file the default .blend file

bpy.ops.wm.save_mainfile(filepath='', hide_props_region=True, check_existing=True, filter_blender=True, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='', compress=False, relative_remap=False, exit=False)

Save the current Blender file

Parameters

filepath (string, (optional, never None)) – File Path, Path to file
hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (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_archive (boolean, (optional)) – Filter archive files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_usd (boolean, (optional)) – Filter USD files
filter_volume (boolean, (optional)) – Filter OpenVDB volume files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
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 ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default – Automatically determine display type for files.
- LIST_VERTICAL Short List – Display files as short list.
- LIST_HORIZONTAL Long List – Display files as a detailed list.
- THUMBNAIL Thumbnails – Display files as thumbnails.
sort_method (enum in [], (optional)) – File sorting mode
compress (boolean, (optional)) – Compress, Write compressed .blend file
relative_remap (boolean, (optional)) – Remap Relative, Remap relative paths when saving to a different directory
exit (boolean, (optional)) – Exit, Exit Blender after saving

bpy.ops.wm.save_userpref(): Make the current preferences default

bpy.ops.wm.search_menu(): Pop-up a search over all menus in the current context

bpy.ops.wm.search_operator(): Pop-up a search over all available operators in current context

bpy.ops.wm.set_stereo_3d(display_mode='ANAGLYPH', anaglyph_type='RED_CYAN', interlace_type='ROW_INTERLEAVED', use_interlace_swap=False, use_sidebyside_crosseyed=False)

Toggle 3D stereo support for current window (or change the display mode)

Parameters

display_mode (enum in ['ANAGLYPH', 'INTERLACE', 'TIMESEQUENTIAL', 'SIDEBYSIDE', 'TOPBOTTOM'], (optional)) –
Display Mode
- ANAGLYPH Anaglyph – Render views for left and right eyes as two differently filtered colors in a single image (anaglyph glasses are required).
- INTERLACE Interlace – Render views for left and right eyes interlaced in a single image (3D-ready monitor is required).
- TIMESEQUENTIAL Time Sequential – Render alternate eyes (also known as page flip, quad buffer support in the graphic card is required).
- SIDEBYSIDE Side-by-Side – Render views for left and right eyes side-by-side.
- TOPBOTTOM Top-Bottom – Render views for left and right eyes one above another.
anaglyph_type (enum in ['RED_CYAN', 'GREEN_MAGENTA', 'YELLOW_BLUE'], (optional)) – Anaglyph Type
interlace_type (enum in ['ROW_INTERLEAVED', 'COLUMN_INTERLEAVED', 'CHECKERBOARD_INTERLEAVED'], (optional)) – Interlace Type
use_interlace_swap (boolean, (optional)) – Swap Left/Right, Swap left and right stereo channels
use_sidebyside_crosseyed (boolean, (optional)) – Cross-Eyed, Right eye should see left image and vice versa

bpy.ops.wm.splash(): Open the splash screen with release info

bpy.ops.wm.splash_about(): Open a window with information about UPBGE

bpy.ops.wm.sysinfo(filepath='')

Generate system information, saved into a text file

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

bpy.ops.wm.tool_set_by_id(name='', cycle=False, as_fallback=False, space_type='EMPTY')

Set the tool by name (for keymaps)

Parameters

name (string, (optional, never None)) – Identifier, Identifier of the tool
cycle (boolean, (optional)) – Cycle, Cycle through tools in this group
as_fallback (boolean, (optional)) – Set Fallback, Set the fallback tool instead of the primary tool
space_type (enum in ['EMPTY', 'VIEW_3D', 'IMAGE_EDITOR', 'NODE_EDITOR', 'SEQUENCE_EDITOR', 'CLIP_EDITOR', 'DOPESHEET_EDITOR', 'GRAPH_EDITOR', 'NLA_EDITOR', 'TEXT_EDITOR', 'LOGIC_EDITOR', 'CONSOLE', 'INFO', 'TOPBAR', 'STATUSBAR', 'OUTLINER', 'PROPERTIES', 'FILE_BROWSER', 'SPREADSHEET', 'PREFERENCES'], (optional)) – Type

File

startup/bl_operators/wm.py:2157

bpy.ops.wm.tool_set_by_index(index=0, cycle=False, expand=True, as_fallback=False, space_type='EMPTY')

Set the tool by index (for keymaps)

Parameters

index (int in [-inf, inf], (optional)) – Index in Toolbar
cycle (boolean, (optional)) – Cycle, Cycle through tools in this group
expand (boolean, (optional)) – expand, Include tool subgroups
as_fallback (boolean, (optional)) – Set Fallback, Set the fallback tool instead of the primary
space_type (enum in ['EMPTY', 'VIEW_3D', 'IMAGE_EDITOR', 'NODE_EDITOR', 'SEQUENCE_EDITOR', 'CLIP_EDITOR', 'DOPESHEET_EDITOR', 'GRAPH_EDITOR', 'NLA_EDITOR', 'TEXT_EDITOR', 'LOGIC_EDITOR', 'CONSOLE', 'INFO', 'TOPBAR', 'STATUSBAR', 'OUTLINER', 'PROPERTIES', 'FILE_BROWSER', 'SPREADSHEET', 'PREFERENCES'], (optional)) – Type

File