silvermoong / stocking-texture-tool

丝袜纹理工具 
 中文 | English 
给插画里的丝袜加上真实的织物纹理。粗涂出丝袜在哪，沿横纹画几条线，工具就算出纹理怎样绕着腿和身体走，按你选的样式渲染出来，没有摩尔纹。全程在本机运行，不上传任何东西。
 分界线左边是原图，右边是处理后。 
白丝黑丝都可以（左边原图，右边处理后）：
## 能做什么
- **几条线铺满整条腿。** 每个部位画 1–3 条线告诉它横纹往哪走，横纹自动铺满，在屏幕上处处等距。手、头发挡住的地方，横纹在下面连续走。
- **点一下选出一条腿。** 点选用 Segment Anything，点完可以在小 / 中 / 大三档范围里挑。
- **六种样式：** 细线、针织、线圈、斜单线、加濑风、油光（试验）。每种都能加纱线反光的亮点。
- **纹理层（试验）：** 最多把四种纹理按百分比叠在一起，比如细线 30%、加濑风 70%，都按同一套走向线画。
- **高光粒子（试验）：** 像油光那样顺着受光处找出整条腿的高光带，画成细密的粒子而不是平滑光带，可以叠在任何样式上。
- **预设：** 调好的样式、密度、斜度、强度、纹理层、亮点、高光粒子和摩尔纹效果可以存成预设，换一张图一键读取，也能导出成小文件发给别人。
- **白丝黑丝都行。** 强度按丝袜深浅自动设定：同样的纹理在白丝上显眼一倍，白丝会自动调低。
- **不出摩尔纹。** 横纹太密、接近像素大小的地方，纹理会自动减弱；「标出问题」会把这些地方标出来。
- **想要摩尔纹时有个试验开关。** 真丝袜叠穿、拍照时那种水波似的明暗条纹，打开「摩尔纹效果」的开关，再用「强度」调明暗、「面积」调它从一小圈扩到多大。默认关；条纹顺着膝盖、大腿这些鼓起的地方走，平的地方没有。
- **左右一键镜像。** 左腿画好，右腿点一下就有。
- **三种导出：** 成品图；只有丝袜、其余透明的 PNG（叠在原图上就等于成品图，方便在 Photoshop 里当图层）；丝袜引导 PSD（以后可以再打开接着改）。你自己的 PSD 永远不会被改写。
- 中文 / English 界面。
## 安装
需要 Windows 10（1803 以上）或 Windows 11。有 NVIDIA 显卡（RTX 20 系或更新、驱动 570 以上）会快很多，没有也能用。
1. 下载这个仓库：点右上角 **Code → Download ZIP** 解压，或者
 [code] 
2. 双击文件夹里的 `install.bat`。Windows 可能提示「无法验证发布者」或「Windows 已保护你的电脑」，点「运行」，或者「更多信息 → 仍要运行」。
 文件夹的完整路径不要太长（100 个字符以内），比如放在 `D:\stocking-texture-tool`。
安装程序会检测显卡，从本项目 GitHub 上的安装文件包下载需要的文件：一个独立的 Python 3.12、全部依赖、对应显卡的 PyTorch 和两个模型。最后在桌面建一个「丝袜纹理工具」快捷方式。电脑上不需要事先装 Python，也不会动你已有的 Python。显卡版要下载约 3.3 GB，CPU 版约 740 MB，装完显卡版约占 5 GB。
GitHub 下载失败的文件，会改从各自的原始来源下载（PyPI、PyTorch、Hugging Face 等）。
装好后双击桌面图标打开。也可以把图片或 PSD 直接拖到图标上。
- 中途断网了，重新运行 `install.bat` 即可，已经下载的部分不会重复下载。
- **更新：** 再运行一次 `install.bat`。它会先把代码更新到 GitHub 上的最新版（下载 ZIP 的直接替换有变化的文件；`git clone` 的用 git 快进，不会覆盖你自己改过的文件），再补装新版需要的依赖和模型。连不上 GitHub 时照常安装手上的代码。不想更新：`install.bat -NoUpdate`。
- 更新显卡驱动后再运行一次，会从 CPU 版换成显卡版。
- 想强制用 CPU：`install.bat -Torch cpu`。
- **卸载：** 删掉这个文件夹和桌面快捷方式。设置和自动保存的工作在 `%LOCALAPPDATA%\StockingTexture`，也可以一起删。
### 离线安装
安装文件包下载太慢，或者安装的电脑不能联网时，先在别处把文件下好：
1. 打开安装文件包，下载 `stt-deps-1-base.zip`，再按显卡选一种 PyTorch：
 - NVIDIA 显卡：`stt-deps-1-torch-cuda.zip.001` 和 `.002`，两个都要
 - 其他电脑：`stt-deps-1-torch-cpu.zip`
2. 在 `install.bat` 旁边新建一个 `deps` 文件夹，把下载的文件原样放进去。**不用解压，也不要改文件名**，安装程序会自己拼接、校验和解压。
3. 双击 `install.bat`，全程不用联网。
## 使用
### 1. 打开图片
把 PNG、JPG 或 PSD 拖进窗口，或者按 Ctrl+O。PSD 取合成后的画面。
### 2. 涂部位
左边第 1 步「部位」。默认已经有「左腿」「右腿」两个部位。
- **点选（S）：** 在腿上左键点一下，整条腿就选进来；右键减去。点完旁边会出现「小 / 中 / 大」，按 Tab 切换范围。漏掉的地方用小档再点一下补上；几次点选拼在一起时，各块中间被线稿隔开的细缝会自动补上（范围旁边的「补接缝」开关可以关）。
- **画笔（B）/ 橡皮（E）：** 手动修边，`[` `]` 调笔刷大小。
- **切开（K）：** 在部位上画一条线，分成两块。画面上方会出现「自动贴线」开关，打开后线会吸到附近的线稿上。两胸或两条腿选在了一起，点那里的「自动分割」，会沿中线分开。
凡是有折痕的地方，两边各用一个部位：左右大腿、胯部、左右胸。腿以外也一样能用，比如一件上衣切成领子、左胸、右胸三块：
### 3. 画走向线
左边第 2 步「走向」，选「走向（P）」，沿着你想要的一道横纹画一条线。横纹是绕着腿一圈一圈的线，所以在腿上画的是横穿过腿的弧线，像腿上套着的环看得见的那半圈。
- 每个部位 1–3 条就够，每条横跨部位宽度的大约八成。
- **线只管方向，不管疏密。** 画得密还是稀都一样，横纹间距由纹理页的「密度」决定。
- 方向变化大的地方各补一条。凸起的地方（膝盖）上方画 ∩、下方画 ∪，把它包住；凹进去的地方（脚踝正面）反过来，上方 ∪、下方 ∩：
- 线可以横穿手或头发，横纹会在下面接着走。
- 右键或 Delete 删掉指针下的线。每画一条只重算这一个部位，一两秒就好。
- **镜像：** 左腿画好后，选中左腿点「镜像」，右腿就有了一套翻转过来的线，之后可以照常修改。
两条腿画好走向线后，白色细线是算出来的横纹：
上衣也一样，横纹顺着胸部的弧度弯曲：
### 4. 弯折的腿
一条腿弯折、大腿压着小腿时，用一个部位就够，膝盖处没有接缝。大腿和小腿各画一条走向线，再按下面两步处理交界和膝盖。
只画两条走向线时，大腿