BlendData(bpy_struct)

base class — bpy_struct

class bpy.types.BlendData(bpy_struct)

Main data structure representing a .blend file and all its data-blocks

actions

Action data-blocks

Type

BlendDataActions bpy_prop_collection of Action, (readonly)

armatures

Armature data-blocks

Type

BlendDataArmatures bpy_prop_collection of Armature, (readonly)

brushes

Brush data-blocks

Type

BlendDataBrushes bpy_prop_collection of Brush, (readonly)

cache_files

Cache Files data-blocks

Type

BlendDataCacheFiles bpy_prop_collection of CacheFile, (readonly)

cameras

Camera data-blocks

Type

BlendDataCameras bpy_prop_collection of Camera, (readonly)

collections

Collection data-blocks

Type

BlendDataCollections bpy_prop_collection of Collection, (readonly)

curves

Curve data-blocks

Type

BlendDataCurves bpy_prop_collection of Curve, (readonly)

filepath

Path to the .blend file

Type

string, default “”, (readonly, never None)

fonts

Vector font data-blocks

Type

BlendDataFonts bpy_prop_collection of VectorFont, (readonly)

grease_pencils

Grease Pencil data-blocks

Type

BlendDataGreasePencils bpy_prop_collection of GreasePencil, (readonly)

images

Image data-blocks

Type

BlendDataImages bpy_prop_collection of Image, (readonly)

is_dirty

Have recent edits been saved to disk

Type

boolean, default False, (readonly)

is_saved

Has the current session been saved to disk as a .blend file

Type

boolean, default False, (readonly)

lattices

Lattice data-blocks

Type

BlendDataLattices bpy_prop_collection of Lattice, (readonly)

libraries

Library data-blocks

Type

BlendDataLibraries bpy_prop_collection of Library, (readonly)

lightprobes

Light Probe data-blocks

Type

BlendDataProbes bpy_prop_collection of LightProbe, (readonly)

lights

Light data-blocks

Type

BlendDataLights bpy_prop_collection of Light, (readonly)

linestyles

Line Style data-blocks

Type

BlendDataLineStyles bpy_prop_collection of FreestyleLineStyle, (readonly)

masks

Masks data-blocks

Type

BlendDataMasks bpy_prop_collection of Mask, (readonly)

materials

Material data-blocks

Type

BlendDataMaterials bpy_prop_collection of Material, (readonly)

meshes

Mesh data-blocks

Type

BlendDataMeshes bpy_prop_collection of Mesh, (readonly)

metaballs

Metaball data-blocks

Type

BlendDataMetaBalls bpy_prop_collection of MetaBall, (readonly)

movieclips

Movie Clip data-blocks

Type

BlendDataMovieClips bpy_prop_collection of MovieClip, (readonly)

node_groups

Node group data-blocks

Type

BlendDataNodeTrees bpy_prop_collection of NodeTree, (readonly)

objects

Object data-blocks

Type

BlendDataObjects bpy_prop_collection of Object, (readonly)

paint_curves

Paint Curves data-blocks

Type

BlendDataPaintCurves bpy_prop_collection of PaintCurve, (readonly)

palettes

Palette data-blocks

Type

BlendDataPalettes bpy_prop_collection of Palette, (readonly)

particles

Particle data-blocks

Type

BlendDataParticles bpy_prop_collection of ParticleSettings, (readonly)

scenes

Scene data-blocks

Type

BlendDataScenes bpy_prop_collection of Scene, (readonly)

screens

Screen data-blocks

Type

BlendDataScreens bpy_prop_collection of Screen, (readonly)

shape_keys

Shape Key data-blocks

Type

bpy_prop_collection of Key, (readonly)

sounds

Sound data-blocks

Type

BlendDataSounds bpy_prop_collection of Sound, (readonly)

speakers

Speaker data-blocks

Type

BlendDataSpeakers bpy_prop_collection of Speaker, (readonly)

texts

Text data-blocks

Type

BlendDataTexts bpy_prop_collection of Text, (readonly)

textures

Texture data-blocks

Type

BlendDataTextures bpy_prop_collection of Texture, (readonly)

use_autopack

Automatically pack all external data into .blend file

Type

boolean, default False

version

File format version the .blend file was saved with

Type

int array of 3 items in [0, inf], default (0, 0, 0), (readonly)

volumes

Volume data-blocks

Type

BlendDataVolumes bpy_prop_collection of Volume, (readonly)

window_managers

Window manager data-blocks

Type

BlendDataWindowManagers bpy_prop_collection of WindowManager, (readonly)

workspaces

Workspace data-blocks

Type

BlendDataWorkSpaces bpy_prop_collection of WorkSpace, (readonly)

worlds

World data-blocks

Type

BlendDataWorlds bpy_prop_collection of World, (readonly)

batch_remove(ids)

Remove (delete) several IDs at once.

WARNING: Considered experimental feature currently.

Note that this function is quicker than individual calls to remove() (from bpy.types.BlendData ID collections), but less safe/versatile (it can break Blender, e.g. by removing all scenes…).

Parameters

ids – Iterables of IDs (types can be mixed).

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

orphans_purge()

Remove (delete) all IDs with no user.

Parameters

  • do_local_ids (bool, optional) – Include unused local IDs in the deletion, defaults to True

  • do_linked_ids (bool, optional) – Include unused linked IDs in the deletion, defaults to True

  • do_recursive (bool, optional) – Recursively check for unused IDs, ensuring no orphaned one remain after a single run of that function, defaults to False

Returns

The number of deleted IDs.

temp_data(filepath=None)

A context manager that temporarily creates blender file data.

Parameters

filepath (str or NoneType) – The file path for the newly temporary data. When None, the path of the currently open file is used.

Returns

Blend file data which is freed once the context exists.

Return type

bpy.types.BlendData

user_map(subset, key_types, value_types)

Returns a mapping of all ID data-blocks in current bpy.data to a set of all datablocks using them.

For list of valid set members for key_types & value_types, see: bpy.types.KeyingSetPath.id_type.

Parameters

  • subset (sequence) – When passed, only these data-blocks and their users will be included as keys/values in the map.

  • key_types (set of strings) – Filter the keys mapped by ID types.

  • value_types (set of strings) – Filter the values in the set by ID types.

Returns

dictionary of bpy.types.ID instances, with sets of ID’s as their values.

Return type

dict

Inherited Properties

Inherited Functions

References