User Manual

INSTALL
README

GOK Manual V2.3

Sun Java Desktop System Documentation Team

Sun Microsystems, Inc.

This manual describes version 0.11.9 of GOK.

Copyright © 2004 Sun Microsystems, Inc.

Copyright��© 2003, 2004 GOK Development Team

Copyright © 2002, 2003 ATRC

Feedback

To report a bug or make a suggestion regarding the GOK application or this manual, follow the directions in the GNOME Feedback Page.


Table of Contents

Introduction
Getting Started
To Start GOK
When You Start GOK
Usage
To Use the Compose Keyboard
To Manipulate GOK Windows
To Use Mouse Functions
To Start Applications
To Navigate and Use the Desktop and Desktop Applications
To Access Application Menus
To Access Application Toolbars
To Quit GOK
Preferences
Appearance Preferences
Keyboards Preferences
Actions Preferences
Feedback Preferences
Access Methods Preferences
Prediction Preferences

Introduction

The GNOME On-Screen Keyboard (GOK) application displays virtual keyboards on your screen that you can operate using the standard mouse pointer or an alternative pointing device. GOK displays the following types of keyboards:

  • Compose keyboardThe compose keyboard enables you to type alphanumeric characters to compose text by selecting the characters from the keyboard.
  • Dynamic keyboardsGOK generates keyboards that contain keys to represent the applications that are running on your desktop or the menus that are contained in an application.

Getting Started

To Start GOK

You can start GOK in the following ways:

Menu
Choose Applications->Accessibility->On-Screen Keyboard.
Command line
Execute the following command: gokYou can use the -d option to specify default settings.

When You Start GOK

If support for assistive technologies is not enabled on your system when you start GOK, the following Warning window appears:

Figure 1. Warning Window

Shows GOK Warning window.

To use the full capabilities of GOK, activate the Enable and Log Out button. When you log in again and start GOK, support for assistive technologies is enabled and the Information window is not displayed.

When you start GOK with support for assistive technologies enabled, the GOK – main window appears:

Figure 2. GOK – Main Window

Shows GOK main window.

The GOK – main window contains the following keys that you can activate to display a variety of different keyboards:

Compose
Displays a compose keyboard.
Window
Displays keys to enable you to move or resize the GOK windows.
Mouse
Displays keys that emulate standard mouse controls.
Launcher
Displays keys to enable you to start other applications.
Activate
Displays keys to enable you to navigate and use the desktop and the applications that are currently running on the desktop.
GOK
Displays keys to enable you to access information about the GOK application such as Help and Preferences, and also to exit the application.
Menus
Displays keys to reflect the menu items that are contained in the current application.
Toolbars
Displays keys to reflect the toolbar items that are contained in the current application.
UI Grab
Displays keys to reflect user interface elements that the user can interact with, other than menus or toolbar items. For example, the UI Grab feature displays keys that represent the buttons that are displayed on a dialog.

Usage

 

To Use the Compose Keyboard

To use the compose keyboard feature of GOK, activate Compose in the GOK – main window. The GOK – Keyboard window is displayed.

The GOK compose keyboard is a standard alphanumeric keyboard. You can customize the type of compose keyboard that GOK displays in the GOK Preferences dialog. See the section called “Keyboards Preferences” for more information.

GOK uses the spaces at the top of the keyboard for word prediction, if you enable the word prediction options in the GOK Preferences dialog.

The method that you use to select and activate the keys on the keyboards depends on the option that you select in the GOK Preferences dialog. See the section called “Access Methods Preferences” for more information.

To return to the GOK – main window at any time, activate Back.

To hide the keyboard, activate Hide. To display the keyboard again, activate Show.

To Access Edit Functions

To access standard text editing functions from the GOK standard keyboard, activate Edit.

Note

The Edit key is only available if you have a document open in a text editor application.

When you activate Edit, the GOK – text-operations window is displayed. The following table describes the keys that the GOK – text-operations window contains.

