# FacialRiggingBG

**Repository Path**: uitcis/FacialRiggingBG

## Basic Information

- **Project Name**: FacialRiggingBG
- **Description**: blender rig face
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FacialRiggingBG

Blender 面部骨骼绑定插件 - 基于 Rigify 系统的面部骨骼编辑器

## 介绍

FacialRiggingBG 是一个 Blender 插件，专门用于面部骨骼的快速绑定和编辑。该插件基于 Blender 的 Rigify 系统，提供了可视化的锚点编辑器，帮助用户将面部骨骼精确放置在网格表面，快速生成自然的面部绑定效果。

## 软件架构

- **核心模块**: `__init__.py` - 插件注册与初始化
- **操作器模块**: `operators/` - 各种功能操作
  - `facerig_anchor_editor.py` - 锚点编辑器（可视化管理面部锚点）
  - `facerig_rigify.py` - Rigify 绑定生成
  - `facerig_utils.py` - 工具函数库
- **面板模块**: `panels.py` - Blender UI 面板
- **属性模块**: `properties.py` - 自定义属性定义
- **配置模块**: `preferences.py` - 插件设置
- **数据文件**: JSON 格式的骨骼位置配置

## 功能特性

- **锚点编辑器**: 可视化在网格表面放置和调整面部锚点
- **一键生成**: 快速从 metarig 生成完整面部绑定
- **骨骼对称**: 支持左右对称的骨骼调整
- **多种约束**: 内置丰富的骨骼约束工具（复制旋转/位置/缩放、阻尼跟踪等）
- **权重绘制**: 自动权重绘制支持

## 安装教程

1. 下载本仓库或克隆到本地
2. 打开 Blender，进入 `编辑 > 预设 > 文件路径`
3. 将插件文件夹路径添加到 Blender 的插件搜索路径
4. 在 Blender 中打开 `编辑 > 预设 > 插件`，搜索 "FacialRiggingBG"
5. 勾选启用插件

或者直接将整个文件夹复制到 Blender 插件目录：
- Windows: `C:\Users\用户名\AppData\Roaming\Blender Foundation\Blender\版本号\scripts\addons\`
- Linux: `~/.config/blender/版本号/scripts/addons/`
- macOS: `~/Library/Application Support/Blender/版本号/scripts/addons/`

## 使用说明

### 1. 基础面部绑定流程

1. 创建头部网格模型
2. 在场景中添加 Armature，选择 `FacialRiggingBG > Create MetaRig` 创建基础骨骼
3. 在编辑模式下调整骨骼位置
4. 选择 `FacialRiggingBG > Generate Rig` 生成完整绑定

### 2. 使用锚点编辑器

1. 选择头部网格和 Armature
2. 打开面板 `FacialRiggingBG > Anchor Editor`
3. 点击 "Calculate from Anchors" 计算骨骼位置
4. 在 3D 视图中拖拽锚点进行调整

### 3. 调整骨骼

- 使用 "Adjust Bones to Anchors" 将骨骼对齐到锚点
- 支持对称模式，可同时调整左右两侧

## 参与贡献

1. Fork 本仓库
2. 新建功能分支 (`git checkout -b feat/xxx`)
3. 提交您的更改 (`git commit -m 'Add xxx'`)
4. 推送分支 (`git push origin feat/xxx`)
5. 提交 Pull Request

## 许可证

本项目基于 GPL 许可证开源 - 详见 LICENSE 文件。

## 联系方式

如有问题，请提交 Issue 或 Pull Request。