https://github.com/dianazabelina/3d-viewer
Program for visualizing wireframe 3D models
https://github.com/dianazabelina/3d-viewer
cpp education gtest gui mvc qt unit-testing viewer wireframe
Last synced: about 1 month ago
JSON representation
Program for visualizing wireframe 3D models
- Host: GitHub
- URL: https://github.com/dianazabelina/3d-viewer
- Owner: DianaZabelina
- Created: 2025-05-21T16:31:26.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-25T13:08:23.000Z (12 months ago)
- Last Synced: 2025-06-25T14:23:50.143Z (12 months ago)
- Topics: cpp, education, gtest, gui, mvc, qt, unit-testing, viewer, wireframe
- Language: C++
- Homepage:
- Size: 52.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 3D Viewer
3D Viewer — это учебный проект, в рамках которого реализована программа для визуализации каркасной модели в трехмерном пространстве на C++ с применением объектно-ориентированного подхода.
## Содержание
- [Введение](#введение)
- [Требования к проекту](#требования-к-проекту)
- [Основное задание](#part-1-основное-задание)
- [Дополнительно. Настройки](#part-2-дополнительно-настройки)
- [Дополнительно. Запись](#part-3-дополнительно-запись)
## Введение
В рамках проекта разработано приложение для отображения 3D-моделей в каркасном виде. Программа поддерживает загрузку моделей в формате .obj, их трансформации и настройку визуальных параметров отображения.
Проект выполнен в составе команды. Моя зона ответственности включала:
- разработку элементов графического пользовательского интерфейса;
- построение структуры окна приложения и интерфейса взаимодействия (view);
- составление пользовательской документации;
- ручное тестирование элементов интерфейса: проверка работы кнопок и полей ввода, соответствие логике и требованиям проекта.
## Требования к проекту
Ниже приведены требования к реализации проекта 3D Viewer.
## Part 1. Основное задание
- Программа должна быть разработана на языке C++ стандарта C++17.
- Код программы должен находиться в папке src.
- При написании кода необходимо придерживаться Google Style.
- Сборка программы должна быть настроена с помощью Makefile со стандартным набором целей для GNU-программ: all, install, uninstall, clean, dvi, dist, tests. Установка должна вестись в любой другой произвольный каталог.
- Программа должна быть разработана в соответствии с принципами объектно-ориентированного программирования, структурный подход запрещен.
- Должно быть обеспечено полное покрытие unit-тестами модулей, связанных с загрузкой моделей и аффинными преобразованиями.
- В один момент времени должна быть только одна модель на экране.
- Программа должна предоставлять возможность:
- Загружать каркасную модель из файла формата obj (поддержка только списка вершин и поверхностей);
- Перемещать модель на заданное расстояние относительно осей X, Y, Z;
- Поворачивать модель на заданный угол относительно своих осей X, Y, Z;
- Масштабировать модель на заданное значение.
- В программе должен быть реализован графический пользовательский интерфейс, на базе любой GUI-библиотеки с API для C++:
* Для Linux: GTK+, CEF, Qt, JUCE;
* Для Mac: GTK+, CEF, Qt, JUCE, SFML, Nanogui, Nngui.
- Графический пользовательский интерфейс должен содержать:
- Кнопку для выбора файла с моделью и поле для вывода его названия;
- Зону визуализации каркасной модели;
- Кнопку/кнопки и поля ввода для перемещения модели;
- Кнопку/кнопки и поля ввода для поворота модели;
- Кнопку/кнопки и поля ввода для масштабирования модели;
- Информацию о загруженной модели — название файла, кол-во вершин и ребер.
- Программа должна корректно обрабатывать и позволять пользователю просматривать модели с деталями до 100, 1000, 10 000, 100 000, 1 000 000 вершин без зависания (зависание — это бездействие интерфейса более 0,5 секунды).
- Программа должна быть реализована с использованием паттерна MVC, то есть:
- не должно быть кода бизнес-логики в коде представлений;
- не должно быть кода интерфейса в контроллере и в модели;
- контроллеры должны быть тонкими.
- Необходимо использовать минимум три различных паттерна проектирования (например, фасад, стратегия и команда).
- Классы должны быть реализованы внутри пространства имен `s21`.
- Для осуществления афинных преобразований могут использоваться матрицы из библиотеки из предыдущего проекта s21_matrix+.
*Замечание:* **Не загружай тяжелые файлы (>10 Мб) в гит.**
## Part 2. Дополнительно. Настройки
- Программа должна позволять настраивать тип проекции (параллельная и центральная).
- Программа должна позволять настраивать тип (сплошная, пунктирная), цвет и толщину ребер, способ отображения (отсутствует, круг, квадрат), цвет и размер вершин.
- Программа должна позволять выбирать цвет фона.
- Настройки должны сохраняться между перезапусками программы.
## Part 3. Дополнительно. Запись
- Программа должна позволять сохранять полученные («отрендеренные») изображения в файл в форматах bmp и jpeg.
- Программа должна позволять по специальной кнопке записывать небольшие «скринкасты» — текущие пользовательские аффинные преобразования загруженного объекта в gif-анимацию (640x480, 10fps, 5s).