IDOverrideLibrary(bpy_struct)

base class — bpy_struct

class bpy.types.IDOverrideLibrary(bpy_struct)

Struct gathering all data needed by overridden linked IDs

hierarchy_root

Library override ID used as root of the override hierarchy this ID is a member of

Type:

ID, (readonly)

is_in_hierarchy

Whether this library override is defined as part of a library hierarchy, or as a single, isolated and autonomous override

Type:

boolean, default True

is_system_override

Whether this library override exists only for the override hierarchy, or if it is actually editable by the user

Type:

boolean, default False

properties

List of overridden properties

Type:

IDOverrideLibraryProperties bpy_prop_collection of IDOverrideLibraryProperty, (readonly)

reference

Linked ID used as reference by this override

Type:

ID, (readonly)

operations_update()

Update the library override operations based on the differences between this override ID and its reference

reset(*, do_hierarchy=True, set_system_override=False)

Reset this override to match again its linked reference ID

Parameters:

  • do_hierarchy (boolean, (optional)) – Also reset all the dependencies of this override to match their reference linked IDs

  • set_system_override (boolean, (optional)) – Reset all user-editable overrides as (non-editable) system overrides

destroy(*, do_hierarchy=True)

Delete this override ID and remap its usages to its linked reference ID instead

Parameters:

do_hierarchy (boolean, (optional)) – Also delete all the dependencies of this override and remap their usages to their reference linked IDs

resync(scene, *, view_layer=None, residual_storage=None, do_hierarchy_enforce=False, do_whole_hierarchy=False)

Resync the data-block and its sub-hierarchy, or the whole hierarchy if requested

Parameters:

  • scene (Scene, (never None)) – The scene to operate in (for contextual things like keeping active object active, ensuring all overridden objects remain instantiated, etc.)

  • view_layer (ViewLayer, (optional)) – The view layer to operate in (same usage as the scene data, in case it is not provided the scene’s collection will be used instead)

  • residual_storage (Collection, (optional)) – Collection where to store objects that are instantiated in any other collection anymore (garbage collection, will be created if needed and none is provided)

  • do_hierarchy_enforce (boolean, (optional)) – Enforce restoring the dependency hierarchy between data-blocks to match the one from the reference linked hierarchy (WARNING: if some ID pointers have been purposedly overridden, these will be reset to their default value)

  • do_whole_hierarchy (boolean, (optional)) – Resync the whole hierarchy this data-block belongs to, not only its own sub-hierarchy

Returns:

Success, Whether the resync process was successful or not

Return type:

boolean

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

id (str) – 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 (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References