Использовано

Florence запускается легко. Чтобы запустить Florence из командной строки, выполните:

$ florence
		

From a MATE desktop, you can launch Florence from the menu Applications->Accessibility->Florence Virtual keyboard. If you prefer that Florence is launched at MATE startup, choose the menu item System->Preferences->Sessions, click on the Startup programs tab, then click Add and enter /usr/bin/florence so Florence is launched with MATE at next boot.

Когда включён Florence, иконка должны находиться в зоне уведомлений, обычно справа сверху экрана. Клик по иконке убирает или включает видимость Florence на экране. Щелчком правой кнопкой мыши на нём вызывается меню. В этом меню вы можете использовать quit, чтобы выйти из Florence.

Методы ввода

Florence can be used with 4 different input methods. Each method has advantages and drawbacks. It is up to you to select the right one for your usage pattern.

  1. The default input method is the "mouse" method. This is adapted for mouse/trackpad input. It is pretty straightforward. Just click on the key with a mouse button to press it. Release the mouse button to release the key. The advantage of this method is its simplicity. It does not require learning. The drawback is that is requires a pointing device with a button and that the user is able to use it.

  2. The second input method is the "touch" method. This is adapted for touch screen input. The difference with the mouse input method is that it not possible to touch the keyboard without clicking. In this mode, the keys are pressed on touch end.

  3. The next method is the "timer" method. Use this method if you are unable to use a button. Point a key with the pointer and a timer is triggered. When the timer expires, the key is pressed and immediately released. The timer is cancelled if the pointer leaves the key. Note you can still press a mouse button to activate the key if you have one available. The advantage of this method is that it does not require a button. The drawbacks are that it is slower than the button method and that you can not hold a key pressed.

  4. The last method is the "ramble" method. Like the timer method, the ramble method does not require a button. This method can be faster than the timer method but requires dexterity and training to be used efficiently. The ramble method can be passive: no button necessary, or active: deaf while the pointer button is not pressed. There are two sub-methods for rambling.

    1. The time-based ramble method requires good timing. While you move the pointer, Florence will detect keys that are to be activated based on the time the pointer stays over them. With this method, you can press the same key multiple times by moving the pointer to near the border of the key and back to the center. This method can be pretty fast with good training.

    2. The distance-based ramble method requires some dexterity to be used efficiently. The distance the pointer moves over the key is measured and the key is activated when it reaches a threshold. The key can be pressed multiple times by moving the pointer over the key repeatedly. A second threshold is there to detect multiple occurences. To use this method efficiently, apply quick gestures over the keys you want to activate.

Режимы Florence

Florence работает в нескольких режимах, влияющих на его функционал и использование пользователем.

В режиме автоскрытия Florence сворачивается, когда в нём нет необходимости. Есть несколько правил, чтобы понять, когда Florence должен быть запущен. Они описаны в at-spi. Например, Florence появляется, когда вы наведёте курсор на редактируемый виджет, который настроен при использовании клавиатуры. Florence будет скрыт, когда курсор убран с виджета. Это не работает, если виджет на совместим с at-spi. В частности, виджеты QT3 не будут стабильно работать с Florence. Вы должны быть уверены, что ваши приложения поддерживают at-spi, если вы намереваетесь использовать Florence в скрытом режиме. Когда этот режим отключён, Florence всегда виден на экране.

The auto hide mode requires accessibility to be activated, which means the at-spi registry daemon is running and applications are using it.

Рисунок 1. Расширения Florence

Показывает доступные расширения

На рисунке выше показаны различные части раскладки по умолчанию. Там же показаны другие раскладки, которые могут быть выбраны в окне настройки (раздел раскладок).

The default keyboard layout can be extended with 4 extensions to the core keyboard. The Florence key pad is an extension to the left of the main keyboard which contains keys to access special Florence functions: see below for a complete list of Florence functions. The arrows keypad is an extension added to the right of the core keyboard and contains the arrow keys along with navigation keys. The numpad extension contains the numeric keys and the function keys extension contains the function keys. Each extension can be activated and deactivated independantly. The extensions are relative to the selected layout.

