PQS Main – Extras

Shader: Terrain/PQS/PQS Main - Extras  ·  materialType = Extra

The PQS Material { } drives the shader that paints a body's near-surface terrain — the real, subdivided quad-sphere you see from low orbit down to the ground. This is the counterpart to the ScaledVersion materials, which paint only the distant low-LOD sphere; the PQS material takes over as the camera descends and the two are cross-faded across the fadeStart / fadeEnd altitudes. Terrain/PQS/PQS Main - Extras is the fully-featured member of the "PQS Main" family.

Like the rest of the family it builds the surface procedurally and world-space triplanar — projecting tiling textures down the three world axes and blending them by the surface normal, so there are no UV seams. It blends three textures by elevation, layers a separate texture on steep slopes, crossfades between a fine and a coarse tiling by camera distance, and (on bodies with an atmosphere) folds in aerial-perspective haze and underwater fog.

Extra is, in effect, the full Main shader — every elevation band carries its own normal map with independent near/far tiling — with one addition: it exposes oceanFogDistance, so you can tune how quickly the surface fades into the underwater fog colour. It is one of the pre-1.8 terrain shaders. If you do not need the ocean-fog control, Main is identical in every other respect; for a lighter normal-map budget, see Optimized.

We shall first see how to enable the material, then how the shader assembles the surface, and finally discuss each group of properties in turn.

Enabling

Select the material by setting materialType = Extra in the PQS { } node. The Material { } node then accepts the properties listed below.

PQS
{
    materialType = Extra
    Material
    {
        // Colour grading of the per-vertex colour map
        saturation = 1
        contrast   = 1
        tintColor  = 1, 1, 1, 0

        // How strongly the textures show, and the near/far crossfade distance
        powerNear      = 0.5
        powerFar       = 0.5
        groundTexStart = 2000
        groundTexEnd   = 10000

        // Low elevation band
        lowTex          = MyMod/PluginData/sand_color.dds
        lowBumpMap      = MyMod/PluginData/sand_normal.dds
        lowNearTiling   = 1000
        lowMultiFactor  = 10

        // Mid elevation band
        midTex          = MyMod/PluginData/rock_color.dds
        midBumpMap      = MyMod/PluginData/rock_normal.dds
        midNearTiling   = 1000
        midMultiFactor  = 10

        // High elevation band
        highTex         = MyMod/PluginData/snow_color.dds
        highBumpMap     = MyMod/PluginData/snow_normal.dds
        highNearTiling  = 1000
        highMultiFactor = 10

        // Where each band fades to the next (on normalised vertex elevation)
        lowStart  = 0
        lowEnd    = 0.3
        highStart = 0.8
        highEnd   = 1

        // Steep-slope overlay
        steepTex      = MyMod/PluginData/cliff_color.dds
        steepBumpMap  = MyMod/PluginData/cliff_normal.dds
        steepPower    = 1

        // Atmospheric haze and underwater fog (only on bodies with an atmosphere)
        globalDensity    = 1
        fogColorRamp     = MyMod/PluginData/fog_ramp.dds
        oceanFogDistance = 1000
    }
}

How the surface is built

The shader is a triplanar terrain surface assembled per pixel. There is no single colour map; instead a base colour, three elevation textures, a steep overlay, and fog are combined in the following order:

