From wiki.gpii

(Redirected from WSIS - Setup details)

Jump to: navigation, search

Linux/Gnome Machine

Machine Specs:

Running Fedora 17 (or other linux distrubution with gnome-shell)

Desktop Icons enabled (Link instructions)

Running applications/screen setup:

File browser running (contrast settings)
perhaps browser? (contrast settings, )
Desktop Icons showing (contrast settings, )

Low Vision (High Contrast):

gsettings set org.gnome.desktop.interface icon-theme 'HighContrast'

gsettings get org.gnome.desktop.interface gtk-theme 'HighContrast'

NOT SURE IF NECESSARY: gsettings set org.gnome.desktop.background picture-uri (was 'file:///usr/share/backgrounds/verne/default/verne.xml')

gsettings get org.gnome.desktop.background color-shading-type
'vertical'
gsettings get org.gnome.desktop.background draw-background
true
gsettings get org.gnome.desktop.background picture-options
'none'
gsettings get org.gnome.desktop.background primary-color
'#FFFFFFFFFFFF'
gsettings get org.gnome.desktop.background secondary-color
'#4a2c59f36e75'

PERHAPS CHANGE FONT SIZE FOR ICONS AS WELL - OR AT LEAST MAKE BOLD FONT

Low Vision (Moderate / Font size):

//font size for menu items + menu bars
gsettings set org.gnome.desktop.interface font-name 'Cantarell 18' (was 'Cantarell 11')

//font size for file-picker, console, some menu bars, gnome-menu bar
gsettings set org.gnome.desktop.interface text-scaling-factor 1.6

//Icon text for desktop
gsettings set org.gnome.nautilus.desktop font 'Cantarell 18' (WAS )

Severe Low Vision (magnifier)

//Enable screen magnifier
org.gnome.desktop.a11y.applications screen-magnifier-enabled

org.gnome.desktop.a11y.magnifier lens-mode false
org.gnome.desktop.a11y.magnifier mag-factor 2
org.gnome.desktop.a11y.magnifier mouse-tracking "proportional" ( 'none', 'centered','proportional', 'push' )
org.gnome.desktop.a11y.magnifier screen-position "right-half"
org.gnome.desktop.a11y.magnifier scroll-at-edges true
org.gnome.desktop.a11y.magnifier show-cross-hairs true

Physical Disability (onscreen keyboard)

//Enable on-screen keyboard
gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled true

// Enable sticky keys
gsettings set org.gnome.desktop.a11y.keyboard stickykeys-enable true

//Enable accessibility keyboard shortcuts
gsettings set org.gnome.desktop.a11y.keyboard enable true

//Enable the bounce keys
gsettings set org.gnome.desktop.a11y.keyboard bouncekeys-enable true

//Ignore multiple presses of the same key within this many milliseconds.
gsettings set org.gnome.desktop.a11y.keyboard bouncekeys-delay 300

//Enable mouse keys
gsettings set org.gnome.desktop.a11y.keyboard mousekeys-enable true

//How many milliseconds to wait before mouse movement keys start to operate.
gsettings set org.gnome.desktop.a11y.keyboard mousekeys-init-delay 120

//How many pixels per second to move at the maximum speed.
gsettings set org.gnome.desktop.a11y.keyboard mousekeys-max-speed 850

//How long to accelerate in milliseconds
gsettings set org.gnome.desktop.a11y.keyboard mousekeys-accel-time 800

//Enable slow keys
gsettings set org.gnome.desktop.a11y.keyboard slowkeys-enable true

//Enable toggle keys
gsettings set org.gnome.desktop.a11y.keyboard togglekeys-enable true

Blind (screen reader)

//Enable screen reader
gsettings set org.gnome.desktop.a11y.applications screen-reader-enabled true

//Beep when a key is first pressed - NOT USED
gsettings set org.gnome.desktop.a11y.keyboard slowkeys-beep-press

//Beep when a key is rejected - NOT USED
gsettings set org.gnome.desktop.a11y.keyboard slowkeys-beep-reject

