{"id":21203730,"url":"https://github.com/bl33h/3dmodelloader","last_synced_at":"2025-07-10T07:30:25.770Z","repository":{"id":189035769,"uuid":"671761586","full_name":"bl33h/3dModelLoader","owner":"bl33h","description":"A program that uses SDL2 and glm to load, render, and rotate the lines of 3D models from OBJ files for display.","archived":false,"fork":false,"pushed_at":"2023-08-18T00:33:32.000Z","size":348,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-01-30T06:58:55.541Z","etag":null,"topics":["3d","cpp","display","glm","gnu","linux","loader","obj-files","sdl2","spaceship"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bl33h.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-07-28T04:40:18.000Z","updated_at":"2024-01-01T12:37:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a32e529-4e71-41aa-bd2d-57c36041d1e7","html_url":"https://github.com/bl33h/3dModelLoader","commit_stats":{"total_commits":18,"total_committers":1,"mean_commits":18.0,"dds":0.0,"last_synced_commit":"2e338f1dce78bcf1467a3f6286781553e2bba428"},"previous_names":["bl33h/3dmodelloader"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl33h%2F3dModelLoader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl33h%2F3dModelLoader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl33h%2F3dModelLoader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bl33h%2F3dModelLoader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bl33h","download_url":"https://codeload.github.com/bl33h/3dModelLoader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225625587,"owners_count":17498645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","cpp","display","glm","gnu","linux","loader","obj-files","sdl2","spaceship"],"created_at":"2024-11-20T20:26:26.658Z","updated_at":"2024-11-20T20:26:27.892Z","avatar_url":"https://github.com/bl33h.png","language":"C++","readme":"# 3dModelLoader\nThe 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. \n\n\u003cp align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExeDIya3ZwemRyMG9wNDl2ZDJhbGU4bGtrYzRuMnhpZ2s2cmo0bTEyaCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/2KYs49eO9V2VDGy3QX/giphy.gif\" alt=\"pic\" width=\"500\"\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" \u003e\n  \u003ca href=\"#Files\"\u003eFiles\u003c/a\u003e •\n  \u003ca href=\"#Features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#how-to-use\"\u003eHow To Use\u003c/a\u003e \n\u003c/p\u003e\n\n## Files\n\n- configure.sh: A shell script to set up the project dependencies and environment.\n- build.sh: A shell script to build the project using CMake.\n- run.sh: A shell script to execute the compiled graphics application.\n- clean.sh: A shell script to clean up build artifacts and generated files.\n- src: A directory containing the source code files for the graphics application.\n  - colors.h: Header file that defines the Color struct and functions for manipulating colors in the application.\n  - triangles.h: Header file that enables drawing triangles using SDL_Renderer with 3D vertices and colors from colors.h.\n  - faces.h: Header file that defines the 'Face' struct containing a trio of integer vertex indices.\n  - main.cpp: The main C++ source file that implements the graphics application.\n- CMakeLists.txt: The CMake configuration file that manages the build process.\n\n## Features\nThe main features of the graphics application include:\n\n- 3D Model Loading and Rendering: The program can load 3D models in OBJ format and render them on the screen using SDL and OpenGL.\n- 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.\n- 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.\n- Wireframe Rendering: The application renders the 3D model as wireframes, showing the edges and faces of the model using lines.\n- 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.\n- User-Friendly Controls: Users can conveniently control the rotation of the model using the interface, allowing them to explore various viewpoints\n\n## How To Use\nTo 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:\n\n```bash\n# Clone this repository\n$ git clone https://github.com/bl33h/3dModelLoader\n\n# Open the project\n$ cd 3dModelLoader\n\n# Give execution permissions\n$ chmod +x configure.sh\n$ chmod +x build.sh\n$ chmod +x run.sh\n\n# Run the app\n$ ./run.sh\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbl33h%2F3dmodelloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbl33h%2F3dmodelloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbl33h%2F3dmodelloader/lists"}