Skip to main content

Guides (Construction Geometry)

Sometimes you need geometry in a sketch just for reference — to position other shapes, define tangent lines, or set up construction lines — without including it in the final profile. The .guide() method marks any sketch element as construction geometry.

Making a guide​

Call .guide() on any sketch shape:

import { sketch } from 'fluidcad/core';
import { circle, polygon } from 'fluidcad/core';

sketch("xy", () => {
    circle(100).guide()
    polygon(6, 100)
})

Guide circle with hexagon

The guide circle helps you visually align the hexagon, but it's excluded from the final sketch output.

Use cases​

Alignment reference​

import { sketch, move } from 'fluidcad/core';
import { circle } from 'fluidcad/core';

sketch("xy", () => {
    circle(80).guide()

    move([40, 0])
    circle(15)

    move([-40, 40])
    circle(15)

    move([-40, -40])
    circle(15)
})

Guide circle for alignment

Construction lines​

sketch("xy", () => {
    line([0, 0], [100, 100]).guide()   // diagonal construction line
    rect(50, 30).centered()              // actual geometry
})

Guide geometry is visible in the viewport but does not contribute to the extruded or cut profile.