diff --git a/README.md b/README.md index 8b02352..d318f7b 100644 --- a/README.md +++ b/README.md @@ -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`, экспорт модели) и протестировать на целевых ОС. \ No newline at end of file