TINMAN 3D / REALTIME TERRAIN
Software Development Kit - User Manual

struct Tinman.Pyramid.Info

Short Name:
  • struct Pyramid.Info
Fields:

Provides detail information about a heightmap.

Fields

The following table lists all fields of this config type.

Field Type Constraint Default
required levels number    

The number of pyramid levels.

required tile number    

The size of a single map tile, in pixels.

required size number    

The size of the bottom-most pyramid level.

optional georef Tinman.Georef  
null

The georeference of the pyramid.

optional flags Pyramid.Flags[]  
[]

Additional behaviour flags of the pyramid.

optional pad number  
0

The pad width of this pyramid.

Tile padding is used to avoid color bleeding that will occur when texture samples are filtered at the edge of a pyramid tile (assuming tiles are stored in some kind of texture atlas). The tile pad width gives the number of safety pixels at the that are borrowed from neighbouring pyramid tiles:

      8x8 tile, with a pad of 2:

    0   1   2   3   4   5   6   7
  +---+---+---+---+---+---+---+---+
0 |###|###|###|###|###|###|###|###|
  +---+---+---+---+---+---+---+---+
1 |###|###|###|###|###|###|###|###|
  +---+--(X)--+---+---+--(X)--+---+
2 |###|###|   |   |   |   |###|###|
  +---+---+---+---+---+---+---+---+
3 |###|###|   |   |   |   |###|###|
  +---+---+---+---+---+---+---+---+
4 |###|###|   |   |   |   |###|###|
  +---+---+---+---+---+---+---+---+
5 |###|###|   |   |   |   |###|###|
  +---+--(X)--+---+---+--(X)--+---+
6 |###|###|###|###|###|###|###|###|
  +---+---+---+---+---+---+---+---+
7 |###|###|###|###|###|###|###|###|
  +---+---+---+---+---+---+---+---+

The point coordinates marked with (X) will be mapped to the corner vertices of each terrain mesh sector. Only the effective region of a padded tile (i.e. the square surrounded by (X)) contains actual data. The padded pixels are sampled from neighbouring source tiles and carry redundant information.

optional resolution number[]  
0

For each pyramid level, holds the edge length of the square that has the same area as the parallelogram defined by the ground vectors corresponding to the raster steps of (1|0) and (0|1).

Usages

The following table shows all usages of this config type.

Used By: