LayMesh文档
EN

LayMesh#

渐变对照画廊:30 组原始配方与跨端输出,附参考差异说明。

用可读代码绘制科研图,按物理尺寸组织版面。 一个可编辑项目可以组合原生图表、图片、矢量图形、文字和公式,生成静态图件或多页演示。

在线文档 · 视频教程(Bilibili) · English · 示例库

LayMesh 综合展示

展示图源码 · 开始使用

安装与第一次预览#

推荐安装 VS Code 扩展,或下载匹配平台的 VSIX。平台包内置原生引擎,无需另外安装 Python、Rust 或 npm;Remote SSH 选择远程宿主平台的包。

打开工作文件夹,把下面保存为 figure.lay,执行 LayMesh:打开预览:

lay
page = canvas(size=(120mm,90mm), background="#ffffff")p = plot(size=(110mm,80mm),         x=axis(label="Time (s)"), y=axis(label="Signal"))p.line(x=[0,1,2,3], y=[1,3,2,4], label="Experiment")p.legend(position="top_left")page.add(p, offset=(5mm,5mm))

当前源码构建也支持直接写 add(p, offset=(5mm,5mm))。画布可以用独立的 canvas(...) 声明。省略画布声明时,第一次 add(...) 会创建 160 × 90 mm 的透明画布,布局 DPI 为 300。

尺寸和位置默认 mm,字号和线宽默认 pt。显式单位包括 mm/cm/in/inch/pt/px;布局 px 使用 canvas.layout_dpi,导出 DPI 独立控制栅格密度。详见单位与尺寸。

CLI、Python 与 Notebook#

需要 Python 3.10+,平台 wheel 内置引擎和公式字体:

sh
python -m pip install laymeshpython -m laymesh --versionlaymesh validate figure.laylaymesh render figure.lay -o figure.pdflaymesh render figure.lay -o figure.png
python
from laymesh import render_fileresult = render_file("figure.lay", output="figure.pdf")

Notebook 先运行 %load_ext laymesh.ipython,再使用 %laymesh figure.lay 或 %%laymesh 编写版面。支持 NumPy/pandas 数据绑定、Matplotlib Figure 导入以及保存可独立复现的源码和资源。安装与平台要求 · Python API · Notebook

学习与查询#

任务 完整说明
尺寸、锚点、分组、复用 第一张版面 · 布局与素材
折线、散点、误差、统计、热图、极坐标 第一张数据图 · 科研绘图
主题、样式库、字体、渐变和阴影 样式与动画库:导入、逐项案例、第三方 CSS · 样式完整手册 · 样式图库
97 个动画、关键帧、步骤与放映 动画完整手册 · 效果目录 · 综合案例
视频、页面音轨和跨页背景音乐 视频与音频 · 可运行示例
编排独立页面和导出整本 PDF 多页文档
文字、公式、艺术字与效果 字体 · 公式 · 艺术字
SVG/PDF、图片、可编辑 PPTX、MP4/GIF 静态导出 · 动画导出

.lay 描述独立页面,.laydoc 编排多页;多面板显式定位。PDF 保留主体矢量,模糊效果局部栅格化。VS Code 导出只选择格式与路径,图片默认 1200 DPI、TIFF 默认 LZW,其余参数在设置中调整。视频导出需要 FFmpeg。

主题保存重复外观,.lay 保存尺寸、定位和数据;显式参数优先于样式。当前源码手册包含最新离线样式库及诊断改动,使用这些功能需包含相应改动的引擎构建;已发布包以发布说明为准。

文档与开发#

入门 · 语言参考 · API · 架构 · 示例与历史执行结果

源码开发需要 Rust 1.93.1;构建与发布脚本需要 Python 3.11+。在仓库根目录运行:

sh
cargo build --release --locked -p laymesh-clipython -m pip install -e './python'python -m laymesh render examples/basic.lay -o basic.pdfcargo test --workspace --lockedpython -m unittest discover -s python/tests -v

无需 Python 时,可直接调用 target/release/laymesh(Windows 为 laymesh.exe)。发布流程包含 wheel 构建、包审计、隔离安装验证及 PyPI Trusted Publishing 配置。文档站构建使用 python scripts/build-docs.py,由 GitHub Pages 工作流发布。

LayMesh 使用 MIT 许可证。原生依赖、公式字体和配色数据保留各自许可,详见第三方声明。