文字图片生成

图片生成插件使用说明

1. 插件功能概述

本插件用于根据指定的文字内容动态生成图片，支持自定义字体和背景图片。生成的图片可以缓存以提高性能。

2. 字体与背景图片配置

字体文件

• 字体文件来源
  由于中文字体文件体积较大，安装包中未包含字体文件，请自行下载并上传至服务器。

• 版权提示
  字体可能存在版权问题，请尽量选择开源字体（如：思源黑体、文泉驿正黑等）以避免侵权风险。

• 字体目录
  将下载的字体文件（仅支持 .ttf 格式）上传至以下目录：

  app/plugin/makepic/font

背景图片

• 背景图片目录
  将自定义的背景图片上传至以下目录：

  app/plugin/makepic/bg

• 图片格式说明
  当前插件的图片生成模式为固定模式，程序会随机选择背景图片和字体样式进行组合。

3. 插件调用方法

在模板中使用以下标签调用图片生成功能：

<img src="<!--{iCMS:plugin:makePic text="$article.title" cache="true"}-->" >

参数说明

• text（必填）
  需要显示的文字内容，例如文章标题 $article.title。

• cache（可选）
  是否生成图片缓存，默认值为 false。

  • true：启用缓存，提升后续访问速度。
  • false：不启用缓存，每次重新生成图片。

示例代码

以下是一个完整的调用示例：

<img src="<!--{iCMS:plugin:makePic text="欢迎使用iCMS" cache="true"}-->" alt="动态生成图片">

4. 注意事项

1. 字体格式限制
   当前插件仅支持 .ttf 格式的字体文件，请确保上传的字体文件符合要求。
2. 缓存机制
   启用缓存后，生成的图片将存储在服务器缓存目录中。如果需要更新图片内容，请清除缓存或禁用缓存功能。
3. 随机性说明
   插件会随机选择字体和背景图片进行组合，若需固定样式，请修改插件代码以实现自定义逻辑。

5. 特别鸣谢

感谢 /mg沉默之水 提供本插件的代码支持！

通过以上步骤，您可以轻松配置并使用图片生成插件。如有任何疑问或改进建议，请随时联系技术支持或查阅相关文档。