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

    A thermometer column on an InstrumentScale - every gradation labelled. More...

    Import Statement: import Clayground.Lab

    Properties

    Detailed Description

    The face for a quantity that has a natural bottom and is read off the scale rather than as a proportion: a temperature, a wind speed, a water level, a tank. It is the vertical sibling of BarFace, and the difference is what it is for: a bar answers "how full", a column answers "how much" - so every major gradation carries its number, and the reading is capped by a line you can sight along.

    Flat: an ink-edged column, a fill in the colour the reading has earned, the severity bands tinted behind it, a bulb at the foot because that is what makes the shape read as an instrument rather than as a progress bar. No glass, no mercury shine.

    Example usage:

    import Clayground.Lab
    
    InstrumentScale {
        id: wind
        probe: "windSpeed"
        unit: "m/s"; min: 0; max: 30
        okUntil: 12; warnUntil: 20
        damping: 0.5
    }
    
    ColumnFace { height: panel.body.height; scale: wind; label: "WIND" }

    See also InstrumentScale, BarFace, DigitFace, and Gauge.

    Property Documentation

    frameRadius : real

    Corner radius of the frame - 0 when baked into a Texture.


    label : string

    Caption above the column; empty hides the row.


    scale : InstrumentScale

    The measurement model this face draws.


    showBulb : bool

    Draw the reservoir at the foot.


    showFrame : bool

    Draw the panel background and border behind the face.


    showPeak : bool

    Mark the held peak. Follows scale.peakHold by default.


    showValue : bool

    Print the reading above the column.


    showZones : bool

    Tint the severity bands into the column.


    thickness : real

    Width of the column.