Documentation / Node reference / tex nodes
tex/FileHDR
Loads a Radiance .hdr image as a high dynamic range texture.
Files
Decodes a Radiance (.hdr) file, the format most HDRI libraries publish, into a float texture suitable for image-based lighting. The usual use is an equirectangular environment map: drop this inside a geo/Environment and the whole scene is lit by it, or point a material's envMap at it directly.
Radiance stores each pixel as RGB plus a shared exponent, so values well above 1 survive — that is what makes the bright parts of a sky read as a light source rather than as white. Mips are prefiltered with the GGX filter by default, which is what the roughness response of a material samples; switch to Box for a plain texture that happens to be HDR.
For OpenEXR files use tex/FileEXR instead. Ordinary 8-bit images (JPG, PNG) go through tex/Image.
Parameters
| Name | Type | What it does |
|---|---|---|
| path | AssetPath | Path or URL of the Radiance .hdr file to load. |
| mipmapsFilter | UInt8 Box · EnvironmentGGX | How the mip chain is built. EnvironmentGGX prefilters each level for a roughness value, which is what environment lighting samples; Box is a plain 2x2 average, for an HDR image used as an ordinary texture. |
| reload | Button | Decode the file again, picking up a change made on disk since the last cook. |
See also
- tex/FileEXR
- tex/Image
- geo/Environment
This page is generated from the engine, so it describes the release you can download. The same text is in the editor's Help panel next to the node itself.