Module Texture :: Class Texture

Class Texture

The Texture object

This object gives access to Texture-specific data in Blender.

Note that many of the attributes of this object are only relevant for specific texture types.

Method Summary
string.	`getExtend()` Get the extend mode of the texture.
Blender Image	`getImage()` Get the Image associated with this texture (or None).
string	`getName()` Get the name of this Texture object.
string	`getType()` Get this Texture's type.
	`setExtend(extendmode)` Set the extend mode of this texture (only used for IMAGE textures)
	`setFlags(f1, f2, f3, f4)` Set this object's flags.
	`setImage(image)` Set the Image of this texture.
	`setImageFlags(f1, f2, f3, etc)` Set the Image flags (only makes sense for IMAGE textures).
	`setName(name)` Set the name of this Texture object.
	`setSType(stype)` Set the SType.
	`setType(type)` Set this Texture's type.

Instance Variable Summary
int	`animFrames`: Number of frames of a movie to use.
int	`animLength`: Number of frames of a movie to use (0 for all).
tuple of 4 (int,int)	`animMontage`: Montage mode, start frames and durations.
int	`animOffset`: Offsets the number of the first movie frame to use.
int	`animStart`: Starting frame of the movie to use.
int	`anti`: Image anti-aliasing enabled.
float	`brightness`: Changes the brightness of a texture's color.
int	`calcAlpha`: Calculation of image's alpha channel enabled.
float	`contrast`: Changes the contrast of a texture's color.
tuple of 4 ints	`crop`: Sets the cropping extents (for image textures).
int	`cyclic`: Looping of animated frames enabled.
float	`distAmnt`: Amount of distortion (for distorted noise textures).
int	`distMetric`: The distance metric (for Voronoi textures).
float	`exp`: Minkovsky exponent (for Minkovsky Voronoi textures).
int	`extend`: Texture's 'Extend' mode (for image textures).
int	`fields`: Use of image's fields enabled.
int	`fieldsPerImage`: Number of fields per rendered frame.
float	`filterSize`: The filter size (for image and envmap textures).
int	`flags`: Texture's 'Flag' bitfield.
float	`hFracDim`: Highest fractional dimension (for Musgrave textures).
Blender Image (or None)	`image`: Texture's image object.
int	`imageFlags`: Texture's 'ImageFlags' bits.
int	`interpol`: Interpolate image's pixels to fit texture mapping enabled.
Blender Ipo	`ipo`: Texture Ipo data.
float	`iScale`: Intensity output scale (for Musgrave and Voronoi textures).
float	`lacunarity`: Gap between succesive frequencies (for Musgrave textures).
int	`mipmap`: Mipmaps enabled.
int	`movie`: Movie frames as images enabled.
string	`name`: Texture data name.
int	`noiseBasis`: Noise basis type (wood, stucci, marble, clouds, Musgrave, distorted).
int	`noiseBasis2`: Additional noise basis type (wood, marble, distorted noise).
int	`noiseDepth`: Noise depth (magic, marble, clouds).
float	`noiseSize`: Noise size (wood, stucci, marble, clouds, Musgrave, distorted noise).
string	`noiseType`: Noise type (for wood, stucci, marble, clouds textures).
int	`normalMap`: Use of image RGB values for normal mapping enabled.
float	`octs`: Number of frequencies (for Musgrave textures).
tuple of 2 ints	`repeat`: Repetition multiplier (for image textures).
tuple of 3 floats	`rgbCol`: RGB color tuple.
int	`rot90`: X/Y flip for rendering enabled.
int	`saw`: Produce bands using saw wave (marble, wood textures).
int	`sine`: Produce bands using sine wave (marble, wood textures).
int	`stField`: Standard field deinterlacing enabled.
int	`stype`: Texture's 'SType' mode.
int	`tri`: Produce bands using triangle wave (marble, wood textures).
float	`turbulence`: Turbulence (for magic, wood, stucci, marble textures).
int	`type`: Texture's 'Type' mode.
int	`useAlpha`: Use of image's alpha channel enabled.
int	`users`: Number of texture users.
float	`weight1`: Weight 1 (for Voronoi textures).
float	`weight2`: Weight 2 (for Voronoi textures).
float	`weight3`: Weight 3 (for Voronoi textures).
float	`weight4`: Weight 4 (for Voronoi textures).

