A minimal OpenGL-based 3D object viewer written in C++
SCOP is a small 3D rendering application that loads .obj files, renders them using OpenGL, and allows camera movement, object manipulation, and toggling between texture and color modes.
This project is entirely built without external math or model libraries (no GLM, no Assimp), and only uses OpenGL and basic windowing.
- 🧱 Loads and renders
.obj3D models - 🎨 Displays different colors per face
- 🔄 Object auto-rotates around its center
- 🕹️ Move object freely along X, Y, Z axes
- ⌨️ Keyboard controls for translation
- 🎭 Toggle between solid color and texture
- Smooth transition between modes
- 🔲 Perspective projection enabled
- 📂 Custom-made
.objparser - 🧮 Self-implemented matrix math (no glm)
- 📜 Shader loader written from scratch
- ✔️ Gracefully handles malformed
.objfiles (e.g. open teapot mesh) - ✔️ Texture mapping with correct UVs
- ✔️ Face normal smoothing
- ✔️ Display mode toggle (wireframe, normal debug)
- ✔️ Mouse camera control (arcball rotation)
| Key | Action |
|---|---|
WASD |
Move object (X/Y axis) |
Q / E |
Move object (Z axis) |
R |
Reset object position |
T |
Toggle between texture / color |
1 |
Change View Option (Wire / Fill) |
ESC |
Quit the application |
You need first GLFW Install
make
./scop teapot.obj
or
./scop├── Makefile
├── README.md
├── library
│ └── stb_image.h
├── resources <- add Your obj file
│ ├── 42.mtl
│ ├── 42.obj
│ ├── sample.png
│ ├── teapot.obj
│ ├── teapot2.mtl
│ └── teapot2.obj
└── srcs
├── InputHandler.cpp
├── InputHandler.hpp
├── Material.cpp
├── Material.hpp
├── MathUtils.hpp
├── Model.cpp
├── Model.hpp
├── Shader.cpp
├── Shader.hpp
├── UVRotation.hpp
├── main.cpp
└── shaders
├── shader_frag.glsl
└── shader_vert.glsl