diff --git a/README.md b/README.md index d54b2f1..ac7ccaf 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,44 @@ -# Mesora - -Mesora is an experimental Autodesk Fusion add-in for informational 3D dimensions. -The experimental build is available under Design → Solid → Inspect → Mesora — Add -Dimension. Select geometry repeatedly to build a table of measurements. Two point -selections form one distance; each other supported selection forms its own row. -Each row has a session ID and a choice of compatible measurement types. Select a -row and use Remove selected to delete it; Cancel point clears an unfinished pair. -The same menu provides show/hide, refresh and clear. Use disposable documents while testing. - -The planned MVP keeps dimension definitions in memory only. Nothing is intentionally -written to `Design.attributes`; closing the document or stopping the add-in loses the -session dimensions. CustomGraphics can mark a document modified even when groups are -deleted. Fusion may serialize CustomGraphics into an inaccessible persistent artifact; -removing groups in `documentSaving` and restoring after `documentSaved` is implemented -but has not been validated by save/reopen testing. It is not a safety guarantee. Use -only disposable documents, and do not save them with the experimental build enabled. - -The source package is in `Mesora/`. Unit tests run with: +

Mesora for Autodesk Fusion

+

Informational dimensions, in the model.
Measure supported geometry and keep a table of 3D dimensions for the current session.

+ +

Download experimental 1.0.0 · Русский · Report a problem

+ +> **Experimental: use disposable documents only.** Save and reopen safety has not been established. Do not save documents while this build is enabled: Fusion CustomGraphics may leave an inaccessible persistent artifact even after graphics are removed. The implemented remove-before-save and restore-after-save behavior is unverified and is not a safety guarantee. See [safety research](docs/fusion-safety.md). + +## Measure in context + +Open **Design → Solid → Inspect → Mesora — Add Dimension**, select geometry, and build a table of measurements. Rows have session IDs such as `m1`; edit their geometry, choose a compatible measurement type, adjust the placement offset, or remove rows. Confirm the command to display the dimensions. The Mesora menu also provides visibility, refresh, and removal commands. + +Depending on the selected geometry, the table offers **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area**, or **Perimeter**. Distance and angle use two compatible objects; other types use one supported object. The choices depend on the selection, and unsupported combinations are rejected. + +## Install and try + +1. Download `Mesora-1.0.0.zip` from the [experimental release](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) and extract it to a permanent folder. +2. In Fusion, open **Utilities → Scripts and Add-Ins → Add-Ins**. Use **+ → Script or add-in from device** and select the `Mesora` folder containing `Mesora.py` and `Mesora.manifest`. +3. Select **Mesora → Run**. If desired, enable **Run on Startup**; observe the safety warning above whenever the add-in is enabled. +4. Open a disposable design and use **Design → Solid → Inspect → Mesora — Add Dimension**. Select one or two objects for a row, review the compatible type and preview, then confirm. + +Keep the extracted folder in place while Fusion uses it. No separate Python installation is needed for the release archive. + +## Status and limits + +- Measurements are **session-only**. Definitions are kept in memory, not intentionally written to `Design.attributes`; closing the document or stopping the add-in loses them. +- Creating or deleting CustomGraphics can mark a document as modified. Save/reopen behavior remains unverified; the warning above applies even when graphics have been cleared. +- Read-only measurements and direct graphic creation/deletion were tried in macOS Fusion. The command was exercised on a temporary macOS design using programmatic selection events and UI confirmation. Physical picking, broader event lifecycle, appearance and rotation, transformed or nested occurrences, and Windows remain to be validated. Offline tests do not establish native Fusion acceptance. +- The manifest declares Windows and macOS; that declaration is not evidence of native testing on both systems. + +## Development and support + +The add-in source is in `Mesora/`. To run offline tests or build a local archive: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -Native read-only measurement and direct render/create/delete calls have been tried on -macOS Fusion. The command was exercised on a temporary macOS design using programmatic Fusion -selection events and UI confirmation. Physical picking, broader event lifecycle, safe -save/reopen, transformed occurrences, Windows, and appearance/rotation acceptance remain open. -See [research and test notes](docs/fusion-safety.md). - -## Installation - -Build `python3 scripts/build.py --version 1.0.0`, extract the ZIP into the Fusion AddIns directory so that `Mesora/Mesora.manifest` and `Mesora/Mesora.py` are directly inside the extracted folder, then start Mesora from Fusion's Add-Ins dialog. The ZIP is also intended for GitHub Releases when published. Restarting or stopping the add-in clears session measurements. +[Safety and test notes](docs/fusion-safety.md) · [Development](docs/DEVELOPMENT.md) · [Contributing](CONTRIBUTING.md) · [Report a problem](https://github.com/4FusionLab/Mesora/issues) Mesora is available under the [PolyForm Noncommercial License 1.0.0](LICENSE). Commercial use outside its permitted purposes requires a separate agreement with the copyright holder; contact 4FusionLab. + +Mesora is an independent [4FusionLab](https://github.com/4FusionLab) project and is not affiliated with or endorsed by Autodesk. diff --git a/README.ru.md b/README.ru.md index f5d9034..50ea717 100644 --- a/README.ru.md +++ b/README.ru.md @@ -1,28 +1,44 @@ -# Mesora +