Florence keys

The following keys give access to special Florence functions. They are located on the "Florence keys" extension.

Рисунок 2. Minimize key

Minimize key.


The minimize key hides the keyboard. The program is still running and the keyboard can be shown again by clicking on the icon or by selecting a text entry widget when auto-hide mode is on.

Рисунок 3. Configuration key

Configuration key.


The configuration key opens the configuration dialog. See the configuration chapter for more information about the configuration dialog.

Рисунок 4. Move key

Move key.


You can move the keyboard around the screen with the move key. Press the move key, move the pointer and release the button when the keyboard is located where you want it.

Рисунок 5. Bigger key

Bigger key.


Press the bigger key to increase the size of the keyboard.

Рисунок 6. Smaller key

Smaller key.


Press the smaller key to decrease the size of the keyboard.

Рисунок 7. Close key

Close key.


Press the close key to terminate the program. The close key is accessible when the alt modifier key is pressed, at the location of the minimize key.

Рисунок 8. Switch key

Switch key.


The switch key is accessible when the alt modifier key is pressed, at the location of the configuration key. The label of the key shows the current language of the keyboard. Press it to switch to the next laguage. Pressing it several times cycles through the available language layouts. On GNOME/MATE, the available language layouts can be configured with the gnome-keyboard-properties program (in the layout tab). If only one language is configured, pressing this key has no effect, it just shows the language layout currently configured.

Клавиши-модификаторы

Некоторые клавиши имеют модификатор, как на обычной клавиатуре. Когда клавиша нажата, выполняется другое действие, нежели на обычной клавише. Управляют включением модификации клавиши SHIFT и CAPS LOCK. Это - два разных типа клавиш-модификаторов: блокированный и неблокированный типы модификаторов. Блокированный тип активируется, когда кнопка нажата и деактивируется, когда кнопка нажата ещё раз. Неблокированный тип активирован только когда кнопка нажата.

When activated, the locker keys turn red (the color can be changed in the settings dialog) and the symbol displayed on all non-modifier keys is changed accordingly. If a non-modifier key is pressed while a locker key is active, its effect will be modified according to it.

When using a mouse, it is not possible to press 2 keys at the same time. As a solution to this problem, Florence latches non-locker modifiers when pressed. When a modifier is latched, it turns green (that color can be changed in the settings dialog). It will remain latched until another non-modifier key is pressed. If a latched key is pressed again, it turns red and becomes locked. A locked modifier will remain locked until it is pressed again to become released.

Configuration

The configuration dialog is accessible via the system tray and floating icon (right click on it and select Preferences) or via the command line with the -c or --config switch: florence --config or via the configuration button on the keyboard if present. Hacking configuration is possible via dconf (see the hacking section)

Некоторые выбранные опции не будут применены, пока вы не нажмёте "Применить". Некоторые другие опции применяются сразу, но могут быть отменены нажатием кнопки "Отмена", если вы перед этим не применили изменения.

Настраиваемые опции разделены на четыре группы для более лучшего понимания и поиска между ними.

Конфигурировать стиль

Рисунок 9. Диалог настроек стиля

Показывает диалог настройки стиля.

Следующие опции стиля могут быть настроены:

  1. Стиль: выберите ваш стиль, нажав на иконку стиля.

  2. Цвет кнопок по умолчанию: выбор цвета обычных кнопок.

  3. Цвет заблокированных кнопок: выбор цвета недоступных к использованию кнопок.

  4. Цвет нажатых кнопок: выбор цвета нажатых или заблокированных кнопок.

  5. Цвет сфокусированной кнопки: выбор цвета клавиши, на которой находится курсор.

  6. Цвет символов: выбор цвета текста на клавишах.

  7. Цвет краёв: выбор цвета окаймления букв. Используется для улучшения видимости символов на кнопках. Должен быть более контрастным, нежели цвет самого символа.

  8. Увеличение фокуса: установка масштаба "лупы". Полезно для людей с нарушением зрения.

  9. Enable sound: when this box is checked, the keyboard generates sound feedback when a key is hovered, pressed or released.

  10. Use system font: when this box is checked, the labels on the keys use the default system font. When this box is unchecked, the font selected below is used instead.

  11. Keyboard font: With this parameter you can select the font used to draw key labels and its size.

