Interface PowerProfileMonitor

All Superinterfaces:

Initable, Proxy

All Known Implementing Classes:

PowerProfileMonitor.PowerProfileMonitor$Impl

@Generated("org.javagi.JavaGI")
public interface PowerProfileMonitor
extends Proxy, Initable

GPowerProfileMonitor 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:

• disable automatic downloads;
• reduce the rate of refresh from online sources such as calendar or email synchronisation;
• reduce the use of expensive visual effects.

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 GObject.Object::notify signal for Gio.PowerProfileMonitor:power-saver-enabled, and unref the GPowerProfileMonitor itself when exiting.

Since:

2.70

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	PowerProfileMonitor.Builder<B extends Builder<B>>
static class	PowerProfileMonitor.PowerProfileMonitor$Impl	The PowerProfileMonitor$Impl type represents a native instance of the PowerProfileMonitor interface.
static class	PowerProfileMonitor.PowerProfileMonitorInterface	The virtual function table for GPowerProfileMonitor.

Nested classes/interfaces inherited from interface Initable

Initable.Initable$Impl, Initable.InitableIface

Method Summary

Modifier and Type	Method	Description
static PowerProfileMonitor	dupDefault()	Gets a reference to the default GPowerProfileMonitor for the system.
default boolean	getPowerSaverEnabled()	Gets whether the system is in “Power Saver” mode.
static @Nullable Type	getType()	Get the GType of the PowerProfileMonitor class.

Methods inherited from interface Initable

init

Methods inherited from interface Proxy

handle

Method Details

getType

static @Nullable Type getType()

Get the GType of the PowerProfileMonitor class.

Returns:

the GType

dupDefault

static PowerProfileMonitor dupDefault()

Gets a reference to the default GPowerProfileMonitor for the system.

Returns:

a new reference to the default GPowerProfileMonitor

Since:

2.70

getPowerSaverEnabled

default boolean getPowerSaverEnabled()

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

You are expected to listen to the GPowerProfileMonitor::notify::power-saver-enabled signal to know when the profile has changed.

Returns:

Whether the system is in “Power Saver” mode.

Since:

2.70