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

1.9 KiB
Raw Permalink Blame History

项目简介

我也不知道这个东西是什么,乱搞的。

使用方法

安装依赖

首先安装一个图像处理包

pip install pillow==11.3.0

或者直接使用requirement.txt

pip install -r requirement.txt

项目使用

MatrixGenerator就是模块本身。 使用的时候直接导入PictureMatrixGeneraterPicItem

from MatrixGenerator import PictureMatrixGenerater, PicItem

前者是生成器,后者是图片项。 图片项包含两个属性:

  • pic:图片路径或者图片对象
  • label:图片标签 图片支持两种类型:
  • 图片路径:直接传入图片路径
  • 图片对象:直接传入图片对象(PIL.Image 图片对象导入方式大概是这样的:
from PIL import Image
Image.open("/path/to/open.jpg")

使用PictureMatrixGenerater生成图片矩阵,首先需要传入背景图片路径、图片矩阵大小、图片项大小、图片项间距、图片项数量、字体间距、字体路径、字体大小。

  • background:背景图片路径(必须是路径,不支持图片对象)
  • picSize:图片矩阵大小
  • itemSize:图片项大小
  • margin:图片项间距
  • itemNum:图片项数量
  • fontMargin:字体间距
  • font:字体路径
  • fontSize:字体大小 例如:
generator = PictureMatrixGenerater(
    background="./pic/background.jpg",
    picSize=(1920, 1080), 
    itemSize=(200, 200),
    margin=20,
    itemNum=4,
    fontMargin=20,
    font="./font/STKAITI.TTF",
    fontSize=30
)

生成图片矩阵之前,需要一个图片项列表:

picList = [
    PicItem("./pic/1.jpg", "1"),
    PicItem("./pic/2.jpg", "2"),
    PicItem("./pic/3.jpg", "3"),
    PicItem("./pic/4.jpg", "4"),
]

这里提供一个小技巧:

picList = [PicItem(pic, str(i)) for i, pic in enumerate(picList)]

之后调用generate方法生成图片矩阵:

generator.generate(picList)