🇬🇧 OFFICIAL DOCUMENTATION (ENGLISH VERSION)

UV Retopo Add-on — User Manual

Version: 1.92.0 | Target Software: Blender 4.1+

1. Introduction

UV Retopo is a cutting-edge topology engine for complex garments and organic models. Instead of manually wrapping polygons around a 3D shape, you build a perfect, flat quad-grid in 2D space (like sewing patterns). The engine then mathematically projects, snaps, and stitches this grid onto your 3D Highpoly model, perfectly preserving UV islands.

2. Recommended Pipelines

Variant A: Using Fill Grid (Automated Workflow)

1. Preparation: In the Select Objects panel, assign your Highpoly model. Create an empty mesh for Retopo and a 2D Plane.

2. Analyze: Click 1-Click Prepare Highpoly. The engine will automatically find borders, internal holes, and generate 3D attachment curves.

3. Perimeters: Adjust the Target Edge Length (mesh density) and click Build Perimeters.

4. Fill: Select the generated perimeters (including internal holes) and click Fill Grid. The area will be filled with mathematically perfect Coons patches.

5. Evaluate: Turn on Live Preview to see the 3D volume, UVs, and materials in real-time.

6. Normalize: Click Auto-Sync & Normalize All to resolve any vertex deficits across seams.

7. Finalize: Click Snap To Highpoly (bakes the 3D form) and then Stitch Seams (fuses the 3D geometry).

Variant B: Fully Manual Topology Creation

1. Perform steps 1 and 2 from Variant A (1-Click Prepare Highpoly).

2. Click Create Retopo Endpoints to generate structural corner vertices on the 2D plane.

3. Enter Edit Mode. Select Endpoints and manually extrude (E key) geometry to build boundaries and fill faces using standard Blender tools. Enable Clamp Mode for perfectly straight lines.

4. Click Check & Fix Endpoints to clean up any cloned endpoint IDs created during manual extrusion.

5. Select your seam boundaries and click Auto-Sync & Normalize All (turn OFF Even Spacing to preserve your custom vertex spacing proportions).

6. Finalize using Snap To Highpoly and Stitch Seams.

3. Complete UI Breakdown

Panel 1: Select Objects

• Highpoly: Your dense target mesh (e.g., from Marvelous Designer).

• Retopo: The active mesh where you build the 2D topology.

• Live Mesh: An auto-generated proxy mesh used for the 3D Live Preview.

• Plane: A 2D bounding box defining your flat workspace.

Panel 2: Highpoly Preparation

• 1-Click Prepare Highpoly: The core setup button. It scans the Highpoly, detects outer borders and internal holes, generates 3D curves, and applies a UV checker material automatically.

• Advanced:

  • HP Chain ID / Select HP Chain: Debug tools to visually inspect detected Highpoly boundary chains.

  • Curve Thickness / Z Offset: Adjusts the visual thickness and Z-height of the generated 3D reference curves.

Panel 3: Base Retopology

• Create Retopo Endpoints: Generates structural corner vertices on the 2D plane.

• Check & Fix Endpoints: Scans for duplicated endpoints (caused by manual extrusion) and strips their hidden IDs, leaving only the "true" corners.

• Target Edge Length: Defines the density of the generated mesh.

• Build Perimeters: Generates 2D outlines (including around holes) based on the target length.

• Fill Grid: Mathematically fills the selected boundaries with a perfect quad-grid (Coons Patch).

• Patch Operations:

  • Sync Manual Edits: Updates the patch grid if you manually move boundary vertices.

  • Unlink: Destroys the mathematical patch data, turning the grid into standard "dead" geometry for unrestricted manual editing.

  • Force Update Patch: Forces a surface recalculation.

• Grid Alignment Settings: Sliders to adjust tension and smoothing across the patch grid.

Panel 4: Preview Settings

• Live Preview (ON/OFF): Activates real-time 3D projection. Any edit to the 2D mesh is instantly reflected in 3D (Zero-Lag) with full UV/Material sync.

• Show/Hide Patch Overlay: Toggles a color-coded X-Ray GPU overlay to visually distinguish generated Coons patches.

• Enable Thickness / Thickness / Offset: Dynamically applies a Solidify modifier to the Live Mesh to evaluate fabric volume.

Panel 5: Retopo Clamp Mode

• Clamp Mode (ON/OFF): Constrains vertex movement strictly along the X or Y axis. Essential for manual 2D alignment.

Panel 6: Seam Management

• Recalculate Seam Membership: Forces the engine to re-evaluate which vertices belong to which seams (use after knife cuts).

• Even Spacing (Equal): * ON: Vertices on seams are distributed with perfectly equal mathematical spacing.

  • OFF: Preserves your manual 2D spacing edits, intelligently projecting those exact proportions onto the 3D curve.

• Auto-Sync & Normalize All: A powerful tool that finds paired seams, calculates missing vertices, adds loop cuts, and perfectly aligns both sides for flawless stitching.

• Advanced: Tools to inspect specific boundary chains on the Retopo mesh.

Panel 7: Finalize (Snap & Stitch)

• Selected Only: Applies snapping/flattening only to the active selection.

• Snap To Highpoly: Bakes the flat 2D topology onto the 3D surface (matching the Live Preview) and permanently applies Solidify thickness.

• Flatten to 2D: Instantly unwraps the 3D mesh back to a perfect flat 2D state using baked UVs.

• Mark/Clear Ignore: Mark inner edges (like folded hems) to "Ignore". They will snap perfectly but will not weld during stitching, preventing non-manifold geometry errors.

• Stitch Seams: Surgically fuses 3D seams using a Point-Merge algorithm. Fuses the 3D vertices but perfectly preserves their independent UV coordinates.

4. Changelog & History

• v1.92.0 (The Ultimate Performance Update): Extreme $O(1)$ Live Mode optimization—zero FPS drops when editing heavy meshes. Introduced Execution Lock (Mute) to prevent UV tearing during bulk geometry generation. Full UI and tooltip localization in 5 languages (EN, RU, ES, JP, ZH).

• v1.89.0 (The Hole & Workflow Update): Full Automatic Hole Detection (pockets, buttonholes). Introduced "1-Click Prepare Highpoly". Rebuilt modular 7-panel UI. Added Patch X-Ray GPU Overlay. Seam synchronization rebuilt with Master-Slave hierarchy.

• v1.86.6: Massively improved Live Mode via unified 2D BVH caching. 100% flawless sub-polygon UV and Material projection accuracy.

• v1.86.0: Introduced Live 3D Preview Mode, Auto-Material sync, and dynamic Solidify.

