Shapes and drawing#

Basic shapes, paths, fills, dashes, compound outlines, and visible-outline fusion.

Basic shapes#

Rounded rectangle#

Set corner radius, fill, and stroke independently on a rectangle.

1tile = rect(size=(61 mm, 37 mm), border_radius=6 mm, fill="#d8f0ec",2            border_color="#087f8c", border_width=1 mm)3page.add(tile, target=page.top_left, offset=(28 mm, 28 mm))

tile = rect(size=(61 mm, 37 mm), border_radius=6 mm, fill="#d8f0ec",
            border_color="#087f8c", border_width=1 mm)
page.add(tile, target=page.top_left, offset=(28 mm, 28 mm))

Rendered result: Rounded rectangle

Source: rect.lay.

Reproduce: laymesh validate examples/gallery/shapes/rect.lay; laymesh render examples/gallery/shapes/rect.lay -o rect.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/rect.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Ellipse#

Use different width and height to show the fill, stroke, and bounding box.

1oval = ellipse(size=(68 mm, 38 mm), fill="#f3be6b",2               border_color="#a66435", border_width=0.8 mm)3page.add(oval, target=page.top_left, offset=(25 mm, 28 mm))

oval = ellipse(size=(68 mm, 38 mm), fill="#f3be6b",
               border_color="#a66435", border_width=0.8 mm)
page.add(oval, target=page.top_left, offset=(25 mm, 28 mm))

Rendered result: Ellipse

Source: ellipse.lay.

Reproduce: laymesh validate examples/gallery/shapes/ellipse.lay; laymesh render examples/gallery/shapes/ellipse.lay -o ellipse.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/ellipse.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Line and arrow#

Draw a straight line and a diagonal arrow in the same coordinate system.

1page.add(line(dx=55 mm, dy=0 mm, line_color="#087f8c", line_width=1.2 mm),2         target=page.top_left, offset=(18 mm, 34 mm))3page.add(line(end_head=head(), dx=55 mm, dy=13 mm, line_color="#e67563", line_width=1.2 mm),4         target=page.top_left, offset=(18 mm, 48 mm))

page.add(line(dx=55 mm, dy=0 mm, line_color="#087f8c", line_width=1.2 mm),
         target=page.top_left, offset=(18 mm, 34 mm))
page.add(line(end_head=head(), dx=55 mm, dy=13 mm, line_color="#e67563", line_width=1.2 mm),
         target=page.top_left, offset=(18 mm, 48 mm))

Source: line-arrow.lay.

Reproduce: laymesh validate examples/gallery/shapes/line-arrow.lay; laymesh render examples/gallery/shapes/line-arrow.lay -o line-arrow.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/line-arrow.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Preset shapes#

Polygon and polyline#

A polygon closes automatically; a polyline follows only the supplied points.

1area = polygon(points=[(0 mm, 26 mm), (20 mm, 0 mm), (41 mm, 9 mm),2                       (50 mm, 28 mm), (12 mm, 35 mm)],3               fill="#a4dcd7", border_color="#087f8c", border_width=0.6 mm)4page.add(area, target=page.top_left, offset=(8 mm, 30 mm))5route = polyline(points=[(0 mm, 28 mm), (13 mm, 6 mm), (28 mm, 25 mm),6                         (43 mm, 0 mm)],7                 line_color="#e67563", line_width=1.4 mm, line_cap=round)8page.add(route, target=page.top_left, offset=(66 mm, 33 mm))

area = polygon(points=[(0 mm, 26 mm), (20 mm, 0 mm), (41 mm, 9 mm),
                       (50 mm, 28 mm), (12 mm, 35 mm)],
               fill="#a4dcd7", border_color="#087f8c", border_width=0.6 mm)
page.add(area, target=page.top_left, offset=(8 mm, 30 mm))
route = polyline(points=[(0 mm, 28 mm), (13 mm, 6 mm), (28 mm, 25 mm),
                         (43 mm, 0 mm)],
                 line_color="#e67563", line_width=1.4 mm, line_cap=round)