Method Details

getExtend()

Get the extend mode of the texture. See setExtend.

Returns:: string.

getImage()

Get the Image associated with this texture (or None).

Returns:: Blender Image

getName()

Get the name of this Texture object.

Returns:: string

getType()

Get this Texture's type. See setType.

Returns:: string

setExtend(extendmode)

Set the extend mode of this texture (only used for IMAGE textures)

Parameters:: extendmode - The new extend mode. One of: 'Extend', 'Clip', 'ClipCube' and 'Repeat'
(type=string)

setFlags(f1=None, f2=None, f3=None, f4=None)

Set this object's flags.

Parameters:: f1, f2, f3, f4 - Flags to be set (omitted flags are cleared). Can be any of 'FlipBlendXY', 'NegAlpha', 'CheckerOdd', and 'CheckerEven'
           (type of f1=string)
           (type of f2=string)
           (type of f3=string)
           (type of f4=string)

setImage(image)

Set the Image of this texture.

Parameters:: image - The new Image.
(type=Blender Image)

Warning: This sets the texture's type to 'Image' if it is not already.

setImageFlags(f1=None, f2=None, f3=None, etc=None)

Set the Image flags (only makes sense for IMAGE textures). Omitted flags are cleared.

Parameters:: f1, f2, f3, etc - Flag to set. See ImageFlags for their meanings. Can be any of: 'InterPol', 'UseAlpha', 'MipMap', 'Fields', 'Rot90', 'CalcAlpha', 'Cyclic', 'Movie', 'StField', 'Anti' and 'NormalMap'
           (type of f1=string)
           (type of f2=string)
           (type of f3=string)
           (type of etc=string)

setName(name)

Set the name of this Texture object.

Parameters:: name - The new name.
(type=string)

setSType(stype)

Set the SType.

Parameters:: stype - The new stype. This can be any of the values listed in STypes or 'Default' which sets the stype to the default value.
(type=string)

Note: the set of valid parameters is dependent on the current texture type. Be sure to always set the texture type before setting the texture's stype; otherwise an exception might occur.

setType(type)

Set this Texture's type.

Parameters:: type - The new type. Possible options are: 'None', 'Clouds', 'Wood', 'Marble', 'Magic', 'Blend', 'Stucci', 'Noise', 'Image', 'Plugin', 'EnvMap', 'Musgrave', 'Voronoi' and 'DistNoise'
(type=string)

Instance Variable Details

animFrames

Number of frames of a movie to use. Value is clamped to the range [0,30000].

Type:: int

animLength

Number of frames of a movie to use (0 for all). Value is clamped to the range [0,9000].

Type:: int

animMontage

Montage mode, start frames and durations. Example:

( 
(fra1,dur1), (fra2,dur2), (fra3,dur3), (fra4,dur4) )

Type:: tuple of 4 (int,int)

animOffset

Offsets the number of the first movie frame to use. Value is clamped to the range [-9000,9000].

Type:: int

animStart

Starting frame of the movie to use. Value is clamped to the range [1,9000].

Type:: int

anti

Image anti-aliasing enabled. Also see ImageFlags.

Type:: int

brightness

Changes the brightness of a texture's color. Value is clamped to the range [0.0,2.0].

Type:: float

calcAlpha

Calculation of image's alpha channel enabled. Also see ImageFlags.

Type:: int

contrast

Changes the contrast of a texture's color. Value is clamped to the range [0.01,5.0].

Type:: float

crop

Sets the cropping extents (for image textures).

Type:: tuple of 4 ints

cyclic

Looping of animated frames enabled. Also see ImageFlags.

Type:: int

distAmnt

Amount of distortion (for distorted noise textures). Value is clamped to the range [0.0,10.0].

Type:: float

distMetric

The distance metric (for Voronoi textures).

Type:: int

exp