Table 1. Text Editing Functions

Key Function
c – Move the cursor back one character.
word – Move the cursor back one word.
line – Move the cursor back one line.
sent. – Move the cursor back one sentence.
c + Move the cursor forward one character.
word + Move the cursor forward one word.
line + Move the cursor forward one line.
sent. + Move the cursor forward one sentence.
Select Activate the text selection function.
word Select the current word when the Select option is enabled.
sent. Select the current sentence when the Select option is enabled.
all Select all of the text in the current document when the Select option is enabled.
Repeat Next Activate this key to repeat the current operation until you specifically cancel the action.
cut Delete the selected text.
paste Insert text that you cut or copy.
copy Copy selected text to the application memory.
ins Return to the compose keyboard and use the keyboard to insert text at the current cursor position.

To close the GOK – text-operations window and return to the compose keyboard, activate back.

To Display a Numeric Keypad Only

To display the numeric keypad only on the screen, activate Num Pad in the GOK – Keyboard window.

To Launch a Text Editor and Start Entering Text in a New Document

To use GOK to launch a text editor and start to enter text in a new document, perform the following steps:

  1. In the GOK – main window, activate Launcher.
  2. In the GOK – launcher window, activate Text Editor.
  3. In the GOK – launcher window, activate back to return to the GOK – main window.
  4. In the GOK – main window, activate Compose to display the compose keyboard.

You can now use the compose keyboard to enter text in the document.

To Manipulate GOK Windows

To modify or move the GOK windows, activate Window in the GOK – main window. The following table describes the keys that the GOK – move-resize window contains.

Table 2. Window Manipulation Functions

Key Function
Dock Top Position the window at the top left of the screen and remove the window frame. Docked windows are typically not overlapped by other windows, or the amount by which docked windows can be overlapped is limited.
Dock Bottom Position the window at the bottom left of the screen and remove the window frame.
Fill Resize the window so that it fills the full width of the screen.
Left up diagonal arrow Move the window left and upwards.
Up Move the window up.
Right up diagonal arrow Move the window right and upwards.
Narrower Decrease the width of the window.
Left Move the window left.
Float Select this option to undock a window that is already docked so that you can move the window around the screen. Windows that are not docked are called floating windows. Other windows can overlap floating windows.
Right Move the window right.
Wider Increase the width of the window.
Left down diagonal arrow Move the window left and downwards.
Down Move the window down.
Right down diagonal arrow Move the window right and downwards.
Shorter Decrease the height of the window.
Hide Hide the GOK – move-resize window.
Repeat Next Key Activate this key to repeat the current window manipulation action until you select another action. For example, if this key is selected and you activateDown, GOK continues to move the window down until you select another action or the window cannot move down any further.
Taller Increase the height of the window.

To Use Mouse Functions

To use mouse functions, activate Mouse in the GOK – main window. The following table describes the keys that the GOK – mouse window contains.

Table 3. Mouse Functions

Key Function
back Return to the GOK – main window.
Latch Press-and-hold the next key that you activate until you activate the key again. For example, if you activate Latch and then activate Button 1, you can perform a drag-and-drop operation.
Pointer Use the core mouse pointer to track the movement of any extended input device.
Repeat Activate this key to repeat the current mouse action until you select another action.
NW Move the pointer left and upwards.
N Move the pointer up.
NE Move the pointer right and upwards.
Button 1 Activate the left mouse button.
W Move the pointer left.
Dbl Click Perform a double-click action.
E Move the pointer right.
Button 2 Activate the middle mouse button.
SW Move the pointer left and downwards.
S Move the pointer down.
SE Move the pointer right and downwards.
Button 3 Activate the right mouse button.

To Start Applications

To start standard applications from GOK, activate Launcher in the GOK – main window. The following table describes the keys that the GOK – launcher window contains.

Table 4. Starting Applications Functions

