Skip to content

Neryss/Scop

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Title

Scop : a C++ program which can open & visualize 3D .obj files.

Description

This programs aims at being an object loader and viewer in OpenGL. This is done without any external libraries to load objects or shaders etc.

Everything is done by hand, matrixes, loading, text display.

Examples

Here are some example of the program being used:

Cube preview

Dragon preview

Moon preview

Getting Started

Dependencies

  • C++ (Linux : g++ pkg)
  • OpenGL
  • Glew :
sudo apt-get install libglew-dev
  • GLFW (window & input events management) :
sudo apt-get install libglfw3
sudo apt-get install libglfw3-dev
  • -lXi compile flag
sudo apt-get install libxi-dev

Compiling

make

Executing program

./scop <path/to/obj/file> [-f](for fullscreen)

Controls

Arrow keys  : Change rotation axis
0 (!numpad) : Stop rotation
WASD        : Move the camera on X and Z axis
CTRL        : Accelerate movement speed
Space/Shift : Move the camera on Y axis
L           : Enable/Disable texture
M           : Enable/Disable wireframe mod
R           : Reset camera
H           : Randomize object rotation
F5          : Switch from small to large screen size
F3          : Minecraft style debug informations
Echap       : Quit

Help for use on Windows/wsl

Works on Win10, WSL2, GeForce GTX 950.

If program segfaults at exit and/or glxinfo -B segfaults or gives errors

  • For Win11, you should update your WSL kernel to version : 1.3.15, by typing in powershell :
wsl --update --pre-release

If none of the above worked :

  • Reboot wsl (wsl --shutdown in a windows terminal) and/or your PC.
  • Try a good old :
sudo apt upgrade
  • Try this less safe option if needed (warning : this is destructive, as it removes previous version of old packages from your system, and can take up to 1 hour to complete and may also include useless packages)
sudo apt full-upgrade

=> Any other advise for common problems or issues ?

Known limitations

  • VSync doesn't seem to work properly on WSL.
  • WSL and GPU drivers render shaders differently sometimes, as diamonds instead of triangles for colors (even though the polygons are still created properly).
  • Issues with obj file handling on WSL (no idea as to how or why or what or where...).

Credits

We've been working on this project as a team of 3, you can find us here:

Releases

No releases published

Packages

No packages published

Languages

  • C++ 95.5%
  • GLSL 3.0%
  • Makefile 1.5%