Table of Contents

Load Texture Node

  • Category: Data
  • Edition: All editions
  • Output type: Color and four masks
  • Typical place in a graph: at the start of a graph, to bring in a height map, mask or color map made outside Vista

Load Texture brings an image from your project into the graph, stretched over the whole biome. Use it for a height map from another terrain tool or a sculpt, a mask painted in an image editor, a splat map from another pipeline, or a color map. The image comes out whole (RGBA) and as one mask per channel (R, G, B, A).

A height map image loaded as terrain: an island with one main peak

When to use it

  • Start from a height map made elsewhere: World Machine, Gaea, a DEM converted to an image, a sculpt.
  • Use a hand painted mask: where forests go, a road layout, a coastline.
  • Bring in a splat or color map, one channel per mask.
  • Not for: real world data downloaded by Vista (use Load Real World Data); painting masks inside the editor (use Paint Mask).

Outputs

Slot Type What it holds
RGBA Color The whole image, stored at 8 bits per channel.
R, G, B, A Mask One channel each, at full precision. Use R for a grayscale height map.

With no texture set, every output is black.

Properties

Property Default Range What it does
Texture None A texture asset The image to load. It is stretched to cover the whole biome, whatever its own size or shape.

Importing height maps

  • PNG, TGA, EXR and other images: import them as usual. For height maps, turn off sRGB (Color Texture), set Compression to None, and use a 16 bit format (such as R16) for 16 bit images. An 8 bit format turns smooth slopes into steps.
  • RAW files (.raw, .r8, .r16, .r32): Vista imports them as textures. Select the file and set its Width, Height and Bit Depth in the import settings to match how it was exported; the default is 512 × 512, 16 bit. Wrong values give a scrambled image.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Resolution How detailed this node's result is, in texels across the biome. The node has no input, so Relative To Main Input (default) and Relative To Graph both follow the biome's Canvas Resolution, times the multiplier below. Absolute sets an exact size. The image is resampled to that size. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
Split Execution Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off.
Bypass Skips the node. Nothing comes out.

Examples

Both examples load the same 512 × 512 island height map through R into Height Output, on a 1024 × 1024 m biome with the Vista Manager's Max Height at 400 m.

16 bit (R16) Same image as 8 bit (RGB24)
A smooth island mountain The same island covered in fine contour steps
Smooth slopes. 256 levels for 400 m of height leave a step about every 1.6 m, which shows as contour lines all over the slopes.

2D view of the R output: a bright peak fading to black at the coast

Recipes

  • External height map: Load Texture R → Levels to set the height range → erosion → Height Output.
  • Splat map to texture layers: Load Texture R, G, B, A → four Texture Output nodes, through Weight Blend if the channels do not add up to 1.
Warning

Use the R channel, not RGBA, for heights. RGBA is stored at 8 bits per channel, so a height taken from it steps like an 8 bit image even when the file is 16 bit.

Note

The image always covers the whole biome. A square image on a rectangular biome is stretched; crop or resize it to the biome's proportions first.

Performance

Very cheap: one copy per output in use.

For AI agents

  • Type name: LoadTextureNode. Outputs: RGBA = 110 (ColorTexture, ARGB32), R = 100, G = 101, B = 102, A = 103 (Masks, RFloat). No inputs.
  • Property: texture (asset path). Sampled over the biome's full 0 to 1 UV; resolution follows the graph.
  • Measured: the same height map as R16 and RGB24 gives the same range (0 to 0.912) but RGB24 shows visible 1/255 steps in 3D. Note vista_graphitor_display --as height on this node shows the RGBA output; route R through a node (such as Height Output) to view the full precision height.
  • RAW import: RawImporter (.raw, .r8, .r16, .r32) with width, height (1 to 8192) and bitDepth (8, 16, 32) set on the importer.