Wm Operators

bpy.ops.wm.alembic_export(filepath="", check_existing=True, 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_btx=False, filter_collada=False, filter_alembic=True, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', start=-2147483648, end=-2147483648, xsamples=1, gsamples=1, sh_open=0.0, sh_close=1.0, selected=False, renderable_only=True, visible_layers_only=False, flatten=False, uvs=True, packuv=True, normals=True, vcolors=False, face_sets=False, subdiv_schema=False, apply_subdiv=False, curves_as_mesh=False, compression_type='OGAWA', global_scale=1.0, triangulate=False, quad_method='SHORTEST_DIAGONAL', ngon_method='BEAUTY', export_hair=True, export_particles=True, as_background_job=False, init_scene_frame_range=False)

Export current scene in an Alembic archive

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_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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the export, use the default value to take the start frame of the current scene
  • end (int in [-inf, inf], (optional)) – End Frame, End frame of the export, use the default value to take the end frame of the current scene
  • xsamples (int in [1, 128], (optional)) – Transform Samples, Number of times per frame transformations are sampled
  • gsamples (int in [1, 128], (optional)) – Geometry Samples, Number of times per frame object data are sampled
  • sh_open (float in [-1, 1], (optional)) – Shutter Open, Time at which the shutter is open
  • sh_close (float in [-1, 1], (optional)) – Shutter Close, Time at which the shutter is closed
  • selected (boolean, (optional)) – Selected Objects Only, Export only selected objects
  • renderable_only (boolean, (optional)) – Renderable Objects Only, Export only objects marked renderable in the outliner
  • visible_layers_only (boolean, (optional)) – Visible Layers Only, Export only objects in visible layers
  • flatten (boolean, (optional)) – Flatten Hierarchy, Do not preserve objects’ parent/children relationship
  • uvs (boolean, (optional)) – UVs, Export UVs
  • packuv (boolean, (optional)) – Pack UV Islands, Export UVs with packed island
  • normals (boolean, (optional)) – Normals, Export normals
  • vcolors (boolean, (optional)) – Vertex Colors, Export vertex colors
  • face_sets (boolean, (optional)) – Face Sets, Export per face shading group assignments
  • subdiv_schema (boolean, (optional)) – Use Subdivision Schema, Export meshes using Alembic’s subdivision schema
  • apply_subdiv (boolean, (optional)) – Apply Subsurf, Export subdivision surfaces as meshes
  • curves_as_mesh (boolean, (optional)) – Curves as Mesh, Export curves and NURBS surfaces as meshes
  • compression_type (enum in ['OGAWA', 'HDF5'], (optional)) – Compression
  • global_scale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin
  • triangulate (boolean, (optional)) – Triangulate, Export Polygons (Quads & NGons) as Triangles
  • quad_method (enum in ['BEAUTY', 'FIXED', 'FIXED_ALTERNATE', 'SHORTEST_DIAGONAL'], (optional)) –

    Quad Method, Method for splitting the quads into triangles

    • BEAUTY Beauty , Split the quads in nice triangles, slower method.
    • FIXED Fixed, Split the quads on the first and third vertices.
    • FIXED_ALTERNATE Fixed Alternate, Split the quads on the 2nd and 4th vertices.
    • SHORTEST_DIAGONAL Shortest Diagonal, Split the quads based on the distance between the vertices.
  • ngon_method (enum in ['BEAUTY', 'FIXED', 'FIXED_ALTERNATE', 'SHORTEST_DIAGONAL'], (optional)) –

    Polygon Method, Method for splitting the polygons into triangles

    • BEAUTY Beauty , Split the quads in nice triangles, slower method.
    • FIXED Fixed, Split the quads on the first and third vertices.
    • FIXED_ALTERNATE Fixed Alternate, Split the quads on the 2nd and 4th vertices.
    • SHORTEST_DIAGONAL Shortest Diagonal, Split the quads based on the distance between the vertices.
  • export_hair (boolean, (optional)) – Export Hair, Exports hair particle systems as animated curves
  • export_particles (boolean, (optional)) – Export Particles, Exports non-hair particle systems
  • as_background_job (boolean, (optional)) – Run as Background Job, Enable this to run the import in the background, disable to block Blender while importing. This option is deprecated; EXECUTE this operator to run in the foreground, and INVOKE it to run as a background job
bpy.ops.wm.alembic_import(filepath="", check_existing=True, 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_btx=False, filter_collada=False, filter_alembic=True, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', scale=1.0, set_frame_range=True, validate_meshes=False, is_sequence=False, as_background_job=False)

Load an Alembic archive

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_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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • scale (float in [0.0001, 1000], (optional)) – Scale, Value by which to enlarge or shrink the objects with respect to the world’s origin
  • set_frame_range (boolean, (optional)) – Set Frame Range, If checked, update scene’s start and end frame to match those of the Alembic archive
  • validate_meshes (boolean, (optional)) – Validate Meshes, Check imported mesh objects for invalid data (slow)
  • is_sequence (boolean, (optional)) – Is Sequence, Set to true if the cache is split into separate files
  • as_background_job (boolean, (optional)) – Run as Background Job, Enable this to run the export in the background, disable to block Blender while exporting. This option is deprecated; EXECUTE this operator to run in the foreground, and INVOKE it to run as a background job
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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=True, filemode=1, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', link=False, autoselect=True, active_collection=True, instance_collections=False, 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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • link (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending
  • 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
  • set_fake (boolean, (optional)) – Fake User, Set Fake User for appended items (except Objects and Groups)
  • use_recursive (boolean, (optional)) – Localize All, Localize all appended data, including those indirectly linked from other libraries
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:294
bpy.ops.wm.call_menu(name="")

Call (draw) a pre-defined menu

Parameters:name (string, (optional, never None)) – Name, Name of the menu
bpy.ops.wm.call_menu_pie(name="")

Call (draw) a pre-defined pie menu

Parameters:name (string, (optional, never None)) – Name, Name of the pie menu
bpy.ops.wm.call_panel(name="", keep_open=True)

Call (draw) a pre-defined panel

Parameters:
  • name (string, (optional, never None)) – Name, Name of the menu
  • keep_open (boolean, (optional)) – Keep Open
bpy.ops.wm.collada_export(filepath="", check_existing=True, 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_btx=False, filter_collada=True, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', prop_bc_export_ui_section='main', apply_modifiers=False, export_mesh_type=0, export_mesh_type_selection='view', export_global_forward_selection='Y', export_global_up_selection='Z', apply_global_orientation=False, selected=False, include_children=False, include_armatures=False, include_shapekeys=False, deform_bones_only=False, include_animations=True, include_all_actions=True, export_animation_type_selection='sample', sampling_rate=1, keep_smooth_curves=False, keep_keyframes=False, keep_flat_curves=False, active_uv_only=False, use_texture_copies=True, triangulate=True, use_object_instantiation=True, use_blender_profile=True, sort_by_name=False, export_object_transformation_type=0, export_object_transformation_type_selection='matrix', export_animation_transformation_type=0, export_animation_transformation_type_selection='matrix', open_sim=False, limit_precision=False, keep_bind_info=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_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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • prop_bc_export_ui_section (enum in ['main', 'geometry', 'armature', 'animation', 'collada'], (optional)) –

    Export Section, Only for User Interface organization

    • main Main, Data Export Section.
    • geometry Geom, Geometry Export Section.
    • armature Arm, Armature Export Section.
    • animation Anim, Animation Export Section.
    • collada Extra, Collada Export Section.
  • 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.
  • export_global_forward_selection (enum in ['X', 'Y', 'Z', '-X', '-Y', '-Z'], (optional)) –

    Global Forward Axis, Global Forward axis for export

    • X X Forward, Global Forward is positive X Axis.
    • Y Y Forward, Global Forward is positive Y Axis.
    • Z Z Forward, Global Forward is positive Z Axis.
    • -X -X Forward, Global Forward is negative X Axis.
    • -Y -Y Forward, Global Forward is negative Y Axis.
    • -Z -Z Forward, Global Forward is negative Z Axis.
  • export_global_up_selection (enum in ['X', 'Y', 'Z', '-X', '-Y', '-Z'], (optional)) –

    Global Up Axis, Global Up axis for export

    • X X Up, Global UP is positive X Axis.
    • Y Y Up, Global UP is positive Y Axis.
    • Z Z Up, Global UP is positive Z Axis.
    • -X -X Up, Global UP is negative X Axis.
    • -Y -Y Up, Global UP is negative Y Axis.
    • -Z -Z Up, Global UP is negative Z Axis.
  • apply_global_orientation (boolean, (optional)) – Apply Global Orientation, Rotate all root objects to match the global orientation settings otherwise set the global orientation per Collada asset
  • 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)
  • include_shapekeys (boolean, (optional)) – Include Shape Keys, Export all Shape Keys from Mesh Objects
  • deform_bones_only (boolean, (optional)) – Deform Bones only, Only export deforming bones with armatures
  • include_animations (boolean, (optional)) – Include Animations, Export animations if available (exporting animations will enforce the decomposition of node transforms into <translation> <rotation> and <scale> components)
  • include_all_actions (boolean, (optional)) – Include all Actions, Export also unassigned actions (this allows you to export entire animation libraries for your character(s))
  • export_animation_type_selection (enum in ['sample', 'keys'], (optional)) –

    Key Type, Type for exported animations (use sample keys or Curve keys)

    • sample Samples, Export Sampled points guided by sampling rate.
    • keys Curves, Export Curves (note: guided by curve keys).
  • sampling_rate (int in [1, inf], (optional)) – Sampling Rate, The distance between 2 keyframes (1 to key every frame)
  • keep_smooth_curves (boolean, (optional)) – Keep Smooth curves, Export also the curve handles (if available) (this does only work when the inverse parent matrix is the unity matrix, otherwise you may end up with odd results)
  • keep_keyframes (boolean, (optional)) – Keep Keyframes, Use existing keyframes as additional sample points (this helps when you want to keep manual tweaks)
  • keep_flat_curves (boolean, (optional)) – All keyed curves, Export also curves which have only one key or are totally flat
  • active_uv_only (boolean, (optional)) – Only Selected UV Map, Export only the selected UV Map
  • use_texture_copies (boolean, (optional)) – Copy, Copy textures to same folder where the .dae file is exported
  • triangulate (boolean, (optional)) – Triangulate, Export Polygons (Quads & NGons) as Triangles
  • use_object_instantiation (boolean, (optional)) – Use Object Instances, Instantiate multiple Objects from same Data
  • use_blender_profile (boolean, (optional)) – Use Blender Profile, Export additional Blender specific information (for material, shaders, bones, etc.)
  • sort_by_name (boolean, (optional)) – Sort by Object name, Sort exported data by Object name
  • export_object_transformation_type (int in [-inf, inf], (optional)) – Transform, Object Transformation type for translation, scale and rotation
  • export_object_transformation_type_selection (enum in ['matrix', 'decomposed'], (optional)) –

    Transform, Object Transformation type for translation, scale and rotation

    • matrix Matrix, Use <matrix> representation for exported transformations.
    • decomposed Decomposed, Use <rotate>, <translate> and <scale> representation for exported transformations.
  • export_animation_transformation_type (int in [-inf, inf], (optional)) – Transform, Transformation type for translation, scale and rotation. Note: The Animation transformation type in the Anim Tab is always equal to the Object transformation type in the Geom tab
  • export_animation_transformation_type_selection (enum in ['matrix', 'decomposed'], (optional)) –

    Transform, Transformation type for translation, scale and rotation. Note: The Animation transformation type in the Anim Tab is always equal to the Object transformation type in the Geom tab

    • matrix Matrix, Use <matrix> representation for exported transformations.
    • decomposed Decomposed, Use <rotate>, <translate> and <scale> representation for exported transformations.
  • open_sim (boolean, (optional)) – Export to SL/OpenSim, Compatibility mode for SL, OpenSim and other compatible online worlds
  • limit_precision (boolean, (optional)) – Limit Precision, Reduce the precision of the exported data to 6 digits
  • keep_bind_info (boolean, (optional)) – Keep Bind Info, Store Bindpose information in custom bone properties for later use during Collada export
bpy.ops.wm.collada_import(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_btx=False, filter_collada=True, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', import_units=False, fix_orientation=False, find_chains=False, auto_connect=False, min_chain_length=0, keep_bind_info=False)

Load a Collada file

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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • import_units (boolean, (optional)) – Import Units, If disabled match import to Blender’s current Unit settings, otherwise use the settings from the Imported scene
  • fix_orientation (boolean, (optional)) – Fix Leaf Bones, Fix Orientation of Leaf Bones (Collada does only support Joints)
  • find_chains (boolean, (optional)) – Find Bone Chains, Find best matching Bone Chains and ensure bones in chain are connected
  • auto_connect (boolean, (optional)) – Auto Connect, Set use_connect for parent bones which have exactly one child bone
  • min_chain_length (int in [0, inf], (optional)) – Minimum Chain Length, When searching Bone Chains disregard chains of length below this value
  • keep_bind_info (boolean, (optional)) – Keep Bind Info, Store Bindpose information in custom bone properties for later use during Collada export
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:682

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

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

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

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

Undocumented contribute <https://developer.blender.org/T51061>

Parameters:data_path (string, (optional, never None)) – Context Attributes, RNA context string
File:startup/bl_operators/wm.py:522
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:817

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

Undocumented contribute <https://developer.blender.org/T51061>

Parameters:data_path (string, (optional, never None)) – Context Attributes, RNA context string
File:startup/bl_operators/wm.py:549
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:201

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

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

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

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

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

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

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

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

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

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

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:1031
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:997
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 contribute <https://developer.blender.org/T51061>

Parameters:filepath (string, (optional, never None)) – filepath
File:startup/bl_operators/wm.py:1807
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:85

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

bpy.ops.wm.lib_reload(library="", filepath="", directory="", filename="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA')

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
  • 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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
bpy.ops.wm.lib_relocate(library="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, relative_path=True, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA')

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
  • 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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.

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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • link (boolean, (optional)) – Link, Link the objects or data-blocks rather than appending
  • 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
bpy.ops.wm.memory_statistics()

Print memory statistics to the console

bpy.ops.wm.open_mainfile(filepath="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', 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
  • 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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • 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:1442
bpy.ops.wm.operator_defaults()

Set the active operator to its default values

bpy.ops.wm.operator_pie_enum(data_path="", prop_string="")

Undocumented contribute <https://developer.blender.org/T51061>

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

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

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:1490
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:1475
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:860
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)) – Mat/Tex/…, 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:209

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)) – files
  • directory (string, (optional, never None)) – directory
  • filter_blender (boolean, (optional)) – filter_blender
  • filter_folder (boolean, (optional)) – filter_folder
  • 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)) – Mat/Tex/…, 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:99

