Go to: Related nodes. Attributes.
File textures allow you to use any image file as a texture
map. The image file can be any of the image file types supported by
Maya.
File Texture can also use a numbered sequence of images, allowing
you to use an animation as a texture map. To do this:
- Set File Texture Name to the name of one of the first image in
the sequence, e.g. "myfile.1.iff"
- Turn on the Use Frame Extension attribute to start using an
image sequence.
- Go to the first frame in your animation where you want the
texture to show, set the Frame Extension attribute to the number of
the image file you want used at that frame, and keyframe it.
- Go to the last frame in your animation where you want the
texture to show, set the Frame Extension attribute to the number of
the image file you want used at that frame, and keyframe it.
Some tips for using File Textures:
- Square images usually give the best image quality.
- Use IFF or SGI format images for optimum performance.
Aside from the attribute described here, File Texture inherits many
other attributes from its parent, Texture
2d. In the table below, important attributes have their names
listed in bold in the description column.
This node is MP safe
Node name |
Parents |
Classification |
MFn type |
Compatible function sets |
file |
texture2d |
texture/2d:drawdb/shader/texture/2d/file |
kFileTexture |
kBase
kNamedObject
kDependencyNode
kTexture2d
kFileTexture |
Related nodes
layeredTexture, envCube, envSphere,
envSky, envBall, envChrome,
bump3d, uvChooser, bump2d,
texture2d, ramp, cloth, water, stencil,
checker, fractal, bulge,
grid, mountain,
texture3d, projection, cloud,
granite, crater, leather,
stucco, brownian, solidFractal, marble, wood, rock, snow, defaultTextureList, place2dTexture, place3dTexture
Attributes (79)
The following quick index only shows top-level attributes
(too many attributes to show them all): blurPixelation, byCycleIncrement, colorProfile, coverage (2), disableFileLoad, doTransform, endCycleExtension, fileHasAlpha, fileTextureName, filterType, filterWidth, forceSwatchGen, frameExtension, frameOffset, hdrExposure, hdrMapping, infoBits, mirrorU,
mirrorV, noiseUV (2), objectType, offset
(2), outSize (2), outTransparency (3), pixelCenter (2), preFilter, preFilterRadius, primitiveId, rayDepth, repeatUV
(2), rotateFrame, rotateUV, stagger,
startCycleExtension,
translateFrame (2), useCache, useFrameExtension, useHardwareTextureCycling,
useMaximumRes, vertexCameraOne (3), vertexCameraThree (3), vertexCameraTwo (3), vertexUvOne (2), vertexUvThree (2), vertexUvTwo (2), wrapU, wrapV
Long name (short name) |
Type |
Default |
Flags |
|
fileTextureName
(ftn ) |
string |
NULL |
|
|
disableFileLoad
(dfl ) |
bool |
false |
|
|
useFrameExtension
(ufe ) |
bool |
false |
|
|
frameExtension
(fe ) |
integer |
1 |
|
|
frameOffset
(io ) |
integer |
0 |
|
|
useHardwareTextureCycling
(uhc ) |
bool |
false |
|
|
startCycleExtension
(sce ) |
integer |
1 |
|
|
endCycleExtension
(ece ) |
integer |
1 |
|
|
byCycleIncrement
(bci ) |
integer |
1 |
|
|
forceSwatchGen
(fsg ) |
bool |
false |
|
|
filterType
(ft ) |
enum |
QUADRATIC_FILTER |
|
|
filterWidth
(fw ) |
float |
0.707 |
|
|
preFilter
(pf ) |
bool |
false |
|
|
preFilterRadius
(pfr ) |
float |
2.0f |
|
|
useCache
(uca ) |
bool |
false |
|
|
useMaximumRes
(umr ) |
bool |
false |
|
|
coverage
(c ) |
float2 |
1.0, 1.0 |
|
|
|
|
translateFrame
(tf ) |
float2 |
0.0, 0.0 |
|
|
translateFrameU
(tfu ) |
float |
0.0 |
|
|
|
translateFrameV
(tfv ) |
float |
0.0 |
|
|
|
rotateFrame
(rf ) |
angle (double) |
0.0deg |
|
|
doTransform
(dtf ) |
bool |
true |
|
|
mirrorU
(mu ) |
bool |
false |
|
|
mirrorV
(mv ) |
bool |
false |
|
|
stagger
(s ) |
bool |
false |
|
|
wrapU
(wu ) |
bool |
true |
|
|
wrapV
(wv ) |
bool |
true |
|
|
repeatUV
(re ) |
float2 |
1.0, 1.0 |
|
|
|
|
offset
(of ) |
float2 |
0.0, 0.0 |
|
|
|
|
rotateUV
(ro ) |
angle (double) |
0.0deg |
|
|
noiseUV
(n ) |
float2 |
0.0, 0.0 |
|
|
|
|
blurPixelation
(blp ) |
bool |
true |
|
|
vertexCameraOne
(vc1 ) |
float3 |
|
|
|
vertexCameraOneX
(c1x ) |
float |
0.0 |
|
|
|
vertexCameraOneY
(c1y ) |
float |
0.0 |
|
|
|
vertexCameraOneZ
(c1z ) |
float |
0.0 |
|
|
|
vertexCameraTwo
(vc2 ) |
float3 |
|
|
|
vertexCameraTwoX
(c2x ) |
float |
0.0 |
|
|
|
vertexCameraTwoY
(c2y ) |
float |
0.0 |
|
|
|
vertexCameraTwoZ
(c2z ) |
float |
0.0 |
|
|
|
vertexCameraThree
(vc3 ) |
float3 |
|
|
|
vertexCameraThreeX
(c3x ) |
float |
0.0 |
|
|
|
vertexCameraThreeY
(c3y ) |
float |
0.0 |
|
|
|
vertexCameraThreeZ
(c3z ) |
float |
0.0 |
|
|
|
vertexUvOne
(vt1 ) |
float2 |
|
|
|
vertexUvOneU
(t1u ) |
float |
0.0 |
|
|
|
vertexUvOneV
(t1v ) |
float |
0.0 |
|
|
|
vertexUvTwo
(vt2 ) |
float2 |
|
|
|
vertexUvTwoU
(t2u ) |
float |
0.0 |
|
|
|
vertexUvTwoV
(t2v ) |
float |
0.0 |
|
|
|
vertexUvThree
(vt3 ) |
float2 |
|
|
|
vertexUvThreeU
(t3u ) |
float |
0.0 |
|
|
|
vertexUvThreeV
(t3v ) |
float |
0.0 |
|
|
|
objectType
(otp ) |
char |
'\0' |
|
|
rayDepth
(rdp ) |
integer |
0 |
|
|
primitiveId
(pi ) |
integer |
0 |
|
|
pixelCenter
(pct ) |
float2 |
|
|
|
pixelCenterX
(pcx ) |
float |
0.0 |
|
|
|
pixelCenterY
(pcy ) |
float |
0.0 |
|
|
|
hdrMapping
(hm ) |
enum |
HDR_LINEAR_MAPPING |
|
|
hdrExposure
(he ) |
float |
0.0 |
|
|
outSize
(os ) |
float2 |
|
|
|
outSizeX
(osx ) |
float |
0.0 |
|
|
|
outSizeY
(osy ) |
float |
0.0 |
|
|
|
fileHasAlpha
(fha ) |
bool |
false |
|
|
outTransparency
(ot ) |
float3 |
0.0, 0.0, 0.0 |
|
|
outTransparencyR
(otr ) |
float |
0.0 |
|
|
|
outTransparencyG
(otg ) |
float |
0.0 |
|
|
|
outTransparencyB
(otb ) |
float |
0.0 |
|
|
|
infoBits
(ib ) |
integer |
0 |
|
|
colorProfile
(cp ) |
integer |
0 |
|