← Back to Docs
  • index.html
  • Clayground
  • Clayground.Lab
  • PartPlacer
  • Clayground 2026.7
  • PartPlacer QML Type

    The palette's parts as ONE handheld tool that carries which part it is about to place. More...

    Import Statement: import Clayground.Lab
    Inherits:

    HandheldInstrument

    Properties

    Signals

    Detailed Description

    A build tool is an instrument whose reading is an act: it takes a place, and instead of remembering it, it puts something there. That is the whole of "build is not a mode" - clicking a part in the palette TAKES it, the board shows a ghost where it would go, a click puts it there, and Esc or the right button puts it back down. The ghost is the domain's (it is the part's own visual, half transparent); this only says where and whether.

    InstrumentBelt {
        id: hands
        PartPlacer { id: placer; board: board }
    }

    See also HandheldInstrument, InstrumentBelt, Board, and BoardPalette.

    Property Documentation

    board : Board


    free : bool [read-only]

    The spot is free - the one refusal a placement can meet, and the ghost says so first.


    partType : string


    partType \brief What the next click places. : string


    spot : var [read-only]

    Where the part would land, as board cells {col, row} - null off-board.


    Signal Documentation

    placed(int id)

    Note: The corresponding handler is onPlaced.