KWin
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | Properties | List of all members
KWin::SlideEffect Class Reference

#include <slide.h>

Inheritance diagram for KWin::SlideEffect:
KWin::Effect

Public Member Functions

 SlideEffect ()
 
 ~SlideEffect () override
 
void reconfigure (ReconfigureFlags) override
 
void prePaintScreen (ScreenPrePaintData &data, std::chrono::milliseconds presentTime) override
 
void paintScreen (const RenderTarget &renderTarget, const RenderViewport &viewport, int mask, const QRegion &region, Output *screen) override
 
void postPaintScreen () override
 
void prePaintWindow (EffectWindow *w, WindowPrePaintData &data, std::chrono::milliseconds presentTime) override
 
void paintWindow (const RenderTarget &renderTarget, const RenderViewport &viewport, EffectWindow *w, int mask, QRegion region, WindowPaintData &data) override
 
bool isActive () const override
 
int requestedEffectChainPosition () const override
 
int horizontalGap () const
 
int verticalGap () const
 
bool slideBackground () const
 
- Public Member Functions inherited from KWin::Effect
 Effect (QObject *parent=nullptr)
 
 ~Effect () override
 
virtual void postPaintWindow (EffectWindow *w)
 
virtual bool provides (Feature)
 
virtual bool perform (Feature feature, const QVariantList &arguments)
 
virtual void drawWindow (const RenderTarget &renderTarget, const RenderViewport &viewport, EffectWindow *w, int mask, const QRegion &region, WindowPaintData &data)
 
virtual void windowInputMouseEvent (QEvent *e)
 
virtual void grabbedKeyboardEvent (QKeyEvent *e)
 
virtual QString debug (const QString &parameter) const
 
virtual bool touchDown (qint32 id, const QPointF &pos, std::chrono::microseconds time)
 
virtual bool touchMotion (qint32 id, const QPointF &pos, std::chrono::microseconds time)
 
virtual bool touchUp (qint32 id, std::chrono::microseconds time)
 
virtual bool tabletToolEvent (QTabletEvent *event)
 
virtual bool tabletToolButtonEvent (uint button, bool pressed, quint64 tabletToolId)
 
virtual bool tabletPadButtonEvent (uint button, bool pressed, void *tabletPadId)
 
virtual bool tabletPadStripEvent (int number, int position, bool isFinger, void *tabletPadId)
 
virtual bool tabletPadRingEvent (int number, int position, bool isFinger, void *tabletPadId)
 
template<typename T >
int animationTime (int defaultDuration)
 
virtual bool blocksDirectScanout () const
 

Static Public Member Functions

static bool supported ()
 
- Static Public Member Functions inherited from KWin::Effect
static QPointF cursorPos ()
 
static double animationTime (const KConfigGroup &cfg, const QString &key, int defaultTime)
 
static double animationTime (int defaultTime)
 
static double interpolate (double x, double y, double a)
 
static void setPositionTransformations (WindowPaintData &data, QRect &region, EffectWindow *w, const QRect &r, Qt::AspectRatioMode aspect)
 

Properties

int horizontalGap
 
int verticalGap
 
bool slideBackground
 

Additional Inherited Members

- Public Types inherited from KWin::Effect
enum  {
  PAINT_WINDOW_OPAQUE = 1 << 0 , PAINT_WINDOW_TRANSLUCENT = 1 << 1 , PAINT_WINDOW_TRANSFORMED = 1 << 2 , PAINT_SCREEN_REGION = 1 << 3 ,
  PAINT_SCREEN_TRANSFORMED = 1 << 4 , PAINT_SCREEN_WITH_TRANSFORMED_WINDOWS = 1 << 5 , PAINT_SCREEN_BACKGROUND_FIRST = 1 << 6
}
 
enum  Feature {
  Nothing = 0 , ScreenInversion , Blur , Contrast ,
  HighlightWindows
}
 
enum  ReconfigureFlag { ReconfigureAll = 1 << 0 }
 
- Public Slots inherited from KWin::Effect
virtual bool borderActivated (ElectricBorder border)
 

Detailed Description

Definition at line 46 of file slide.h.

Constructor & Destructor Documentation

◆ SlideEffect()

KWin::SlideEffect::SlideEffect ( )

Definition at line 25 of file slide.cpp.

◆ ~SlideEffect()

KWin::SlideEffect::~SlideEffect ( )
override

Definition at line 52 of file slide.cpp.

Member Function Documentation

◆ horizontalGap()

int KWin::SlideEffect::horizontalGap ( ) const
inline

Definition at line 135 of file slide.h.

◆ isActive()

bool KWin::SlideEffect::isActive ( ) const
inlineoverridevirtual

Overwrite this method to indicate whether your effect will be doing something in the next frame to be rendered. If the method returns false the effect will be excluded from the chained methods in the next rendered frame.

This method is called always directly before the paint loop begins. So it is totally fine to e.g. react on a window event, issue a repaint to trigger an animation and change a flag to indicate that this method returns true.

