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 (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

References