# 头像加边框

**Repository Path**: taylorandtony/avatar-with-border

## Basic Information

- **Project Name**: 头像加边框
- **Description**: 为大量头像批量添加png格式的头像框
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-25
- **Last Updated**: 2022-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 头像批量边框添加程序

用于批量把 `png` 格式的图片按照透明度叠加到另外的图片上。

![](readme/screenshots.gif)

## 快速开始

方法一和方法二需要以下基础：

- 已配置 Python 开发环境，且 pip 能够正常访问网络
- 已安装 Git 版本控制系统
- 熟悉自己平台（Windows/Linux）的命令行操作

### 一、在已配制了 Python 环境的计算机上运行

1. 克隆此项目

```shell
git clone https://gitee.com/taylorandtony/avatar-with-border.git
```

2. 安装依赖，或者跳到`序号 5` 查看使用虚拟环境进行配置。

```shell
pip install numpy tqdm opencv-python
```

3. 在 `AddFrame.py` 文件同级目录下，也就是这个仓库的文件夹下，创建三个文件夹：

- `backgrounds`: 放置原头像
- `template`: 放边框，确保边框图片名称为 cover.png

- `results`: 程序的输出结果存放位置

4. 运行 `python AddFrame.py` 将自动依据文件夹结构，进行头像添加边框的操作。添加边框后的头像将保存在 results 里。这将只使用 `cover.png` 作为唯一模板。

5. 如果使用虚拟环境，下面为 Windows 平台所有操作：

```shell
# 克隆项目
git clone https://gitee.com/taylorandtony/avatar-with-border.git
cd avatar-with-border
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
.\venv\Scripts\activate
# 安装依赖
pip install numpy tqdm opencv-python
# 创建文件夹
mkdir backgrounds
mkdir template
mkdir results
# 把需要当作边框的图片复制到 template 文件夹内
# 直接复制即可，copy 命令就为了做个样子
copy path/to/cover.png ./template/cover.png /Y
# 运行
python AddFrame.py
```

### 二、打包此程序为 exe 并脱离开发环境运行

```shell
# 克隆项目
git clone https://gitee.com/taylorandtony/avatar-with-border.git
cd avatar-with-border
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
.\venv\Scripts\activate
# 安装依赖
pip install numpy tqdm opencv-python pyinstaller
# 打包 exe
pyinstaller -F AddFrame.py
```

## 使用命令行参数

软件同时支持以下参数：

### 若处理单个文件

`-b` `--back`: 待处理原头像图片

`-t` `--temp`: 待添加的模板，必须 `png` 格式

`-o` `--output`: 处理后的头像保存路径，文件名将自动处理

例如：

```shell
# 把 模板.png 作为边框添加到 头像.png 上，并把结果输出到 results 文件夹
mkdir results
python .\AddFrame.py -b "头像.png" -t "模板.png" -o "results"
```

### 若有多个模板

`-m` `--multi`: 传入该参数后，程序自动遍历 `template` 文件夹下所有的图片，并依次把它们添加到每一个位于 `backgrounds` 内的头像上（笛卡尔积）。

例如：

```shell
# 根据文件夹结构自动处理
python .\AddFrame.py -m
```

### 其他参数

`-d` `--delete`: 删除 `results` 文件夹下所有的图片。