组与复用#

用途与概念#

group 是带局部坐标的可复用容器。先向组添加实例，再把整个组放入页面。组内 target 引用同一组内已经存在的实例，组的放置会重放这些关系。

最小完整示例#

此文件包含画布及必要定义，可直接运行 laymesh validate 或 laymesh render，不依赖前文未声明的变量。

1# Minimal complete example: group2page=canvas(size=(100mm,75mm),background="#ffffff")3g=group()4a=g.add(rect(size=(35mm,20mm),fill="#e6f2f3"))5g.add(text("Reused"),target=a.center,anchor=center)6page.add(g,offset=(8mm,8mm))7page.add(g,offset=(55mm,38mm),rotation=15deg)

# Minimal complete example: group
page=canvas(size=(100mm,75mm),background="#ffffff")
g=group()
a=g.add(rect(size=(35mm,20mm),fill="#e6f2f3"))
g.add(text("Reused"),target=a.center,anchor=center)
page.add(g,offset=(8mm,8mm))
page.add(g,offset=(55mm,38mm),rotation=15deg)

1# Minimal complete example: group2page=canvas(size=(100mm,75mm),background="#ffffff")3g=group()4a=g.add(rect(size=(35mm,20mm),fill="#e6f2f3"))5g.add(text("Reused"),target=a.center,anchor=center)6page.add(g,offset=(8mm,8mm))7page.add(g,offset=(55mm,38mm),rotation=15deg)

# Minimal complete example: group
page=canvas(size=(100mm,75mm),background="#ffffff")
g=group()
a=g.add(rect(size=(35mm,20mm),fill="#e6f2f3"))
g.add(text("Reused"),target=a.center,anchor=center)
page.add(g,offset=(8mm,8mm))
page.add(g,offset=(55mm,38mm),rotation=15deg)

依赖文件

examples/manual/group.lay

参数与默认行为#

裸几何长度使用画布单位，裸字号和描边宽度使用 pt。显式调用参数优先于继承和主题默认值；下面的接口参考逐项列出允许类型、可选值与默认来源。

组合用法#

用组组合底板、标题和连接线，可以多次放置、旋转或缩放。fuse 是另一项操作：把同容器中已放置的两个矢量实例合并成一个新轮廓，原实例退出绘制和引用。

7card = group()8base = card.add(rect(size=(38 mm, 28 mm), border_radius=3 mm, fill="#d8f0ec",9                     border_color="#087f8c", border_width=0.5 mm), target=card.top_left)10card.add(ellipse(size=(10 mm, 10 mm), fill="#f2ab47"),11         anchor=center, target=base.center)12first = page.add(card, target=page.top_left, offset=(8 mm, 30 mm))13page.add(card,size=(52 mm, 38 mm), target=first.top_right,14         offset=(11 mm, -3 mm))

card = group()
base = card.add(rect(size=(38 mm, 28 mm), border_radius=3 mm, fill="#d8f0ec",
                     border_color="#087f8c", border_width=0.5 mm), target=card.top_left)
card.add(ellipse(size=(10 mm, 10 mm), fill="#f2ab47"),
         anchor=center, target=base.center)
first = page.add(card, target=page.top_left, offset=(8 mm, 30 mm))
page.add(card,size=(52 mm, 38 mm), target=first.top_right,
         offset=(11 mm, -3 mm))

1# Gallery: containers / group-reuse2page = canvas(name="Reusable group", size=(120 mm, 80 mm), background="#f7f9fc")3font = "DejaVu Sans"4heading = text(content="Reusable group", font_family=font, font_size=14 pt, color="#203864")5page.add(heading, target=page.top_left, offset=(7 mm, 5 mm))6# BEGIN DEMO7card = group()8base = card.add(rect(size=(38 mm, 28 mm), border_radius=3 mm, fill="#d8f0ec",9                     border_color="#087f8c", border_width=0.5 mm), target=card.top_left)10card.add(ellipse(size=(10 mm, 10 mm), fill="#f2ab47"),11         anchor=center, target=base.center)12first = page.add(card, target=page.top_left, offset=(8 mm, 30 mm))13page.add(card,size=(52 mm, 38 mm), target=first.top_right,14         offset=(11 mm, -3 mm))15# END DEMO

# Gallery: containers / group-reuse
page = canvas(name="Reusable group", size=(120 mm, 80 mm), background="#f7f9fc")
font = "DejaVu Sans"
heading = text(content="Reusable group", font_family=font, font_size=14 pt, color="#203864")
page.add(heading, target=page.top_left, offset=(7 mm, 5 mm))
# BEGIN DEMO
card = group()
base = card.add(rect(size=(38 mm, 28 mm), border_radius=3 mm, fill="#d8f0ec",
                     border_color="#087f8c", border_width=0.5 mm), target=card.top_left)
card.add(ellipse(size=(10 mm, 10 mm), fill="#f2ab47"),
         anchor=center, target=base.center)
first = page.add(card, target=page.top_left, offset=(8 mm, 30 mm))
page.add(card,size=(52 mm, 38 mm), target=first.top_right,
         offset=(11 mm, -3 mm))
# END DEMO