Skip to content

TileNormalCustomData

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:31

Shape the LDtk / Tiled loader extracts from per-tile custom data when synthesizing regions. Authors populate these in the map editor’s tile-properties panel.

All fields optional — an untagged tile emits a single flat region for its cell. Cap thickness values are in pixels; legacy *Px aliases are accepted for back-compat and map to the unsuffixed canonical fields.

optional tileBump?: NormalBump

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:39

Bump source override for the face region.


optional tileCap?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:63

Shorthand — when no per-edge field is set, treated as tileCapTop.


optional tileCapBottom?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:57

Cap thickness from the bottom edge in pixels.


optional tileCapBottomLeft?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:75

N×N square flat cap at the bottom-left corner.


optional tileCapBottomPx?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:83


optional tileCapBottomRight?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:77

N×N square flat cap at the bottom-right corner.


optional tileCapLeft?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:59

Cap thickness from the left edge in pixels.


optional tileCapLeftPx?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:85


optional tileCapPx?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:79


optional tileCapRight?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:61

Cap thickness from the right edge in pixels.


optional tileCapRightPx?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:87


optional tileCapTop?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:55

Cap thickness from the top edge in pixels.


optional tileCapTopLeft?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:71

Corner cap — N×N square flat cap at the top-left corner of the cell. Use when the tile art shows a small flat patch at that corner with the wall face wrapping around it in an L-shape (outer walls facing outward). Composes with edge caps — union of all cap rects is cap, complement is face.


optional tileCapTopPx?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:81


optional tileCapTopRight?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:73

N×N square flat cap at the top-right corner.


optional tileDir?: NormalDirection

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:33

Screen-space direction the face tilts. See NormalDirection.


optional tileDirection?: NormalDirection

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:35

Alias of tileDir.


optional tileElevation?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:53

Elevation of the tile’s primary surface in [0, 1] (0 = ground plane, 1 = top-of-wall):

  • Tiles with tileDir (wall faces): applies to the face region. Caps always bake at 1.0 regardless. Default 0.5 (midway up).
  • Flat tiles (no tileDir or tileDir: 'flat'): applies to the whole cell. Use 1.0 for “all-cap” tiles (wall top viewed dead-on, roof patches, pillar caps). Unset → descriptor default, which defaults to 0 (ground plane = floor).

optional tilePitch?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:37

Tilt angle override in radians. Inherits descriptor pitch when absent.


optional tileStrength?: number

Defined in: packages/three-flatland/src/loaders/normalDescriptor.ts:41

Gradient strength override for the face region.