Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MatVision Studio

Ваш принт — на объёмном коврике, с тканью, швом и светом.

Локальная Windows-студия для визуализации дизайнов ковриков: настройте рисунок в интерактивной 3D-сцене, рассмотрите материал и получите PNG с физическим освещением.

Версия 0.1.8 · Windows x64 · Активная разработка · Приоритет: качество изображения

Скачать Windows-версию · Инструкция · План развития · Сравнение с аналогами · Сборка

Фоторендер коврика из MatVision Studio

Реальный экспорт установленной 0.1.5: Windows, RTX 3050 Laptop, 1920 × 1232 px, 128 проходов. Остаточный шум сохранён; кадр не ретушировался и не генерировался ИИ.

Для чего нужен проект

MatVision Studio помогает дизайнерам, мастерским печати и продавцам показывать будущий внешний вид коврика до изготовления: оценивать композицию, демонстрировать край и изнанку, сравнивать материалы и готовить изображения для согласования с заказчиком.

Основная польза — предметный рабочий процесс: загрузить принт → настроить изделие → выбрать ракурс → сохранить проект и изображение. Не нужно самостоятельно собирать коврик, материалы и свет в универсальном 3D-редакторе. Экономия времени — ожидаемая польза, пока без сравнительного измерения.

Это визуальный прогноз. Точное совпадение с печатью требует измерений реальной ткани, чернил, принтера и профилей цвета.

Уже работает

Задача Возможности 0.1.8
Изделие Desk Mat 900 × 400 мм, Mouse Pad 400 × 450 мм, толщина, скругления, обычный/прошитый край
Принт PNG/JPEG/WebP, drag-and-drop, Cover/Contain/Stretch, масштаб, сдвиг, поворот, effective DPI
Материал Ткань и резина; карты цвета/нормалей/шероховатости/высоты; физический масштаб повторения
Свет Студийные схемы, поверхности стола, контактные тени, локальная HDR-панорама Poly Haven для фото
Камера Свободное вращение, готовые ракурсы, макро ткани, вид снизу, линейка
Движение Скручивание и восемь демонстраций: уголок, волна, укладка, переворот, два рулона, облёт края, свет, слои
Файлы Переносимый .matvision v2 с принтом и картами; обычный PNG до 3840 px по длинной стороне
Фото Трассировка путей, 10 отражений, до 4096 проходов, DOF, опциональный denoise и рельеф по карте высоты
Ultimate Локальный Cycles prototype через отдельный Blender 4.5 LTS: плоский коврик, принт, камера, PNG и отмена

Движения используют заданные деформации. Полноценная физика ткани ещё в плане.

В 0.1.6 появился Scene Core и переключатель «Мягкий студийный свет»: пять больших источников улучшают освещение ткани в интерактивной Studio. Режим экспериментальный, выключен по умолчанию и не сохраняется в проекте. В фоторежиме по-прежнему работает отдельная трассировка путей; новые источники в неё не передаются. Архитектура и ограничения.

В 0.1.7 Photo получил режимы Preview/High/Ultra/Reference, физическую камеру без размытия по умолчанию, встроенный пространственный фильтр шума и ограниченный геометрический рельеф для отдельного снимка. Ultimate пока прототип: Cycles рендерит только базовый плоский коврик и предупреждает о непренесённых шве, изгибе и картах материалов. Нужен отдельно установленный или распакованный Blender 4.5 LTS; он не входит в установщик. Матрица возможностей и ограничения.

В 0.1.8 исправлено сохранение готового PNG Ultimate в Windows-приложении: кнопка становится доступной только после загрузки изображения, открывает системный диалог и сообщает результат рядом с собой.

Как выглядит работа

Макро ткани и прошитый край в Windows-приложении

Интерактивный просмотр 0.1.5: ткань Poly Haven и отдельные петли оверлока.

Фоторежим в Windows-приложении

Фоторежим 0.1.5. Статус и кнопки доступны внутри прокручиваемого окна.

Прототип Ultimate с результатом Cycles в Windows-приложении

Ultimate 0.1.7: реальный результат Blender/Cycles, базовая плоская сцена. Шов, изгиб и карты материалов пока не перенесены.

Photo 0.1.7 с новым шумоподавлением и f/16

Нативный Photo-прогон 0.1.7: 128 проходов, SmartDenoise, f/16. Сопоставление экспозиции с Ultimate ещё не завершено.

Изгиб коврика Показ конструкции
Подъём уголка Показ ткани и основы

Последние два кадра — демонстрации 0.1.4, сохранённые в 0.1.5. Это показ геометрии, не физическое испытание. Происхождение кадров.

Быстрый старт

  1. Откройте релиз v0.1.8, скачайте MatVisionStudio-0.1.8-x64-setup.exe и установите программу.
  2. Нажмите «+ Изображение» или перетащите PNG/JPEG/WebP на сцену.
  3. Выберите изделие и размещение принта. Для готового материала нажмите «Применить ткань Poly Haven».
  4. Настройте край, свет и камеру. «Макро ткани» помогает рассмотреть рельеф и шов.
  5. Ctrl+S сохраняет проект; Ctrl+E экспортирует обычный PNG.
  6. «Фото» запускает физическую съёмку. По умолчанию 1920 px / 512 проходов; после расчёта сохраните PNG.

