diff --git a/scripts/export_psd_from_json.py b/scripts/export_psd_from_json.py index c54eee0..4e29721 100644 --- a/scripts/export_psd_from_json.py +++ b/scripts/export_psd_from_json.py @@ -1,7 +1,50 @@ -""" -PSD导出模块:基于Vue模板配置生成PSD文件 -支持从Vue模板解析图层信息、文本样式和位置信息 -适配海报生成流程 +""" + * @file export_psd_from_json.py + * @brief PSD导出模块:基于Vue模板配置生成PSD文件 + * 支持从Vue模板解析图层信息、文本样式和位置信息 + * + * @author 徐海潆 (2212180@mail.nankai.edu.cn) + * @date 2025.7.4 + * @version v2.0.0 + * + * @details + * 本文件主要实现: + * - Vue模板配置文件解析和图层信息提取 + * - CSS样式解析和透明度、字体、颜色等属性提取 + * - 图片和文本图层的创建和位置计算 + * - PSD文件生成和图层叠加处理 + * - 字体加载和文本渲染功能 + * - 图像缩放、对齐和透明度处理 + * + * @note + * - 支持多种图片格式和字体文件加载 + * - 自动处理图层z-index排序和透明度设置 + * - 提供图片路径自动查找功能 + * - 生成预览图和缩略图便于查看效果 + * - 兼容PIL和psd-tools库进行图像处理 + * + * @usage + * # 从Vue模板配置创建PSD文件 + * create_psd_from_vue_config( + * vue_templates_path='configs/vue_templates.yaml', + * output_path='outputs/design.psd', + * template_name='nku.png', + * content_data={'title_content': '标题', 'subtitle_content': '副标题'} + * ) + * + * # 从图片列表创建简单PSD文件 + * create_psd_from_images( + * image_paths=['image1.jpg', 'image2.png'], + * output_path='outputs/simple.psd' + * ) + * + * # 快速运行 + * python export_psd_from_json.py + * # 需完善 + * 字体加载需要接口 + * @copyright + * (c) 2025 砚生项目组 + */ """ import yaml