Image(ID)

base classes — bpy_struct, ID

class bpy.types.Image(ID)

Image datablock referencing an external or packed image

bindcode

OpenGL bindcode

Type :int in [0, inf], default 0, (readonly)

colorspace_settings

Input color space settings

Type :ColorManagedColorspaceSettings, (readonly)

depth

Image bit depth

Type :int in [0, inf], default 0, (readonly)

display_aspect

Display Aspect for this image, does not affect rendering

Type :float array of 2 items in [0.1, 5000], default (0.0, 0.0)

field_order

Order of video fields (select which lines are displayed first)

• EVEN Upper First, Upper field first.
• ODD Lower First, Lower field first.

Type :enum in [‘EVEN’, ‘ODD’], default ‘EVEN’

file_format

Format used for re-saving this file

• BMP BMP, Output image in bitmap format.
• IRIS Iris, Output image in (old!) SGI IRIS format.
• PNG PNG, Output image in PNG format.
• JPEG JPEG, Output image in JPEG format.
• TARGA Targa, Output image in Targa format.
• TARGA_RAW Targa Raw, Output image in uncompressed Targa format.
• OPEN_EXR_MULTILAYER OpenEXR MultiLayer, Output image in multilayer OpenEXR format.
• OPEN_EXR OpenEXR, Output image in OpenEXR format.
• AVI_JPEG AVI JPEG, Output video in AVI JPEG format.
• AVI_RAW AVI Raw, Output video in AVI Raw format.
• H264 H.264, Output video in H.264 format.
• FFMPEG MPEG, Output video in MPEG format.
• THEORA Ogg Theora, Output video in Ogg format.
• XVID Xvid, Output video in Xvid format.

Type :enum in [‘BMP’, ‘IRIS’, ‘PNG’, ‘JPEG’, ‘TARGA’, ‘TARGA_RAW’, ‘OPEN_EXR_MULTILAYER’, ‘OPEN_EXR’, ‘AVI_JPEG’, ‘AVI_RAW’, ‘H264’, ‘FFMPEG’, ‘THEORA’, ‘XVID’], default ‘TARGA’

filepath

Image/Movie file name

Type :string, default “”, (never None)

filepath_raw

Image/Movie file name (without data refreshing)

Type :string, default “”, (never None)

fps

Speed of the animation in frames per second

Type :int in [1, 100], default 0

frame_duration

Duration (in frames) of the image (1 when not a video/sequence)

Type :int in [0, inf], default 0, (readonly)

frame_end

End frame of an animated texture

Type :int in [0, 128], default 0

frame_start

Start frame of an animated texture

Type :int in [0, 128], default 0

generated_height

Generated image height

Type :int in [1, 16384], default 0

generated_type

Generated image type

• BLANK Blank, Generate a blank image.
• UV_GRID UV Grid, Generated grid to test UV mappings.
• COLOR_GRID Color Grid, Generated improved UV grid to test UV mappings.

Type :enum in [‘BLANK’, ‘UV_GRID’, ‘COLOR_GRID’], default ‘BLANK’

generated_width

Generated image width

Type :int in [1, 16384], default 0

has_data

True if this image has data

Type :boolean, default False, (readonly)

is_dirty

Image has changed and is not saved

Type :boolean, default False, (readonly)

mapping

Mapping type to use for this image in the game engine

• UV UV Coordinates, Use UV coordinates for mapping the image.
• REFLECTION Reflection, Use reflection mapping for mapping the image.

Type :enum in [‘UV’, ‘REFLECTION’], default ‘UV’

packed_file

Type :PackedFile, (readonly)

pixels

Image pixels in floating point values

Type :float in [-inf, inf], default 0.0

render_slot

The current render slot displayed, only for viewer type images

Type :int in [0, 7], default 0

resolution

X/Y pixels per meter

Type :float array of 2 items in [-inf, inf], default (0.0, 0.0)

size

Width and height in pixels, zero when image data cant be loaded

Type :int array of 2 items in [-inf, inf], default (0, 0), (readonly)

source

Where the image comes from

