BlendImportContext(bpy_struct)

base class — bpy_struct

class bpy.types.BlendImportContext(bpy_struct)

Contextual data for a blendfile library/linked-data related operation. Currently only exposed as read-only data for the pre/post blendimport handlers

import_items

(default None, readonly)

Type:

BlendImportContextItems[BlendImportContextItem]

options

Options for this blendfile import operation (default set(), readonly)

  • LINK Only link data, instead of appending it.

  • MAKE_PATHS_RELATIVE Make paths of used library blendfiles relative to current blendfile.

  • USE_PLACEHOLDERS Generate a placeholder (empty ID) if not found in any library files.

  • FORCE_INDIRECT Force loaded ID to be tagged as indirectly linked (used in reload context only).

  • APPEND_SET_FAKEUSER Set fake user on appended IDs.

  • APPEND_RECURSIVE Append (make local) also indirect dependencies of appended IDs coming from other libraries. NOTE: All IDs (including indirectly linked ones) coming from the same initial library are always made local.

  • APPEND_LOCAL_ID_REUSE Try to re-use previously appended matching IDs when appending them again, instead of creating local duplicates.

  • APPEND_ASSET_DATA_CLEAR Clear the asset data on append (it is always kept for linked data).

  • SELECT_OBJECTS Automatically select imported objects.

  • USE_ACTIVE_COLLECTION Use the active Collection of the current View Layer to instantiate imported collections and objects.

  • OBDATA_INSTANCE Instantiate object data IDs (i.e. create objects for them if needed).

  • COLLECTION_INSTANCE Instantiate collections as empties, instead of linking them into the current view layer.

Type:

set[Literal[‘LINK’, ‘MAKE_PATHS_RELATIVE’, ‘USE_PLACEHOLDERS’, ‘FORCE_INDIRECT’, ‘APPEND_SET_FAKEUSER’, ‘APPEND_RECURSIVE’, ‘APPEND_LOCAL_ID_REUSE’, ‘APPEND_ASSET_DATA_CLEAR’, ‘SELECT_OBJECTS’, ‘USE_ACTIVE_COLLECTION’, ‘OBDATA_INSTANCE’, ‘COLLECTION_INSTANCE’]]

process_stage

Current stage of the import process (default 'INIT', readonly)

  • INIT Blendfile import context has been initialized and filled with a list of items to import, no data has been linked or appended yet.

  • DONE All data has been imported and is available in the list of “import_items”.

Type:

Literal[‘INIT’, ‘DONE’]

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions