73 lines
1.9 KiB
Plaintext
73 lines
1.9 KiB
Plaintext
# `ytpgif` 指令说明
|
||
|
||
## 功能简介
|
||
`ytpgif` 用于生成来回镜像翻转的仿 YTPMV（YouTube Poop Music Video）风格动图。
|
||
|
||
---
|
||
|
||
## 命令格式
|
||
```bash
|
||
ytpgif [倍速]
|
||
```
|
||
|
||
---
|
||
|
||
## 使用示例
|
||
|
||
- **默认倍速**
|
||
```bash
|
||
ytpgif
|
||
```
|
||
使用默认倍速（1.0）处理你发送或回复的图片，生成镜像动图。
|
||
|
||
- **指定倍速（较快）**
|
||
```bash
|
||
ytpgif 2.5
|
||
```
|
||
以 2.5 倍速处理图片，生成节奏更快的镜像动图。
|
||
|
||
- **指定倍速（较慢）**
|
||
回复一张图片并发送：
|
||
```bash
|
||
ytpgif 0.5
|
||
```
|
||
以 0.5 倍速生成慢节奏的镜像动图。
|
||
|
||
---
|
||
|
||
## 参数说明
|
||
|
||
### `倍速`（可选）
|
||
- **类型**：浮点数
|
||
- **默认值**：`1.0`
|
||
- **有效范围**：`0.1 ～ 20.0`
|
||
|
||
#### 作用：
|
||
- **静态图**：控制“原图 ↔ 镜像”切换的速度（值越大，切换越快）。
|
||
- **GIF 动图**：控制截取原始动图正向与反向片段的时长（值越大，截取的片段越长）。
|
||
|
||
---
|
||
|
||
## 使用方式
|
||
|
||
在发送指令前，请确保满足以下任一条件：
|
||
- 在消息中**直接附带一张图片**，或
|
||
- **回复一条包含图片的消息**后再发送指令。
|
||
|
||
插件将自动执行以下操作：
|
||
1. 下载并识别图片（支持静态图和 GIF 动图）。
|
||
2. 自动缩放图像，**最大边长不超过 256 像素**（保持宽高比）。
|
||
3. 根据图片类型处理：
|
||
- **静态图** → 生成“原图 ↔ 镜像”循环动图。
|
||
- **GIF 动图** → 截取开头一段正向播放 + 同一段镜像翻转播放，拼接成新动图。
|
||
4. **保留透明通道**（若原图含透明），否则转为 RGB 模式以避免颜色异常。
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
⚠️ 以下情况可能导致处理失败或效果不佳：
|
||
- 图片过大、格式损坏或网络问题；
|
||
- 动图帧数过多或单帧持续时间过短；
|
||
- 输出 GIF 单段帧数超过 **500 帧**（系统将自动限制以防资源耗尽）。
|