picture-matrix/README.md
2025-07-21 18:47:59 +08:00

69 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 项目简介
我也不知道这个东西是什么,乱搞的。
## 使用方法
### 安装依赖
首先安装一个图像处理包
```sh
pip install pillow==11.3.0
```
或者直接使用`requirement.txt`
```sh
pip install -r requirement.txt
```
### 项目使用
`MatrixGenerator`就是模块本身。
使用的时候直接导入`PictureMatrixGenerater``PicItem`
```python
from MatrixGenerator import PictureMatrixGenerater, PicItem
```
前者是生成器,后者是图片项。
图片项包含两个属性:
- `pic`:图片路径或者图片对象
- `label`:图片标签
图片支持两种类型:
- 图片路径:直接传入图片路径
- 图片对象:直接传入图片对象(`PIL.Image`
图片对象导入方式大概是这样的:
```python
from PIL import Image
Image.open("/path/to/open.jpg")
```
使用`PictureMatrixGenerater`生成图片矩阵,首先需要传入背景图片路径、图片矩阵大小、图片项大小、图片项间距、图片项数量、字体间距、字体路径、字体大小。
- `background`:背景图片路径(必须是路径,不支持图片对象)
- `picSize`:图片矩阵大小
- `itemSize`:图片项大小
- `margin`:图片项间距
- `itemNum`:图片项数量
- `fontMargin`:字体间距
- `font`:字体路径
- `fontSize`:字体大小
例如:
```python
generator = PictureMatrixGenerater(
background="./pic/background.jpg",
picSize=(1920, 1080),
itemSize=(200, 200),
margin=20,
itemNum=4,
fontMargin=20,
font="./font/STKAITI.TTF",
fontSize=30
)
```
生成图片矩阵之前,需要一个图片项列表:
```python
picList = [
PicItem("./pic/1.jpg", "1"),
PicItem("./pic/2.jpg", "2"),
PicItem("./pic/3.jpg", "3"),
PicItem("./pic/4.jpg", "4"),
]
```
这里提供一个小技巧:
```python
picList = [PicItem(pic, str(i)) for i, pic in enumerate(picList)]
```
之后调用`generate`方法生成图片矩阵:
```python
generator.generate(picList)
```