Подробности, горячие клавиши, импорт карт и устранение проблем: руководство пользователя.

Нужны Windows 10/11 x64, WebView2 и видеокарта с WebGL2. Установщик может скачать WebView2, если он отсутствует. После установки сцена и встроенные материалы работают локально; Node.js, Rust, Vite и облачная учётная запись пользователю не нужны. Пока репозиторий приватный, скачивание релиза требует доступа к нему.

Как устроено

flowchart LR
    A[Принт и карты] --> B[React + TypeScript: проект]
    B --> S[MatVisionScene: размеры и параметры]
    S --> C[ThreeSceneAdapter + WebGL2: сцена]
    C --> D[N8AO + postprocessing]
    C --> E[Снимок геометрии и материалов]
    E --> F[three-mesh-bvh + three-gpu-pathtracer]
    F --> G[Фото PNG]
    B <--> H[Tauri + Rust: файлы Windows]
    H <--> I[Проект .matvision]
Loading

Размеры изделия и Scene Core выражены в миллиметрах; Three.js преобразует их в метры. Принт связан с поверхностью через UV-координаты и следует за изгибами. Расчёт света идёт в линейном пространстве, вывод — sRGB с ACES. Для фото создаётся отдельная сцена с запечённым принтом и полной геометрией петель шва. Rust обслуживает файлы и Windows-интеграцию, но не рассчитывает каждый кадр.

Технология Версия Роль
Tauri / Rust / WebView2 Tauri Rust 2.11.5, API 2.11.1 Окно Windows, файлы, установщик
React / TypeScript 19.3.0 / 6.0.3 Интерфейс, состояние и типы
Three.js / WebGL2 0.186.0 Геометрия, камера, материалы и свет
N8AO 2.0.1 Контактное затенение
postprocessing 6.39.5 SMAA, тональное преобразование, композиция
three-gpu-pathtracer 0.0.24 Прогрессивный фоторендер
three-mesh-bvh 0.9.5 Ускорение пересечений лучей; подготовка в worker
Vite / pnpm 8.3.0 / 11.19.0 Сборка и зависимости
Vitest / Playwright / WebdriverIO см. package.json CPU-, браузерные и Windows-проверки
Poly Haven CC0-ресурсы Локальные карты ткани и HDR-фотостудия

Перечисленные графические библиотеки действительно используются. Blender, Ammo.js, SSGI и Material Maker не встроены. Сторонние лицензии.

Отличия и ограничения

Специализация на ковриках, локальные проекты с вложенными материалами и общий процесс для принта, шва, изгибов и фото — основа проекта. Онлайн-сервисы удобны готовыми сценами и разнообразием шаблонов; Blender предоставляет значительно более широкие средства моделирования и симуляции.

Мы не заявляем превосходство над всеми аналогами по скорости или реализму: сравнительного теста пока нет. Сравнение с Pacdora, PSD-мокапами и Blender содержит источники и границы применимости.

  • На установленной Windows-версии подтверждены фото 1920 × 1232 / 128 проходов на RTX 3050 Laptop, нативное сохранение PNG/проектов, отмена, повторное открытие и возврат в студию. Отчёт.
  • Фото 2560/3840 px и 512/1024 прохода доступны, но не сертифицированы этим тестом. Обычный 4K PNG проверялся отдельно.
  • На протестированном Intel UHD / Direct3D11 фоторежим искажает материалы и блокируется с объяснением. Программа запрашивает мощную видеокарту; остальные GPU требуют проверки.
  • На малом числе проходов виден шум; denoiser пока отсутствует. В экспериментальном Studio микроволокна представлены отдельной картой нормалей, но не геометрией и пока не перенесены в Photo. Карта высоты не меняет силуэт.
  • .matvision v2 включает принт и карты; читаются старые v0/v1. Приложение 0.1.4 не открывает v2. Параметры отдельного фото пока не сохраняются в проекте.
  • ICC Print Proof, видеоэкспорт и полноценная физика ткани ещё не реализованы.

Разработка и план

git clone https://github.com/AlexCodeHadjar/matvision-studio.git
cd matvision-studio
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm tauri dev

Для нативного запуска установите Rust/MSVC/Windows SDK и WebView2: подробная инструкция разработчика.

Ближайшие направления: качество фото и сохранение его параметров, ткань и край крупным планом, проверяемые изгибы и физика, каталог материалов, пакетная съёмка. ROADMAP.md объясняет пользу, проверки и необходимые уточнения. Настройки слабых ПК отложены до приёмки качества.

Документация

Репозиторий содержит исходники 0.1.8, тесты, документацию и ресурсы. Установщик размещается в Releases; Blender, зависимости сборки, кеши и личные проекты в Git не включаются. Проверка Windows-версии 0.1.7 фиксирует прогоны Photo и Cycles prototype; проверка исправления сохранения 0.1.8 фиксирует отдельный нативный прогон. Матрица рендереров перечисляет ещё не реализованный перенос и калибровку. Отдельная лицензия собственного кода ещё не оформлена; лицензии зависимостей сохраняются.

About

Локальная Windows-студия 3D-визуализации ковриков: пользовательские принты, PBR-ткань, прошитый край, изгибы и физический фоторендер. Tauri · Three.js.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages