GitHub - tsong/viewer: A simple 3D model viewer for OBJ files

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
obj		obj
utils		utils
README		README
camera.cpp		camera.cpp
camera.h		camera.h
cameradialog.cpp		cameradialog.cpp
cameradialog.h		cameradialog.h
cameradialog.ui		cameradialog.ui
glwidget.cpp		glwidget.cpp
glwidget.h		glwidget.h
light.cpp		light.cpp
light.h		light.h
lightdialog.cpp		lightdialog.cpp
lightdialog.h		lightdialog.h
lightdialog.ui		lightdialog.ui
main.cpp		main.cpp
mainwindow.cpp		mainwindow.cpp
mainwindow.h		mainwindow.h
mesh.cpp		mesh.cpp
mesh.h		mesh.h
openglrenderer.cpp		openglrenderer.cpp
openglrenderer.h		openglrenderer.h
phong.fsh		phong.fsh
phong.vsh		phong.vsh
renderer.h		renderer.h
scene.cpp		scene.cpp
scene.h		scene.h
types.h		types.h
viewer.pro		viewer.pro
viewer.pro.user		viewer.pro.user

Repository files navigation

===============================================================================
                                   VIEWER
===============================================================================

===================
      Author
===================

Tim Song
timsong@uvic.ca

===================
     Overview
===================

This program loads 3D models in OBJ format and provides a simple arc-ball
camera to view it. Lights can be added, and different rendering
modes are available. Additionally, the mesh can be subdivided using the
Catmull-Clark subdivision algorithm.

Only quad meshes are currently supported.

===================
      Usage
===================

- To open an OBJ file, use the "File->Open OBJ" menu command

- Hold and drag the left mouse button to move the camera
- Hold and drag the right mouse button or use the scroll wheel to zoom
- Additional camera settings can be configured through the "Edit->Camera"
  menu option
- The camera's coordinate can be shown through the "Show->Info" 
  menu option

- Lights can be configured through the "Edit->Light Sources" menu option

- The coordinate axis can be shown through the "Show->Axis" menu option

- Different rendering modes can be selected in the "Render" menu
	- Default OpenGL shading
	- Wireframe
	- Phong shading

- The "Subdivide" menu allows you to specify the number of steps to perform
  subdivision. NOTE: This may take a long time for larger meshes.

===================
     Build
===================

This program was built using Qt 4.7.0. After installing the framework, run
> qmake
> make
to build the program.