LayMesh单位与尺寸#
用途与概念#
几何裸值采用 canvas.unit，初始为 mm；字号和线宽裸值采用 pt。显式单位最便于阅读和跨主题复现。布局 px 使用 layout_dpi，位图输出 DPI 则决定最终像素数。
最小完整示例#
此文件包含画布及必要定义，可直接运行 laymesh validate 或 laymesh render，不依赖前文未声明的变量。
# Minimal complete example: linepage=canvas(size=(100mm,75mm),background="#ffffff")page.add(line(length=55mm,angle=20deg,start_cap=round,end_head=head(shape=triangle,size=(6mm,5mm)),line_width=2mm),offset=(12mm,15mm))# Minimal complete example: linepage=canvas(size=(100mm,75mm),background="#ffffff")page.add(line(length=55mm,angle=20deg,start_cap=round,end_head=head(shape=triangle,size=(6mm,5mm)),line_width=2mm),offset=(12mm,15mm))预览
依赖文件
examples/manual/line.lay
参数与默认行为#
裸几何长度使用画布单位，裸字号和描边宽度使用 pt。显式调用参数优先于继承和主题默认值；下面的接口参考逐项列出允许类型、可选值与默认来源。
组合用法#
长度乘无单位数仍是长度；两个同类长度相除得到比例。size=(40mm,auto) 常用于图片保留比例与文本自然高度，是否支持 auto 由素材决定。
box = rect(size=(20 mm, 23 mm), fill="#087f8c")first = page.add(box,size=(47 mm, auto), target=page.top_left, offset=(10 mm, 28 mm))follower = page.add(box, target=first.top_right, offset=(6 mm, 0 mm))page.add(text(content="47 mm", font_family=font, font_size=9 pt, color="#ffffff"), anchor=center, target=first.center)page.add(text(content="next", font_family=font, font_size=9 pt, color="#ffffff"), anchor=center, target=follower.center)# Gallery: positioning / dependent-sizepage = canvas(name="Size moves followers", size=(120 mm, 80 mm), background="#f7f9fc")font = "DejaVu Sans"heading = text(content="Size moves followers", font_family=font, font_size=14 pt, color="#203864")page.add(heading, target=page.top_left, offset=(7 mm, 5 mm))# BEGIN DEMObox = rect(size=(20 mm, 23 mm), fill="#087f8c")first = page.add(box,size=(47 mm, auto), target=page.top_left, offset=(10 mm, 28 mm))follower = page.add(box, target=first.top_right, offset=(6 mm, 0 mm))page.add(text(content="47 mm", font_family=font, font_size=9 pt, color="#ffffff"), anchor=center, target=first.center)page.add(text(content="next", font_family=font, font_size=9 pt, color="#ffffff"), anchor=center, target=follower.center)# END DEMO预览
依赖文件
examples/gallery/positioning/dependent-size.lay
常见错误与限制#
页面尺寸必须为正且不接受 auto。不能把角度与长度相加。line(angle=...) 支持 deg/rad，裸角度按度；极坐标数据角度由 angle_unit 指定。
逐项功能说明#
详细行为与补充示例#
物理长度与标量#
page = canvas(size=(150, 100), unit="mm")panel = rect(size=(40, 25), fill="#eef5f2", border_color="#245447", border_width=0.6)page.add(panel, offset=(2cm, 35))尺寸、位置、间距、几何半径和 padding 跟随画布单位。字号、行高、边框宽度、线宽与虚线长度的裸值按 pt 解释。显式单位优先：2cm、2 cm、2inch、2in 都可使用。layout_dpi=96 只控制 px 到物理长度的换算，PNG 导出 --dpi 独立控制像素数。
数据、透明度、缩放比例、计数、坐标范围仍是无单位标量。裸数字仅在物理参数入口换算；2mm + 3 不合法，2mm + 3cm 合法。
自动尺寸#
图片 size=(80, auto) 固定宽度并保持原图比例；文字使用它限定换行宽度，高度随内容计算。page.add(plot, size=(120, 90)) 会重新排版图表；固定绘图区不随外框缩放。
photo = image(src="sample.png")page.add(photo, size=(2inch, auto), offset=(2cm, 35)).width 和 .height 保留为实例的只读测量值。不能再向构造器或 add 传入 width=、height=。
具名区域#
固定绘图区使用 plot_area=box(offset=(20, 10), size=(80, 55))。图片裁剪使用 crop=box(offset=(0.1, 0.1), size=(0.8, 0.8))；裁剪数值是原图归一化坐标，仍是 0–1 的标量。
workflow#
本流程的完整源码与可执行验证文件列在功能覆盖清单。组合使用时请遵循本页的输入条件与限制。