//Beep when a modifier is pressed. - NOT USED
gsettings set org.gnome.desktop.a11y.keyboard stickykeys-modifier-beep

//Beep when a key is rejected - NOT USED
gsettings set org.gnome.desktop.a11y.keyboard bouncekeys-beep-reject

//Beep when a keyboard accessibility feature changes
gsettings set org.gnome.desktop.a11y.keyboard feature-state-change-beep

Windows 7 Machine

Machine Specs: Running Windows 7 (32-bit)

Running applications/screen setup:

File browser
Desktop has several icons

General notes: Two settings handlers are needed for Windows: one directly editing the registry (RegistrySettingsHandler) and one using the SystemParametersInfo API. The settings of the former are described with the path and name of registry. The latter is described with the name of the SPI parameter and the options stored in the corresponding structure. Though not implemented, SPI handler is preferred over RegistrySettingsHandler as it is more reliable. Details on the SPI function and a full list of parameters are available here: http://msdn.microsoft.com/en-us/library/windows/desktop/ms724947(v=vs.85).aspx

Low vision (High contrast):

SPI_GETHIGHCONTRAST and SPI_SETHIGHCONTRAST with structure HIGHCONTRAST. We need to specify the name of the high contrast theme we will apply. In the long run, we need to figure out where we can get that from. For the demo, we omit this setting, applying the default high contrast theme for the system. No other settings needed for the demo.

Moderate Low vision (Font size):

SPI_SETICONTITLELOGFONT with structure LOGFONT
SPI_SETNONCLIENTMETRICS with structure NONCLIENTMETRICS that includes various fonts and sizes.

Control Panel > Display > Set Custom text size (DPI) = 150%

Severe low vision (magnifier):

Screen Magnifier (Windows built-in) - Settings are in registry, as described in Screen Magnifier Settings: Windows built in
Magnification API can also be used, though we can do the demo without it.

UI Setting	Registry Name	Registry Type	Registry Data
Zoom level	Magnification	REG_DWORD	200
Set how much the view changes...	ZoomIncrement	REG_DWORD	100
Turn on color inversion	Invert	REG_DWORD	0
Follow the mouse pointer	FollowMouse	REG_DWORD	1
Follow the keyboard focus	FollowFocus	REG_DWORD	0
Have Magnifier follow the text insertion point	FollowCaret	REG_DWORD	0
Views***	MagnificationMode	REG_DWORD	1

** Once Views is set to ‘Docked’ (MagnificationMode = 1), it may not revert to other views easily. See http://answers.microsoft.com/en-us/windows/forum/windows_7-desktop/windows-7-magnifier-not-working-correctly/23cb5292-f5c6-47a7-9a3f-48f75612edf0?page=1

Physical disability (on-screen keyboard):

The on-screen keyboard executable is located in %system32%\osk.exe. For the WSIS demo, it should be enough to launch it.

Related options for the physical keyboard include: Mouse Keys, Sticky Keys, Toggle Keys, Filter Keys:

SPI_GETFILTERKEYS, FILTERKEYS
SPI_GETMOUSEKEYS, MOUSEKEYS
SPI_GETSTICKYKEYS, STICKYKEYS
SPI_GETTOGGLEKEYS, TOGGLEKEYS
SPI_GETKEYBOARDDELAY
SPI_GETKEYBOARDSPEED

Blind (screen reader):

Narrator (Windows built-in) - Settings are in registry, as described in Screen Reader Settings: Win7 Built in Narrator
JAWS uses .jcf configuration files, as described here: http://wiki.gpii.net/images/0/04/-SP2_WP204-_Analyzing_Configuration_of_JAWS.pdf. Therefore, a new type of settings handler is needed (probably out of scope for the demo).

General:

