BlueGit

timfa click-tween

Files

click-tween / README.md

README.md

README.md 3.9 KiB Download Raw

Click Tween voor KDE Plasma 6.7 / Wayland

De muisaanwijzer krimpt naar 80% in 150 ms wanneer links of rechts wordt ingedrukt. Hij blijft klein tijdens vasthouden en slepen en groeit in 720 ms terug na loslaten. Bij beide knoppen tegelijk blijft hij klein totdat beide los zijn. De middelste knop verandert de animatie niet.

Het effect schaalt KWin's bestaande cursor rond zijn hotspot. Cursorvorm, zichtbaarheid en positie blijven door KWin beheerd. Het onderschept geen klikken. Bij uitschakelen en schermvergrendeling wordt de schaal hersteld.

Instellingen

Open Systeeminstellingen → Bureaubladeffecten → Click Tween en klik op de instellingenknop. Meld na een plugin-update één keer af en opnieuw aan. KWin/Qt houdt native plugincode in het geheugen; uit-/aanvinken of alleen Systeeminstellingen heropenen laadt een vervangen bibliotheek niet opnieuw. Daarna werken gewone instellingenwijzigingen direct via Toepassen, zonder afmelden.

  • Klik-tween-tijd: 0–5000 ms, standaard 150 ms.
  • Release-tween-tijd: 0–5000 ms, standaard 720 ms.
  • Afzonderlijke easing: standaard easeOutBack voor klik en easeOutElastic voor release.
  • 31 keuzes: Linear plus In, Out en InOut voor Sine, Quad, Cubic, Quart,

Quint, Expo, Circ, Back, Elastic en Bounce, zoals op https://easings.net/. De implementatie gebruikt Qt QEasingCurve; curveparameters zijn Qt-standaardwaarden.

0 ms betekent direct. Back en Elastic kunnen voorbij de eindgrootte veren. Toepassen bewaart de instellingen in ~/.config/kwinrc, groep Effect-clicktween, en werkt direct voor de volgende animatie. Standaardinstellingen herstelt de oorspronkelijke tijden en curves. De klik wordt niet vertraagd: de animatie begint bij het indrukken.

Installeren

Voor jouw Arch-gebaseerde systeem met KWin 6.7.x:

cd ~/kwin-click-tween
./install.sh

Het script bouwt lokaal, vraagt sudo voor de plugin in de systeemmap, en schakelt hem voor de huidige gebruiker direct en blijvend in, ook bij een herinstallatie. Bestaande animatie-instellingen blijven behouden; zonder opgeslagen instellingen gelden de bovenstaande standaardwaarden. Bij een update blijft af- en aanmelden nodig om de nieuwe plugincode te laden. Start het script als je eigen gebruiker, niet met sudo ./install.sh. Bouwvereisten: gcc, pkgconf, kwin, qt6-base, qt6-declarative, kcoreaddons, kconfig, kcmutils, kwindowsystem, wayland, libepoxy en libdrm. De meeste zijn al onderdeel van jouw Plasma-installatie.

Alleen bouwen zonder installeren of instellingen wijzigen:

./install.sh --build-only

Uitschakelen of verwijderen

Uitschakelen kan via Systeeminstellingen → Bureaubladeffecten → Click Tween, of via:

kwriteconfig6 --file kwinrc --group Plugins --key kwin_effect_clicktweenEnabled false
qdbus6 org.kde.KWin /Effects org.kde.kwin.Effects.unloadEffect kwin_effect_clicktween

Volledig verwijderen:

./install.sh --uninstall

Compatibiliteit en controle

Dit is een experimentele native plugin voor de interne KWin 6.7 API. Na een KWin-update voer je het installatiescript opnieuw uit. Andere KWin-minorversies worden geweigerd totdat de code daarvoor is gecontroleerd. De plugin draait in KWin zelf; bewaar open werk voordat je de eerste keer installeert. Gelijktijdige cursor-effecten zoals Shake Cursor of Zoom kunnen hun eigen cursor tekenen en moeten apart worden gecontroleerd.

Handmatig controleren na installatie:

  • Links en rechts: korte klik, vasthouden, slepen en snel herhaald klikken.
  • Beide knoppen indrukken; één loslaten mag de cursor niet herstellen.
  • Test pijl, tekstcursor en handje, ook in XWayland-apps.
  • Controleer op meerdere schermen met verschillende schaalfactoren.
  • Uitschakelen tijdens vasthouden moet de oorspronkelijke grootte herstellen.

De buildcontrole controleert compileren, linken, metadata en het laden van de pluginfactory tegen de lokale KWin-versie. Visueel gedrag moet nog in een actieve sessie worden getest.

Licentie: GPL-2.0-or-later.

