What a client's own commits have taught the engine about one window's extent ALONG a strip that runs one way (ScrollEngine::reportCommittedSize). More...
#include <PhosphorScrollEngine/ScrollStashTypes.h>
Public Member Functions | |
| bool | isEmpty () const |
Public Attributes | |
| int | floorPx = 0 |
| The extent along the strip the client committed past the tile it was offered, which the column is then held to exactly like a declared minimum (0: none). | |
| int | peekPx = 0 |
| The last extent along the strip the client committed to its WHOLE tile when that was not the offer (0: none). | |
| bool | gaveBack = false |
| A narrower answer has given part or all of floorPx back since it was learned. | |
| bool | pinned = false |
| A wider answer re-taught the floor after a give-back. | |
What a client's own commits have taught the engine about one window's extent ALONG a strip that runs one way (ScrollEngine::reportCommittedSize).
Runtime state only: nothing here is serialized or persisted, no strip stash carries it, and none of it is a width intent. The one copy kept outside ScrollEngine::m_committedExtents is the evacuee park's (ScrollEvacueePark::committed), which carries it across a KWin sleep or unplug round trip like the declared minimum.
|
inline |
| int PhosphorScrollEngine::CommittedMainExtent::floorPx = 0 |
The extent along the strip the client committed past the tile it was offered, which the column is then held to exactly like a declared minimum (0: none).
The strip reads it through ScrollLayoutParams::committedFloor.
| bool PhosphorScrollEngine::CommittedMainExtent::gaveBack = false |
A narrower answer has given part or all of floorPx back since it was learned.
It outlives a floor given back entirely, so that a re-teach pins, and ends with the floor's other drops or with the peek memory.
| int PhosphorScrollEngine::CommittedMainExtent::peekPx = 0 |
The last extent along the strip the client committed to its WHOLE tile when that was not the offer (0: none).
Read only by the screen-edge peek floor, which must keep protecting a column the client answers at full width after the floor itself has been satisfied and dropped. A wider answer sets it with the floor, and a narrower one replaces it. With no floor held it ends, and the whole extent with it, once the column offers the tile less than this on a pass that offers the tile its whole rect (ScrollEngine::endStalePeeks), since a client that took the narrower on-screen offer reports nothing and nothing else would revise it. It also ends when the client answers a whole offer narrower than this with that very offer (a park included), which the compositor reports for a parked tile (ScrollEngine::reportCommittedSize). Either end waits while another column the window holds still offers it this much.
| bool PhosphorScrollEngine::CommittedMainExtent::pinned = false |
A wider answer re-taught the floor after a give-back.
The client is not answering the same offer the same way twice, and following it down again would offer it the size that taught the floor and start the cycle over, so a narrower answer no longer gives the floor back. The drops that end a floor outright end this with it.