• v1.77.0: Legacy stable version.

  ---

  ---

  🇷🇺 ОФИЦИАЛЬНАЯ ДОКУМЕНТАЦИЯ (РУССКАЯ ВЕРСИЯ)

  UV Retopo Add-on — Руководство пользователя

  Версия: 1.92.0 | Платформа: Blender 4.1+

  1. Введение

  UV Retopo — это передовой инструмент для создания идеальной квад-топологии сложной одежды и органики. Вместо ручной обтяжки 3D-формы полигонами, аддон позволяет вам выстроить плоскую сетку в 2D-пространстве (как швейные выкройки), а затем математически спроецировать, примагнитить и сшить ее на вашей 3D Highpoly-модели с полным сохранением UV-островков.

  2. Рекомендуемый рабочий процесс (Пайплайн)

  Вариант А: Использование Fill Grid (Быстрый авто-процесс)

  1. Подготовка: В панели Select Objects укажите Highpoly-модель. Создайте пустой меш для Retopo и плоскость (Plane).

  2. Анализ: Нажмите 1-Click Prepare Highpoly. Движок сам найдет границы, отверстия и создаст кривые привязки.

  3. Периметры: Настройте Target Edge Length (плотность сетки) и нажмите Build Perimeters.

  4. Заливка: Выделите созданные контуры (включая внутренние отверстия) и нажмите Fill Grid. Сетка сгенерируется математически идеально.

  5. Проверка в 3D: Включите Live Preview, чтобы в реальном времени видеть 3D-форму ткани и текстуры.

  6. Сведение швов: Нажмите Auto-Sync & Normalize All, чтобы движок устранил разницу в количестве вершин на стыкующихся краях.

  7. Финализация: Нажмите Snap To Highpoly (запекание формы) и затем Stitch Seams (физическое сшивание краев).

  Вариант Б: Полностью ручное создание топологии

  1. Выполните шаги 1 и 2 из Варианта А (1-Click Prepare Highpoly).

  2. Нажмите Create Retopo Endpoints. На 2D-плоскости появятся угловые точки ваших будущих выкроек.

  3. Перейдите в Edit Mode. Выделяйте Endpoints и вручную экструдируйте (клавиша E) геометрию, выстраивая границы и полигоны инструментами Blender. Включите Clamp Mode для идеально ровных линий.

  4. Нажмите Check & Fix Endpoints, чтобы скрипт очистил геометрию от "клонов" угловых точек, которые Blender создает при экструдировании.

  5. Выделите границы швов и нажмите Auto-Sync & Normalize All (отключите галочку Even Spacing, если хотите сохранить свои ручные отступы между вершинами).

  6. Выполните финализацию (Snap To Highpoly -> Stitch Seams).

  ---

  3. Подробное описание панели интерфейса (UI)

  Блок 1: Select Objects (Выбор объектов)

  • Highpoly: Ваша целевая плотная модель (например, импортированная из Marvelous Designer).

  • Retopo: Активный меш, в котором вы создаете 2D-топологию.

  • Live Mesh: Служебный объект, который генерируется автоматически для показа 3D-превью.

  • Plane: Служебная 2D-плоскость, ограничивающая рабочую зону выкроек.

  Блок 2: Highpoly Preparation (Подготовка)

  • 1-Click Prepare Highpoly: Главная кнопка старта. Автоматически сканирует Highpoly, находит все внешние контуры и внутренние отверстия (карманы, петли), генерирует 3D-кривые и применяет проверочный UV-материал.

  • Advanced (Дополнительно):

    • HP Chain ID / Select HP Chain: Инструмент дебага. Позволяет перебирать и визуально выделять найденные цепи границ на Highpoly.

    • Curve Thickness / Z Offset: Настройки визуальной толщины и высоты сгенерированных 3D-кривых над плоскостью.

  Блок 3: Base Retopology (Базовая ретопология)

  • Create Retopo Endpoints: Создает структурные угловые точки (Endpoints) на 2D-плоскости.

  • Check & Fix Endpoints: Сканирует меш на наличие скопированных Endpoints (возникающих при ручном экструдировании) и удаляет с них скрытые системные ID, оставляя только "истинные" углы.

  • Target Edge Length: Целевая длина ребра. Чем меньше значение, тем плотнее будет сгенерированная сетка.

  • Build Perimeters: Генерирует 2D-контуры (включая обход отверстий) на основе выбранной плотности.

  • Fill Grid: Математически заполняет выделенную область (между периметрами) идеальной квад-сеткой (Патч Кунса).

  • Patch Operations (Операции с патчами):

    • Sync Manual Edits: Обновляет сетку патча, если вы вручную сдвинули вершины на его границе.

    • Unlink: Безвозвратно стирает системные математические данные патча, превращая его в обычную "мертвую" геометрию (удобно для дальнейшего жесткого ручного редактирования).

    • Force Update Patch: Принудительный перерасчет поверхности.

  • Grid Alignment Settings: Ползунки для тонкого математического сглаживания и натяжения сетки внутри сгенерированного патча.

  Блок 4: Preview Settings (Настройки отображения)

  • Live Preview (ON/OFF): Включает уникальный режим, при котором любые изменения 2D-сетки мгновенно отображаются на 3D-модели. Работает без задержек (Zero-Lag) и переносит UV/Материалы.

  • Show/Hide Patch Overlay: Включает цветной рентген-оверлей. Каждый сгенерированный патч подсвечивается своим цветом для навигации.

  • Enable Thickness / Thickness / Offset: Динамически применяет модификатор Solidify на Live Mesh, чтобы оценить реальный объем и толщину ткани (с отступом наружу или внутрь).

  Блок 5: Retopo Clamp Mode

  • Clamp Mode (ON/OFF): Жестко ограничивает движение вершин строго по осям X или Y. Незаменимо при ручном выравнивании геометрии в 2D.

  Блок 6: Seam Management (Управление швами)

  • Recalculate Seam Membership: Заставляет движок заново проанализировать, какие вершины принадлежат к каким швам (используется после разрезания сетки ножом).

  • Even Spacing (Equal): * Включено: Вершины на швах будут распределены с идеально равными отступами (как по линейке).

    • Выключено: Скрипт сохранит ваши ручные 2D-правки пропорций вершин, бережно спроецировав их на 3D-кривую.

  • Auto-Sync & Normalize All: Мощнейший инструмент. Находит парные швы, вычисляет недостаток вершин, добавляет лупкаты и идеально сводит левую и правую части шва для будущей сшивки.

  • Advanced: Позволяет выделить конкретную цепь на Retopo меше для ручной проверки.

  Блок 7: Finalize (Snap & Stitch - Финализация)

  • Selected Only: Применяет функции ниже только к выделенным вершинам.

  • Snap To Highpoly: Окончательно запекает 2D-сетку, оборачивая её вокруг 3D-модели (1-в-1 с Live Preview) и применяет физическую толщину (Solidify).

  • Flatten to 2D: Разворачивает 3D-модель обратно в плоское состояние на основе её UV-координат.

  • Mark/Clear Ignore: Позволяет выделить внутренние ребра (например, подвороты одежды) и пометить их как "Ignore". Они примагнитятся к 3D, но не будут сшиты с основной тканью (предотвращает ошибки non-manifold геометрии).

  • Stitch Seams: Хирургически сшивает 3D-швы алгоритмом Point-Merge. Идеально сливает вершины в 3D, но сохраняет им раздельные UV-координаты.

  ---

  4. История обновлений (Changelog)

  • v1.92.0 (The Ultimate Performance Update): Экстремальная оптимизация Лайв-режима $O(1)$ — полное отсутствие падения FPS при редактировании тяжелых сеток. Добавлен "Глушитель" (Execution Lock) для предотвращения искажения UV при авто-генерации. Полная локализация интерфейса и подсказок на 5 языков (EN, RU, ES, JP, ZH).

  • v1.89.0 (The Hole & Workflow Update): Внедрено полное автоматическое распознавание отверстий (карманов, петель). Добавлен "1-Click Prepare Highpoly". Интерфейс перестроен в 7 логичных модулей. Добавлен цветной GPU-оверлей патчей. Синхронизация швов переписана на иерархию "Master-Slave".

  • v1.86.6: Масштабное улучшение производительности через единый 2D BVH-кэш. Безупречная 100% точность переноса материалов и UV в Live-режиме.

  • v1.86.0: Внедрен Real-Time Live Preview, синхронизация материалов и динамический Solidify.

  • v1.77.0: Базовая стабильная Legacy-версия.