page.add(route, target=page.top_left, offset=(66 mm, 33 mm))

Rendered result: Polygon and polyline

Source: polygon-polyline.lay.

Reproduce: laymesh validate examples/gallery/shapes/polygon-polyline.lay; laymesh render examples/gallery/shapes/polygon-polyline.lay -o polygon-polyline.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/polygon-polyline.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Arc and sector#

Compare an open arc with a closed sector at the same radius.

1page.add(arc(radius=18 mm, start=-45 deg, end=220 deg,2             line_color="#087f8c", line_width=1.5 mm, line_cap=round),3         target=page.top_left, offset=(16 mm, 32 mm))4page.add(sector(radius=18 mm, start=-40 deg, end=160 deg,5                fill="#f3be6b", border_color="#a66435", border_width=0.5 mm),6         target=page.top_left, offset=(68 mm, 32 mm))

page.add(arc(radius=18 mm, start=-45 deg, end=220 deg,
             line_color="#087f8c", line_width=1.5 mm, line_cap=round),
         target=page.top_left, offset=(16 mm, 32 mm))
page.add(sector(radius=18 mm, start=-40 deg, end=160 deg,
                fill="#f3be6b", border_color="#a66435", border_width=0.5 mm),
         target=page.top_left, offset=(68 mm, 32 mm))

Rendered result: Arc and sector

Source: arc-sector.lay.

Reproduce: laymesh validate examples/gallery/shapes/arc-sector.lay; laymesh render examples/gallery/shapes/arc-sector.lay -o arc-sector.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/arc-sector.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Star and ring#

Inner and outer radii shape the star; the ring keeps its central hole transparent.

1page.add(star(points=7, outer_radius=20 mm, inner_radius=9 mm,2              fill="#f3be6b", border_color="#a66435", border_width=0.6 mm),3         target=page.top_left, offset=(15 mm, 31 mm))4page.add(ring(outer_radius=20 mm, inner_radius=9 mm,5              fill="#70c4be", border_color="#087f8c", border_width=0.6 mm),6         target=page.top_left, offset=(65 mm, 31 mm))

page.add(star(points=7, outer_radius=20 mm, inner_radius=9 mm,
              fill="#f3be6b", border_color="#a66435", border_width=0.6 mm),
         target=page.top_left, offset=(15 mm, 31 mm))
page.add(ring(outer_radius=20 mm, inner_radius=9 mm,
              fill="#70c4be", border_color="#087f8c", border_width=0.6 mm),
         target=page.top_left, offset=(65 mm, 31 mm))

Source: star-ring.lay.

Reproduce: laymesh validate examples/gallery/shapes/star-ring.lay; laymesh render examples/gallery/shapes/star-ring.lay -o star-ring.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/star-ring.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Paths and fills#

Path commands#

Join straight, quadratic, cubic, and elliptical-arc segments into one path.

1curve = path(commands=[2    move_to(0 mm, 27 mm),3    line_to(12 mm, 5 mm),4    quad_to(23 mm, -5 mm, 35 mm, 10 mm),5    cubic_to(44 mm, 24 mm, 54 mm, 7 mm, 65 mm, 13 mm),6    arc_to(12 mm, 12 mm, 0 deg, false, true, 82 mm, 27 mm)7], fill="none", border_color="#087f8c", border_width=1.5 mm,8   border_cap=round, border_join=round)9page.add(curve, target=page.top_left, offset=(13 mm, 31 mm))

curve = path(commands=[
    move_to(0 mm, 27 mm),
    line_to(12 mm, 5 mm),
    quad_to(23 mm, -5 mm, 35 mm, 10 mm),
    cubic_to(44 mm, 24 mm, 54 mm, 7 mm, 65 mm, 13 mm),
    arc_to(12 mm, 12 mm, 0 deg, false, true, 82 mm, 27 mm)
], fill="none", border_color="#087f8c", border_width=1.5 mm,
   border_cap=round, border_join=round)