Key Function
Terminal Starts the default terminal application.
Web Browser Starts the default web browser application.
Text Editor Starts the default text editor application.
Help Browser Starts the default Help application.

To Navigate and Use the Desktop and Desktop Applications

To move focus around the desktop environment, activate the Activate key in the GOK – main window. The GOK – Window List window contains keys that represent the desktop components and applications that are currently running. For example, the GOK – Window List window may contain the following keys:

Table 5. Focus Functions

Key Function
Desktop Moves focus to the desktop.
Bottom Panel Moves focus to the panel at the bottom of the screen.
GOK – main Moves focus to the GOK – main window.
Untitled 1 – gedit Moves focus to the gedit text editor.
Terminal Moves focus to the Terminal window.

To Access Application Menus

GOK dynamically generates keyboards to reflect the menus on the application that currently has focus. To view and access the menus for the current application, activateMenus in the GOK – main window. The GOK – Menus window contains a key for each menu that is contained on the application menubar. For example, if the Terminalapplication currently has focus, and you activate Menus in the GOK – main window, the GOK – Menus window contains the following keys:

  • File
  • Edit
  • View
  • Terminal
  • Tabs
  • Help

When you activate a key that represents a menu, a new keyboard is displayed that contains a key for each menu item that is contained on that menu in the application.

To Access Application Toolbars

GOK dynamically generates keyboards to reflect the toolbar items on the application that currently has focus, if the application contains a toolbar. To view and access the toolbar items for the current application, activate Toolbars in the GOK – main window. The GOK – Toolbars window contains a key for each toolbar item that is contained on the application toolbar.

To Quit GOK

Perform the following steps:

  1. Activate GOK in the GOK – main window.
  2. Activate Quit GOK.
  3. Activate Really Quit.

Preferences

To open the Preferences dialog, activate GOK in the GOK – main window, then activate Preferences. The GOK Preferences dialog contains the following tabbed sections:

  • AppearanceThe Appearance tabbed section contains preferences to enable you to customize how the GOK windows and keys are displayed.
  • KeyboardsThe Keyboards tabbed section enables you to specify the type of keyboard that GOK displays when you click the Compose key.
  • ActionsIn the context of GOK, an action is a method by which you activate keys on the GOK keyboards. The Actions tabbed section enables you to select predefined actions or create new actions to suit your requirements.
  • FeedbackThe Feedback tabbed section enables you to specify how you want to receive feedback when you successfully activate a key. You can also create new feedback methods to suit your requirements.
  • Access MethodsThe Access Methods tabbed section enables you to specify how you access and select keys from the GOK keyboards.
  • PredictionThe Prediction tabbed section enables you to select word completion or command prediction options.

Appearance Preferences

Key width
Use this spin box to specify the width of each key that is displayed on the on-screen keyboard. The maximum width allowed is 200 pixels.
Key height
Use this spin box to specify the height of each key that is displayed on the on-screen keyboard. The maximum height allowed is 200 pixels.
Spacing
Use this spin box to specify the space between each key that is displayed on the on-screen keyboard. The maximum space allowed is 100 pixels.
Preview
Use this area to preview any changes that you make to the key size and spacing preferences.
Dock
Select this option to position the window at the top or bottom of the desktop and remove the menubar from the window. When you select this option, the Dock Topand Dock Bottom options are activated.
Dock Top
Select this option to position the window at the top of the desktop.
Dock Bottom
Select this option to position the window at the bottom of the desktop.
Fill Width
Select this option to expand the GOK window so that it fills the entire width of the screen.
Use Desktop Theme Preferences
Select this option to apply the desktop theme preferences to the GOK application. To select a desktop theme, activate the Launch button on the menu panel, then choose Preferences->Desktop Preferences->Display->Theme. If you do not select this option, the desktop theme is applied to all other applications except GOK.You must restart GOK before any change to this setting takes effect.

Keyboards Preferences