• FILE Single Image, Single image file.
• SEQUENCE Image Sequence, Multiple image files, as a sequence.
• MOVIE Movie, Movie file.
• GENERATED Generated, Generated image.
• VIEWER Viewer, Compositing node viewer.

Type :enum in [‘FILE’, ‘SEQUENCE’, ‘MOVIE’, ‘GENERATED’, ‘VIEWER’], default ‘FILE’

tiles_x

Degree of repetition in the X direction

Type :int in [1, 16], default 0

tiles_y

Degree of repetition in the Y direction

Type :int in [1, 16], default 0

type

How to generate the image

Type :enum in [‘IMAGE’, ‘MULTILAYER’, ‘UV_TEST’, ‘RENDER_RESULT’, ‘COMPOSITING’], default ‘IMAGE’, (readonly)

use_animation

Use as animated texture in the game engine

Type :boolean, default False

use_clamp_x

Disable texture repeating horizontally

Type :boolean, default False

use_clamp_y

Disable texture repeating vertically

Type :boolean, default False

use_color_unpremultiply

For premultiplied alpha images, do color space conversion on colors without alpha, to avoid fringing for images with light backgrounds

Type :boolean, default False

use_fields

Use fields of the image

Type :boolean, default False

use_generated_float

Generate floating point buffer

Type :boolean, default False

use_premultiply

Convert RGB from key alpha to premultiplied alpha

Type :boolean, default False

use_tiles

Use of tilemode for faces (default shift-LMB to pick the tile for selected faces)

Type :boolean, default False

view_as_render

Apply render part of display transformation when displaying this image on the screen

Type :boolean, default False

save_render(filepath, scene=None)

Save image to a specific path using a scenes render settings

Parameters:

• filepath (string, (never None)) – Save path
• scene (Scene, (optional)) – Scene to take image parameters from

save()

Save image to its source path

pack(as_png=False)

Pack an image as embedded data into the .blend file

Parameters:as_png (boolean, (optional)) – as_png, Pack the image as PNG (needed for generated/dirty images)

unpack(method='USE_LOCAL')

Save an image packed in the .blend file to disk

Parameters:method (enum in [‘USE_LOCAL’, ‘WRITE_LOCAL’, ‘USE_ORIGINAL’, ‘WRITE_ORIGINAL’], (optional)) – method, How to unpack

reload()

Reload the image from its source path

update()

Update the display image from the floating point buffer

scale(width, height)

Scale the image in pixels

Parameters:

• width (int in [1, 10000]) – Width
• height (int in [1, 10000]) – Height

gl_touch(filter=9985, mag=9729)

Delay the image from being cleaned from the cache due inactivity

Parameters:

• filter (int in [-inf, inf], (optional)) – Filter, The texture minifying function to use if the image wan’t loaded
• mag (int in [-inf, inf], (optional)) – Magnification, The texture magnification function to use if the image wan’t loaded

Returns:

Error, OpenGL error value

Return type:

int in [-inf, inf]

gl_load(filter=9985, mag=9729)

Load the image into OpenGL graphics memory

Parameters:

• filter (int in [-inf, inf], (optional)) – Filter, The texture minifying function
• mag (int in [-inf, inf], (optional)) – Magnification, The texture magnification function

Returns:

Error, OpenGL error value

Return type:

int in [-inf, inf]

gl_free()

Free the image from OpenGL graphics memory

Inherited Properties

bpy_struct.id_data ID.name ID.users ID.use_fake_user ID.tag

ID.is_updated ID.is_updated_data ID.is_library_indirect ID.library

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden 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.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear ID.update_tag

References

bpy.context.edit_image BackgroundImage.image BlendData.images BlendDataImages.load BlendDataImages.new BlendDataImages.remove Brush.clone_image CompositorNodeImage.image EnvironmentMapTexture.image ImageTexture.image

MeshTextureFace.image MeshTexturePoly.image ShaderNodeTexEnvironment.image ShaderNodeTexImage.image SpaceImageEditor.image TextureNodeImage.image UILayout.template_image_layers UVProjectModifier.image VoxelDataTexture.image