page.add(curve, target=page.top_left, offset=(13 mm, 31 mm))

Rendered result: Path commands

Source: path-commands.lay.

Reproduce: laymesh validate examples/gallery/shapes/path-commands.lay; laymesh render examples/gallery/shapes/path-commands.lay -o path-commands.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/path-commands.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Even-odd hole#

Outer and inner subpaths use even-odd fill to leave a transparent hole.

1frame = path(commands=[2  move_to(0 mm, 0 mm), line_to(62 mm, 0 mm),3  line_to(62 mm, 42 mm), line_to(0 mm, 42 mm), close(),4  move_to(19 mm, 12 mm), line_to(43 mm, 12 mm),5  line_to(43 mm, 30 mm), line_to(19 mm, 30 mm), close()6], fill="#087f8c", fill_rule=evenodd,7   border_color="#203864", border_width=0.5 mm)8page.add(frame, target=page.top_left, offset=(27 mm, 27 mm))

frame = path(commands=[
  move_to(0 mm, 0 mm), line_to(62 mm, 0 mm),
  line_to(62 mm, 42 mm), line_to(0 mm, 42 mm), close(),
  move_to(19 mm, 12 mm), line_to(43 mm, 12 mm),
  line_to(43 mm, 30 mm), line_to(19 mm, 30 mm), close()
], fill="#087f8c", fill_rule=evenodd,
   border_color="#203864", border_width=0.5 mm)
page.add(frame, target=page.top_left, offset=(27 mm, 27 mm))

Rendered result: Even-odd hole

Source: evenodd-hole.lay.

Reproduce: laymesh validate examples/gallery/shapes/evenodd-hole.lay; laymesh render examples/gallery/shapes/evenodd-hole.lay -o evenodd-hole.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/evenodd-hole.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Linear gradient#

Fill a rectangle diagonally with multiple color stops.

1paint = linear_gradient(start=(0, 0), end=(1, 1),2                        stops=[(0, "#f8cf7b"), (0.5, "#ed8770"), (1, "#8f5fa5")])3page.add(rect(size=(75 mm, 42 mm), border_radius=5 mm, fill=paint),4         target=page.top_left, offset=(22 mm, 27 mm))

paint = linear_gradient(start=(0, 0), end=(1, 1),
                        stops=[(0, "#f8cf7b"), (0.5, "#ed8770"), (1, "#8f5fa5")])
page.add(rect(size=(75 mm, 42 mm), border_radius=5 mm, fill=paint),
         target=page.top_left, offset=(22 mm, 27 mm))

Rendered result: Linear gradient

Source: linear-gradient.lay.

Reproduce: laymesh validate examples/gallery/shapes/linear-gradient.lay; laymesh render examples/gallery/shapes/linear-gradient.lay -o linear-gradient.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/linear-gradient.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Radial gradient#

Control the transition inside an ellipse with a center and radius.

1paint = radial_gradient(center=(0.37, 0.3), radius=0.8,2                        stops=[(0, "#d8fff7"), (1, "#087f8c")])3page.add(ellipse(size=(54 mm, 43 mm), fill=paint),4         target=page.top_left, offset=(33 mm, 27 mm))

paint = radial_gradient(center=(0.37, 0.3), radius=0.8,
                        stops=[(0, "#d8fff7"), (1, "#087f8c")])
page.add(ellipse(size=(54 mm, 43 mm), fill=paint),
         target=page.top_left, offset=(33 mm, 27 mm))

Rendered result: Radial gradient

Source: radial-gradient.lay.

Reproduce: laymesh validate examples/gallery/shapes/radial-gradient.lay; laymesh render examples/gallery/shapes/radial-gradient.lay -o radial-gradient.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/radial-gradient.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Strokes and composition#

Custom dashes#

Compare one and multiple dash-gap length pairs on two lines.

