TERRAIN 1 BRL-CAD BRL-CAD
terrain Generate terrain field from mathematical noise
`terrain` -w x_postings -n y_postings -s xy_postings -L noise_Lacunarity -H noise_H_value -O noise_octaves -o noise_offset -S noise_scale -V noise_Vector_scale -D noise_Delta -f noise_function -c host/net format conversion off > file.dsp

## DESCRIPTION

The `terrain` program produces pseudo-terrain from procedural noise suitable for use with a BRL-CAD dsp primitive. Noise values are computed for the grid points of the lattice and the resultant values are output on the standard output as unsigned shorts in network byte order. The size of the grid is specified with the `-w` and `-n` options.

## OPTIONS

`-w` grid_x_postings

  Specifies the number of grid points in the X dimension. Default is 256.

`-n` grid_y_postings

  Specifies the number of grid points in the Y dimension. Default is 256.

`-c`

  Turns of the conversion of the data from host to network format. This only has an effect on little-endian machines.

`-v`

  Turns on verbose mode. Information about which filter is running is printed.

`-f` noise_type

  Selects the type of noise field to be used. Options include

L

  A lunar-like surface.

f

  Fractional Brownian motion (fBm).

t

  Turbulence.

T

  Turbulence inverted: 1.0 - turb(pt).

m

  A Multi-fractal.

r

  A Ridged multi-fractal.

### Noise Options

`-O` noise_octaves

  Specifies the number of octaves of noise to layer. Typical values are 2 through 8.

`-L` noise_Lacunarity

  Specifies the scaling factor between successive octaves of noise. Practical values are non-integer numbers between 1.7 and 4.0.

`-H` noise_H_val

  Specifies the value of H in the noise equation. Usually 1.0

`-S` noise_scale

  Scales the noise uniformly in X, Y and Z dimensions by the value noise_scale. Values below 1.0 cause the noise pattern to become smaller. Values above 1.0 cause it to get bigger

`-V` scale_x,scale_y,scale_z

  Allows non-uniform scaling of the X, Y and Z dimensions. See `-S` above.

`-D` delta_x,delta_y,delta_z

  Specifies a translation in noise space.

## AUTHOR

BRL-CAD Team

## COPYRIGHT

This software is Copyright (c) 2000-2024 by the United States Government as represented by U.S. Army Research Laboratory.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org