# 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`

    LightProbe 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`

    Version of Blender the .blend was saved with

    Type: | int array of 3 items in [0, inf], default (0, 0, 0), (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=(id1, id2, ...))

    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

  `user_map`([subset=(id1, id2, ...), ]key_types={..}, value_types={..})

    Returns a mapping of all ID datablocks 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

`bpy_struct.id_data` |

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_overridable_library` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` `bpy_struct.keyframe_delete` | `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.pop` `bpy_struct.property_overridable_library_set` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values`

References

`Context.blend_data` | `RenderEngine.update`