https://github.com/bl33h/3dmodelloader
A program that uses SDL2 and glm to load, render, and rotate the lines of 3D models from OBJ files for display.
https://github.com/bl33h/3dmodelloader
3d cpp display glm gnu linux loader obj-files sdl2 spaceship
Last synced: 7 months ago
JSON representation
A program that uses SDL2 and glm to load, render, and rotate the lines of 3D models from OBJ files for display.
- Host: GitHub
- URL: https://github.com/bl33h/3dmodelloader
- Owner: bl33h
- License: mit
- Created: 2023-07-28T04:40:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-18T00:33:32.000Z (almost 2 years ago)
- Last Synced: 2024-01-30T06:58:55.541Z (over 1 year ago)
- Topics: 3d, cpp, display, glm, gnu, linux, loader, obj-files, sdl2, spaceship
- Language: C++
- Homepage:
- Size: 340 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 3dModelLoader
The code represents a program for loading and rendering a 3D model using SDL (Simple DirectMedia Layer) and OpenGL. The program is designed to read a 3D model in OBJ format, apply rotation transformations to it, and display the rotated model on the screen.
Files •
Features •
How To Use
## Files
- configure.sh: A shell script to set up the project dependencies and environment.
- build.sh: A shell script to build the project using CMake.
- run.sh: A shell script to execute the compiled graphics application.
- clean.sh: A shell script to clean up build artifacts and generated files.
- src: A directory containing the source code files for the graphics application.
- colors.h: Header file that defines the Color struct and functions for manipulating colors in the application.
- triangles.h: Header file that enables drawing triangles using SDL_Renderer with 3D vertices and colors from colors.h.
- faces.h: Header file that defines the 'Face' struct containing a trio of integer vertex indices.
- main.cpp: The main C++ source file that implements the graphics application.
- CMakeLists.txt: The CMake configuration file that manages the build process.
## Features
The main features of the graphics application include:
- 3D Model Loading and Rendering: The program can load 3D models in OBJ format and render them on the screen using SDL and OpenGL.
- Model Rotation: The application can apply horizontal and vertical rotation transformations to the loaded 3D model, allowing users to visualize the model from different angles.
- Interactive Display: The program provides an interactive display where users can view the loaded 3D model, rotate it using real-time transformations, and observe the changes in its orientation.
- Wireframe Rendering: The application renders the 3D model as wireframes, showing the edges and faces of the model using lines.
- Graphical User Interface: The program features a graphical user interface that utilizes SDL to create a window for rendering the 3D model, enabling easy interaction and visualization.
- User-Friendly Controls: Users can conveniently control the rotation of the model using the interface, allowing them to explore various viewpoints
## How To Use
To clone and run this application, you'll need [wsl](https://learn.microsoft.com/en-us/windows/wsl/install) and the following tools installed on it: [Git](https://git-scm.com), [C++ compiler](https://www.fdi.ucm.es/profesor/luis/fp/devtools/mingw.html), [CMake](https://cmake.org/download/), [Make](https://linuxhint.com/install-make-ubuntu/), [glm](https://sourceforge.net/projects/glm.mirror/), and [SDL2](https://www.oreilly.com/library/view/rust-programming-by/9781788390637/386c15eb-41b2-41b4-bd65-154a750a58d8.xhtml). From your command line:
```bash
# Clone this repository
$ git clone https://github.com/bl33h/3dModelLoader
# Open the project
$ cd 3dModelLoader
# Give execution permissions
$ chmod +x configure.sh
$ chmod +x build.sh
$ chmod +x run.sh
# Run the app
$ ./run.sh
```