Mesora для Autodesk Fusion

+

Информационные размеры прямо в модели.
Измеряйте поддерживаемую геометрию и собирайте таблицу 3D-размеров на время сеанса.

-Mesora — экспериментальный аддон Autodesk Fusion для информационных 3D-размеров. -Откройте Design → Solid → Inspect → Mesora — Add Dimension и последовательно выбирайте геометрию, чтобы заполнить таблицу измерений. Две точки образуют расстояние; для каждой строки можно выбрать совместимый тип измерения. В том же меню доступны показ, обновление и очистка размеров. Используйте только тестовые документы. +

Скачать экспериментальную версию 1.0.0 · English · Сообщить о проблеме

-Для MVP определения размеров хранятся только в памяти. Аддон намеренно не записывает -их в `Design.attributes`: при закрытии документа или остановке аддона они теряются. -Создание и удаление CustomGraphics может пометить документ изменённым. Из-за бага -Fusion графика, присутствующая при сохранении, может стать неудаляемой. Удаление перед -сохранением и восстановление после него реализованы, но **не проверены сохранением и -повторным открытием** и не дают гарантии безопасности. Для испытаний используйте -только тестовые документы; пока не сохраняйте их при включённой сборке. +> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.md). -Исходники аддона находятся в `Mesora/`. Автономные тесты запускаются командой: +## Измерения в контексте модели + +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть сеансовые идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. + +## Установка и первый запуск + +1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +2. В Fusion откройте **Utilities → Scripts and Add-Ins → Add-Ins**. Нажмите **+ → Script or add-in from device** и выберите папку `Mesora` с файлами `Mesora.py` и `Mesora.manifest`. +3. Выберите **Mesora → Run**. При желании включите **Run on Startup**; пока аддон включён, учитывайте предупреждение выше. +4. Откройте тестовую модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. + +Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. + +## Статус и ограничения + +- Измерения существуют **только в текущем сеансе**. Определения хранятся в памяти и намеренно не записываются в `Design.attributes`; при закрытии документа или остановке аддона они теряются. +- Создание или удаление CustomGraphics может пометить документ изменённым. Сохранение и повторное открытие не проверены; предупреждение выше действует и после очистки графики. +- На macOS Fusion опробованы измерения без записи и прямое создание и удаление графики. Команда проверялась на временной модели с программными событиями выбора и подтверждением в интерфейсе. Физический выбор мышью, другие события, внешний вид и поворот, трансформированные и вложенные экземпляры, а также Windows ещё требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS; это не подтверждает нативную проверку на обеих системах. + +## Разработка и поддержка + +Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -На macOS Fusion проверены отдельные измерения и прямое создание/удаление графики. -Интерактивный сценарий команд, события, сохранение, трансформации компонентов и -Windows ещё требуют проверки. Подробности — в [заметках](docs/fusion-safety.md). - -## Установка - -Соберите архив командой `python3 scripts/build.py --version 1.0.0` и распакуйте его в каталог AddIns Fusion: файлы `Mesora.manifest` и `Mesora.py` должны находиться непосредственно в папке `Mesora`. Затем запустите Mesora в диалоге Add-Ins. Остановка или перезапуск аддона удаляет сеансовые размеры. +[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. + +Mesora — независимый проект [4FusionLab](https://github.com/4FusionLab), не связанный с Autodesk и не одобренный ею. diff --git a/README_RU.md b/README_RU.md index f5d9034..50ea717 100644 --- a/README_RU.md +++ b/README_RU.md @@ -1,28 +1,44 @@ -# Mesora +

Mesora для Autodesk Fusion

+

Информационные размеры прямо в модели.
Измеряйте поддерживаемую геометрию и собирайте таблицу 3D-размеров на время сеанса.