bpy.ops.wm.previews_clear(id_type={'ALL', 'GEOMETRY', 'GROUP', 'IMAGE', 'LIGHT', 'MATERIAL', 'OBJECT', 'SCENE', 'SHADING', 'TEXTURE', 'WORLD'})

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

Parameters:id_type (enum set in {'ALL', 'GEOMETRY', 'SHADING', 'SCENE', 'GROUP', '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 materiasl, lights, worlds, textures and images.
  • SCENE Scenes.
  • GROUP Groups.
  • 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="")

Undocumented contribute <https://developer.blender.org/T51061>

Parameters:data_path (string, (optional, never None)) – Property Edit, Property data_path edit
File:startup/bl_operators/wm.py:1341
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:1380
bpy.ops.wm.properties_edit(data_path="", property="", value="", default="", min=-10000, max=10000.0, use_soft_limits=False, is_overridable_library=False, soft_min=-10000, soft_max=10000.0, description="")

Undocumented contribute <https://developer.blender.org/T51061>

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
  • default (string, (optional, never None)) – Default Value, Default value of the property. Important for NLA mixing
  • min (float in [-inf, inf], (optional)) – Min
  • max (float in [-inf, inf], (optional)) – Max
  • use_soft_limits (boolean, (optional)) – Use Soft Limits
  • is_overridable_library (boolean, (optional)) – Is Library Overridable
  • soft_min (float in [-inf, inf], (optional)) – Min
  • soft_max (float in [-inf, inf], (optional)) – Max
  • description (string, (optional, never None)) – Tooltip
File:

startup/bl_operators/wm.py:1137

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

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)

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
  • 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
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, 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_empty (boolean, (optional)) – Empty
bpy.ops.wm.read_userpref()

