# TerrainGroundCover

> Talos next · Since 0.7; changed in next

Grass, flowers and forest-floor cover a terrain grows near the camera in HD, dense where the terrain's channels or layers say and coloured by the ground under it.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `preset` | `string` | no |  |  | A built-in layer set: meadow, forest-floor or meadow-forest (the default when no cover is given). |
| `cover` | `object` | no |  |  | Own layers instead of a preset: a GroundCover document. A layer's source.channel names terrain channels or terrain layers (their blend weight), alternatives separated by \|; the densest of those the terrain has wins (meadow\|grass). |
| `distanceM` | `number` | no |  |  | How far from the camera the cover reaches, metres, 10..400; default 55. |
| `density` | `number` | no |  |  | Scales the blade count, 0..1; default 1. |
| `carpet` | `number` | no |  |  | How much the ground under the cover is darkened toward it, 0..1; default 1. |
| `groundTint` | `number` | no |  |  | 0..1: how far the blades take the colour of the terrain under them; default 0.85. |
| `farCover` | `number` | no |  |  | 0..1: past distanceM, how far the terrain layers the cover grows on take its colour and its canopy's shade (the cover seen from afar, where no blades are drawn), fading in as the blades fade out; default 0 (off: the bare layer). |
| `sets` | `object` | no |  |  | Cover material sets for a preset's layers: layer id -> project-relative set folder (the same as a layer's `material`). |