-Mesora — экспериментальный аддон Autodesk Fusion для информационных 3D-размеров. -Откройте Design → Solid → Inspect → Mesora — Add Dimension и последовательно выбирайте геометрию, чтобы заполнить таблицу измерений. Две точки образуют расстояние; для каждой строки можно выбрать совместимый тип измерения. В том же меню доступны показ, обновление и очистка размеров. Используйте только тестовые документы. +

Скачать экспериментальную версию 1.0.0 · English · Сообщить о проблеме

-Для MVP определения размеров хранятся только в памяти. Аддон намеренно не записывает -их в `Design.attributes`: при закрытии документа или остановке аддона они теряются. -Создание и удаление CustomGraphics может пометить документ изменённым. Из-за бага -Fusion графика, присутствующая при сохранении, может стать неудаляемой. Удаление перед -сохранением и восстановление после него реализованы, но **не проверены сохранением и -повторным открытием** и не дают гарантии безопасности. Для испытаний используйте -только тестовые документы; пока не сохраняйте их при включённой сборке. +> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.md). -Исходники аддона находятся в `Mesora/`. Автономные тесты запускаются командой: +## Измерения в контексте модели + +Откройте **Design → Solid → Inspect → Mesora — Add Dimension**, выбирайте геометрию и собирайте таблицу измерений. У строк есть сеансовые идентификаторы, например `m1`: можно изменить геометрию, выбрать совместимый тип измерения, настроить отступ и удалить строку. Подтвердите команду, чтобы показать размеры. В меню Mesora также доступны показ и скрытие, обновление и удаление размеров. + +В зависимости от выбранной геометрии доступны **Distance**, **Angle**, **Edge Length**, **Radius**, **Diameter**, **Area** и **Perimeter**. Для расстояния и угла выбираются два совместимых объекта, для остальных типов — один поддерживаемый объект. Доступные варианты зависят от выбора; неподдерживаемые сочетания отклоняются. + +## Установка и первый запуск + +1. Скачайте `Mesora-1.0.0.zip` со страницы [экспериментального релиза](https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0) и распакуйте архив в постоянную папку. +2. В Fusion откройте **Utilities → Scripts and Add-Ins → Add-Ins**. Нажмите **+ → Script or add-in from device** и выберите папку `Mesora` с файлами `Mesora.py` и `Mesora.manifest`. +3. Выберите **Mesora → Run**. При желании включите **Run on Startup**; пока аддон включён, учитывайте предупреждение выше. +4. Откройте тестовую модель и выберите **Design → Solid → Inspect → Mesora — Add Dimension**. Укажите один или два объекта для строки, проверьте совместимый тип и предпросмотр, затем подтвердите команду. + +Не перемещайте распакованную папку, пока Fusion использует аддон. Для готового архива отдельная установка Python не нужна. + +## Статус и ограничения + +- Измерения существуют **только в текущем сеансе**. Определения хранятся в памяти и намеренно не записываются в `Design.attributes`; при закрытии документа или остановке аддона они теряются. +- Создание или удаление CustomGraphics может пометить документ изменённым. Сохранение и повторное открытие не проверены; предупреждение выше действует и после очистки графики. +- На macOS Fusion опробованы измерения без записи и прямое создание и удаление графики. Команда проверялась на временной модели с программными событиями выбора и подтверждением в интерфейсе. Физический выбор мышью, другие события, внешний вид и поворот, трансформированные и вложенные экземпляры, а также Windows ещё требуют проверки. Автономные тесты не подтверждают приёмку в Fusion. +- В манифесте заявлены Windows и macOS; это не подтверждает нативную проверку на обеих системах. + +## Разработка и поддержка + +Исходники аддона находятся в `Mesora/`. Автономные тесты и локальная сборка: ```sh python3 -m unittest discover -s tests -v +python3 scripts/check_project.py +python3 scripts/build.py --version 1.0.0 ``` -На macOS Fusion проверены отдельные измерения и прямое создание/удаление графики. -Интерактивный сценарий команд, события, сохранение, трансформации компонентов и -Windows ещё требуют проверки. Подробности — в [заметках](docs/fusion-safety.md). - -## Установка - -Соберите архив командой `python3 scripts/build.py --version 1.0.0` и распакуйте его в каталог AddIns Fusion: файлы `Mesora.manifest` и `Mesora.py` должны находиться непосредственно в папке `Mesora`. Затем запустите Mesora в диалоге Add-Ins. Остановка или перезапуск аддона удаляет сеансовые размеры. +[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues) Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab. + +Mesora — независимый проект [4FusionLab](https://github.com/4FusionLab), не связанный с Autodesk и не одобренный ею.