1page.add(line(dx=84 mm, dy=0 mm, line_color="#087f8c", line_width=1.3 mm,2              line_dash=[5 mm, 2 mm], line_cap=round),3         target=page.top_left, offset=(16 mm, 35 mm))4page.add(line(dx=84 mm, dy=0 mm, line_color="#e67563", line_width=1.3 mm,5              line_dash=[1 mm, 2 mm, 5 mm, 2 mm], line_cap=round),6         target=page.top_left, offset=(16 mm, 52 mm))

page.add(line(dx=84 mm, dy=0 mm, line_color="#087f8c", line_width=1.3 mm,
              line_dash=[5 mm, 2 mm], line_cap=round),
         target=page.top_left, offset=(16 mm, 35 mm))
page.add(line(dx=84 mm, dy=0 mm, line_color="#e67563", line_width=1.3 mm,
              line_dash=[1 mm, 2 mm, 5 mm, 2 mm], line_cap=round),
         target=page.top_left, offset=(16 mm, 52 mm))

Rendered result: Custom dashes

Source: dashes.lay.

Reproduce: laymesh validate examples/gallery/shapes/dashes.lay; laymesh render examples/gallery/shapes/dashes.lay -o dashes.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/dashes.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Reusable outlines#

Create single, double, and triple outlines from the same color and line width.

1 2 3 4box = rect(size=(27 mm, 25 mm), border_radius=3 mm,5           fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style="solid")6page.add(box, target=page.top_left, offset=(11 mm, 32 mm))7page.add(rect(size=(27 mm, 25 mm), border_radius=3 mm,8              fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style=double),9         target=page.top_left, offset=(46 mm, 32 mm))10page.add(rect(size=(27 mm, 25 mm), border_radius=3 mm,11              fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style=triple),12         target=page.top_left, offset=(81 mm, 32 mm))



box = rect(size=(27 mm, 25 mm), border_radius=3 mm,
           fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style="solid")
page.add(box, target=page.top_left, offset=(11 mm, 32 mm))
page.add(rect(size=(27 mm, 25 mm), border_radius=3 mm,
              fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style=double),
         target=page.top_left, offset=(46 mm, 32 mm))
page.add(rect(size=(27 mm, 25 mm), border_radius=3 mm,
              fill="#d8f0ec", border_color="#087f8c", border_width=1.6 mm, border_style=triple),
         target=page.top_left, offset=(81 mm, 32 mm))

Rendered result: Reusable outlines

Source: outlines.lay.

Reproduce: laymesh validate examples/gallery/shapes/outlines.lay; laymesh render examples/gallery/shapes/outlines.lay -o outlines.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/outlines.lay（120 × 80 mm，4 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Visible-outline fusion#

Join the visible outlines of a rectangle and line into a new vector path.

1box = rect(size=(23 mm, 21 mm), fill="#087f8c")2left = page.add(box, target=page.top_left, offset=(16 mm, 35 mm))3stem = page.add(line(dx=42 mm, dy=0 mm, line_color="#087f8c",4                     line_width=4 mm),5                target=page.top_left, offset=(45 mm, 45.5 mm))6joined = page.fuse(left, stem, points=(left.middle_right, stem.start),7                   bridge_width=4 mm, junction=round, radius=2 mm,8                   fill="#087f8c", border_color="none")

box = rect(size=(23 mm, 21 mm), fill="#087f8c")
left = page.add(box, target=page.top_left, offset=(16 mm, 35 mm))
stem = page.add(line(dx=42 mm, dy=0 mm, line_color="#087f8c",
                     line_width=4 mm),
                target=page.top_left, offset=(45 mm, 45.5 mm))
joined = page.fuse(left, stem, points=(left.middle_right, stem.start),
                   bridge_width=4 mm, junction=round, radius=2 mm,
                   fill="#087f8c", border_color="none")

Rendered result: Visible-outline fusion

Source: fuse.lay.

