SimpleHydrology - GitLite

KO | EN

gitlite — search

#javascript #python #llm #android #rust #linux #macos #java #awesome #kubernetes #vue #pytorch #ios #open-source

SimpleHydrology

(★ 738)

Procedural Hydrology / River / Lake Simulation

파일 탐색기

최종 버전 다운로드 (.zip)

- normal.png
- rock.png
- banner.png
- side1.png
- side2.png
- side3.png
- side4.png
- side5.png
- top1.png
- top2.png
- top3.png
- top4.png
- top5.png
- top6.png
- - FastNoiseLite.h
  - math.h
- - default.fs
  - default.vs
  - depth.fs
  - depth.vs
  - image.fs
  - image.vs
  - map.fs
  - map.vs
  - ssao.fs
  - ssao.vs
  - tree.fs
  - tree.vs
  - treedepth.fs
  - treedepth.vs
- cellpool.h
- model.h
- vegetation.h
- vertexpool.h
- water.h
- world.h
.gitignore
imgui.ini
Makefile
README.md
SimpleHydrology.cpp

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/weigert/SimpleHydrology

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd SimpleHydrology

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make all

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SimpleHydrology
C++ implementation of a particle based procedural hydrology system for terrain generation. This extends simple particle based hydraulic erosion to capture streams and pools.

Rendered using my homebrew [TinyEngine](https://github.com/weigert/TinyEngine).

[Link to a blog post about this](https://nickmcd.me/2020/04/15/procedural-hydrology/)

![Banner Image](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/banner.png)

## Compiling

Use the makefile to compile the program.

make all

### Dependencies

Erosion System:
    - gcc
    - glm

Renderer:
    - TinyEngine (and sub dependencies)

## Usage

./hydrology [SEED]

If no seed is specified, it will take a random one.

### Controls

- Zoom and Rotate Camera: Scroll
    - Arrow Keys: Move Camera Position
    - WASD / C / V: Move Camera Anchor
    - Toggle Pause: P (WARNING: PAUSED BY DEFAULT!!)
    - Toggle Map View: M
    - Toggle Hydrology Map View: ESC

### Screenshots
![Example Output 1](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/top4.png)

![Example Output 2](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/side5.png)

![Example Output 3](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/top5.png)

![Example Output 4](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/side4.png)

![Example Output 5](https://github.com/weigert/SimpleHydrology/blob/master/screenshots/side3.png)

## Reading
The main file is just to wrap the OpenGL code for drawing. At the very bottom, you can see the main game loop that calls the erosion and vegetation growth functions.

The part of the code described in the blog article is contained in the file `water.h`. Read this to find the implementation of the procedural hydrology.

The trees are implemented in `vegetation.h`.

All of the code is wrapped with the world class in `world.h`. The bottom of this file contains a bunch of stuff relevant for rendering, but not the erosion system.

The rest is shaders and rendering stuff.

## Update October 2021

The rendering system has been updated to use [vertex pooling](https://nickmcd.me/2021/04/04/high-performance-voxel-engine/) to remove all remeshing cost.

Improvements have also been made to the flooding algorithm to increase the search plane at fixed, deterministic increments by iteratively looking for the lowest point on the boundary. Additionally, the region can be grown by only tracking the boundary.

For a next iteration on this system, see [SoilMachine](https://github.com/weigert/SoilMachine).

## Update January 2023

The flooding system has been removed for now, because of buggyness and slowness. A better system has been proposed [here](https://github.com/weigert/SoilMachine).

Momentum and discharge maps are now explicit and interact physically with the water particles, giving river meandering behavior.

Parameters have been properly separated out.

Libnoise dependency has been removed.

## Windows Ports
Windows ports for this program exist:

https://github.com/pawel-mazurkiewicz/SimpleHydrologyWindows

https://github.com/Roipo/SimpleHydrology

## License
MIT License.

See my website for a [more detailed copyright notice](https://nickmcd.me/copyright-notice/).