Go to file
Jack Christensen bc1fae35a7 Update .gitlab-ci.yml to hopefully get freeimage working 2024-08-19 13:55:16 -04:00
hgt Update .gitignore to include /hgt directory for testing purposes 2024-08-19 10:19:55 -04:00
imgui Add imgui_impl_opengl3_loader.h to hopefully fix loader issues in test 2024-08-12 17:30:29 -04:00
include Renamed callbacks_tmp back to callbacks 2024-08-18 22:29:54 -04:00
shaders Fix typo 2024-08-19 11:06:50 -04:00
source Add test loop in main.cpp 2024-08-19 10:43:07 -04:00
.gitignore Update .gitignore to include /hgt directory for testing purposes 2024-08-19 10:19:55 -04:00
.gitlab-ci.yml Update .gitlab-ci.yml to hopefully get freeimage working 2024-08-19 13:55:16 -04:00
CMakeLists.txt Add freeimage to dependencies 2024-08-19 13:51:04 -04:00
CMakePresets.json Make CMake files machine agnostic 2024-08-12 16:05:20 -04:00
COPYING Remove file extensions for licensing files 2024-08-10 19:43:14 -04:00
LICENSE Remove file extensions for licensing files 2024-08-10 19:43:14 -04:00
README.md Update README.md 2024-08-12 22:29:35 +00:00
imgui.ini Add slider for tessellation factor 2024-08-17 19:05:05 -04:00

README.md

TerraVisor

TerraVisor is a 3D visualization tool designed for rendering and exploring terrain data. It leverages OpenGL for high-performance rendering and provides users with interactive features to manipulate and visualize complex terrain models.

Features

  • Real-Time Rendering: Utilize the power of OpenGL for fast, real-time terrain visualization.
  • Interactive Tools: Rotate, zoom, and pan the terrain model for detailed exploration.
  • Custom Shaders: Supports custom GLSL shaders for advanced rendering effects.

Installation

Prerequisites

Before building TerraVisor, ensure that you have the following prerequisites installed on your system:

  • Git: Used for cloning the repository and managing source code.
  • CMake: Build system generator used to configure the project.
  • Ninja: Fast build system used to compile the project.
  • vcpkg: Package manager for acquiring C++ libraries.

Installation Steps

  1. Clone the Repository:

    First, clone the repository from GitLab

    git clone http://git.jackmchristensen.com/jack/terravisor.git
    cd terravisor
    
  2. Install vcpkg:

    If you havent installed vcpkg yet, follow these steps to set it up:

    git clone https://github.com/microsoft/vcpkg.git
    cd vcpkg
    ./bootstrap-vcpkg.sh   # Use .\bootstrap-vcpkg.bat on Windows
    

    Optionally, integrate vcpkg with your system:

    ./vcpkg integrate install
    
  3. Install Dependencies:
    Use vcpkg to install dependencies:

     ./vcpkg install glm glew glfw3 assimp
    
  4. Configure the Project:

    Navigate back to the project root directory and configure the project using CMake and Ninja. Be sure to specify the vcpkg toolchain file:

    cd ..
    cmake -B build -S . -G Ninja -DCMAKE_TOOLCHAIN_FILE=./vcpkg/scripts/buildsystems/vcpkg.cmake
    
  5. Build the Project:

    Build the project using Ninja:

    cmake --build build
    
  6. Run the Application:

    Once the build process is complete, you can run the TerraVisor application:

    ./build/TerraVisor
    

Acknowledgements

GLEW - OpenGL Extension Wrangler Library
GLFW - OpenGL Framework
GLM - OpenGL Mathematics
ASSIMP - Open Asset Import Library
Dear ImGui

Contact

For questions or support, please reach out to Jack Christensen at contact@jackmchristensen.com