https://github.com/meshiest/heightmap2brs

Generate Brickadia Save files from PNG heightmaps
https://github.com/meshiest/heightmap2brs

brickadia heightmap save-files

Last synced: 6 months ago
JSON representation

Generate Brickadia Save files from PNG heightmaps

• Host: GitHub
• URL: https://github.com/meshiest/heightmap2brs
• Owner: Meshiest
• Created: 2020-05-05T03:20:29.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2022-12-27T21:39:58.000Z (about 3 years ago)
• Last Synced: 2024-03-19T17:32:42.713Z (almost 2 years ago)
• Topics: brickadia, heightmap, save-files
• Language: Rust
• Homepage:
• Size: 50.4 MB
• Stars: 2
• Watchers: 3
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Heightmap2BRS

[Download here](https://github.com/Meshiest/heightmap2brs/releases)

![Example output](https://i.imgur.com/QdPLN09.png)

![GTAV Map](https://i.imgur.com/J9XpmT3.png)

![Gui](https://i.imgur.com/8v9MXnl.png)

### Compiling

You need [rust](https://www.rust-lang.org/).

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] 

    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     Input colormap PNG image

        -o, --output         Output BRS file

        -s, --size             Brick stud size (default 1)

        -v, --vertical     Vertical scale multiplier (default 1)

        --owner               Set the owner name (default Generator)

        --owner_id         Set the owner id (default a1b16aca-9627-4a16-a160-67fa9adbb7b6)

    ARGS:

        ...    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](https://github.com/Kmschr/GeoTIFF2Heightmap).