Load last saved preferences

bpy.ops.wm.recover_auto_save(filepath="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=False, filter_blenlib=False, filemode=8, display_type='LIST_LONG', sort_method='FILE_SORT_TIME')

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_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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
bpy.ops.wm.recover_last_session()

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

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 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
  • 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="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', 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
  • 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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • compress (boolean, (optional)) – Compress, Write compressed .blend file
  • relative_remap (boolean, (optional)) – Remap Relative, Make paths relative 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="", 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_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=8, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', compress=False, relative_remap=False, exit=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_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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_alembic (boolean, (optional)) – Filter Alembic 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_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_SHORT Short List, Display files as short list.
    • LIST_LONG Long List, Display files as a detailed list.
    • THUMBNAIL Thumbnails, Display files as thumbnails.
  • sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Sort by time, Sort files by modification time.
    • FILE_SORT_SIZE Sort by size, Sort files by size.
  • compress (boolean, (optional)) – Compress, Write compressed .blend file
  • relative_remap (boolean, (optional)) – Remap Relative, Make paths relative when saving to a different directory
  • exit (boolean, (optional)) – Exit, Exit Blender after saving
bpy.ops.wm.save_userpref()

Save preferences separately, overrides startup file preferences

bpy.ops.wm.search_menu()

Pop-up a search menu 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.sysinfo(filepath="")

Generate system information, saved into a text file

Parameters:filepath (string, (optional, never None)) – filepath
File:startup/bl_operators/wm.py:1420
bpy.ops.wm.tool_set_by_id(name="", cycle=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
  • space_type (enum in ['EMPTY', 'VIEW_3D', 'IMAGE_EDITOR', 'NODE_EDITOR', 'SEQUENCE_EDITOR', 'CLIP_EDITOR', 'DOPESHEET_EDITOR', 'GRAPH_EDITOR', 'NLA_EDITOR', 'TEXT_EDITOR', 'CONSOLE', 'INFO', 'TOPBAR', 'STATUSBAR', 'OUTLINER', 'PROPERTIES', 'FILE_BROWSER', 'PREFERENCES'], (optional)) – Type
File:

startup/bl_operators/wm.py:1527

bpy.ops.wm.tool_set_by_index(index=0, cycle=False, expand=True, 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 sub-groups
  • space_type (enum in ['EMPTY', 'VIEW_3D', 'IMAGE_EDITOR', 'NODE_EDITOR', 'SEQUENCE_EDITOR', 'CLIP_EDITOR', 'DOPESHEET_EDITOR', 'GRAPH_EDITOR', 'NLA_EDITOR', 'TEXT_EDITOR', 'CONSOLE', 'INFO', 'TOPBAR', 'STATUSBAR', 'OUTLINER', 'PROPERTIES', 'FILE_BROWSER', 'PREFERENCES'], (optional)) – Type
File:

startup/bl_operators/wm.py:1568

bpy.ops.wm.toolbar()

Undocumented contribute <https://developer.blender.org/T51061>

File:startup/bl_operators/wm.py:1611
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:843
bpy.ops.wm.userpref_autoexec_path_add()

Add path to exclude from autoexecution

bpy.ops.wm.userpref_autoexec_path_remove(index=0)

Remove path to exclude from autoexecution

Parameters:index (int in [0, inf], (optional)) – Index
bpy.ops.wm.window_close()

Close the current window

bpy.ops.wm.window_fullscreen_toggle()

Toggle the current window fullscreen

bpy.ops.wm.window_new()

Create a new window

bpy.ops.wm.window_new_main()

Create a new main window with its own workspace and scene selection