user: How do I use Image Operators in Blender? Include parameters, examples, warnings and best practices.

assistant:  Name, Image data-block 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 [Image Generated Type Items](bpy_types_enum_items/image_generated_type_items.html#rna-enum-image-generated-type-items), (optional)) – Generated Type, Fill the image with a grid for UV map testing
        - **float** (*boolean**,* *(**optional**)*) – 32-bit Float, Create image with 32-bit floating-point bit depth
        - **use_stereo_3d** (*boolean**,* *(**optional**)*) – Stereo 3D, Create an image with left and right views
        - **tiled** (*boolean**,* *(**optional**)*) – Tiled, Create a tiled image

bpy.ops.image.open(*\**, *allow_path_tokens=True*, *filepath=''*, *directory=''*, *files=None*, *hide_props_region=True*, *check_existing=False*, *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_archive=False*, *filter_btx=False*, *filter_alembic=False*, *filter_usd=False*, *filter_obj=False*, *filter_volume=False*, *filter_folder=True*, *filter_blenlib=False*, *filemode=9*, *relative_path=True*, *show_multiview=False*, *use_multiview=False*, *display_type='DEFAULT'*, *sort_method=''*, *use_sequence_detection=True*, *use_udim_detecting=True*)
:   Open image

    Parameters:
    :   - **allow_path_tokens** (*boolean**,* *(**optional**)*) – Allow the path to contain substitution tokens
        - **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
        - **hide_props_region** (*boolean**,* *(**optional**)*) – Hide Operator Properties, Collapse the region displaying the operator settings
        - **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_archive** (*boolean**,* *(**optional**)*) – Filter archive files
        - **filter_btx** (*boolean**,* *(**optional**)*) – Filter btx files
        - **filter_alembic** (*boolean**,* *(**optional**)*) – Filter Alembic files
        - **filter_usd** (*boolean**,* *(**optional**)*) – Filter USD files
        - **filter_obj** (*boolean**,* *(**optional**)*) – Filter OBJ files
        - **filter_volume** (*boolean**,* *(**optional**)*) – Filter OpenVDB volume files
        - **filter_folder** (*boolean**,* *(**optional**)*) – Filter folders
        - **filter_blenlib** (*boolean**,* *(**optional**)*) – Filter Blender IDs
        - **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
        - **show_multiview** (*boolean**,* *(**optional**)*) – Enable Multi-View
        - **use_multiview** (*boolean**,* *(**optional**)*) – Use Multi-View
        - **display_type** (enum in [`'DEFAULT'`, `'LIST_VERTICAL'`, `'LIST_HORIZONTAL'`, `'THUMBNAIL'`], (optional)) –

          Display Type

          - `DEFAULT`
            Default – Automatically determine display type for files.
          - `LIST_VERTICAL`
            Short List – Display files as short list.
          - `LIST_HORIZONTAL`
            Long List – Display files as a detailed list.
          - `THUMBNAIL`
            Thumbnails – Display files as thumbnails.
        - **sort_method** (*enum in* *[**]**,* *(**optional**)*) – File sorting mode
        - **use_sequence_detection** (*boolean**,* *(**optional**)*) – Detect Sequences, Automatically detect animated sequences in selected images (based on file names)
        - **use_udim_detecting** (*boolean**,* *(**optional**)*) – Detect UDIMs, Detect selected UDIM files and load all matching tiles

bpy.ops.image.open_images(*\**, *directory=''*, *files=None*, *relative_path=True*, *use_sequence_detection=True*, *use_udim_detection=True*)
:   Undocumented, consider [contributing](https://developer.blender.org/).

    Parameters:
    :   - **directory** (*string**,* *(**optional**,* *never None**)*) – directory
        - **files** (`bpy_prop_collection` of `OperatorFileListElement`, (optional)) – files
        - **relative_path** (*boolean**,* *(**optional**)*) – Use relative path
        - **use_sequence_detection** (*boolean**,* *(**optional**)*) – Use sequence detection
        - **use_udim_detection** (*boolean**,* *(**optional**)*) – Use UDIM detection

    File:
    :   [startup/bl_operators/image.py:238](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/image.py#L238)

bpy.ops.image.pack()
:   Pack an image as embedded data into the .blend file

bpy.ops.image.project_apply()
:   Project edited image back onto the object

    File:
    :   [startup/bl_operators/image.py:192](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/image.py#L192)

bpy.ops.image.project_edit()
:   Edit a snapshot of the 3D Viewport in an external image editor

    File:
    :   [startup/bl_operators/image.py:122](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/image.py#L122)

bpy.ops.image.read_viewlayers()
:   Read all the current scene’s view layers from cache, as needed

bpy.ops.image.reload()
:   Reload current image from disk

bpy.ops.image.remove_render_slot()
:   Remove the current render slot

bpy.ops.image.render_border(*\**, *xmin=0*, *xmax=0*, *ymin=0*, *ymax=0*, *wait_for_input=True*)
:   Set the boundaries of the render region and enable render region

    Parameters:
    :   - **xmin** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – X Min
        - **xmax** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – X Max
        - **ymin** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Y Min
        - **ymax** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Y Max
        - **wait_for_input** (*boolean**,* *(**optional**)*) – Wait for Input

bpy.ops.image.replace(*\**, *filepath=''*, *hide_props_region=True*, *check_existing=False*, *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_archive=False*, *filter_btx=False*, *filter_alembic=False*, *filter_usd=False*, *filter_obj=False*, *filter_volume=False*, *filter_folder=True*, *filter_blenlib=False*, *filemode=9*, *relative_path=True*, *show_multiview=False*, *use_multiview=False*, *display_type='DEFAULT'*, *sort_method=''*)
:   Replace current image by another one from disk

    Parameters:
    :   - **filepath** (*string**,* *(**optional**,* *never None**)*) – File Path, Path to file
        - **hide_props_region** (*boolean**,* *(**optional**)*) – Hide Operator Properties, Collapse the region displaying the operator settings
        - **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_archive** (*boolean**,* *(**optional**)*) – Filter archive files
        - **filter_btx** (*boolean**,* *(**optional**)*) – Filter btx files
        - **filter_alembic** (*boolean**,* *(**optional**)*) – Filter Alembic files
        - **filter_usd** (*boolean**,* *(**optional**)*) – Filter USD files
        - **filter_obj** (*boolean**,* *(**optional**)*) – Filter OBJ files
        - **filter_volume** (*boolean**,* *(**optional**)*) – Filter OpenVDB volume files
        - **filter_folder** (*boolean**,* *(**optional**)*) – Filter folders
        - **filter_blenlib** (*boolean**,* *(**optional**)*) – Filter Blender IDs
        - **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
        - **show_multiview** (*boolean**,* *(**optional**)*) – Enable Multi-View
        - **use_multiview** (*boolean**,* *(**optional**)*) – Use Multi-View
        - **display_type** (enum in [`'DEFAULT'`, `'LIST_VERTICAL'`, `'LIST_HORIZONTAL'`, `'THUMBNAIL'`], (optional)) –

          Display Type

          - `DEFAULT`
            Default – Automatically determine display type for files.
          - `LIST_VERTICAL`
            Short List – Display files as short list.
          - `LIST_HORIZONTAL`
            Long List – Display files as a detailed list.
          - `THUMBNAIL`
            Thumbnails – Display files as thumbnails.
        - **sort_method** (*enum in* *[**]**,* *(**optional**)*) – File sorting mode

bpy.ops.image.resize(*\**, *size=(0, 0)*, *all_udims=False*)
:   Resize the image

    Parameters:
    :   - **size** (*int array* *of* *2 items in* *[**1**,* *inf**]**,* *(**optional**)*) – Size
        - **all_udims** (*boolean**,* *(**optional**)*) – All UDIM Tiles, Scale all the image’s UDIM tiles

bpy.ops.image.rotate_orthogonal(*\**, *degrees='90'*)
:   Rotate the image

    Parameters:
    :   **degrees** (enum in [`'90'`, `'180'`, `'270'`], (optional)) –

        Degrees, Amount of rotation in degrees (90, 180, 270)

        - `90`
          90 Degrees – Rotate 90 degrees clockwise.
        - `180`
          180 Degrees – Rotate 180 degrees clockwise.
        - `270`
          270 Degrees – Rotate 270 degrees clockwise.

bpy.ops.image.sample(*\**, *size=1*)
:   Use mouse to sample a color in current image

    Parameters:
    :   **size** (*int in* *[**1**,* *128**]**,* *(**optional**)*) – Sample Size

bpy.ops.image.sample_line(*\**, *xstart=0*, *xend=0*, *ystart=0*, *yend=0*, *flip=False*, *cursor=5*)
:   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
        - **flip** (*boolean**,* *(**optional**)*) – Flip
        - **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_all_modified()
:   Save all modified images

bpy.ops.image.save_as(*\**, *save_as_render=False*, *copy=False*, *allow_path_tokens=True*, *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_archive=False*, *filter_btx=False*, *filter_alembic=False*, *filter_usd=False*, *filter_obj=False*, *filter_volume=False*, *filter_folder=True*, *filter_blenlib=False*, *filemode=9*, *relative_path=True*, *show_multiview=False*, *use_multiview=False*, *display_type='DEFAULT'*, *sort_method=''*)
:   Save the image with another name and/or settings

    Parameters:
    :   - **save_as_render** (*boolean**,* *(**optional**)*) – Save As Render, Save image with render color management.For display image formats like PNG, apply view and display transform.For intermediate image formats like OpenEXR, use the default render output color space
        - **copy** (*boolean**,* *(**optional**)*) – Copy, Create a new image file without modifying the current image in Blender
        - **allow_path_tokens** (*boolean**,* *(**optional**)*) – Allow the path to contain substitution tokens
        - **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_archive** (*boolean**,* *(**optional**)*) – Filter archive files
        - **filter_btx** (*boolean**,* *(**optional**)*) – Filter btx files
        - **filter_alembic** (*boolean**,* *(**optional**)*) – Filter Alembic files
        - **filter_usd** (*boolean**,* *(**optional**)*) – Filter USD files
        - **filter_obj** (*boolean**,* *(**optional**)*) – Filter OBJ files
        - **filter_volume** (*boolean**,* *(**optional**)*) – Filter OpenVDB volume files
        - **filter_folder** (*boolean**,* *(**optional**)*) – Filter folders
        - **filter_blenlib** (*boolean**,* *(**optional**)*) – Filter Blender IDs
        - **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
        - **show_multiview** (*boolean**,* *(**optional**)*) – Enable Multi-View
        - **use_multiview** (*boolean**,* *(**optional**)*) – Use Multi-View
        - **display_type** (enum in [`'DEFAULT'`, `'LIST_VERTICAL'`, `'LIST_HORIZONTAL'`, `'THUMBNAIL'`], (optional)) –

          Display Type

          - `DEFAULT`
            Default – Automatically determine display type for files.
          - `LIST_VERTICAL`
            Short List – Display files as short list.
          - `LIST_HORIZONTAL`
            Long List – Display files as a detailed list.
          - `THUMBNAIL`
            Thumbnails – Display files as thumbnails.
        - **sort_method** (*enum in* *[**]**,* *(**optional**)*) – File sorting mode

bpy.ops.image.save_sequence()
:   Save a sequence of images

bpy.ops.image.tile_add(*\**, *number=1002*, *count=1*, *label=''*, *fill=True*, *color=(0.0, 0.0, 0.0, 1.0)*, *generated_type='BLANK'*, *width=1024*, *height=1024*, *float=False*, *alpha=True*)
:   Adds a tile to the image

    Parameters:
    :   - **number** (*int in* *[**1001**,* *2000**]**,* *(**optional**)*) – Number, UDIM number of the tile
        - **count** (*int in* *[**1**,* *inf**]**,* *(**optional**)*) – Count, How many tiles to add
        - **label** (*string**,* *(**optional**,* *never None**)*) – Label, Optional tile label
        - **fill** (*boolean**,* *(**optional**)*) – Fill, Fill new tile with a generated image
        - **color** (*float array* *of* *4 items in* *[**0**,* *inf**]**,* *(**optional**)*) – Color, Default fill color
        - **generated_type** (enum in [Image Generated Type Items](bpy_types_enum_items/image_generated_type_items.html#rna-enum-image-generated-type-items), (optional)) – Generated Type, Fill the image with a grid for UV map testing
        - **width** (*int in* *[**1**,* *inf**]**,* *(**optional**)*) – Width, Image width
        - **height** (*int in* *[**1**,* *inf**]**,* *(**optional**)*) – Height, Image height
        - **float** (*boolean**,* *(**optional**)*) – 32-bit Float, Create image with 32-bit floating-point bit depth
        - **alpha** (*boolean**,* *(**optional**)*) – Alpha, Create an image with an alpha channel

bpy.ops.image.tile_fill(*\**, *color=(0.0, 0.0, 0.0, 1.0)*, *generated_type='BLANK'*, *width=1024*, *height=1024*, *float=False*, *alpha=True*)
:   Fill the current tile with a generated image

    Parameters:
    :   - **color** (*float array* *of* *4 items in* *[**0**,* *inf**]**,* *(**optional**)*) – Color, Default fill color
        - **generated_type** (enum in [Image Generated Type Items](bpy_types_enum_items/image_generated_type_items.html#rna-enum-image-generated-type-items), (optional)) – Generated Type, F