Обновить 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**.
#### 🔧 Функционал
- мгновенная отправка модели в слайсер по веб-ссылкам (`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 (в зависимости от настроек слайсера).
**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`, экспорт модели) и протестировать на целевых ОС.