diff --git a/.github/RELEASE_POLICY.md b/.github/RELEASE_POLICY.md index fe8f07c..e956772 100644 --- a/.github/RELEASE_POLICY.md +++ b/.github/RELEASE_POLICY.md @@ -1,5 +1,7 @@ # 4FusionLab — automatic runtime release policy +[Русская версия](RELEASE_POLICY.ru.md) + ## Trigger - A direct push to `main` or a PR merge into `main` is the only normal release event. PR checks, manual CI dispatch and version-tag pushes **do not** initiate publication. diff --git a/.github/RELEASE_POLICY.ru.md b/.github/RELEASE_POLICY.ru.md new file mode 100644 index 0000000..226af4d --- /dev/null +++ b/.github/RELEASE_POLICY.ru.md @@ -0,0 +1,29 @@ +# 4FusionLab — политика автоматических релизов исполняемых компонентов + +[English](RELEASE_POLICY.md) + +## Запуск + +- Прямой push в `main` или объединение PR в `main` — единственное обычное событие релиза. Проверки PR, ручной запуск CI и отправка тегов версий **не** запускают публикацию. +- Перед публикацией сравнивайте `GITHUB_SHA` с последним **опубликованным** тегом GitHub Release, являющимся предком `main`. Если ZIP-релизов нет, используйте исходный диапазон push `github.event.before..GITHUB_SHA`. Удалённые и переименованные исполняемые файлы по-прежнему дают право на релиз. +- `.github/release-paths.txt` репозитория остаётся проверенным перечнем путей релиза. Изменения только README, руководств, тестов и CI **сами по себе не создают релиз**. Push только документации может восстановить ранее неудавшийся выпуск, если подходящие изменения после последнего опубликованного тега ещё не выпущены. +- Перед публикацией должны пройти все обязательные существующие проверки CI. При отказе проверки нет релиза, изменяемого тега и замены артефактов. + +## Версия и распространение + +- GitVersion.Tool **6.8.2** определяет числовую версию `MAJOR.MINOR.PATCH` по `GitVersion.yml` и полной истории Git. ZIP пакета, встроенный манифест Fusion (где применимо), автоматически созданный неизменяемый тег `vMAJOR.MINOR.PATCH` и GitHub Release соответствуют одному коммиту и версии. +- Конвейер создаёт тег **автоматически** при публикации GitHub Release. Участники никогда не создают и не отправляют теги релиза вручную. Существующий тег версии, указывающий на другой коммит, считается ошибкой; опубликованный релиз никогда не перезаписывается. +- При наличии используются проверенные заметки конкретной версии; иначе они автоматически создаются из истории Git. Подготовка файла заметок вручную только для выпуска изменения кода не требуется. +- Стабильные релизы становятся Latest. Предварительные выпуски никогда не становятся Latest. Проектные требования к нативной CAD-приёмке, тестам, подписанным архивам и контрольным суммам, совместимости ОС и публикации продолжают действовать. + +## Этот репозиторий + +Перечень исполняемых файлов: `filamentra/**`. После тестов Python публикуется версионированный ZIP исходников с контрольной суммой; это распространение кода, пока не установщик аддона Fusion. + +Если после последнего опубликованного релиза не изменились подходящие входные исполняемые файлы, CI может запуститься, но публикация пропускается, даже если GitVersion вычислит другую версию. После сбоя следующая отправка в `main` повторяет публикацию после успешного прохождения обычных проверок CI; опубликованные теги и артефакты никогда не перезаписываются. + +## Общие Actions релизов + +Общие определение GitVersion, проверка исполняемых изменений, заметки и проверенные ZIP-релизы используют Actions `4FusionLab/.github`, закреплённые за коммитом `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`. Репозиторий сохраняет независимо тестируемый сборщик исходников Filamentra на Python; ZIP не является готовым установщиком Autodesk Fusion. Дублирующие локальные помощники релизов удалены. + +**Платформа восстановления:** классификатор опубликованных релизов отдельно закреплён за `2e961620a068c3ad754f6e1be05fb6e4ac68e843` с `recover-unpublished: 'true'` и `github.token` только для чтения. Остальные общие Actions сохраняют проверенное закрепление `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`. diff --git a/AGENTS.md b/AGENTS.md index 0b0c5e6..19bb447 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,21 +1,23 @@ -# Разработка Filamentra +# Filamentra development -Filamentra — планируемый Fusion add-in для поиска филаментов и установки визуальных Appearances. Рабочие Python-модули существуют, но полного установочного аддона пока нет. +[Русская версия](AGENTS.ru.md) -## Общие правила 4FusionLab +Filamentra is a planned Fusion add-in for finding filaments and installing visual Appearances. Working Python modules exist, but a complete installable add-in does not yet exist. -- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель общего CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. -- Общайся и составляй планы на русском, код и UI Fusion — на английском. Сохраняй независимые README.md и README.ru.md. -- Перед изменениями изучай текущие файлы и Git-статус. Conventional Commits; предпочтительно PR с успешными проверками, прямой push в main допускается. -- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и формат пакета без миграционного плана. Не коммить секреты, токены или личные CAD-файлы. -- Где есть runtime, релиз создаёт push или merge в main только для файлов из .github/release-paths.txt после успешного CI. GitVersion.Tool 6.8.2, неизменяемый автоматический тег и GitHub Release; теги вручную не создавай. -- Изменение docs, README, тестов, AGENTS.md или CI само по себе не должно выпускать релиз. Общие Actions подключай только по конкретному commit SHA. -- Unit-тесты и ZIP не заменяют нативную проверку Autodesk Fusion. Сохраняй существующие ограничения и доказательства совместимости. +## Shared 4FusionLab rules -## Правила реализации +- Shared standards: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; shared CI model: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. +- Communicate and make plans in Russian; use English for code and Fusion UI. Retain separate README.md and README.ru.md. +- Inspect current files and Git status before changes. Use Conventional Commits; a PR with passing checks is preferred, and direct push to main is allowed. +- Do not change Fusion manifest UUIDs, command IDs, OS support or package format without a migration plan. Do not commit secrets, tokens or personal CAD files. +- Where runtime exists, a push or merge to main creates a release only for paths in .github/release-paths.txt after successful CI. Use GitVersion.Tool 6.8.2, an automatically created immutable tag and GitHub Release; do not create tags manually. +- Docs, README, tests, AGENTS.md or CI changes must not independently publish a release. Pin shared Actions only to a specific commit SHA. +- Unit tests and ZIPs do not replace native Autodesk Fusion validation. Preserve existing limitations and compatibility evidence. -- Сверяй реализованные возможности с README.md, README.ru.md и docs/ROADMAP.md. Не представляй задуманные UI, скачивание каталога или установку в Fusion как готовые функции. -- Основные модули: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py и filamentra/texture_generator.py. Сохраняй детерминизм, provenance и границы реального Fusion API. -- Данные Filamentra-DataSource — визуальные приближения, а не сертифицированные механические или оптические параметры. Не изобретай производителей, SKU и оттенки. -- Сейчас релиз распространяет исходный ZIP Python-модулей и SHA-256, а не готовый Fusion installer. Изменение формата пакета требует отдельной проверки. -- Выполняй `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` и проверку checksum. Нативную работу в Fusion утверждай только после отдельного CAD-теста. +## Implementation rules + +- Verify implemented capabilities against README.md, README.ru.md and docs/ROADMAP.md. Do not present planned UI, catalog downloads or installation in Fusion as completed functionality. +- Main modules: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py and filamentra/texture_generator.py. Preserve determinism, provenance and the boundaries of the actual Fusion API. +- Filamentra-DataSource data are visual approximations, not certified mechanical or optical parameters. Do not invent manufacturers, SKUs or shades. +- The release currently distributes a source ZIP of Python modules and SHA-256, not a finished Fusion installer. Changing the package format requires separate review. +- Run `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` and checksum verification. Claim native Fusion behavior only after a separate CAD test. diff --git a/AGENTS.ru.md b/AGENTS.ru.md new file mode 100644 index 0000000..a759ae8 --- /dev/null +++ b/AGENTS.ru.md @@ -0,0 +1,23 @@ +# Разработка Filamentra + +[English](AGENTS.md) + +Filamentra — планируемый Fusion add-in для поиска филаментов и установки визуальных Appearances. Рабочие Python-модули существуют, но полного установочного аддона пока нет. + +## Общие правила 4FusionLab + +- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель общего CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. +- Общайся и составляй планы на русском, код и UI Fusion — на английском. Сохраняй независимые README.md и README.ru.md. +- Перед изменениями изучай текущие файлы и Git-статус. Conventional Commits; предпочтительно PR с успешными проверками, прямой push в main допускается. +- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и формат пакета без миграционного плана. Не коммить секреты, токены или личные CAD-файлы. +- Где есть runtime, релиз создаёт push или merge в main только для файлов из .github/release-paths.txt после успешного CI. GitVersion.Tool 6.8.2, неизменяемый автоматический тег и GitHub Release; теги вручную не создавай. +- Изменение docs, README, тестов, AGENTS.md или CI само по себе не должно выпускать релиз. Общие Actions подключай только по конкретному commit SHA. +- Unit-тесты и ZIP не заменяют нативную проверку Autodesk Fusion. Сохраняй существующие ограничения и доказательства совместимости. + +## Правила реализации + +- Сверяй реализованные возможности с README.md, README.ru.md и docs/ROADMAP.md. Не представляй задуманные UI, скачивание каталога или установку в Fusion как готовые функции. +- Основные модули: filamentra/appearance_mapping.py, filamentra/fusion_appearance.py и filamentra/texture_generator.py. Сохраняй детерминизм, provenance и границы реального Fusion API. +- Данные Filamentra-DataSource — визуальные приближения, а не сертифицированные механические или оптические параметры. Не изобретай производителей, SKU и оттенки. +- Сейчас релиз распространяет исходный ZIP Python-модулей и SHA-256, а не готовый Fusion installer. Изменение формата пакета требует отдельной проверки. +- Выполняй `python -m unittest discover -s tests -v`, `python scripts/build_release.py --version X.Y.Z` и проверку checksum. Нативную работу в Fusion утверждай только после отдельного CAD-теста. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 48b96a8..42646fb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,5 +1,7 @@ # Contributing to Filamentra +[Русская версия](CONTRIBUTING.ru.md) + Thanks for helping improve Filamentra, a planned filament appearance catalog for Autodesk Fusion from [4FusionLab](https://github.com/4FusionLab). The project is in pre-development. Please open an [issue](https://github.com/4FusionLab/Filamentra/issues) to discuss significant technical changes or new catalog formats before implementing them. @@ -46,6 +48,6 @@ For bugs, include Fusion version, operating system, exact steps, actual vs expec ## License and code contributions -A project license has not yet been selected. Public visibility alone does not grant reuse rights. Before submitting substantial code or assets, coordinate the intended licensing and contribution terms with the maintainers. +Filamentra is distributed under the [PolyForm Noncommercial License 1.0.0](LICENSE). Commercial use outside its permitted purposes requires a separate agreement with 4FusionLab; third-party components retain their own licenses. Before submitting substantial code or assets, coordinate their licensing and contribution terms with the maintainers. Filamentra is independent of Autodesk and filament manufacturers. diff --git a/CONTRIBUTING.ru.md b/CONTRIBUTING.ru.md new file mode 100644 index 0000000..79560bd --- /dev/null +++ b/CONTRIBUTING.ru.md @@ -0,0 +1,53 @@ +# Участие в разработке Filamentra + +[English](CONTRIBUTING.md) + +Спасибо за помощь в развитии Filamentra — планируемого каталога внешних видов филаментов для Autodesk Fusion от [4FusionLab](https://github.com/4FusionLab). + +Проект находится на этапе подготовки к разработке. Перед реализацией существенных технических изменений или новых форматов каталога откройте [обсуждение](https://github.com/4FusionLab/Filamentra/issues). + +## Предложить филамент + +По возможности укажите следующие данные: + +- **Производитель:** официальное название бренда. +- **Серия:** точное семейство продуктов, например PLA Matte, PLA+ или PETG. +- **Название цвета:** официальное написание. +- **Идентификатор продукта:** SKU, код производителя или аналог при наличии. +- **Цветовой ориентир:** опубликованный производителем HEX/RGB или другой проверяемый источник, если доступен. +- **Отделка:** матовая, глянцевая, silk, полупрозрачная, композитная или другие документированные характеристики. +- **Источник:** ссылка на официальную страницу продукта или спецификации. +- **Дата проверки:** когда информация была проверена. + +Не угадывайте значения цвета или свойства поверхности. Если значение оценочное, обозначьте его как приближение и объясните причину. Сама по себе фотография продукта не является надёжным колориметрическим ориентиром. + +## Принципы данных + +1. ID каталога должен оставаться стабильным при изменении названий или свойств. +2. Не выдумывайте сочетания производителя, серии и цвета. +3. Не заменяйте незаметно подтверждённые источником значения предположениями. +4. Сохраняйте историю источников внешне проверяемых данных. +5. Не распространяйте защищённые изображения и материалы поставщиков без соответствующих прав. +6. Различайте свойства визуального Appearance и сертифицированные физические данные материала. + +## Принципы разработки + +- Логика чтения, проверки и синхронизации каталога должна тестироваться вне Fusion. +- Для изменения Design используйте поддерживаемые методы Autodesk Fusion API. +- Установка должна быть идемпотентной, а применение к выбранной геометрии — явным действием. +- Никогда не меняйте уже применённые внешние виды в сохранённой модели пользователя без намеренного действия обновления. +- Прежде чем заявлять поддержку поведения Fusion, проверьте его в реальном приложении. +- Документируйте ограничения и неудачные проверки совместимости. +- Предпочитайте небольшие, удобные для проверки изменения с кратким объяснением. + +Актуальные планы и этапы приведены в [docs/ROADMAP.md](docs/ROADMAP.ru.md). + +## Сообщения об ошибках + +Укажите версию Fusion, операционную систему, точные шаги, фактическое и ожидаемое поведение и, по возможности, минимальный пример. Не прикладывайте частные модели и проприетарные файлы производителей без разрешения. + +## Лицензия и вклад в код + +Filamentra распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых случаев требует отдельного соглашения с 4FusionLab; сторонние компоненты сохраняют собственные лицензии. Перед отправкой существенного кода или ресурсов согласуйте с сопровождающими их лицензирование и условия вклада. + +Filamentra не связана с Autodesk и производителями филаментов. diff --git a/docs/FUSION_APPEARANCE_ADAPTER.md b/docs/FUSION_APPEARANCE_ADAPTER.md index c8e5e95..cb81686 100644 --- a/docs/FUSION_APPEARANCE_ADAPTER.md +++ b/docs/FUSION_APPEARANCE_ADAPTER.md @@ -1,5 +1,7 @@ # Fusion Appearance adapter — transmission and haze +[Русская версия](FUSION_APPEARANCE_ADAPTER.ru.md) + Status: experimental SDK adapter, with offline mock tests only. The package does NOT contain a complete Palette or installer UI. No in-Fusion render, save or reopen test has been executed. diff --git a/docs/FUSION_APPEARANCE_ADAPTER.ru.md b/docs/FUSION_APPEARANCE_ADAPTER.ru.md new file mode 100644 index 0000000..a38e0f8 --- /dev/null +++ b/docs/FUSION_APPEARANCE_ADAPTER.ru.md @@ -0,0 +1,50 @@ +# Адаптер Fusion Appearance — пропускание и мутность + +[English](FUSION_APPEARANCE_ADAPTER.md) + +Статус: экспериментальный адаптер SDK, проверенный только автономными тестами с имитациями. Пакет НЕ содержит полноценную палитру или интерфейс установки. Рендеринг, сохранение и повторное открытие в Fusion не проверялись. + +## Сопоставление с Filamentra v1 + +Данные наследуются так же, как в исходном каталоге: пресет → линейка → цвет. + +| Поле | Сопоставление Autodesk Fusion | Точность | +| --- | --- | --- | +| HEX/непрозрачная alpha | `Appearance.color = Color.create(...)` | Прямое | +| `surface_type` | `AppearanceSurfaceTypes.*` и `Appearances.add` | Прямое | +| `roughness` | `Appearance.roughness` | Прямое при `haze = 0` | +| `normal_gl` | `Appearance.normalTexture` | Прямое при наличии локального ресурса | +| `textures.roughness` | `Appearance.roughnessTexture` | Прямое при `haze = 0` | +| `ior` | `appearanceProperties.itemById('transparent_ior').value` | Прямое при проверке во время выполнения | +| `attenuation_distance_mm` | `itemById('transparent_distance').value` | Прямое только при известных единицах и обратном чтении | +| `transmission` | `TransparentAppearanceSurface` вместо числового значения | Приблизительное; числовая интенсивность не применяется | +| `haze` | Более высокая шероховатость поверхности | Приблизительное; меняет отражения и не является объёмным рассеянием | + +Документированного независимого свойства Fusion API для мутности или точной числовой доли пропускания света НЕТ. Адаптер НЕ преобразует ни одно из них в alpha. Неподдерживаемые сопоставления, отсутствующие PBR-ресурсы, свойства только для чтения, нераспознанные единицы и снижение точности описываются в возвращаемом `FusionAppearanceReport` (`exact`, `approximate`, `unavailable`). + +Для мутных материалов безопаснее пропустить исходную карту шероховатости, чем позволить ей незаметно отменить числовую шероховатость, добавленную для имитации мутности. + +Адаптер преобразует расстояние затухания с помощью единиц, возвращаемых `FloatProperty.units`; если единицы установить не удалось, свойство отмечается как недоступное без предположений. Нейтральный цвет предпросмотра Clear — условность рендерера, а НЕ утверждение об измеренном HEX производителя. + +## Пример внутри Autodesk Fusion (июль 2026 и новее) + + from filamentra.fusion_appearance import install_catalog_color + + report = install_catalog_color( + design, line, color, presets_by_id, + texture_root="/path/to/local/extracted/catalog", + ) + print(report.exact) + print(report.approximate) + print(report.unavailable) + +Этот код устанавливает Appearance в Design. Он не применяет внешний вид к геометрии и не изменяет выбранные тела. + +Официальные источники: +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Appearance.htm +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_AppearanceSurfaceTypes.htm +https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_FloatProperty_units.htm + +## Приёмка в реальном Fusion не завершена + +Запустите тест на поддерживаемой сборке Fusion в macOS и Windows. Создайте PLA Translucent, PETG Translucent и PETG Clear в одном Design. Проверьте IOR, единицы затухания и шероховатость. Выполните рендер образцов с толщиной стенки 0,8, 2 и 10 мм с фиксированным логотипом 4FusionLab позади них. Проверьте сохранение и повторное открытие и опишите различия между окном Design и рабочей средой Render. Без этой проверки не заявляйте полную оптическую эквивалентность Filamentra Pages. diff --git a/docs/MULTICOLOR_RENDERING.md b/docs/MULTICOLOR_RENDERING.md index 506bdbb..885e7a3 100644 --- a/docs/MULTICOLOR_RENDERING.md +++ b/docs/MULTICOLOR_RENDERING.md @@ -1,5 +1,7 @@ # Multicolor preview renderer — experimental +[Русская версия](MULTICOLOR_RENDERING.ru.md) + Filamentra includes an **offline PNG generator** for manufacturer RGBA display swatches and a **small experimental Fusion API adapter**. The end-to-end Add-In has not yet been tested in Autodesk Fusion and is not ready for release. ## Goals and modes diff --git a/docs/MULTICOLOR_RENDERING.ru.md b/docs/MULTICOLOR_RENDERING.ru.md new file mode 100644 index 0000000..e239db4 --- /dev/null +++ b/docs/MULTICOLOR_RENDERING.ru.md @@ -0,0 +1,64 @@ +# Рендерер многоцветного предпросмотра — экспериментальная версия + +[English](MULTICOLOR_RENDERING.md) + +Filamentra содержит **автономный генератор PNG** для отображаемых производителями образцов RGBA и **небольшой экспериментальный адаптер Fusion API**. Полный сценарий аддона ещё не проверен в Autodesk Fusion и не готов к выпуску. + +## Цели и режимы + +- Solid: один проверенный цвет производителя; используется напрямую `Appearance.color` (здесь не реализовано). +- Multicolor / подобие коэкструзии: создание резких **цветовых полос в UV** по двум или более опубликованным образцам. +- Gradient / rainbow: создание плавных **UV-градиентов** между опубликованными образцами RGBA. + +Все узоры — **предпросмотр в UV-пространстве**, а не физическая симуляция экструзии филамента. Распределение оттенков на напечатанной детали зависит от оси печати, траекторий слайсера, подачи филамента, положения катушки, расположения пигментов при экструзии и геометрии. Filamentra не может вывести эти данные только из образцов. + +Для записей с несколькими цветами необязательный объект `rendering` управляет предпросмотром по умолчанию. При его отсутствии генератор выбирает `uv_bands` для `color_mode="multicolor"` и `uv_gradient` для `color_mode="gradient"`. В будущем интерфейс сможет менять направление и число повторов во время выполнения. Источник данных рендеринга всегда должен быть `filamentra_estimate`. + +## Автономная генерация PNG + + from filamentra.texture_generator import render_to_cache + + shade = { + "color_mode": "multicolor", + "rgba_swatches": ["#3D3D3FFF", "#EC4235FF"] + } + texture_path = render_to_cache(shade, "/tmp/filamentra-cache", 512, 512) + +Функция использует только стандартную библиотеку Python (без PIL, NumPy и внешних сетевых запросов), записывает детерминированный RGBA PNG и кеширует его по хешу содержимого. Сохраняются все каналы образца производителя, включая alpha; непрозрачность отображаемого образца **не** равна измеренному объёмному пропусканию света. Сейчас градиент интерполирует значения каналов в кодированном sRGB; это алгоритм предпросмотра, а не спектральное смешение. + +## Адаптер Fusion API — только ручной тест + + from filamentra.fusion_appearance import install_preview_appearance + + # Требуются существующий adsk.fusion.Design и созданный texture_path. + appearance = install_preview_appearance( + design, + "Filamentra | esun/pla-matte-dual/black-red", + texture_path, + roughness=0.86 + ) + +Адаптер вызывает `Design.appearances.add`, подключает `Appearance.colorTexture`, затем шероховатость. Он намеренно не назначает Appearance геометрии, не обрабатывает постоянные идентификаторы и не предоставляет палитру. Целевая версия API — Fusion за июль 2026 года и новее. + +Autodesk: +- https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Appearances_add.htm +- https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Appearance_colorTexture.htm +- https://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/files/core_Appearance.htm + +## Проверка и следующие шаги реализации + +Запустите тесты без Fusion: + + python -m unittest discover -s tests -v + +Затем вручную проверьте Autodesk Fusion на Windows и macOS на кубе, цилиндре и криволинейной детали: + +1. Создайте внешний вид без изменения геометрии. +2. Проверьте направление UV-проекции, швы и повторение для примеров с двумя и четырьмя цветами. +3. Выполните рендер в окне Design и в рабочей среде Render. +4. Сохраните и повторно откройте модель; убедитесь, что встроенная текстура и шероховатость сохранились. +5. Прежде чем заявлять визуальную калибровку, проверьте реальные напечатанные образцы при контролируемом освещении. + +**Не реализовано:** мост HTML Palette, элементы управления UV-проектором, пресеты направления для геометрии, обнаружение дубликатов, пользовательский поворот, Apply to Selection, загрузки релизов каталога и проверенная физическая оптическая симуляция. Позиционирование градиента по слоям требует данных слайсера или принтера и явно не входит в задачи текущего генератора текстур. + +Исходные данные и подсказки для предпросмотра находятся в [Filamentra-DataSource](https://github.com/4FusionLab/Filamentra-DataSource). Рендеринг и интеграция с Fusion находятся в этом репозитории. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 637f824..dbc7652 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,5 +1,7 @@ # Filamentra — Roadmap +[Русская версия](ROADMAP.ru.md) + > Planning document. The milestones below are targets, not promises or completed functionality. ## Guiding principles diff --git a/docs/ROADMAP.ru.md b/docs/ROADMAP.ru.md new file mode 100644 index 0000000..836896c --- /dev/null +++ b/docs/ROADMAP.ru.md @@ -0,0 +1,85 @@ +# Filamentra — дорожная карта + +[English](ROADMAP.md) + +> Плановый документ. Указанные этапы — цели, а не обещания или завершённые функции. + +## Основные принципы + +- **Сначала визуальный внешний вид.** Filamentra — каталог внешних видов филаментов, а не база механических свойств. +- **Установка по запросу.** Каталог находится вне модели Fusion; в активной модели создаются только выбранные внешние виды. +- **Без повторных установок.** Записи каталога определяются по стабильным ID, а не только по изменяемым отображаемым названиям. +- **Не перекрашивать автоматически.** Установка внешнего вида не должна изменять геометрию или применять отделку без явного действия. +- **Проверяемые данные каталога.** Записывайте источники и чётко различайте цвета производителя и приближения. +- **Проверка в реальном Fusion.** Автономные модульные тесты необходимы, но недостаточны для утверждений о совместимости API. + +## Этап 0 — осуществимость API + +- Подтвердить поддерживаемые методы создания и изменения Appearance по актуальной официальной документации Fusion API. +- Подтвердить, какие атрибуты и идентификаторы могут сохраняться в Appearance или Design. +- Подготовить прототип моста HTML Palette ↔ Python и жизненного цикла его событий. +- Зафиксировать результаты и ограничения совместимости API. + +**Критерий завершения:** один чётко определённый и документированный способ создать и определить визуальный внешний вид в активной модели Fusion. + +## Этап 1 — Palette и Install + +- Минимальная палитра с небольшим встроенным тестовым каталогом. +- Установка одного визуального Appearance в текущую модель без его применения. +- Обнаружение уже установленного ID каталога. +- Проверка сохранения и повторного открытия, нескольких попыток установки и переключения документов. +- Явное различие состояний ожидания, ошибки и установки. + +**Приёмка Fusion:** создание и сохранность внешнего вида, правильный цвет, отсутствие дубликатов. + +## Этап 2 — модель данных и просмотр каталога + +- Версионированная JSON-схема производителя, серии, цветов, отделки, источников и стабильных ID. +- Просмотр и поиск записей каталога. +- Локальная проверка дубликатов ID, неверных цветов, несогласованных источников и путей. +- Первоначальное заполнение небольшой проверенной по источникам подборкой реальных филаментов. + +**Критерий завершения:** проверка каталога работает без Autodesk. + +## Этап 3 — применение внешнего вида + +- Явное действие Apply to Selection для поддерживаемой геометрии Fusion. +- Список установленных материалов для активной модели. +- Безопасное удаление неиспользуемых внешних видов, когда Fusion это допускает. +- Сохранение ID каталога и отпечатков содержимого для надёжного сопоставления. + +**Приёмка Fusion:** меняется только выбранная геометрия; повторные операции не создают дубликаты. + +## Этап 4 — распространение через GitHub и автономный кеш + +- Версионированный каталог на GitHub. +- Локальный кеш с автономным резервным режимом. +- Проверка обновлений и обработка ошибок без прерывания моделирования. +- Отсутствие незаметных изменений внешнего вида, уже используемого в сохранённых моделях. + +## Этап 5 — точность поверхности и расширение каталога + +- Проверка профилей отделки: матовой, глянцевой, silk, полупрозрачной и композитной. +- Добавление текстур только после проверки поведения официального Fusion API. +- Расширение каталога по производителям, сериям и официальным цветовым вариантам. +- Проверка поддерживаемых конфигураций macOS и Windows. + +## Пока не входит в область проекта + +- Запись и изменение файлов Autodesk `.adsklib`. +- Сертифицированные данные плотности, механических свойств или наборы FEA/CAE. +- Гарантированная колориметрическая точность относительно напечатанного объекта. +- Среда выполнения Inventor, обратная разработка проприетарного формата библиотек Autodesk или отдельный сборщик ADSKLIB. +- Незаметная замена внешних видов, изменённых пользователем. + +## Результаты приёмки + +Для каждого этапа, зависящего от Fusion, фиксируйте: + +- Версию Fusion и операционную систему. +- Точный проверенный образец каталога. +- Что выполнено вручную, а что автоматически. +- Фактические результаты, ошибки и, где полезно, скриншоты. +- Оставшиеся риски совместимости. + +Не отмечайте этап Fusion как пройденный без выполнения его проверок в Fusion.