LayMesh#
渐变对照画廊:30 组原始配方与跨端输出,附参考差异说明。
用可读代码绘制科研图,按物理尺寸组织版面。 一个可编辑项目可以组合原生图表、图片、矢量图形、文字和公式,生成静态图件或多页演示。
在线文档 · 视频教程(Bilibili) · English · 示例库

安装与第一次预览#
推荐安装 VS Code 扩展,或下载匹配平台的 VSIX。平台包内置原生引擎,无需另外安装 Python、Rust 或 npm;Remote SSH 选择远程宿主平台的包。
打开工作文件夹,把下面保存为 figure.lay,执行 LayMesh:打开预览:
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 内置引擎和公式字体:
python -m pip install laymeshpython -m laymesh --versionlaymesh validate figure.laylaymesh render figure.lay -o figure.pdflaymesh render figure.lay -o figure.pngfrom 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+。在仓库根目录运行:
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 工作流发布。