Texture(ID)#

base classes — bpy_struct, ID

subclasses — BlendTexture, CloudsTexture, DistortedNoiseTexture, ImageTexture, MagicTexture, MarbleTexture, MusgraveTexture, NoiseTexture, StucciTexture, VoronoiTexture, WoodTexture

class bpy.types.Texture(ID)#

Texture data-block used by materials, lights, worlds and brushes

animation_data#

Animation data for this data-block

Type:

AnimData, (readonly)

color_ramp#
Type:

ColorRamp, (readonly)

contrast#

Adjust the contrast of the texture

Type:

float in [0, 5], default 1.0

factor_blue#
Type:

float in [0, 2], default 1.0

factor_green#
Type:

float in [0, 2], default 1.0

factor_red#
Type:

float in [0, 2], default 1.0

intensity#

Adjust the brightness of the texture

Type:

float in [0, 2], default 1.0

node_tree#

Node tree for node-based textures

Type:

NodeTree, (readonly)

saturation#

Adjust the saturation of colors in the texture

Type:

float in [0, 2], default 1.0

type#
Type:

enum in Texture Type Items, default ‘IMAGE’

use_clamp#

Set negative texture RGB and intensity values to zero, for some uses like displacement this option can be disabled to get the full range

Type:

boolean, default True

use_color_ramp#

Map the texture intensity to the color ramp. Note that the alpha value is used for image textures, enable “Calculate Alpha” for images without an alpha channel.

Type:

boolean, default False

use_nodes#

Make this a node-based texture

Type:

boolean, default False

use_preview_alpha#

Show Alpha in Preview Render

Type:

boolean, default False

users_material#

Materials that use this texture

(readonly)

users_object_modifier#

Object modifiers that use this texture

(readonly)

evaluate(value)#

Evaluate the texture at the a given coordinate and returns the result

Parameters:

value (mathutils.Vector of 3 items in [-inf, inf]) – The coordinates (x,y,z) of the texture, in case of a 3D texture, the z value is the slice of the texture that is evaluated. For 2D textures such as images, the z value is ignored.

Returns:

The result of the texture where (x,y,z,w) are (red, green, blue, intensity). For grayscale textures, often intensity only will be used.

Return type:

mathutils.Vector of 4 items in [-inf, inf]

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

Inherited Properties#

Inherited Functions#

References#