Files
QuickPrintBridge/README.md

71 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
### README.md для проекта «QuickPrint Bridge»
**QuickPrint Bridge** — инструмент для молниеносной отправки 3D-моделей на печать через веб-ссылки в любой слайсер. Если слайсер не поддерживает веб-интеграцию — модель автоматически экспортируется в формате **3MF**.
#### 🔧 Функционал
- мгновенная отправка модели в слайсер по веб-ссылкам (`prusaslicer://`, `bambustudio://`, `cura://` и др.);
- автоматический экспорт в 3MF при отсутствии поддержки веб-ссылок у слайсера;
- совместимость с любыми слайсерами, поддерживающими указанные протоколы или формат 3MF;
- простой интерфейс с одной кнопкой «Отправить на печать»;
- визуальное отображение статуса операции (успех/ошибка).
#### ✅ Поддерживаемые ОС и технологии
- **ОС:** Windows 10/11 (64-бит);
- **Платформа:** .NET 8 (WPF, MVVM);
- **Интеграция с CAD:** через COM-интерфейсы (например, KOMPAS-3D V21+);
- **Форматы:** STL (для передачи), 3MF (резервный экспорт).
#### 📥 Системные требования
- установленный слайсер (PrusaSlicer, Bambu Studio, Cura и др.);
- .NET 8 Runtime (устанавливается автоматически);
- CAD-система с поддержкой COM-интерфейсов (например, КОМПАС-3D);
- права на запись в папку временных файлов (`%TEMP%`).
#### 🛠 Установка
1. Скопируйте `QuickPrintBridge.dll` в папку `C:\Program Files\ASCON\KOMPAS-3D VXX\Libs\`.
2. Зарегистрируйте плагин в реестре:
- откройте `regedit`;
- перейдите в `HKEY_LOCAL_MACHINE\SOFTWARE\ASCON\KOMPAS-3D\VXX\AddIns`;
- создайте новый ключ с GUID;
- добавьте параметры: `Path` (путь к DLL), `Name` («QuickPrint Bridge»), `LoadAtStart` (`1`).
3. Запустите КОМПАС-3D — плагин появится в меню «Приложения».
#### 🖨 Использование
1. Откройте 3D-модель в CAD-системе.
2. Запустите плагин через меню «Приложения» → «QuickPrint Bridge».
3. Нажмите «Отправить на печать».
4. Модель будет передана в слайсер или экспортирована в 3MF (в зависимости от настроек слайсера).
#### ⚙ Настройка
Параметры задаются в `appsettings.json`:
```json
{
"SlicerProtocols": {
"PrusaSlicer": "prusaslicer://",
"BambuStudio": "bambustudio://",
"Cura": "cura://"
},
"TempExportFolder": "%TEMP%\\QuickPrintBridge",
"FallbackFormat": "3mf",
"StlExport": {
"Deviation": 0.01,
"Angle": 5.0
}
}
```
- `SlicerProtocols` — список поддерживаемых протоколов;
- `TempExportFolder` — папка для временных файлов;
- `FallbackFormat` — формат экспорта при отсутствии поддержки веб-ссылок;
- `StlExport` — параметры экспорта STL.
#### 🔐 Безопасность
- плагин не передаёт данные в интернет;
- все операции выполняются локально;
- рекомендуется подписывать DLL-файл цифровой подписью.
**Изменения:**
- все упоминания `MultiSlicer Link` заменены на `QuickPrint Bridge`;
- соответствующие изменения в названиях файлов, пространств имён (`namespace QuickPrintBridge...`);
- обновлён путь к временной папке в `appsettings.json` (`%TEMP%\\QuickPrintBridge`).
Этот код представляет базовый функционал проекта. Для полноценной работы потребуется дописать методы взаимодействия с конкретной CAD-системой (`GetCurrentModelPath`, экспорт модели) и протестировать на целевых ОС.