# 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>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yanusstudio.com/yanusface/retopology.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.