Reproduce: laymesh validate examples/gallery/shapes/fuse.lay; laymesh render examples/gallery/shapes/fuse.lay -o fuse.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/fuse.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Angled line on a straight edge#

Join lines sloping up and down to rectangle edges and inspect both continuous fillets.

1box = rect(size=(20 mm, 18 mm), fill="#087f8c")2upper = page.add(box, target=page.top_left, offset=(12 mm, 24 mm))3up_line = page.add(line(dx=35 mm, dy=-12 mm, line_width=3 mm),4                   target=page.top_left, offset=(44 mm, 21 mm))5up_join = page.fuse(upper, up_line, points=(upper.middle_right, up_line.start),6                    bridge_width=3 mm, junction=round, radius=2 mm,7                    fill="#087f8c", border_color="none")8 9lower = page.add(box, target=page.top_left, offset=(12 mm, 50 mm))10down_line = page.add(line(dx=35 mm, dy=12 mm, line_width=3 mm),11                     target=page.top_left, offset=(44 mm, 59 mm))12down_join = page.fuse(lower, down_line, points=(lower.middle_right, down_line.start),13                      bridge_width=3 mm, junction=round, radius=2 mm,14                      fill="#087f8c", border_color="none")

box = rect(size=(20 mm, 18 mm), fill="#087f8c")
upper = page.add(box, target=page.top_left, offset=(12 mm, 24 mm))
up_line = page.add(line(dx=35 mm, dy=-12 mm, line_width=3 mm),
                   target=page.top_left, offset=(44 mm, 21 mm))
up_join = page.fuse(upper, up_line, points=(upper.middle_right, up_line.start),
                    bridge_width=3 mm, junction=round, radius=2 mm,
                    fill="#087f8c", border_color="none")

lower = page.add(box, target=page.top_left, offset=(12 mm, 50 mm))
down_line = page.add(line(dx=35 mm, dy=12 mm, line_width=3 mm),
                     target=page.top_left, offset=(44 mm, 59 mm))
down_join = page.fuse(lower, down_line, points=(lower.middle_right, down_line.start),
                      bridge_width=3 mm, junction=round, radius=2 mm,
                      fill="#087f8c", border_color="none")

Rendered result: Angled line on a straight edge

Source: fuse-angled.lay.

Reproduce: laymesh validate examples/gallery/shapes/fuse-angled.lay; laymesh render examples/gallery/shapes/fuse-angled.lay -o fuse-angled.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/fuse-angled.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Angled line on a curved edge#

Join lines to an ellipse and a free Bézier curve, inspecting the curved seams.

1disk = ellipse(size=(22 mm, 22 mm), fill="#087f8c")2round_surface = page.add(disk, target=page.top_left, offset=(12 mm, 24 mm))3up_line = page.add(line(dx=30 mm, dy=-8 mm, line_width=3 mm),4                   target=page.top_left, offset=(46 mm, 27 mm))5round_join = page.fuse(round_surface, up_line,6                       points=(round_surface.middle_right, up_line.start),7                       bridge_width=3 mm, junction=round, radius=2 mm,8                       fill="#087f8c", border_color="none")9 10freeform = path(commands=[move_to(0 mm,0 mm), line_to(20 mm,0 mm),11                          cubic_to(25 mm,4 mm,25 mm,16 mm,20 mm,20 mm),12                          line_to(0 mm,20 mm), close()], fill="#087f8c")13curved_surface = page.add(freeform, target=page.top_left, offset=(12 mm, 51 mm))14down_line = page.add(line(dx=30 mm, dy=8 mm, line_width=3 mm),15                     target=page.top_left, offset=(46 mm, 61 mm))16curved_join = page.fuse(curved_surface, down_line,17                        points=(curved_surface.middle_right, down_line.start),18                        bridge_width=3 mm, junction=round, radius=2 mm,19                        fill="#087f8c", border_color="none")

