GI.Gio.Interfaces.PowerProfileMonitor

PowerProfileMonitor makes it possible for applications as well as OS components to monitor system power profiles and act upon them. It currently only exports whether the system is in “Power Saver” mode (known as “Low Power” mode on some systems).

When in “Low Power” mode, it is recommended that applications:

• disabling automatic downloads
• reduce the rate of refresh from online sources such as calendar or email synchronisation
• if the application has expensive visual effects, reduce them

It is also likely that OS components providing services to applications will lower their own background activity, for the sake of the system.

There are a variety of tools that exist for power consumption analysis, but those usually depend on the OS and hardware used. On Linux, one could use upower to monitor the battery discharge rate, powertop to check on the background activity or activity at all), sysprof to inspect CPU usage, and intel_gpu_time to profile GPU usage.

Don't forget to disconnect the PowerProfileMonitor::notifypowerSaverEnabled signal, and unref the PowerProfileMonitor itself when exiting.

Since: 2.70

Exported types

newtype PowerProfileMonitor

Memory-managed wrapper type.

Constructors

PowerProfileMonitor (ManagedPtr PowerProfileMonitor)

Instances

Eq PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

Methods

(==) :: PowerProfileMonitor -> PowerProfileMonitor -> Bool

(/=) :: PowerProfileMonitor -> PowerProfileMonitor -> Bool

GObject PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

ManagedPtrNewtype PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

Methods

toManagedPtr :: PowerProfileMonitor -> ManagedPtr PowerProfileMonitor

TypedObject PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

Methods

glibType :: IO GType

HasParentTypes PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

IsGValue (Maybe PowerProfileMonitor)

Convert PowerProfileMonitor to and from GValue. See toGValue and fromGValue.

Defined in GI.Gio.Interfaces.PowerProfileMonitor

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe PowerProfileMonitor -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe PowerProfileMonitor)

type ParentTypes PowerProfileMonitor

Defined in GI.Gio.Interfaces.PowerProfileMonitor

type ParentTypes PowerProfileMonitor = '[Initable, Object]

class (GObject o, IsDescendantOf PowerProfileMonitor o) => IsPowerProfileMonitor o

Type class for types which can be safely cast to PowerProfileMonitor, for instance with toPowerProfileMonitor.

Instances

(GObject o, IsDescendantOf PowerProfileMonitor o) => IsPowerProfileMonitor o

Defined in GI.Gio.Interfaces.PowerProfileMonitor

toPowerProfileMonitor :: (MonadIO m, IsPowerProfileMonitor o) => o -> m PowerProfileMonitor

Cast to PowerProfileMonitor, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, init, isFloating, notify, notifyByPspec, ref, refSink, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getData, getPowerSaverEnabled, getProperty, getQdata.

Setters

setData, setDataFull, setProperty.

dupDefault

powerProfileMonitorDupDefault

Arguments

:: (HasCallStack, MonadIO m)

=> m PowerProfileMonitor

Returns: a new reference to the default PowerProfileMonitor

Gets a reference to the default PowerProfileMonitor for the system.

Since: 2.70

getPowerSaverEnabled

powerProfileMonitorGetPowerSaverEnabled

Arguments

:: (HasCallStack, MonadIO m, IsPowerProfileMonitor a)

=> a

monitor: a PowerProfileMonitor

-> m Bool

Returns: Whether the system is in “Power Saver” mode.

Gets whether the system is in “Power Saver” mode.

You are expected to listen to the PowerProfileMonitor::notifypowerSaverEnabled signal to know when the profile has changed.

Since: 2.70

Properties

powerSaverEnabled

Whether “Power Saver” mode is enabled on the system.

Since: 2.70

getPowerProfileMonitorPowerSaverEnabled :: (MonadIO m, IsPowerProfileMonitor o) => o -> m Bool

Get the value of the “power-saver-enabled” property. When overloading is enabled, this is equivalent to

get powerProfileMonitor #powerSaverEnabled