# Raw Editor

The Raw Editor is part of the Pro edition and only appears when Pro is installed.

Canonical URL: https://docs.polyhammer.com/blender-addons/character-dna/0.15.1/pro-features/raw-editor
Product: character-dna
Version: 0.15.1
Channel: production
Updated: 2026-11-21T13:45:20Z
Documentation source: initial main snapshot approved 2026-11-21T13:45:20Z
Documentation commit: 3533cd1260a9bd4b2806aaa4c64ead70766a1674
Release tag commit: 71125e9857db2b5a8ffa9426cc1f769d13017fd5
Owner-approved migration baseline: use current main documentation for the current stable release once; all subsequent releases use their tag snapshots.

<Callout type="info" title="Pro Feature">
The Raw Editor is part of the **Pro** edition and only appears when Pro is installed.
</Callout>

Edit the [Raw Controls](/blender-addons/character-dna/0.15.1/terminology#raw-controls) — more specifically **where** bones are posed when a [Raw Control](/blender-addons/character-dna/0.15.1/terminology#raw-controls) is activated to a value of 1.

Choose **Head** or **Body** with the shared **Component** selector. The selector is locked during editing, and Commit writes to that component's DNA.

[Video: raw editor](https://docs.polyhammer.com/docs-assets/character-dna/1266b506df4569026b7751ea740d32b5ea2fabb12ae380687e89495ef772c326/images/raw-editor/raw_editor.webm)

## Choosing a Raw Control [#choosing-a-raw-control]

The list shows scalar raw controls, plus a **Rest Pose** row at the top called `default` for editing the neutral shape. Quaternion driver inputs are handled by the RBF Editor. Filter the list by:

- **Mesh** — scope controls to a specific LOD0 mesh.
- **Name** — search a control by name.
- **Non-Zero** — hide-zero-value controls. (This can be useful to find which controls are activated.)
- **Value Sort** — sort by value so you can see which controls have the highest values.
- **Side** — a side filter (Left / Right / Center). Helpful if you only want to work on one side of the face.
- **Freeze** — the snowflake button locks the current list order and filtering in place so rows do not reshuffle while you scrub the raw control values.

Select a control and click **Edit** to open an editing session for that expression's pose.

<Callout type="info" title="Note">
Some raw controls like `jawOpenExtreme` are "corrective" expressions, so they activate the expressions they add onto (for example, `jawOpen`).
</Callout>

## Editing a Pose [#editing-a-pose]

While editing, you have two options: work on **target meshes** (LOD0 sculpt targets) or re-pose the selected component's **pose bones** directly. The available tools depend on the mode you're in:

**Editing the Target Mesh** — Mirror, Flip, Reset to Neutral, Reset to DNA, Transfer shape from a selected mesh, and (Rest Pose only) Transfer to Head. A **Strength** slider blends the operation result.

**Editing the Pose Bones Directly** — Mirror/Flip bones, Reset to Rest Pose, Reset to DNA, Mirror/Flip selection, and (Rest Pose only) Snap Bones to Surface.

When done, **Commit** writes the change into the DNA, or **Revert** discards it. Options let you mirror on commit and, for Rest Pose edits, update the mesh and auto-update LODs.

## Bone Matching Solver [#bone-matching-solver]

Instead of posing bones by hand, let the solver find the bone transforms that best fit a target mesh sculpt.

[Video: bone matching solver](https://docs.polyhammer.com/docs-assets/character-dna/1266b506df4569026b7751ea740d32b5ea2fabb12ae380687e89495ef772c326/images/raw-editor/bone_matching_solver.webm)

Sculpt your target mesh, then click **Match Bones to Mesh**. It runs a hyper-optimization algorithm to solve the bone transforms that reproduce your sculpt. The **Solver Settings** popover exposes the hyperparameters:

| Setting | Purpose |
| ------- | ------- |
| Iterations | Number of optimization steps |
| Learning Rate | Optimization step size |
| Rotation / Translation Reg | Regularization to keep the solve stable |
| Warm Weight Threshold | Threshold for warm-start weighting |
| Huber Delta (cm) | Robustness of the loss to outliers |
| Convergence Tolerance | When to stop early |

Enable **Reset Pose** to start each solve from the DNA pose, or disable this to start the solve from the current pose bone positions in the Blender scene.

<Callout type="idea" title="Tip">
Start with the defaults. If the fit undershoots, raise iterations or learning rate; if it gets unstable or spiky, raise the regularization.
</Callout>

## Setup and Hardware [#setup-and-hardware]

The bone matching process happens in another Python subprocess that utilizes [PyTorch](https://pytorch.org/) for accelerating compute on your hardware. This includes options for `CPU`, `CUDA`, and `MPS` on macOS. Setting this to `AUTO` will try to install the dependencies for the most optimal hardware that you have available.

![hardware settings](https://docs.polyhammer.com/docs-assets/character-dna/1266b506df4569026b7751ea740d32b5ea2fabb12ae380687e89495ef772c326/images/raw-editor/hardware_settings.png)

You will have to run the installation process once before you can use the `Match Bones to Mesh` operator. If you have a preference for where the virtual environments should be on disk (these can be several GB), you can set that in the **Solver Environments Folder** preference.
