SurfaceProjection

interface SurfaceProjection

import type { SurfaceProjection } from '@driftengine/core';

In depth

'planar' lays the maps across the two horizontal axes, x and z: ground whose mesh carries flat coordinates, or none worth reading, shows its texture at scale repeats a metre. 'triplanar' reads each map on the three planes across x, y and z and blends them by how squarely the surface faces each, the normal's components raised to sharpness, so walls and rock wear a texture without stretching. See worldUv.ts for the normal map's blend.

What it gives up: the world's coordinates do not move with a mesh, so a moving mesh slides under its texture; triplanar reads every map three times; and the material's uScale, vScale and offsets, which are the mesh's coordinates', do not apply.

Properties