1. Per-vertex colour grading — the PQS supplies a colour per vertex (COLOR.rgb, usually from a colour map or LandControl). The shader desaturates that colour toward its luma by saturation, mixes in tintColor (whose alpha is the mix amount), and scales it by contrast. The result is the base colour that the band textures then tint.
2. Three elevation bands — lowTex, midTex and highTex are blended by the vertex's normalised elevation (written into COLOR.w by the PQS height build). lowStart/lowEnd set the elevation window where the low band fades up into the mid band, and highStart/highEnd the window where the mid band fades into the high band — so low covers the bottom of the height range, mid the middle, high the top.
3. Near/far tiling crossfade — each band is sampled at two tiling scales and crossfaded by camera distance: a fine near tiling (*NearTiling) for close-up detail and a coarse far tiling (*MultiFactor) for the distance, blended between the groundTexStart and groundTexEnd view distances. powerNear and powerFar set how strongly the near and far textures show. Because the triplanar coordinates are world position scaled by 10⁻⁵, the tiling numbers are large (the defaults are 1000 near, 10 far).
4. Texture vs. flat colour — the blended band texture does not replace the base colour, it modulates it: the final albedo is lerp(baseColour, baseColour × bandTexture, texMix), where texMix is driven by powerNear/powerFar and the near/far mix. Where it falls to zero — far away, or with both powers at 0 — you see the flat graded colour map; where it is high you see fully textured terrain.
5. Steep-slope overlay — steepTex and steepBumpMap are blended over the result on steep terrain. The per-vertex steepness is multiplied by steepPower and clamped, so higher steepPower makes the cliff texture reach onto gentler slopes. The overlay has its own distance fade between steepTexStart and steepTexEnd, and its own steepNearTiling / steepTiling.
6. Normal mapping — each band and the steep overlay carry a matching DXT5nm normal map, accumulated at the same band/near/far weights and transformed into world space through the mesh's tangent frame. The surface is then lit with a plain diffuse (Lambert) term plus spherical-harmonic ambient — there is no specular highlight.
7. Aerial-perspective & ocean fog — on a body with an atmosphere, a distance haze is mixed in last. Its colour is read from fogColorRamp indexed by the sun angle, and its strength grows with distance and globalDensity. A second, underwater ocean fog term reads the same ramp at a different row and fades over the oceanFogDistance — the control this variant adds over the plain Main shader. On an airless body the whole fog stage is compiled out and these properties do nothing.

The triplanar projection means the band textures need no UV mapping on the mesh, but the normal mapping still needs mesh tangents, which the PQS quad-sphere provides. Because the colour, elevation and slope all come from the PQS build, the final look depends as much on your PQSMods (height, colour, LandControl) as on the textures set here.

Properties

The properties fall into five groups, which we shall take in turn:

1. Colour grading — how the per-vertex colour map is processed before texturing.
2. Texture blend & distance — the near/far strengths and the crossfade distances.
3. Elevation bands — the three height textures, their normal maps, tiling and transition windows.
4. Steep-slope overlay — the cliff texture for steep terrain.
5. Fog & opacity — the atmospheric haze ramp, ocean-fog distance and the PQS fade scalar.

Colour grading

Property	Format	Description
saturation	Decimal	Saturation of the per-vertex colour map: 0 collapses it to greyscale (luma), 1 leaves it unchanged, higher oversaturates. Default 1.
contrast	Decimal	Contrast multiplier applied to the graded colour. Default 1.
tintColor	Color	A tint mixed into the base colour; the alpha is the mix amount (0 = no tint). Default (1, 1, 1, 0) — i.e. no tint.

Texture blend & distance

Property	Format	Description
powerNear	Decimal	Strength of the fine near texture tier. Drops the textures out toward the flat colour map as it approaches 0. Default 0.5.
powerFar	Decimal	Strength of the coarse far texture tier. Default 0.5.
groundTexStart	Decimal	View distance (m) at which the near→far tiling crossfade begins. Default 2000.
groundTexEnd	Decimal	View distance (m) at which only the far tiling remains. Default 10000.

Elevation bands

Each band has an albedo texture, a normal map, and near/far tiling for both. The band weights come from the vertex elevation and the four transition values at the end of the table.

Property	Format	Description
lowTex	File Path	Albedo for the low elevation band. Triplanar, world-tiled. Default "white".
lowTexScale / lowTexOffset	Vector2	Tiling and offset of lowTex.
lowBumpMap	File Path	DXT5nm normal map for the low band. Default "bump" (flat).
lowBumpMapScale / lowBumpMapOffset	Vector2	Tiling and offset of lowBumpMap.
lowNearTiling	Decimal	World tiling of the low albedo at the near tier. Default 1000.
lowMultiFactor	Decimal	World tiling of the low albedo at the far tier. Default 10.
lowBumpNearTiling	Decimal	World tiling of the low normal map at the near tier. Default 1.
lowBumpFarTiling	Decimal	World tiling of the low normal map at the far tier. Default 1.
midTex	File Path	Albedo for the mid elevation band. Default "white".
midTexScale / midTexOffset	Vector2	Tiling and offset of midTex.
midBumpMap	File Path	DXT5nm normal map for the mid band. Default "bump".
midBumpMapScale / midBumpMapOffset	Vector2	Tiling and offset of midBumpMap.
midNearTiling	Decimal	World tiling of the mid albedo at the near tier. Default 1000.
midMultiFactor	Decimal	World tiling of the mid albedo at the far tier. Default 10.
midBumpNearTiling	Decimal	World tiling of the mid normal map at the near tier. Default 1.
midBumpFarTiling	Decimal	World tiling of the mid normal map at the far tier. Default 1.
highTex	File Path	Albedo for the high elevation band. Default "white".
highTexScale / highTexOffset	Vector2	Tiling and offset of highTex.
highBumpMap	File Path	DXT5nm normal map for the high band. Default "bump".
highBumpMapScale / highBumpMapOffset	Vector2	Tiling and offset of highBumpMap.
highNearTiling	Decimal	World tiling of the high albedo at the near tier. Default 1000.
highMultiFactor	Decimal	World tiling of the high albedo at the far tier. Default 10.
highBumpNearTiling	Decimal	World tiling of the high normal map at the near tier. Default 1.
highBumpFarTiling	Decimal	World tiling of the high normal map at the far tier. Default 1.
lowStart	Decimal	Elevation (normalised 0–1) at which the low band begins fading into the mid band. Default 0.
lowEnd	Decimal	Elevation at which the low band has fully given way to the mid band. Default 0.3.
highStart	Decimal	Elevation at which the mid band begins fading into the high band. Default 0.8.
highEnd	Decimal	Elevation at which the high band fully takes over. Default 1.

Steep-slope overlay

Property	Format	Description
steepTex	File Path	Albedo blended over steep slopes (cliffs). Default "white".
steepTexScale / steepTexOffset	Vector2	Tiling and offset of steepTex.
steepBumpMap	File Path	DXT5nm normal map for the steep overlay. Default "bump".
steepBumpMapScale / steepBumpMapOffset	Vector2	Tiling and offset of steepBumpMap.
steepPower	Decimal	Multiplier on the vertex steepness before it is clamped to the overlay weight. Higher values push the steep texture onto gentler slopes; 0 disables it. Default 1.
steepTexStart	Decimal	View distance (m) at which the steep overlay's near→far tiling fade begins. Default 20000.
steepTexEnd	Decimal	View distance (m) at which the steep overlay reaches its far tiling. Default 30000.
steepNearTiling	Decimal	World tiling of the steep overlay at the near tier. Default 1.
steepTiling	Decimal	World tiling of the steep overlay at the far tier. Default 1.

Fog & opacity

Property	Format	Description
globalDensity	Decimal	Density multiplier for the aerial-perspective haze. Only has an effect on bodies with an atmosphere; higher values thicken the distance fog. Default 1.
fogColorRamp	File Path	1-D colour ramp for the fog. The aerial haze is read from it indexed by the sun angle (so the fog can be tinted differently toward and away from the sun); a second row supplies the underwater ocean-fog colour. Default "white".
fogColorRampScale / fogColorRampOffset	Vector2	Tiling and offset of the fog ramp.
FogColorRamp	Gradient	The fogColorRamp, defined inline as a gradient instead of as a texture.
oceanFogDistance	Decimal	Falloff distance (m) of the underwater ocean fog — the distance over which the surface fades into the ocean-fog colour when seen from below the waterline. Default 1000.
planetOpacity	Decimal	Opacity of the PQS material, used by KSP to fade the terrain against the scaled-space sphere across the fadeStart/fadeEnd transition. Normally left at 1. Default 1.

Notes

• These are the body's near-surface terrain materials. The body simultaneously has a ScaledVersion material for the distant sphere; KSP cross-fades between the two across the fadeStart / fadeEnd altitudes, so the two should be tuned to match where they meet.
• Extra differs from the plain Main shader only by exposing oceanFogDistance; everything else — the three normal-mapped bands, the near/far tiling, the steep overlay — is the same.
• The textures are world-space triplanar, so they need no UVs and the tiling values are in world units scaled by 10⁻⁵ (hence the large defaults). The shader still requires mesh tangents for its normal mapping, which the PQS quad-sphere provides.
• The band colour, the per-vertex elevation that drives the band blend, and the slope that drives the steep overlay all come from the PQS build — your height, colour and LandControl mods shape the input this shader paints.
• The fog stage (globalDensity, fogColorRamp, oceanFogDistance) is only compiled in for bodies with an atmosphere; on an airless body it is removed entirely and those properties have no effect.
• Several shader inputs are driven by KSP at runtime and are not config properties: a floating-origin offset that keeps the world-space triplanar coordinates stable as the game shifts the origin around the craft, and the sun direction, camera altitude and viewer air density used by the fog.
• The surface is lit with a diffuse (Lambert) term only — there is no specular response on this shader.
• materialType = Extra is also accepted under its older alias AtmosphericExtra, which you may see in existing configs; the two select the same shader.