Heightmap2BRS

Download here

Compiling

You need rust.

Run cargo build for the CLI, cargo build --bin heightmap_gui --features gui for the gui.

Usage

Compile or download from releases.

heightmap.exe --help for usage instructions:

USAGE:
    heightmap.exe [FLAGS] [OPTIONS] <INPUT>

FLAGS:
        --cull       Automatically remove bottom level bricks and fully transparent bricks
    -h, --help       Prints help information
        --hdmap      Using a high detail rgb color encoded heightmap
        --lrgb       Use linear rgb input color instead of sRGB
        --micro      Render bricks as micro bricks
        --nocollide  Disable brick collision
        --old        Use old unoptimized heightmap code
        --snap       Snap bricks to the brick grid
        --tile       Render bricks as tiles
        --stud       Render bricks as stud cubes
    -i  --img        Make heightmap flat (use as img2brick)
    -V, --version    Prints version information

OPTIONS:
    -c, --colormap <colormap>    Input colormap PNG image
    -o, --output <output>        Output BRS file
    -s, --size <size>            Brick stud size (default 1)
    -v, --vertical <vertical>    Vertical scale multiplier (default 1)
    --owner <owner>              Set the owner name (default Generator)
    --owner_id <owner_id>        Set the owner id (default a1b16aca-9627-4a16-a160-67fa9adbb7b6)

ARGS:
    <INPUT>...    Input heightmap PNG images

Examples

An example command for generating the GTA V map would be:

heightmap example_maps/gta5_fixed2_height.png -c example_maps/gta5_fixed2_color.png -s 4 -v 20 --tile -o gta5.brs

To use stacked heightmap for increased resolution, simply provide more input files. See the stacked_N.png files in the example_maps directory for example stacked heightmaps.

heightmap ./example_maps/stacked_1.png ./example_maps/stacked_2.png ./example_maps/stacked_3.png ./example_maps/stacked_4.png --tile

To generate HD heightmaps for the --hdmap flag, check out Kmschr's GeoTIFF2Heightmap tool.