ICCHP implementer preparatation - gnome-mag example

From wiki.gpii
Jump to: navigation, search

Implementer preparation:

This page is part of the preparation for ICCHP 2012.

Name and description of the product

Gnome-mag

The default built in screen magnifier for gnome-shell (linux)

Attendee organization name

GPII Architecture Team

Compatability and environment

Requires Linux, running Gnome-Shell (Gnome 3)

Location and Format of settings

The settings for gnome-mag are handled by GConf and available via gsettings.

The relevant gsettings schemas are:

  • org.gnome.desktop.a11y.applications (used for starting the application)
  • org.gnome.desktop.a11y.magnifier (this is where all the settings live)

Starting and closing the application

The launching of gnome-mag is handled via gsettings as well. This means that it can be started by switching a single flag via gsettings:

gsettings set org.gnome.desktop.a11y.applications screen-magnifier-enabled true

Exiting the screen magnifier is also handled via gsettings, by setting the screen-magnifier-enabled to false:

gsettings set org.gnome.desktop.a11y.applications screen-magnifier-enabled false

Detecting whether the application is running

This can be checked using gsettings as well:

gsettings get org.gnome.desktop.a11y.applications screen-magnifier-enabled

This will return 'false' if the magnifier is not enabled, and 'true' if it is"

Notifying the application of updated settings

This happens automatically. As soon as a setting is changed, the gnome-mag will automatically notified and updated to reflect the new setting.

Detecting whether application is installed

This is not relevant for gnome-mag, as this is a built in tool. If gnome 3 (gnome shell) is running on the machine, gnome-mag is installed