Source
1# Click Tween voor KDE Plasma 6.7 / Wayland
2
3De muisaanwijzer krimpt naar 80% in 150 ms wanneer links of rechts wordt
4ingedrukt. Hij blijft klein tijdens vasthouden en slepen en groeit in 720 ms
5terug na loslaten. Bij beide knoppen tegelijk blijft hij klein totdat beide
6los zijn. De middelste knop verandert de animatie niet.
7
8Het effect schaalt KWin's bestaande cursor rond zijn hotspot. Cursorvorm,
9zichtbaarheid en positie blijven door KWin beheerd. Het onderschept geen
10klikken. Bij uitschakelen en schermvergrendeling wordt de schaal hersteld.
11
12## Instellingen
13
14Open Systeeminstellingen → Bureaubladeffecten → Click Tween en klik op de
15instellingenknop. Meld na een plugin-update één keer af en opnieuw aan.
16KWin/Qt houdt native plugincode in het geheugen; uit-/aanvinken of alleen
17Systeeminstellingen heropenen laadt een vervangen bibliotheek niet opnieuw.
18Daarna werken gewone instellingenwijzigingen direct via Toepassen, zonder afmelden.
19
20- Klik-tween-tijd: 0–5000 ms, standaard 150 ms.
21- Release-tween-tijd: 0–5000 ms, standaard 720 ms.
22- Afzonderlijke easing: standaard easeOutBack voor klik en easeOutElastic voor release.
23- 31 keuzes: Linear plus In, Out en InOut voor Sine, Quad, Cubic, Quart,
24 Quint, Expo, Circ, Back, Elastic en Bounce, zoals op https://easings.net/.
25 De implementatie gebruikt Qt QEasingCurve; curveparameters zijn Qt-standaardwaarden.
26
270 ms betekent direct. Back en Elastic kunnen voorbij de eindgrootte veren.
28Toepassen bewaart de instellingen in `~/.config/kwinrc`, groep
29`Effect-clicktween`, en werkt direct voor de volgende animatie.
30Standaardinstellingen herstelt de oorspronkelijke tijden en curves.
31De klik wordt niet vertraagd: de animatie begint bij het indrukken.
32
33## Installeren
34
35Voor jouw Arch-gebaseerde systeem met KWin 6.7.x:
36
37```bash
38cd ~/kwin-click-tween
39./install.sh
40```
41
42Het script bouwt lokaal, vraagt sudo voor de plugin in de systeemmap,
43en schakelt hem voor de huidige gebruiker direct en blijvend in, ook bij
44een herinstallatie. Bestaande animatie-instellingen blijven behouden; zonder
45opgeslagen instellingen gelden de bovenstaande standaardwaarden.
46Bij een update blijft af- en aanmelden nodig om de nieuwe plugincode te laden. Start het script als je eigen
47gebruiker, niet met `sudo ./install.sh`. Bouwvereisten: `gcc`, `pkgconf`,
48`kwin`, `qt6-base`, `qt6-declarative`, `kcoreaddons`, `kconfig`,
49`kcmutils`, `kwindowsystem`, `wayland`, `libepoxy` en `libdrm`.
50De meeste zijn al onderdeel van jouw Plasma-installatie.
51
52Alleen bouwen zonder installeren of instellingen wijzigen:
53
54```bash
55./install.sh --build-only
56```
57
58## Uitschakelen of verwijderen
59
60Uitschakelen kan via Systeeminstellingen → Bureaubladeffecten → Click Tween,
61of via:
62
63```bash
64kwriteconfig6 --file kwinrc --group Plugins --key kwin_effect_clicktweenEnabled false
65qdbus6 org.kde.KWin /Effects org.kde.kwin.Effects.unloadEffect kwin_effect_clicktween
66```
67
68Volledig verwijderen:
69
70```bash
71./install.sh --uninstall
72```
73
74## Compatibiliteit en controle
75
76Dit is een experimentele native plugin voor de interne KWin 6.7 API.
77Na een KWin-update voer je het installatiescript opnieuw uit. Andere
78KWin-minorversies worden geweigerd totdat de code daarvoor is gecontroleerd.
79De plugin draait in KWin zelf; bewaar open werk voordat je de eerste keer
80installeert. Gelijktijdige cursor-effecten zoals Shake Cursor of Zoom kunnen
81hun eigen cursor tekenen en moeten apart worden gecontroleerd.
82
83Handmatig controleren na installatie:
84
85- Links en rechts: korte klik, vasthouden, slepen en snel herhaald klikken.
86- Beide knoppen indrukken; één loslaten mag de cursor niet herstellen.
87- Test pijl, tekstcursor en handje, ook in XWayland-apps.
88- Controleer op meerdere schermen met verschillende schaalfactoren.
89- Uitschakelen tijdens vasthouden moet de oorspronkelijke grootte herstellen.
90
91De buildcontrole controleert compileren, linken, metadata en het laden van
92de pluginfactory tegen de lokale KWin-versie. Visueel gedrag moet nog in een
93actieve sessie worden getest.
94
95Licentie: GPL-2.0-or-later.