# `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 帧**（系统将自动限制以防资源耗尽）。