Настройка окна

Рисунок 10. Диалог настройки окна.

Показывает диалог настроек окна.

  1. Декорирование: украшает окно и заголовок. Делает перетаскивание окна более удобным.

  2. Прозрачность: позволяет вам видеть окна под клавиатурой и щёлкать по ним.

  3. Масштаб: позволяет вам настроить величину клавиатуры. Некоторые менеджеры окон требуют включения декора окна, чтобы масштабировать окно.

  4. Панель задач: сделать Florence видимым на панели задач.

  5. Всегда наверху: держит окно с клавиатурой всегда поверх всех окон.

  6. System tray icon: Display an icon in the system tray to control the keyboard: you can right-click on it to display the Florence menu and left-click on it to show or hide the keybaord.

  7. Floating icon: Like the system tray icon but not attached to the system tray. You can drag the icon around the screen to move it where you want it.

  8. Opacity: set the window opacity in order to see the other windows through the keys. The window manager must support compositing and it must be activated for this option to work.

Настройка поведения

Рисунок 11. Диалог настройки поведения

Показывает диалог настройки поведения

  1. Метод ввода: устанавливает метод ввода. Некоторые методы ввода могут иметь дополнительные опции.

  2. Автоскрытие: включает или выключает автоскрытие окна.

  3. Перемещение к выбраному виджету: эта опция доступна только когда автоскрытие включено. Когда влючено, клавиатура будет перемещена к ближайшему выбранному виджету каждый раз, когда вы выберите другой, с целью уменьшить расстояние от указателя до клавиатуры.

  4. Intermediate icon: In auto-hide mode, don't show the keyboard directly on editable widgets, but make an intermediate icon appear instead. Click on the intermediate icon to show the actual keyboard. This option makes Florence less intrusive: for instance, if you want to read a document without editing, the intermediate icon takes less screen space than the keyboard.

Настройка раскладок

Рисунок 12. Диалог настройки раскладок

Показывает диалог настройки раскладок.

Первый комбобокс позволяет вам выбрать вашу раскладку клавиатуры. К раскладке также могут быть применены расширения. Они могут быть включены или выключены независимо друг от друга. Ниже приведены четыре расширения для стандартной раскладки:

  1. Клавиши навигации: включить или выключить стрелки.

  2. Цифровые клавиши: включение или выключение Num-клавиатуры.

  3. Функциональные клавиши: включение или выключение расширенных функциональных клавиш.

  4. Клавиши действия: включить/выключить расширение клавиш действия.

Параметры командной строки

florence [OPTION] ... [COMMAND] [ARG]

The florence command accepts the following options:

  1. -h (--help): показывает краткую помощь и закрывает программу.

  2. -V (--version): показывает установленную версию Florence и закрывает программу.

  3. -c (--config): открывает окно настроек.

  4. -d (--debug): запускает Florence с дебаггером.

  5. -f (--focus) [window]: with this option, any florence input will go to the selected window. The window argument is the name of the window (the one that most window managers put in the title bar). if the window argument is not provided, florence will select the last focused window. This option is useful for window managers that don't support the 'not focusable' hint and focus the keyboard window instead of the output one. It can also be useful if you want to input text to a window that is not focused. This option must be used for the keyboard to work in GDM.

  6. -u (--use-config) file: use the configuration file provided instead of dconf. The configuration file is a key-value pair file with sections. An example of configuration file is provided at /usr/share/florence/florence.conf (the path may be changed with the --prefix configure option).

The following commands are available to control the keyboard from a script:

  1. show : show the keyboard.

  2. hide : hide the keyboard.

  3. move x,y : move the keyboard at x,y position on the screen.