Compose Keyboard
Select one of the following options:

  • Match physical keyboard as reported by X ServerSelect this option to display the same keyboard layout as the physical keyboard that is attached to the system.
  • Alphanumeric keyboard sorted alphabeticallySelect this option to display a keyboard with the keys sorted in alphabetical order.
  • Alphanumeric keyboard arranged by letter frequencySelect this option to display a keyboard with the keys sorted in order of usage.
  • Read keyboard from fileSelect this option to display a bespoke keyboard. The keyboard contents and layout are specified in an XML file. Select the file from the drop-down list or activate Browse to search for the file.
Custom Keyboards
Use this drop-down list to select a directory that contains other customized keyboard files that GOK can display or activate Browse to select a directory.

Actions Preferences

Name
There are 12 default action methods defined in GOK as follows:

  • Dwell
  • Left Mouse Button
  • Middle Mouse Button
  • Mouse Button 4
  • Mouse Button 5
  • Mouse Pointer
  • Right Mouse Button
  • Switch 1
  • Switch 2
  • Switch 3
  • Switch 4
  • Switch 5

When you select an action method from the Name drop-down list, the settings that are associated with the action are displayed in the dialog. The settings that are displayed vary depending on the type of action that you select.

Action Type
The action type can be one of the following options:

  • SwitchIf you select this option, the following settings are displayed:
    Switch or Button Number
    The options are Switch 1 to Switch 5.
    Behavior
    This setting determines whether the action is performed when you press the switch or release the switch. The options are as follows:

    • Activate when pressed
    • Activate when released
    Delay Before Activation
    This setting enables you to specify a time period that must elapse after you press or release a switch before GOK processes the action as intentional. Use the spin box to specify the time period in 100ths of a second.
  • ValuatorIf you select this option, the following settings are displayed:
    Valuator Type
    The options are as follows:

    • X-Y Valuator
    • Single axis
    Behavior
    The options are as follows:

    • Activate on Enter
    • Activate on Dwell
    • Activate on Move
    Timers and Delays
    The 100ths of a second spin box allows you to specify the time period for which you must hold the pointer over a key before GOK processes the action as intentional. Specify the time period in 100ths of a second.
    Use key averaging
    This option is not currently available.
    Sensitivity
    Use this slider to specify the sensitivity of the pointing device.
Event Source
This setting determines the type of input device that you use to access and navigate the keyboard. The event source can be one of the following options:

  • Core pointer
  • Other input device
  • Joystick

Feedback Preferences

Name
There are five default feedback methods defined in GOK as follows:

  • Key flashing
  • None
  • Sound one
  • Sound two
  • Speech

Depending on the feedback method that you select, the following options are available.

Enable key flashing
Select this option to see the key flash when you activate a key.
Key flashes
When you select the Enable key flashing option, use this spin box to select the number of times the key flashes when you activate a key.
Enable sound
Select this option to hear a sound when you activate a key.
Sound
When you select the Enable sound option, use this drop-down list to select the sound file to play when you activate a key. You can also activate Browse to search for a file.
Speak key label
Select this option to hear the name of the key when you activate a key.

To Add a New Feedback Method

To add a new feedback method, perform the following steps:

  1. Activate Add.
  2. Type a name for the feedback method in the Name field.
  3. Select the options that you want for the feedback.

To Delete a Feedback Method

To delete a feedback method, select the feedback method that you want to delete from the Name drop-down list, then activate Delete.

To Rename a Feedback Method

To rename a feedback method, perform the following steps:

  1. Select the feedback method that you want to rename from the Name drop-down list.
  2. Activate Rename.
  3. Type the new name in the Change the feedback name field.
  4. Activate OK.

Access Methods Preferences

