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 | 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 (82)
The following quick index only shows top-level attributes (too many attributes to show them all): blurPixelation, byCycleIncrement, coverage (2), disableFileLoad, doTransform, endCycleExtension, fileHasAlpha, fileTextureName, filterType, filterWidth, forceSwatchGen, frameExtension, frameOffset, hdrExposure, hdrMapping, infoBits, miConvertToOptim, miEllipticalMaxMinor, miOverrideConvertToOptim, miUseEllipticalFilter, 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 | |
|
|
miUseEllipticalFilter
(uef )
| bool | false | |
|
|
miEllipticalMaxMinor
(emm )
| float | 8.0 | |
|
|
miOverrideConvertToOptim
(oco )
| bool | false | |
|
|
miConvertToOptim
(cto )
| bool | false | |
|
|
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 | |
|