BlendDataImages(bpy_struct)

base class — bpy_struct

class bpy.types.BlendDataImages.BlendDataImages(bpy_struct)

Collection of images

new(name, width, height, alpha=False, float_buffer=False, stereo3d=False, is_data=False, tiled=False)

Add a new image to the main database

Parameters
  • name (string, (never None)) – New name for the data-block

  • width (int in [1, inf]) – Width of the image

  • height (int in [1, inf]) – Height of the image

  • alpha (boolean, (optional)) – Alpha, Use alpha channel

  • float_buffer (boolean, (optional)) – Float Buffer, Create an image with floating point color

  • stereo3d (boolean, (optional)) – Stereo 3D, Create left and right views

  • is_data (boolean, (optional)) – Is Data, Create image with non-color data color space

  • tiled (boolean, (optional)) – Tiled, Create a tiled image

Returns

New image data-block

Return type

Image

load(filepath, check_existing=False)

Load a new image into the main database

Parameters
  • filepath (string, (never None)) – path of the file to load

  • check_existing (boolean, (optional)) – Using existing data-block if this file is already loaded

Returns

New image data-block

Return type

Image

remove(image, do_unlink=True, do_id_user=True, do_ui_user=True)

Remove an image from the current blendfile

Parameters
  • image (Image, (never None)) – Image to remove

  • do_unlink (boolean, (optional)) – Unlink all usages of this image before deleting it

  • do_id_user (boolean, (optional)) – Decrement user counter of all datablocks used by this image

  • do_ui_user (boolean, (optional)) – Make sure interface does not reference this image

tag(value)

tag

Parameters

value (boolean) – Value

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

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

  • BlendData.images