Appearance

A singleton with the look switches every Telamon app shares: transparency and blur, colour scheme, motion, text scale and the brand fonts.

Appearance holds the shared "Transparency and blur" setting (Transparency under [Appearance] in telamonrc, default on; the first time, atlasrc of 1.x is copied to it when it does not exist) and follows the desktop's preferences live. A KConfigWatcher keeps every open Telamon app in step when one of them, or the user, changes the file. Most apps read it through TelamonStyle and TelamonWindow rather than directly.

Example

import QtQuick
import Telamon.Ui

Rectangle {
    color: Appearance.darkMode ? "#202020" : "#f5f5f5"
    Behavior on color {
        enabled: !Appearance.reducedMotion
        ColorAnimation { duration: 150 }
    }
}

Note

effective is what a window acts on: transparency is on AND the compositor offers blur. Blur is missing in software rendering, many VMs, and when KWin's blur effect is off. Nothing signals a change in the compositor, so call refresh() when a window is shown or activated (TelamonWindow does).

The read-only system preferences each have a change signal, so a binding on them updates when the user changes the setting. The brand properties are CONSTANT but computed on each read. Separately, once when Telamon.Ui loads, telamonUiApplyBrand() sets the application font's family to IBM Plex Sans (when installed) and puts the violet highlight in the application palette unless the user chose a Plasma accent; it applies the palette again when the colour scheme changes.

Properties

Name	Type	Default	Description
`accentFromSystem`	`bool` (read-only)	—	`true` when the user chose an accent colour in Plasma (`AccentColor` in kdeglobals `[General]`). Then that accent is used; otherwise the Telamon violet (and the magenta-violet focus ring) is. Constant. Since 1.4.0.
`blurAvailable`	`bool` (read-only)	`false` until read	Whether the compositor offers blur. Updated by `refresh()`.
`colorScheme`	`int` (read-only) (Appearance.ColorScheme)	`Appearance.UnknownScheme`	The system colour scheme, from `QStyleHints`.
`darkMode`	`bool` (read-only)	`false`	`true` when `colorScheme` is dark. When it is unknown, whether the palette's window colour is dark.
`effective`	`bool` (read-only)	—	`transparency && blurAvailable`: whether windows should be translucent over blur.
`fontFamily`	`string` (read-only)	—	`"IBM Plex Sans"` when installed, else the system font's family. It is the application font's family only when IBM Plex Sans is installed. Constant, but computed on each read. Since 1.4.0.
`highContrast`	`bool` (read-only)	`false`	The system asks for high contrast (`QStyleHints` accessibility, Qt 6.10+, or the desktop portal's `contrast`, since 1.5.0).
`monoFamily`	`string` (read-only)	—	`"JetBrains Mono"` when installed, else the system fixed font. Constant, but computed on each read. Since 1.4.0.
`softwareRendering`	`bool` (read-only)	`false`	`true` when rendering is in software: the Qt Quick software adaptation, or OpenGL or Vulkan on a software rasterizer (llvmpipe, softpipe, SwiftShader, lavapipe). Known once the first frame is drawn; changes at most once, `false` to `true`. `TELAMON_SOFTWARE_RENDERING=1` (`ATLAS_...` before 2.0.0) or `0` forces it; any other value is logged and ignored. Apps read it through TelamonStyle. Since 1.5.0.
`reducedMotion`	`bool` (read-only)	`false`	`true` when Plasma's `AnimationDurationFactor` in kdeglobals `[KDE]` is 0 (animations off), the environment has `TELAMON_REDUCED_MOTION=1` (`ATLAS_REDUCED_MOTION=1` before 2.0.0), or the desktop portal's `reduced-motion` is 1 (since 1.5.0). A missing kdeglobals means `false`.
`textScale`	`real` (read-only)	`1.0`	The application font's point size over 10 (Plasma's default). 1.0 is the default size, 1.2 is 20% larger. Kept between 0.5 and 4.
`transparency`	`bool`	`true`	The shared "Transparency and blur" setting. Writable; the change is saved to `telamonrc` and reaches every open Telamon app.

Methods

Signature	Description
`applyBlur(QWindow* window): void`	Blurs (or stops blurring) everything behind the whole window, following `effective`. The window must exist: call it once it is visible.
`refresh(): void`	Asks the compositor again whether blur is on.

Enums

ColorScheme

Value	Description
`Appearance.UnknownScheme`	The system does not say.
`Appearance.LightScheme`	The light colour scheme.
`Appearance.DarkScheme`	The dark colour scheme.