Metadata-Version: 2.3
Name: translated2video
Version: 1.1.0
Summary: 将翻译图层从PSD文件转换为视频的工具
Author: Nouchi
Author-email: Nouchi <nouchipri@outlook.com>
Requires-Dist: click>=8.3.1
Requires-Dist: opencv-python>=4.11.0.86
Requires-Dist: psd-tools[composite]>=1.12.1
Requires-Dist: rich>=14.2.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# [Translated2Video](https://github.com/Nouchi-Kousu/translated2video)

用于半自动将完成嵌字的PSD文件转换为带导读视频的工具。

> 视频样式参见[示例视频](https://www.bilibili.com/video/BV1oxiGBSExm)

## 使用方法

建议使用uv tool安装工具：
```bash
uv tool install translated2video
```
这将在系统中注册命令行工具`t2v`。

> 如何安装uv请参见[uv官方文档](https://docs.astral.sh/uv/)。

使用命令行工具`t2v`，将在PSD文件所在目录下生成一个与PSD文件同名且带有`_output`后缀的mp4视频文件：

```bash
t2v [OPTIONS]
```

所有参数均为可选：
- `--input`, `-i`: 设置输入文件或路径，默认处理当前目录下所有PSD文件，支持传入多个值，支持文件与路径混传，不会递归处理子目录。
- `--rate`, `-r`: 设置输出视频的帧率，默认为24。
- `--interval`, `-l`: 设置每张图片在视频中持续的时间，默认为10秒。
- `--transit`, `-t`: 设置图片之间的过渡时间，默认为500毫秒。
- `--width`, `-w`: 设置输出视频的宽度，默认为-1，表示自动计算宽度以保持原始图片的宽高比。
- `--height`, `-h`: 设置输出视频的高度，默认为-1，表示自动计算高度以保持原始图片的宽高比。
- `--group`, `-g`: 设置包含翻译图层的图层组名称，默认为"翻译"。
- `--help`: 显示帮助信息。

对于`-l`和`-t`参数，请使用形如`1d2h3m4s5ms6us`的格式来指定时间长度，其中`d`表示天，`h`表示小时，`m`表示分钟，`s`表示秒，`ms`表示毫秒，`us`表示微秒，任意单位可省略。例如，`1m30s500ms`表示1分钟30秒500毫秒。

#### PSD文件要求

- PSD文件中的所有翻译图层均应打包于单一图层组中，图层组名可自定，通过命令参数传入，下称“翻译”图层组（若仅有单一翻译图层命名该图层即可）。
- 当隐藏“翻译”图层组时，应为完整无字背景，即视频背景；由于“翻译”图层组始终位于最后渲染，请勿在“翻译”图层组上方添加任何有效图层或图层组。
- “翻译”图层组中可以有子组，子组将被视为整体导出。
- “翻译”图层组中的图层或子组将按从下到上（即PS中渲染的层叠顺序）的顺序在视频中出现。

> 示例PSD文件可自[Releases](https://github.com/Nouchi-Kousu/translated2video/releases)下载