Skip to content

TextureMapFile

Map File#

(TextureMapFile)

  • Category: /Texture/Map
  • Default object name: map_file

Go to Technical page.

Description#

Image map texture using an external file.

Attributes#

Name Type Description
Pass Through bool If checked, the current texture is not evaluated and the value of the attribute selected in Pass Through Attribute is directly forwarded.
Master Input string Name of the attribute that will be used as output if Pass Through is enabled.
Invert bool If checked, the texture is inverted.
Opacity double Set the opacity of the texture.
Projection long Define the projection used to evaluate the texture.
Space long Define whether the texture is evaluated in 2D or 3D. In 2D space, the texture is stretched along the projection axis whereas in 3D space all components are used.
Axis long Define the projection axis.
Uv Slot reference (UvSlot) Define which UV slot is used when the project mode is set to UV.
Object Space long Set the space in which the object must be considered when computing the projection.
Reference Positions string Set the name of the property that contains reference positions of the geometry that have to be used when computing projections.
Uv Property string Set the name of the property that contains uv's of the geometry that have to be used when computing projections.
Camera reference (Camera) Define which camera is used when the texture is in Camera projection mode.
Camera Occlusion bool When on the texture looks for potential occluder between the sample position and the camera. If no occluder is found the sample gets mapped.
Camera Occluders reference (Group) Define which geometries are occluders when camera occlusion is enabled. By default it uses the 3D layer geometries.
Reference Object reference (SceneItem) If an object is selected, the texture will use the object's transformation matrix to compute the texture coordinates.
Projection Translate double[3] Offset the position of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
Projection Rotate double[3] Offset the rotation of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
Projection Scale double[3] Offset the scaling of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
Fit To Bounding Box action
Uv Translate double[3] Offset the UV by the specified values in UVW space.
Uv Rotate double[3] Rotate the UV by the specified values in UVW space.
Uv Scale double[3] Scale the UV by the specified values in UVW space.
Use Texture Aspect Ratio bool If checked, the texture aspect ratio will be included in the camera projection computation.
Filename string Set the path to the image file.
Missing File Behavior long Choose the default texture or default color when the file has not been found.
Single Channel File Behavior long Flag used to determine how a single channel file should be interpreted.
U Repeat Mode long Select the repeat mode on U axis.
V Repeat Mode long Select the repeat mode on V axis.
Interpolation Mode long Select the image interpolation mode.
Detect Sequence action
Sequence Mode long Enable / disable the sequence mode.
Start Frame long In custom frame range mode, set the start frame to use.
End Frame long In custom frame range mode, set the end frame to use.
Frame Offset long Offsets the time. If the offset is set to 50 and the sequence starts at 10, then the first image will be used at frame 60.
Frame Rate double Set the frame rate of the sequence.
Missing Frame long Behavior to apply in case an image is missoing. Drop shows nothing, Hold uses the last read image
Pre Behavior long Behavior to apply before the beginning of the sequence. Drop shows nothing, Hold uses the first image, Repeat loops on the sequence.
Post Behavior long Behavior to apply after the end of the sequence. Drop shows nothing, Hold uses the last image, Repeat loops on the sequence.
Use Raw Data bool If checked, raw values of the file will be used. No color space applied.
Color Space Auto Detect bool If checked, auto detect the color space from file.
File Color Space string Defines the color space of the file. Values will be converted to linear color space.
Pre Multiplied bool If NOT checked, pre-multiplies the RGB colors by the alpha channel.
Multiplier Input double[3] Define the input color to multiply.
Multiplier Affect Alpha bool If selected, the alpha channel is affected by the evaluation.
Gamma Color double[3] Define the gamma applied by color channel.
Gamma Alpha double Define the gamma applied to the alpha of the input color.
Mipmap Filtering Mode long Select mipmap filtering mode.
Ewa Anisotropy Factor double Set EWA anisotropy factor. Enable when if EWA selected in mipmap filtering mode.
Mipmap Quality double Influence the mipmap level chosen when rendering. 100% is neutral while 0% asks for lower resolution levels and 200% asks for sharper resolution.
Maximum Mipmap Level double Defines the maximum mipmap resolution used when rendering. 100% will allow the use of the highest resolution levels available while 0% will limit the choice to the lowest resolution.
Display Mipmap Level bool If checked, output the computed mipmap level as a normalized grayscale value.
Output Layer string Set the group of channels to read from the file.
Default Color double[3] Define the default color used if the texture file wasn't found.