Обновить README.md

This commit is contained in:
2025-11-06 23:54:05 +03:00
parent 092454a75b
commit e24e853f2d

108
README.md
View File

@@ -1,39 +1,71 @@
# QuickPrintBridge ### README.md для проекта «QuickPrint Bridge»
### README.md для проекта «QuickPrint Bridge» **QuickPrint Bridge** — инструмент для молниеносной отправки 3D-моделей на печать через веб-ссылки в любой слайсер. Если слайсер не поддерживает веб-интеграцию — модель автоматически экспортируется в формате **3MF**.
**QuickPrint Bridge** — инструмент для молниеносной отправки 3D-моделей на печать через веб-ссылки в любой слайсер. Если слайсер не поддерживает веб-интеграцию — модель автоматически экспортируется в формате **3MF**. #### 🔧 Функционал
- мгновенная отправка модели в слайсер по веб-ссылкам (`prusaslicer://`, `bambustudio://`, `cura://` и др.);
#### 🔧 Функционал - автоматический экспорт в 3MF при отсутствии поддержки веб-ссылок у слайсера;
- мгновенная отправка модели в слайсер по веб-ссылкам (`prusaslicer://`, `bambustudio://`, `cura://` и др.); - совместимость с любыми слайсерами, поддерживающими указанные протоколы или формат 3MF;
- автоматический экспорт в 3MF при отсутствии поддержки веб-ссылок у слайсера; - простой интерфейс с одной кнопкой «Отправить на печать»;
- совместимость с любыми слайсерами, поддерживающими указанные протоколы или формат 3MF; - визуальное отображение статуса операции (успех/ошибка).
- простой интерфейс с одной кнопкой «Отправить на печать»;
- визуальное отображение статуса операции (успех/ошибка). #### ✅ Поддерживаемые ОС и технологии
- **ОС:** Windows 10/11 (64-бит);
#### ✅ Поддерживаемые ОС и технологии - **Платформа:** .NET 8 (WPF, MVVM);
- **ОС:** Windows 10/11 (64-бит); - **Интеграция с CAD:** через COM-интерфейсы (например, KOMPAS-3D V21+);
- **Платформа:** .NET 8 (WPF, MVVM); - **Форматы:** STL (для передачи), 3MF (резервный экспорт).
- **Интеграция с CAD:** через COM-интерфейсы (например, KOMPAS-3D V21+);
- **Форматы:** STL (для передачи), 3MF (резервный экспорт). #### 📥 Системные требования
- установленный слайсер (PrusaSlicer, Bambu Studio, Cura и др.);
#### 📥 Системные требования - .NET 8 Runtime (устанавливается автоматически);
- установленный слайсер (PrusaSlicer, Bambu Studio, Cura и др.); - CAD-система с поддержкой COM-интерфейсов (например, КОМПАС-3D);
- .NET 8 Runtime (устанавливается автоматически); - права на запись в папку временных файлов (`%TEMP%`).
- CAD-система с поддержкой COM-интерфейсов (например, КОМПАС-3D);
- права на запись в папку временных файлов (`%TEMP%`). #### 🛠 Установка
1. Скопируйте `QuickPrintBridge.dll` в папку `C:\Program Files\ASCON\KOMPAS-3D VXX\Libs\`.
#### 🛠 Установка 2. Зарегистрируйте плагин в реестре:
1. Скопируйте `QuickPrintBridge.dll` в папку `C:\Program Files\ASCON\KOMPAS-3D VXX\Libs\`. - откройте `regedit`;
2. Зарегистрируйте плагин в реестре: - перейдите в `HKEY_LOCAL_MACHINE\SOFTWARE\ASCON\KOMPAS-3D\VXX\AddIns`;
- откройте `regedit`; - создайте новый ключ с GUID;
- перейдите в `HKEY_LOCAL_MACHINE\SOFTWARE\ASCON\KOMPAS-3D\VXX\AddIns`; - добавьте параметры: `Path` (путь к DLL), `Name` («QuickPrint Bridge»), `LoadAtStart` (`1`).
- создайте новый ключ с GUID; 3. Запустите КОМПАС-3D — плагин появится в меню «Приложения».
- добавьте параметры: `Path` (путь к DLL), `Name` («QuickPrint Bridge»), `LoadAtStart` (`1`).
3. Запустите КОМПАС-3D — плагин появится в меню «Приложения». #### 🖨 Использование
1. Откройте 3D-модель в CAD-системе.
#### 🖨 Использование 2. Запустите плагин через меню «Приложения» → «QuickPrint Bridge».
1. Откройте 3D-модель в CAD-системе. 3. Нажмите «Отправить на печать».
2. Запустите плагин через меню «Приложения» → «QuickPrint Bridge». 4. Модель будет передана в слайсер или экспортирована в 3MF (в зависимости от настроек слайсера).
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`, экспорт модели) и протестировать на целевых ОС.