Method
There are seven access methods defined in GOK for selecting a key on a keyboard, as follows:

  • 5 Switch DirectedThis method enables you to use four switches to move the mouse pointer around the keyboard in four directions; up, down, left, and right. You use a fifth switch to activate the selected key.
  • Automatic ScanningThis method enables you to press a switch to start selecting the rows and keys on the keyboard in sequence. When the application reaches the key that you require, you press another switch to activate the key.
  • Direct SelectionThis method enables you to use a direct mouse click. You use the mouse pointer to select a key and then press a switch to activate the key.
  • Dwell SelectionThis method enables you to use a mouse or other pointing device to position the mouse pointer over a key for a specified period of time to select and activate the key.
  • Inverse ScanningThis method enables you to press and hold a switch to start selecting the rows and keys of the keyboard. When you release the switch, the application stops the selection operation on the current key and you press another switch to activate the selected key.
  • Single Key Automatic ScanningThis method enables you to press a switch to start the application to automatically select each key on the keyboard in sequence. When the application reaches the key that you require, you press another switch to activate the key.
  • Single Key Inverse ScanningThis method enables you to press and hold a switch to select each key on the keyboard. When you release the switch, the application stops the selection operation on the current key and you press another switch to activate the selected key.

Depending on the access method that you select, the Operation, Feedback, and Options preferences differ, as described in the following sections.

Operation Preferences

If you select the Automatic Scanning, Inverse Scanning, Single Key Automatic Scanning, or Single Key Inverse Scanning method, the Operation preferences are as follows:

Scan
Use the drop-down list to select the action that is required to start selecting the keys. For example, if you want to activate the right mouse button to start the selection operation, select Right Mouse Button from the drop-down list.
Activate
Use the drop-down list to select the action that is required to activate a selected key.

If you select the Direct Selection or Dwell Selection method, the Operation preferences are as follows:

Select
Use the drop-down list to select how you want to select a key on the keyboard.
Activate
Use the drop-down list to select the action that is required to activate a selected key.

If you select the 5 Switch Directed method, the Operation preferences are as follows:

Up
Use the drop-down list to select the switch that you want to use to move the mouse pointer up.
Down
Use the drop-down list to select the switch that you want to use to move the mouse pointer down.
Left
Use the drop-down list to select the switch that you want to use to move the mouse pointer left.
Right
Use the drop-down list to select the switch that you want to use to move the mouse pointer right.
Activate
Use the drop-down list to select the action that is required to activate a selected key.

Feedback Preferences

The feedback preferences are the same for all access methods as follows:

Movement
Use the drop-down list to select how you want to receive feedback when you are highlighting keys on the keyboard. The following options are available:

  • Key flashing
  • None
  • Sound one
  • Sound two
  • Speech
Activation
Use the drop-down list to select how you want to receive feedback when you activate a key on the keyboard. The options that are available are the same as those listed above.

Options Preferences

If you select the Automatic Scanning, Inverse Scanning, Single Key Automatic Scanning, or Single Key Inverse Scanning method, the Options preferences are as follows:

Scan Delay
Use this spin box to specify the speed at which the application highlights the rows and keys.
Initial Delay (Automatic Scanning and Single Key Automatic Scanning methods only)
Use this spin box to specify the time delay before the application starts to select the keys on the keyboard.
Wrap Rows/Columns
No information available.
Scanning Direction
Select one of the following options to determine the direction in which the application selects the rows and keys:

  • Top/Bottom
  • Bottom/Top
  • Left/Right
  • Right/Left
Cycles Before Stopping
Use this spin box to specify how many selection cycles the application performs before the application stops selecting keys.

Note

If you select the 5 Switch Directed method, only the Scan Delay and Wrap Rows/Columns as described above are available.

Prediction Preferences

Enable word completion
Select this option to enable the word prediction function when you are using the compose keyboard.
Number of predictions
When you select the Enable word completion check box, use this spin box to specify the number of predictions that GOK attempts.
Use extra word list file
When you select the Enable word completion check box, select this option to specify additional word lists from which to predict the words. For example, you can select a word list that contains words that are specific to a project. Enter the path and filename for the word list in the field provided or activate Browse to search the file system for the file.
Enable command prediction
This option is not currently available.
Number of predictions
This option is not currently available.