> For the complete documentation index, see [llms.txt](https://docs.yanusstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yanusstudio.com/yanusface/retopology.md).

# ReTopology

The **ReTopology** feature was created to solve a key challenge:\
YanusFACE works on a **base template** (already rigged and animated). But users who wanted to work with their **own custom models** often couldn’t do so, because their topology didn’t match the template.

With **ReTopology**, you can now seamlessly convert your existing model into the YanusFACE base template with **minimal quality loss**. This makes it possible to fully integrate custom meshes into the YanusFACE pipeline while keeping all rigging and BlendShape functionality.

***

### ⚡ How It Works

1. **Select Base & Target**
   * Choose the **Base Object** (YanusFACE template).
   * Choose your **Target Object** (custom model).
2. **Place Markers**
   * Use **Mark Base Markers** and **Mark Target Markers** to define control points.
   * These markers create a **mapping system** between the template and your model.
   * You can mirror markers or edit them for precision.
3. **Wrapping**
   * Run the **Wrap** function to “project” your custom model into the base topology.
   * The system aligns geometry while preserving the overall shape and detail.
4. **Result**
   * Your model is now retopologized into the YanusFACE base format.
   * This ensures full compatibility with BlendShape generation, modifications, and rigging tools.

***

### 🎯 Why It’s Useful

* **Custom Models Supported** — no need to remodel your character from scratch.
* **Fast Integration** — retopology + modifications = transfer all settings from the base template to your model in minutes.
* **Precision Tools** — marker-based workflow ensures accuracy with minimal loss of detail.
* **Seamless Workflow** — once retopology is complete, you can use the full YanusFACE toolset (Bake, Corrective Expression, Optimize, etc.) on your own mesh.

***

### 🛠 UI Overview

* **Base / Target** — select template and custom object.
* **Markers** — mark, mirror, and edit base/target markers.
* **Wrap** — perform the topology transfer.
* **Dual Panel** — split screen for easier side-by-side adjustments.
* **Area Parameters** — refine results with tools like **Exclude Set**, **Paint Relax**, and **Paint Retain** for better deformation control.

***

### 🎥 Short Demo

{% embed url="<https://youtu.be/pmQ9Z1sEUL4?si=Z8U92RSvhONdp_XZ&t=31>" %}