Image Operators

bpy.ops.image.change_frame(frame=0)

Interactively change the current frame number

Parameters:frame (int in [-300000, 300000], (optional)) – Frame
bpy.ops.image.curves_point_set(point='BLACK_POINT')

Set black point or white point for curves

Parameters:point (enum in [‘BLACK_POINT’, ‘WHITE_POINT’], (optional)) – Point, Set black point or white point for curves
bpy.ops.image.cycle_render_slot(reverse=False)

Cycle through all non-void render slots

Parameters:reverse (boolean, (optional)) – Cycle in Reverse
bpy.ops.image.external_edit(filepath="")

Edit image in an external application

Parameters:filepath (string, (optional, never None)) – filepath
File:startup/bl_operators/image.py:60
bpy.ops.image.invert(invert_r=False, invert_g=False, invert_b=False, invert_a=False)

Invert image’s channels

Parameters:
  • invert_r (boolean, (optional)) – Red, Invert Red Channel
  • invert_g (boolean, (optional)) – Green, Invert Green Channel
  • invert_b (boolean, (optional)) – Blue, Invert Blue Channel
  • invert_a (boolean, (optional)) – Alpha, Invert Alpha Channel
bpy.ops.image.match_movie_length()

Set image’s user’s length to the one of this video

bpy.ops.image.new(name="Untitled", width=1024, height=1024, color=(0.0, 0.0, 0.0, 1.0), alpha=True, generated_type='BLANK', float=False, gen_context='NONE')

Create a new image

Parameters:
  • name (string, (optional, never None)) – Name, Image datablock name
  • width (int in [1, inf], (optional)) – Width, Image width
  • height (int in [1, inf], (optional)) – Height, Image height
  • color (float array of 4 items in [0, inf], (optional)) – Color, Default fill color
  • alpha (boolean, (optional)) – Alpha, Create an image with an alpha channel
  • generated_type (enum in [‘BLANK’, ‘UV_GRID’, ‘COLOR_GRID’], (optional)) –

    Generated Type, Fill the image with a grid for UV map testing

    • 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.
  • float (boolean, (optional)) – 32 bit Float, Create image with 32 bit floating point bit depth
  • gen_context (enum in [‘NONE’, ‘PAINT_CANVAS’, ‘PAINT_STENCIL’], (optional)) – Gen Context, Generation context
