Module Texture :: Class Texture
[frames | no frames]

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).
IDGroup properties: Returns an IDGroup reference to this texture's ID Properties.
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

properties

Returns an IDGroup reference to this texture's ID Properties.
Type:
IDGroup

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 Sun Feb 11 13:30:20 2007 http://epydoc.sf.net