disk = ellipse(size=(22 mm, 22 mm), fill="#087f8c")
round_surface = page.add(disk, target=page.top_left, offset=(12 mm, 24 mm))
up_line = page.add(line(dx=30 mm, dy=-8 mm, line_width=3 mm),
                   target=page.top_left, offset=(46 mm, 27 mm))
round_join = page.fuse(round_surface, up_line,
                       points=(round_surface.middle_right, up_line.start),
                       bridge_width=3 mm, junction=round, radius=2 mm,
                       fill="#087f8c", border_color="none")

freeform = path(commands=[move_to(0 mm,0 mm), line_to(20 mm,0 mm),
                          cubic_to(25 mm,4 mm,25 mm,16 mm,20 mm,20 mm),
                          line_to(0 mm,20 mm), close()], fill="#087f8c")
curved_surface = page.add(freeform, target=page.top_left, offset=(12 mm, 51 mm))
down_line = page.add(line(dx=30 mm, dy=8 mm, line_width=3 mm),
                     target=page.top_left, offset=(46 mm, 61 mm))
curved_join = page.fuse(curved_surface, down_line,
                        points=(curved_surface.middle_right, down_line.start),
                        bridge_width=3 mm, junction=round, radius=2 mm,
                        fill="#087f8c", border_color="none")

Rendered result: Angled line on a curved edge

Source: fuse-curved.lay.

Reproduce: laymesh validate examples/gallery/shapes/fuse-curved.lay; laymesh render examples/gallery/shapes/fuse-curved.lay -o fuse-curved.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/fuse-curved.lay（120 × 80 mm，3 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Line joined to a hollow edge#

Join a diagonal line at the midpoint of a hollow rectangle's right edge while preserving its hole.

1frame = rect(size=(46 mm, 42 mm), fill="none",2             border_color="#ffffff", border_width=2 mm)3box = page.add(frame, target=page.top_left, offset=(16 mm, 26 mm))4stem = page.add(line(dx=32 mm, dy=-32 mm, line_color="#ffffff",5                     line_width=2 mm, line_cap=round),6                target=page.top_left, offset=(62 mm, 15 mm))7joined = page.fuse(box, stem, points=(box.middle_right, stem.start),8                   junction=round, radius=1.5 mm,9                   fill="#ffffff", border_color="none")

frame = rect(size=(46 mm, 42 mm), fill="none",
             border_color="#ffffff", border_width=2 mm)
box = page.add(frame, target=page.top_left, offset=(16 mm, 26 mm))
stem = page.add(line(dx=32 mm, dy=-32 mm, line_color="#ffffff",
                     line_width=2 mm, line_cap=round),
                target=page.top_left, offset=(62 mm, 15 mm))
joined = page.fuse(box, stem, points=(box.middle_right, stem.start),
                   junction=round, radius=1.5 mm,
                   fill="#ffffff", border_color="none")

Rendered result: Line joined to a hollow edge

Source: fuse-outline-edge.lay.

Reproduce: laymesh validate examples/gallery/shapes/fuse-outline-edge.lay; laymesh render examples/gallery/shapes/fuse-outline-edge.lay -o fuse-outline-edge.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/fuse-outline-edge.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Line joined to a hollow corner#

Join a diagonal line at a hollow rectangle's upper-right corner and preserve both contours.

1frame = rect(size=(46 mm, 38 mm), fill="none",2             border_color="#ffffff", border_width=2 mm)3box = page.add(frame, target=page.top_left, offset=(16 mm, 34 mm))4stem = page.add(line(dx=28 mm, dy=-28 mm, line_color="#ffffff",5                     line_width=2 mm, line_cap=round),6                target=page.top_left, offset=(62 mm, 6 mm))7joined = page.fuse(box, stem, points=(box.top_right, stem.start),8                   junction=round, radius=1.5 mm,9                   fill="#ffffff", border_color="none")

frame = rect(size=(46 mm, 38 mm), fill="none",
             border_color="#ffffff", border_width=2 mm)
