SpaceImageEditor(Space)¶

base classes — bpy_struct, Space

class bpy.types.SpaceImageEditor(Space)¶

Image and UV editor space data

cursor_location¶

2D cursor location for this view

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

display_channels¶

Channels of the image to draw

COLOR_ALPHA Color and Alpha, Display image with RGB colors and alpha transparency.
COLOR Color, Display image with RGB colors.
ALPHA Alpha, Display alpha transparency channel.
Z_BUFFER Z-Buffer, Display Z-buffer associated with image (mapped from camera clip start to end).
RED Red.
GREEN Green.
BLUE Blue.

Type: enum in [‘COLOR_ALPHA’, ‘COLOR’, ‘ALPHA’, ‘Z_BUFFER’, ‘RED’, ‘GREEN’, ‘BLUE’], default ‘COLOR’

grease_pencil¶

Grease pencil data for this space

Type: GreasePencil

image¶

Image displayed and edited in this space

Type: Image

image_user¶

Parameters defining which layer, pass and frame of the image is displayed

Type: ImageUser, (readonly, never None)

mask¶

Mask displayed and edited in this space

Type: Mask

mask_display_type¶

Display type for mask splines

OUTLINE Outline, Display white edges with black outline.
DASH Dash, Display dashed black-white edges.
BLACK Black, Display black edges.
WHITE White, Display white edges.

Type: enum in [‘OUTLINE’, ‘DASH’, ‘BLACK’, ‘WHITE’], default ‘OUTLINE’

mask_overlay_mode¶

Overlay mode of rasterized mask

ALPHACHANNEL Alpha Channel, Show alpha channel of the mask.
COMBINED Combined, Combine space background image with the mask.

Type: enum in [‘ALPHACHANNEL’, ‘COMBINED’], default ‘ALPHACHANNEL’

mode¶

Editing context being displayed

VIEW View, View the image.
UV UV Editor, UV edit in mesh editmode.
PAINT Paint, 2D image painting mode.
MASK Mask, Mask editing.

Type: enum in [‘VIEW’, ‘UV’, ‘PAINT’, ‘MASK’], default ‘VIEW’

pivot_point¶

Rotation/Scaling Pivot

BOUNDING_BOX_CENTER Bounding Box Center, Pivot around bounding box center of selected object(s).
CURSOR 3D Cursor, Pivot around the 3D cursor.
INDIVIDUAL_ORIGINS Individual Origins, Pivot around each object’s own origin.
MEDIAN_POINT Median Point, Pivot around the median point of selected objects.
ACTIVE_ELEMENT Active Element, Pivot around active object.

Type: enum in [‘BOUNDING_BOX_CENTER’, ‘CURSOR’, ‘INDIVIDUAL_ORIGINS’, ‘MEDIAN_POINT’, ‘ACTIVE_ELEMENT’], default ‘BOUNDING_BOX_CENTER’

sample_histogram¶

Sampled colors along line

Type: Histogram, (readonly)

scopes¶

Scopes to visualize image statistics

Type: Scopes, (readonly)

show_annotation¶

Show annotations for this view

Type: boolean, default False

show_mask_overlay¶

Type: boolean, default False

show_mask_smooth¶

Type: boolean, default False

show_maskedit¶

Show Mask editing related properties

Type: boolean, default False, (readonly)

show_paint¶

Show paint related properties

Type: boolean, default False, (readonly)

show_region_hud¶

Type: boolean, default False

show_region_tool_header¶

Type: boolean, default False

show_region_toolbar¶

Type: boolean, default False

show_region_ui¶

Type: boolean, default False

show_render¶

Show render related properties

Type: boolean, default False, (readonly)

show_repeat¶

Display the image repeated outside of the main view

Type: boolean, default False

show_stereo_3d¶

Display the image in Stereo 3D

Type: boolean, default False

show_uvedit¶

Show UV editing related properties

Type: boolean, default False, (readonly)

ui_mode¶

Editing context being displayed

VIEW View, View the image.
PAINT Paint, 2D image painting mode.
MASK Mask, Mask editing.

Type: enum in [‘VIEW’, ‘PAINT’, ‘MASK’], default ‘VIEW’

use_image_pin¶

Display current image regardless of object selection

Type: boolean, default False

use_realtime_update¶

Update other affected window spaces automatically to reflect changes during interactive operations such as transform

Type: boolean, default False

uv_editor¶

UV editor settings

Type: SpaceUVEditor, (readonly, never None)

zoom¶

Zoom factor

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

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

draw_handler_add(callback, args, region_type, draw_type)¶

Add a new draw handler to this space type. It will be called every time the specified region in the space type will be drawn. Note: All arguments are positional only for now.

Parameters

callback (function) – A function that will be called when the region is drawn. It gets the specified arguments as input.
args (tuple) – Arguments that will be passed to the callback.
region_type (str) – The region type the callback draws in; usually WINDOW. (bpy.types.Region.type)
draw_type (str) – Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.

Returns

Handler that can be removed later on.

Return type

object

draw_handler_remove(handler, region_type)¶

Remove a draw handler that was added previously.

Parameters

handler (object) – The draw handler that should be removed.
region_type (str) – Region type the callback was added to.

Inherited Properties

Inherited Functions