As the method is called each frame, you should not perform complex calculations. Best use just a boolean flag.

The default implementation of this method returns true.

Since
4.8

Reimplemented from KWin::Effect.

Definition at line 150 of file slide.h.

◆ paintScreen()

void KWin::SlideEffect::paintScreen ( const RenderTarget & renderTarget,
const RenderViewport & viewport,
int mask,
const QRegion & region,
Output * screen )
overridevirtual

In this method you can:

  • paint something on top of the windows (by painting after calling effects->paintScreen())
  • paint multiple desktops and/or multiple copies of the same desktop by calling effects->paintScreen() multiple times

In OpenGL based compositing, the frameworks ensures that the context is current when this method is invoked.

Reimplemented from KWin::Effect.

Definition at line 143 of file slide.cpp.

◆ paintWindow()

void KWin::SlideEffect::paintWindow ( const RenderTarget & renderTarget,
const RenderViewport & viewport,
EffectWindow * w,
int mask,
QRegion region,
WindowPaintData & data )
overridevirtual

This is the main method for painting windows. In this method you can:

  • do various transformations
  • change opacity of the window
  • change brightness and/or saturation, if it's supported

In OpenGL based compositing, the frameworks ensures that the context is current when this method is invoked.

Reimplemented from KWin::Effect.

Definition at line 199 of file slide.cpp.

◆ postPaintScreen()

void KWin::SlideEffect::postPaintScreen ( )
overridevirtual

Called after all the painting has been finished. In this method you can:

  • schedule next repaint in case of animations You shouldn't paint anything here.

In OpenGL based compositing, the frameworks ensures that the context is current when this method is invoked.

Reimplemented from KWin::Effect.

Definition at line 254 of file slide.cpp.

◆ prePaintScreen()

void KWin::SlideEffect::prePaintScreen ( ScreenPrePaintData & data,
std::chrono::milliseconds presentTime )
overridevirtual

Called before starting to paint the screen. In this method you can:

  • set whether the windows or the entire screen will be transformed
  • change the region of the screen that will be painted
  • do various housekeeping tasks such as initing your effect's variables for the upcoming paint pass or updating animation's progress

presentTime specifies the expected monotonic time when the rendered frame will be displayed on the screen.

Reimplemented from KWin::Effect.

Definition at line 96 of file slide.cpp.

◆ prePaintWindow()

void KWin::SlideEffect::prePaintWindow ( EffectWindow * w,
WindowPrePaintData & data,
std::chrono::milliseconds presentTime )
overridevirtual

Called for every window before the actual paint pass In this method you can:

  • enable or disable painting of the window (e.g. enable paiting of minimized window)
  • set window to be painted with translucency
  • set window to be transformed
  • request the window to be divided into multiple parts

In OpenGL based compositing, the frameworks ensures that the context is current when this method is invoked.

presentTime specifies the expected monotonic time when the rendered frame will be displayed on the screen.

Reimplemented from KWin::Effect.

Definition at line 193 of file slide.cpp.

◆ reconfigure()

void KWin::SlideEffect::reconfigure ( ReconfigureFlags flags)
overridevirtual

Called when configuration changes (either the effect's or KWin's global).

In OpenGL based compositing, the frameworks ensures that the context is current when the Effect is reconfigured. If this method is called from within the Effect it is required to ensure that the context is current if the implementation does OpenGL calls.

Reimplemented from KWin::Effect.

Definition at line 62 of file slide.cpp.

◆ requestedEffectChainPosition()

int KWin::SlideEffect::requestedEffectChainPosition ( ) const
inlineoverridevirtual

Reimplement this method to indicate where in the Effect chain the Effect should be placed.

A low number indicates early chain position, thus before other Effects got called, a high number indicates a late position. The returned number should be in the interval [0, 100]. The default value is 0.

In KWin4 this information was provided in the Effect's desktop file as property X-KDE-Ordering. In the case of Scripted Effects this property is still used.

Since
5.0

Reimplemented from KWin::Effect.

Definition at line 155 of file slide.h.

◆ slideBackground()

bool KWin::SlideEffect::slideBackground ( ) const
inline

Definition at line 145 of file slide.h.

◆ supported()

bool KWin::SlideEffect::supported ( )
static

Definition at line 57 of file slide.cpp.

◆ verticalGap()

int KWin::SlideEffect::verticalGap ( ) const
inline

Definition at line 140 of file slide.h.

Member Data Documentation

◆ visibleDesktops

QList<VirtualDesktop *> KWin::SlideEffect::visibleDesktops

Definition at line 123 of file slide.h.

◆ wrap

bool KWin::SlideEffect::wrap

Definition at line 122 of file slide.h.

Property Documentation

◆ horizontalGap

int KWin::SlideEffect::horizontalGap
read

Definition at line 49 of file slide.h.

◆ slideBackground

bool KWin::SlideEffect::slideBackground
read

Definition at line 51 of file slide.h.

◆ verticalGap

int KWin::SlideEffect::verticalGap
read

Definition at line 50 of file slide.h.


The documentation for this class was generated from the following files: