class: PowerProfileMonitorMeta

[123:14] static extends: object

Generated metadata helpers for PowerProfileMonitor interface surfaces.

Methods

• properties ()

  Returns property metadata for PowerProfileMonitor.

  • @r A list.

class: PowerProfileMonitor

[27:7] extends: object

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

Members

• handleObj
• lib
• retainedCallbacks
• signalHandlerNames
• signalSetterHandlers

Methods

• PowerProfileMonitor (Handle = null)

  Creates a new PowerProfileMonitor by wrapping a native handle or another wrapper.

  • @p Handle is the native handle or another wrapper whose handle to adopt.

• toNativeHandle (Source)

  Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.

  • @p Source is the raw handle, raw buffer, wrapper, or null.
  • @r A raw pointer carrier or null when no pointer is present.

• getLib ()

  Returns the opened native library for this generated wrapper.

  • @r The opened native library.

• handle ()

  Returns the wrapped NativeHandle.

  • @r The wrapped NativeHandle.

• isNull ()

  Returns true when the wrapped handle is null.

  • @r A bool.

• describe ()

  Returns a small string for debugging generated wrappers.

  • @r A string.

• get_power_saver_enabled ()

  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.