Egyptian Artifact Viewer

A 3D viewer for Egyptian artifacts with annotation and measurement tools. Built with C++ and OpenGL.

Screenshots

Main View

Default view - King1 with stone texture

Different Models and Textures

| King1 with gold texture | King2 with stone texture

Features in Action

| Annotation markers | Distance measurement*

| Viewing annotations | Artifact information

What It Does

• View 3D Egyptian statues (pharaoh models)
• Rotate and zoom to see from any angle
• Click to place annotations on the model
• Measure distances between points
• Save your annotations and measurements to JSON files

Quick Start

1. Run the program
2. Right-drag to rotate the statue
3. Mouse wheel to zoom
4. Press N and left-click to add annotations
5. Press M and click twice to measure distance
6. Press O to save your data

Controls

Mouse

• Right-click + drag - Rotate
• Left-click - Place point (in annotation/measurement mode)
• Mouse wheel - Zoom

Keyboard

• 1 / 2 - Switch models (King1/King2)
• S / G - Stone/Gold texture
• N - Annotation mode (click to place markers)
• M - Measurement mode (2 clicks for distance)
• P - Print annotations
• L - List measurements
• O - Save to JSON files
• R - Reset view
• V - Wireframe mode
• SPACE - Auto-rotation
• ESC - Exit

Building

Requirements

• Windows 10/11
• Visual Studio 2019+
• OpenGL 3.2+
• GLEW, FreeGLUT, GLM

Setup

1. Open Lab6.vcxproj in Visual Studio
2. Build (Ctrl+Shift+B)
3. Run (F5)

Assets Required

Place your files here:

assets/
??? models/
?   ??? king1.obj
?   ??? king2.obj
??? textures/
    ??? stone.jpg
    ??? gold.jpg

Features

• 3D Viewing - Phong lighting, textures, smooth rotation
• Annotations - Click to mark points of interest
• Measurements - Precise distance calculation
• Auto-normalization - Models automatically centered and scaled
• JSON Export - Save data for research/analysis

Files Created

When you save (press O):

• annotations.json - All your marked points
• measurements.json - All distance measurements

Technical Details

• Language: C++11
• Graphics: OpenGL 3.2 Core
• Libraries: GLEW, FreeGLUT, GLM, STB Image
• Lighting: Phong shading
• Ray-casting: M?ller-Trumbore algorithm

Documentation

See the docs/ folder for:

• USER_GUIDE_V2.5.md - Complete manual
• PROJECT_COMPLETE_GUIDE.md - Technical details
• QUICK_START_V2.md - Quick reference

Known Issues

• Annotations/measurements are stored but not visually rendered yet (data is saved correctly)
• Check console for annotation/measurement data

License

MIT License - See LICENSE file

Version

v2.5 - Academic Edition