Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spicycactuar/heightmap
Textured heightmap OpenGL application
https://github.com/spicycactuar/heightmap
blinn-phong computer-graphics cpp glm glsl heightmap opengl premake5
Last synced: 4 days ago
JSON representation
Textured heightmap OpenGL application
- Host: GitHub
- URL: https://github.com/spicycactuar/heightmap
- Owner: SpicyCactuar
- Created: 2024-10-31T19:10:34.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-12T22:43:42.000Z (11 days ago)
- Last Synced: 2024-12-12T23:29:55.211Z (11 days ago)
- Topics: blinn-phong, computer-graphics, cpp, glm, glsl, heightmap, opengl, premake5
- Language: C++
- Homepage:
- Size: 5.54 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Heightmap
OpenGL application displaying a textured heightmap.
An `nPoints` sized triangle strip is generated at runtime. For each vertex, its tangents and UVs are computed.
The information is fed into a basic graphics pipeline (`.vert` + `.frag`) that displaces the vertices
and subsequently Blinn-Phong shades the resulting fragments. Three terrain textures are mixed according to height.
A single directional light illuminates the scene.
## Project Structure
```plaintext
heightmap/
├── src/ # Source code, including shaders
├── external/ # Bundled libraries' source code (GLFW, GLEW, GLM)
├── assets/ # Static assets (.bmp files)
├── premake5.lua # Premake 5 config
├── premake5 # Premake 5 executable (Unix)
├── premake5.exe # Premake 5 executable (Windows)
└── README.md # Project README
```
## Build - Make
```shell
./premake5 gmake2
make [config={debug_x64|release_x64}]
```
The `config` parameter defaults to `debug_x64`.
## Build - Visual Studio
```shell
./premake5.exe vs2022
```
Open generated `.sln` project file.
## Build - Xcode
```shell
./premake5.apple xcode4
```
Open generated Xcode project.
## Run
```shell
bin/heightmap-{target}.exe
```
Executables have `.exe` extension for all platforms, but binaries are platform-specific.
## Controls
| Key(s) | Action |
|-------------------------|---------------------------------------|
| `↑` / `↓` / `←` / `→` | Move forward, back, left, and right |
| `Space` | Toggle wireframe visualisation mode |
| `N` | Toggle normal visualisation mode |
| `T` / `S` | Scale height up and down |
| `W` / `A` / `S` / `D` | Rotate directional light |
| `Esc` | Close the application |
## Technologies
* **Premake**: `5`
* **C++**: `>= C++17`
* **OpenGL**: `>= 4.2`
* **GLFW**: `3.4.0`
* **GLEW**: `1.13.0`
* **GLM**: `0.9.7.1`