UI Setting	Registry Name	Registry Type	Registry Data
Echo User's Keystrokes	EchoChars	REG_DWORD	1
Announce System Messages	AnnounceSystemMessages	REG_DWORD	1
Announce Scroll Notifications	AnnounceScrollNotifications	REG_DWORD	0
Start Narrator Minimized	StartType	REG_DWORD	0
Background Message Settings *	BackgroundMessageTimeout	REG_DWORD	30000

Voice settings:

UI Setting	Registry Name	Registry Type	Registry Data
Voice	CurrentVoice	REG_SZ
Voice Speed	CurrentSpeed	REG_DWORD	5
Voice Volume (1-9)	CurrentVolume	REG_DWORD	9
Voice Pitch (1-9)	CurrentPitch	REG_DWORD	5

Deaf (captions):

SPI_GETSHOWSOUNDS
SPI_GETSOUNDSENTRY, SOUNDSENTRY

Control Panel > Ease of Access Center > Use text or visual alternatives to sounds > Turn on visual notifications for sounds (Sound Sentry) = 1 Choose visual warning = Flash Desktop

Control Panel > Ease of Access Center > Use text or visual alternatives to sounds >Turn on text captions for spoken dialog (when available) = 1

Android phone

Android has a settings provider that takes care of system settings (http://developer.android.com/reference/android/provider/Settings.html). It seems that a settings handler for an Android device would be an Android service that would use the settings API.

Web App with UI Options:

Site: http://build.fluidproject.org/videodemo/videoPlayer/demos/Mammals.html

List of available settings:

Default UIOptions settings (with comments explaining what they are):
            textSize: "1", // this is a multiplication factor; range 1-2
            textFont: "default", // possible values: times, verdana, arial, comic, default
            theme: "default", // foreground/background colours: "yb" = yellow-on-black, "wb"=white-on-black, "bw", "by"
            lineSpacing: "1",
            toc: false, // show table of contents
            links: false, // make links easier to see (enlarges and bolds them)
            inputsLarger: false, // make inputs larger
            captions: false, // show captions
            transcripts: false, // show transcripts, if available
            language: "en",  // preferred language for captions and transcripts
            volume: 50  // volume for the video

Low vision (Moderate/ Larger Font size)

            textSize: "1.5", // this is a multiplication factor; range 1-2
            textFont: "default", // possible values: times, verdana, arial, comic, default
            theme: "default", // foreground/background colours: "yb" = yellow-on-black, "wb"=white-on-black, "bw", "by"
            lineSpacing: "1.5",
            toc: false, // show table of contents
            links: true, // make links easier to see (enlarges and bolds them)
            inputsLarger: true, // make inputs larger
            captions: false, // show captions
            transcripts: false, // show transcripts, if available
            language: "en",  // preferred language for captions and transcripts
            volume: 50  // volume for the video

Low vision (Severe/ Very Large Font)

            textSize: "2", // this is a multiplication factor; range 1-2
            textFont: "default", // possible values: times, verdana, arial, comic, default
            theme: "default", // foreground/background colours: "yb" = yellow-on-black, "wb"=white-on-black, "bw", "by"
            lineSpacing: "2",
            toc: false, // show table of contents
            links: true, // make links easier to see (enlarges and bolds them)
            inputsLarger: true, // make inputs larger
            captions: false, // show captions
            transcripts: false, // show transcripts, if available
            language: "en",  // preferred language for captions and transcripts
            volume: 50  // volume for the video

Physical Disability (On-screen keyboard)

Blind (WebAnywhere screen reader)

Deaf/Hard of Hearing (Captions & Transcript)

            textSize: "1", // this is a multiplication factor; range 1-2
            textFont: "default", // possible values: times, verdana, arial, comic, default
            theme: "default", // foreground/background colours: "yb" = yellow-on-black, "wb"=white-on-black, "bw", "by"
            lineSpacing: "1",
            toc: false, // show table of contents
            links: false, // make links easier to see (enlarges and bolds them)
            inputsLarger: false, // make inputs larger
            captions: true, // show captions
            transcripts: true, // show transcripts, if available
            language: "en",  // preferred language for captions and transcripts 
            volume: 75  // volume for the video