ImageTexture(Texture)

base classes — bpy_struct, ID, Texture

class bpy.types.ImageTexture(Texture)
checker_distance

Distance between checker tiles

Type:

float in [0, 0.99], default 0.0

crop_max_x

Maximum X value to crop the image

Type:

float in [-10, 10], default 1.0

crop_max_y

Maximum Y value to crop the image

Type:

float in [-10, 10], default 1.0

crop_min_x

Minimum X value to crop the image

Type:

float in [-10, 10], default 0.0

crop_min_y

Minimum Y value to crop the image

Type:

float in [-10, 10], default 0.0

extension

How the image is extrapolated past its original bounds

  • EXTEND Extend – Extend by repeating edge pixels of the image.

  • CLIP Clip – Clip to image size and set exterior pixels as transparent.

  • CLIP_CUBE Clip Cube – Clip to cubic-shaped area around the image and set exterior pixels as transparent.

  • REPEAT Repeat – Cause the image to repeat horizontally and vertically.

  • CHECKER Checker – Cause the image to repeat in checker board pattern.

Type:

enum in ['EXTEND', 'CLIP', 'CLIP_CUBE', 'REPEAT', 'CHECKER'], default 'REPEAT'

filter_size

Multiply the filter size used by interpolation

Type:

float in [0.1, 50], default 1.0

image
Type:

Image

image_user

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

Type:

ImageUser, (readonly)

invert_alpha

Invert all the alpha values in the image

Type:

boolean, default False

repeat_x

Repetition multiplier in the X direction

Type:

int in [1, 512], default 1

repeat_y

Repetition multiplier in the Y direction

Type:

int in [1, 512], default 1

use_alpha

Use the alpha channel information in the image

Type:

boolean, default True

use_calculate_alpha

Calculate an alpha channel based on RGB values in the image

Type:

boolean, default False

use_checker_even

Even checker tiles

Type:

boolean, default False

use_checker_odd

Odd checker tiles

Type:

boolean, default True

use_flip_axis

Flip the texture’s X and Y axis

Type:

boolean, default False

use_interpolation

Interpolate pixels using selected filter

Type:

boolean, default True

use_mirror_x

Mirror the image repetition on the X direction

Type:

boolean, default False

use_mirror_y

Mirror the image repetition on the Y direction

Type:

boolean, default False

use_normal_map

Use image RGB values for normal mapping

Type:

boolean, default False

users_material

Materials that use this texture

Type:

tuple of Material

Note

Takes O(len(bpy.data.materials) * len(material.texture_slots)) time.

(readonly)

users_object_modifier

Object modifiers that use this texture

Type:

tuple of Object

Note

Takes O(len(bpy.data.objects) * len(obj.modifiers)) time.

(readonly)

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

id (str) – 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 (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions