Metadata-Version: 2.4
Name: creative-render-engine
Version: 0.7.0
Summary: Standalone creative image, scroll, and timeline rendering engine
Keywords: image,video,rendering,subtitle,timeline
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3,>=2.12
Requires-Dist: pillow<12,>=11
Requires-Dist: numpy<3,>=2
Requires-Dist: moviepy<3,>=2.2
Requires-Dist: proglog<1,>=0.1.12
Requires-Dist: text-block-renderer<4,>=3.2.2
Provides-Extra: publish
Requires-Dist: setuptools>=78; extra == "publish"
Requires-Dist: mypy<2,>=1.19; extra == "publish"
Requires-Dist: build<2,>=1.2; extra == "publish"
Requires-Dist: twine<7,>=6; extra == "publish"

# Creative Render Engine

独立的创意图片、滚动视频和时间线渲染引擎，提供基于 Pydantic 的任务模型、编译、预览和渲染接口。

## 安装

需要 Python 3.12 或更高版本。

```shell
python -m pip install creative-render-engine
```

发行包名为 `creative-render-engine`，Python 导入名为 `creative_render_engine`。

## 使用

```python
import creative_render_engine as engine

# 获取任务 JSON Schema，查看支持的任务类型和字段。
schema = engine.render_task_json_schema()

# 写入文件前必须配置输出根目录。
engine.settings.output_root = "./output"

# task 为符合 Schema 的任务字典或 RenderTask 模型：
# plan = engine.compile(task)
# preview = engine.preview(plan)
# result = engine.render(plan)
```

支持纯图片、图文、滚动和时间线任务，以及时间线字幕生成。字体、图片、音视频等素材由调用方提供，不随包分发；视频处理依赖 MoviePy 和可用的 FFmpeg。

## 发布

本地打包、校验及上传 PyPI 的步骤见源码目录中的 `build_pypi.md`。