box = page.add(frame, target=page.top_left, offset=(16 mm, 34 mm))
stem = page.add(line(dx=28 mm, dy=-28 mm, line_color="#ffffff",
                     line_width=2 mm, line_cap=round),
                target=page.top_left, offset=(62 mm, 6 mm))
joined = page.fuse(box, stem, points=(box.top_right, stem.start),
                   junction=round, radius=1.5 mm,
                   fill="#ffffff", border_color="none")

Rendered result: Line joined to a hollow corner

Source: fuse-outline-corner.lay.

Reproduce: laymesh validate examples/gallery/shapes/fuse-outline-corner.lay; laymesh render examples/gallery/shapes/fuse-outline-corner.lay -o fuse-outline-corner.png --dpi 150.

Observed CLI output: 有效：examples/gallery/shapes/fuse-outline-corner.lay（120 × 80 mm，2 个顶层实例）; PNG 709 × 472 px at 150 DPI; warnings: none.

Line endpoints and standalone heads#

1# Gallery: shapes / line-endpoints2page=canvas(name="Line endpoints",size=(180mm,120mm),background="#fff")3page.add(text("Line endpoints",font_family="DejaVu Sans",font_size=16pt,color="#203864"),offset=(8mm,6mm))4# BEGIN DEMO5shapes=["triangle","open","stealth","dot","diamond","bar"]6for item in [(36mm,"Start"),(77mm,"End"),(118mm,"Both"),(153mm,"Head only")] {7    page.add(text(item[1],font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(item[0],18mm))8}9for i in range(6) {10    y=30mm+i*11mm11    page.add(text(shapes[i],font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(8mm,y-2mm))12    h=head(shape=shapes[i],size=(6mm,5mm))13    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_head=h,end_cap="round"),offset=(35mm,y))14    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_cap="round",end_head=h),offset=(76mm,y))15    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_head=h,end_head=h),offset=(117mm,y))16    page.add(line(length=0mm,angle=-25deg,line_color="#087f8c",end_head=h),anchor=self.path.end,offset=(162mm,y))17}18route=page.add(path(commands=[move_to(0mm,8mm),cubic_to(c1x=12mm,c1y=-4mm,c2x=32mm,c2y=20mm,x=47mm,y=8mm)],border_color="#e67563",border_width=1.5mm,start_head=head(size=(6mm,5mm)),end_head=head(size=(6mm,5mm))),offset=(35mm,95mm))19for p in [route.path.start,route.path.end] {20    page.add(ellipse(size=(1mm,1mm),fill="#203864"),anchor=center,target=p)21}22# END DEMO23page.add(text("Dots mark logical endpoints; centerline reaches each arrow tip.",font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(35mm,111mm))

# Gallery: shapes / line-endpoints
page=canvas(name="Line endpoints",size=(180mm,120mm),background="#fff")
page.add(text("Line endpoints",font_family="DejaVu Sans",font_size=16pt,color="#203864"),offset=(8mm,6mm))
# BEGIN DEMO
shapes=["triangle","open","stealth","dot","diamond","bar"]
for item in [(36mm,"Start"),(77mm,"End"),(118mm,"Both"),(153mm,"Head only")] {
    page.add(text(item[1],font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(item[0],18mm))
}
for i in range(6) {
    y=30mm+i*11mm
    page.add(text(shapes[i],font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(8mm,y-2mm))
    h=head(shape=shapes[i],size=(6mm,5mm))
    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_head=h,end_cap="round"),offset=(35mm,y))
    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_cap="round",end_head=h),offset=(76mm,y))
    page.add(line(length=27mm,line_width=1.6mm,line_color="#0072b299",start_head=h,end_head=h),offset=(117mm,y))
    page.add(line(length=0mm,angle=-25deg,line_color="#087f8c",end_head=h),anchor=self.path.end,offset=(162mm,y))
}
route=page.add(path(commands=[move_to(0mm,8mm),cubic_to(c1x=12mm,c1y=-4mm,c2x=32mm,c2y=20mm,x=47mm,y=8mm)],border_color="#e67563",border_width=1.5mm,start_head=head(size=(6mm,5mm)),end_head=head(size=(6mm,5mm))),offset=(35mm,95mm))
for p in [route.path.start,route.path.end] {
    page.add(ellipse(size=(1mm,1mm),fill="#203864"),anchor=center,target=p)
}
# END DEMO
page.add(text("Dots mark logical endpoints; centerline reaches each arrow tip.",font_family="DejaVu Sans",font_size=8pt,color="#425466"),offset=(35mm,111mm))