Minkovsky exponent (for Minkovsky Voronoi textures). Value is clamped to the range [0.01,10.0].

Type:: float

extend

Texture's 'Extend' mode (for image textures). See ExtendModes.

Type:: int

fields

Use of image's fields enabled. Also see ImageFlags.

Type:: int

fieldsPerImage

Number of fields per rendered frame. Value is clamped to the range [1,200].

Type:: int

filterSize

The filter size (for image and envmap textures). Value is clamped to the range [0.1,25.0].

Type:: float

flags

Texture's 'Flag' bitfield. See Flags. bitmask.

Type:: int

hFracDim

Highest fractional dimension (for Musgrave textures). Value is clamped to the range [0.0001,2.0].

Type:: float

image

Texture's image object.

Type:: Blender Image (or None)

imageFlags

Texture's 'ImageFlags' bits.

Type:: int

interpol

Interpolate image's pixels to fit texture mapping enabled. Also see ImageFlags.

Type:: int

ipo

Texture Ipo data. Contains the Ipo if one is assigned to the object, None otherwise. Setting to None clears the current Ipo..

Type:: Blender Ipo

iScale

Intensity output scale (for Musgrave and Voronoi textures). Value is clamped to the range [0.0,10.0].

Type:: float

lacunarity

Gap between succesive frequencies (for Musgrave textures). Value is clamped to the range [0.0,6.0].

Type:: float

mipmap

Mipmaps enabled. Also see ImageFlags.

Type:: int

movie

Movie frames as images enabled. Also see ImageFlags.

Type:: int

name

Texture data name.

Type:: string

noiseBasis

Noise basis type (wood, stucci, marble, clouds, Musgrave, distorted). See Noise dictionary.

Type:: int

noiseBasis2

Additional noise basis type (wood, marble, distorted noise). See Noise dictionary.

Type:: int

noiseDepth

Noise depth (magic, marble, clouds). Value is clamped to the range [0,6].

Type:: int

noiseSize

Noise size (wood, stucci, marble, clouds, Musgrave, distorted noise). Value is clamped to the range [0.0001,2.0].

Type:: float

noiseType

Noise type (for wood, stucci, marble, clouds textures). Valid values are 'hard' or 'soft'.

Type:: string

normalMap

Use of image RGB values for normal mapping enabled. Also see ImageFlags.

Type:: int

octs

Number of frequencies (for Musgrave textures). Value is clamped to the range [0.0,8.0].

Type:: float

repeat

Repetition multiplier (for image textures).

Type:: tuple of 2 ints

rgbCol

RGB color tuple.

Type:: tuple of 3 floats

rot90

X/Y flip for rendering enabled. Also see ImageFlags.

Type:: int

saw

Produce bands using saw wave (marble, wood textures). Also see Noise.

Type:: int

sine

Produce bands using sine wave (marble, wood textures). Also see Noise.

Type:: int

stField

Standard field deinterlacing enabled. Also see ImageFlags.

Type:: int

stype

Texture's 'SType' mode. See STypes.

Type:: int

tri

Produce bands using triangle wave (marble, wood textures). Also see Noise.

Type:: int

turbulence

Turbulence (for magic, wood, stucci, marble textures). Value is clamped to the range [0.0,200.0].

Type:: float

type

Texture's 'Type' mode. See Types. Value must be in the range [0,13].

Type:: int

useAlpha

Use of image's alpha channel enabled. Also see ImageFlags.

Type:: int

users

Number of texture users. Read-only.

Type:: int

weight1

Weight 1 (for Voronoi textures). Value is clamped to the range [-2.0,2.0].

Type:: float

weight2

Weight 2 (for Voronoi textures). Value is clamped to the range [-2.0,2.0].

Type:: float

weight3

Weight 3 (for Voronoi textures). Value is clamped to the range [-2.0,2.0].

Type:: float

weight4

Weight 4 (for Voronoi textures). Value is clamped to the range [-2.0,2.0].

Type:: float

Generated by Epydoc 2.1 on Thu Dec 22 22:38:12 2005

http://epydoc.sf.net