Automatically find textures
Match local Base Color, Normal, Roughness, and other material images by filename when opening a model in Tridi Viewer.
Applies to Tridi Viewer 1.1.3 public beta. Release notes
Auto find texture searches for conventionally named image files when a model opens, then applies the best matches to its materials for the current Tridi Viewer session.
Enable automatic matching
- Open Preferences > Import > Global.
- Enable Materials and Textures.
- Expand Auto find texture and enable its checkbox.
- Open or reload the model. Preference changes do not alter a model that is already displayed.
Auto find texture is enabled by default. It scans the model's folder and its subfolders for PNG, JPEG, BMP, and TIFF files. The original model and image files are not modified.
Name texture files for matching
Each filename stem must contain the material name and a recognized map tag. Matching is case-insensitive, and punctuation such as spaces, underscores, and hyphens separates words. For a material named Wood, example stems include wood_basecolor, wood_normal, and wood_roughness.
Tridi matches the complete material identity before interpreting map tags. For example, the word metal inside a material named Metal Chair is not treated as a Metallic tag. A Blender-style numeric suffix such as Wood.001 is matched using Wood.
Default filename tags
The fields in Preferences > Import > Auto find texture are editable. Separate tags with spaces; changes apply on the next load or reload.
| Material map | Default tags | Example for material Wood |
|---|---|---|
| Base Color | basecolor, base_color, base-color, albedo, diffuse, diff, a | wood_basecolor |
| Ambient Occlusion | ambientocclusion, ambient_occlusion, ambient-occlusion, occlusion, ao | wood_ao |
| Metallic | metallic, metalness, metal, m | wood_metallic |
| Roughness | roughness, rough, r | wood_roughness |
| Normal | normal, normalmap, normal_map, normal-map, nrm, nor, n | wood_normal |
| Emissive | emissive, emission, emit, e | wood_emissive |
| Opacity | opacity, alpha, transparency, transparent, opac, o | wood_opacity |
| Height Bump | height, heightmap, height_map, height-map, bump, bumpmap, bump_map, bump-map, hgt, h, b | wood_height |
How Tridi chooses a match
- A filename that starts with the material name ranks above a match later in the filename, and unrelated extra words reduce the match priority.
- For otherwise equal names, Tridi prefers PNG, then TIFF, BMP, and JPEG.
- Tridi samples likely scalar maps and normal maps to favor plausible image content when filenames are equally suitable.
- A Normal-tagged image that is at least 98% grayscale in the sample is treated as Height Bump. A colored tangent-space normal remains Normal, so both maps can be used together.
- An Opacity match is combined with a matching Base Color image. If no Base Color match exists, Opacity is assigned independently.
Understand the limits
Automatic matching uses filenames and sampled image content; it does not read a separate naming manifest. A selected match can replace the material map shown in Tridi Viewer for that load, including an existing imported map. Disable Auto find texture and reload if the source material should remain authoritative.
Height Bump affects surface shading and does not displace geometry. Opacity may change the effective alpha rendering mode according to the matched image. Use the Material panel and render passes to verify the result.