Line endpoints and standalone heads

Source: line-endpoints.lay.

Reproduce: laymesh validate examples/gallery/shapes/line-endpoints.lay; laymesh render examples/gallery/shapes/line-endpoints.lay -o line-endpoints.png --dpi 150.

Observed CLI output: valid, 180 × 120 mm page; PNG 1063 × 709 px at 150 DPI; no warnings.

Color spaces and transparency#

1# Gallery: shapes / colors-alpha2page=canvas(name="Color spaces and alpha",size=(145mm,95mm),background="#fff")3page.add(text("Color spaces and alpha",font_family="DejaVu Sans",font_size=16pt,color="#203864"),offset=(8mm,6mm))4# BEGIN DEMO5colors=["#0072b290",rgb(0,114,178,alpha=0.56),hsv(202deg,1,0.7,alpha=0.56),oklch(0.55,0.12,240deg,alpha=0.56)]6labels=["HEX + alpha","RGB + alpha","HSV + alpha","OKLCH + alpha"]7for i in range(4) {8    x=8mm+i*34mm9    page.add(rect(size=(27mm,43mm),fill="#e6f2f3"),offset=(x,25mm))10    page.add(rect(size=(27mm,14mm),fill="#bbbbbb"),offset=(x,39mm))11    page.add(ellipse(size=(25mm,36mm),fill=colors[i]),offset=(x+1mm,28mm))12    page.add(text(labels[i],font_family="DejaVu Sans",font_size=7pt,color="#425466"),offset=(x,72mm))13}14# END DEMO15page.add(text("One color model across shapes, text, gradients and plots.",font_family="DejaVu Sans",font_size=8pt,color=oklch(0.45,0.1,200deg)),offset=(8mm,84mm))

# Gallery: shapes / colors-alpha
page=canvas(name="Color spaces and alpha",size=(145mm,95mm),background="#fff")
page.add(text("Color spaces and alpha",font_family="DejaVu Sans",font_size=16pt,color="#203864"),offset=(8mm,6mm))
# BEGIN DEMO
colors=["#0072b290",rgb(0,114,178,alpha=0.56),hsv(202deg,1,0.7,alpha=0.56),oklch(0.55,0.12,240deg,alpha=0.56)]
labels=["HEX + alpha","RGB + alpha","HSV + alpha","OKLCH + alpha"]
for i in range(4) {
    x=8mm+i*34mm
    page.add(rect(size=(27mm,43mm),fill="#e6f2f3"),offset=(x,25mm))
    page.add(rect(size=(27mm,14mm),fill="#bbbbbb"),offset=(x,39mm))
    page.add(ellipse(size=(25mm,36mm),fill=colors[i]),offset=(x+1mm,28mm))
    page.add(text(labels[i],font_family="DejaVu Sans",font_size=7pt,color="#425466"),offset=(x,72mm))
}
# END DEMO
page.add(text("One color model across shapes, text, gradients and plots.",font_family="DejaVu Sans",font_size=8pt,color=oklch(0.45,0.1,200deg)),offset=(8mm,84mm))

Color spaces and alpha

Source: colors-alpha.lay.

Reproduce: laymesh validate examples/gallery/shapes/colors-alpha.lay; laymesh render examples/gallery/shapes/colors-alpha.lay -o colors-alpha.png --dpi 150.

Observed CLI output: valid, 145 × 95 mm page; PNG 856 × 561 px at 150 DPI; no warnings.