bpy.ops.image.open(filepath="", directory="", files=None, filter_blender=False, filter_backup=False, filter_image=True, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY')

Open image

Parameters:
  • filepath (string, (optional, never None)) – File Path, Path to file
  • directory (string, (optional, never None)) – Directory, Directory of the file
  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
  • filter_blender (boolean, (optional)) – Filter .blend files
  • filter_backup (boolean, (optional)) – Filter .blend files
  • filter_image (boolean, (optional)) – Filter image files
  • filter_movie (boolean, (optional)) – Filter movie files
  • filter_python (boolean, (optional)) – Filter python files
  • filter_font (boolean, (optional)) – Filter font files
  • filter_sound (boolean, (optional)) – Filter sound files
  • filter_text (boolean, (optional)) – Filter text files
  • filter_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
  • relative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file
  • display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
bpy.ops.image.pack(as_png=False)

Pack an image as embedded data into the .blend file

Parameters:as_png (boolean, (optional)) – Pack As PNG, Pack image as lossless PNG
bpy.ops.image.project_apply()

Project edited image back onto the object

File:startup/bl_operators/image.py:229
bpy.ops.image.project_edit()

Edit a snapshot of the view-port in an external image editor

File:startup/bl_operators/image.py:158
bpy.ops.image.properties()

Toggle display properties panel

bpy.ops.image.read_renderlayers()

Read all the current scene’s render layers from cache, as needed

bpy.ops.image.reload()

Reload current image from disk

bpy.ops.image.replace(filepath="", filter_blender=False, filter_backup=False, filter_image=True, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY')

Replace current image by another one from disk

Parameters:
  • filepath (string, (optional, never None)) – File Path, Path to file
  • filter_blender (boolean, (optional)) – Filter .blend files
  • filter_backup (boolean, (optional)) – Filter .blend files
  • filter_image (boolean, (optional)) – Filter image files
  • filter_movie (boolean, (optional)) – Filter movie files
  • filter_python (boolean, (optional)) – Filter python files
  • filter_font (boolean, (optional)) – Filter font files
  • filter_sound (boolean, (optional)) – Filter sound files
  • filter_text (boolean, (optional)) – Filter text files
  • filter_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
  • relative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file
  • display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
bpy.ops.image.sample()

Use mouse to sample a color in current image

bpy.ops.image.sample_line(xstart=0, xend=0, ystart=0, yend=0, cursor=1002)

Sample a line and show it in Scope panels

Parameters:
  • xstart (int in [-inf, inf], (optional)) – X Start
  • xend (int in [-inf, inf], (optional)) – X End
  • ystart (int in [-inf, inf], (optional)) – Y Start
  • yend (int in [-inf, inf], (optional)) – Y End
  • cursor (int in [0, inf], (optional)) – Cursor, Mouse cursor style to use during the modal operator
bpy.ops.image.save()

Save the image with current name and settings

bpy.ops.image.save_as(save_as_render=False, copy=False, filepath="", check_existing=True, filter_blender=False, filter_backup=False, filter_image=True, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY')

Save the image with another name and/or settings

Parameters:
  • save_as_render (boolean, (optional)) – Save As Render, Apply render part of display transform when saving byte image
  • copy (boolean, (optional)) – Copy, Create a new image file without modifying the current image in blender
  • filepath (string, (optional, never None)) – File Path, Path to file
  • check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
  • filter_blender (boolean, (optional)) – Filter .blend files
  • filter_backup (boolean, (optional)) – Filter .blend files
  • filter_image (boolean, (optional)) – Filter image files
  • filter_movie (boolean, (optional)) – Filter movie files
  • filter_python (boolean, (optional)) – Filter python files
  • filter_font (boolean, (optional)) – Filter font files
  • filter_sound (boolean, (optional)) – Filter sound files
  • filter_text (boolean, (optional)) – Filter text files
  • filter_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
  • relative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file
  • display_type (enum in [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
bpy.ops.image.save_dirty()

Save all modified textures

File:startup/bl_operators/image.py:123
bpy.ops.image.save_sequence()

Save a sequence of images

bpy.ops.image.toolshelf()

Toggles tool shelf display

bpy.ops.image.unpack(method='USE_LOCAL', id="")

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
  • id (string, (optional, never None)) – Image Name, Image datablock name to unpack
bpy.ops.image.view_all(fit_view=False)

View the entire image

Parameters:fit_view (boolean, (optional)) – Fit View, Fit frame to the viewport
bpy.ops.image.view_ndof()

Use a 3D mouse device to pan/zoom the view

bpy.ops.image.view_pan(offset=(0.0, 0.0))

Pan the view

Parameters:offset (float array of 2 items in [-inf, inf], (optional)) – Offset, Offset in floating point units, 1.0 is the width and height of the image
bpy.ops.image.view_selected()

View all selected UVs

bpy.ops.image.view_zoom(factor=0.0)

Zoom in/out the image

Parameters:factor (float in [-inf, inf], (optional)) – Factor, Zoom factor, values higher than 1.0 zoom in, lower values zoom out
bpy.ops.image.view_zoom_in(location=(0.0, 0.0))

Zoom in the image (centered around 2D cursor)

Parameters:location (float array of 2 items in [-inf, inf], (optional)) – Location, Cursor location in screen coordinates
bpy.ops.image.view_zoom_out(location=(0.0, 0.0))

Zoom out the image (centered around 2D cursor)

Parameters:location (float array of 2 items in [-inf, inf], (optional)) – Location, Cursor location in screen coordinates
bpy.ops.image.view_zoom_ratio(ratio=0.0)

Set zoom ratio of the view

Parameters:ratio (float in [-inf, inf], (optional)) – Ratio, Zoom ratio, 1.0 is 1:1, higher is zoomed in, lower is zoomed out

Previous topic

Group Operators

Next topic

Import Anim Operators