[BRLTTY] Windows First Run

[Dave Mielke]

[quoted lines by Oriana Neulinger on 2019/10/26 at 20:19 -0400]

>The Alva's buttons didn't do anything individually, so that's why i was
>hoping to get some keyboard shortcuts... 

They should work. Check what happens when in a console window.

You can see what the keys do by going to brltty.app, clicking on Documentation,
then on Key Binding Lists, and then on Braille Device Bindings. Then scroll
down to Alva, and click on Satellite (small). I've attached the key bindings
for the Satellite 544 (as alva-544.txt) to this message.

>What do you mean by enable the API? I'm assuming it's enabled by default,
>right? 

Yes, but you don't necessarily want to continue to run brltty manually. If you
run brltty's install.bat script (renamed to enable-brlapi.bat in the
development stream for the next release) then the BrlAPI service will be
installed and started. And, yes, the uninstall.bat script (renamed to
disable-brlapi.bat) stops and removes the service. Note, though, that you won't
get the debug logs when brltty is running via the BrlAPI service.

>What does it mean that "no-api off" is commented? 

It means that off is the default for the no-api option. Yes, it's like a double
negative but the option is, after all, to disable the API.

>Or do I need to do things like run the api executable, create the key,
>uncomment the path to the key in the config, etc?

If you want to play with enhyancing security then you might want to set up the
key. For now, though, in order to keep things simple, you should probably set
the API's auth parameter to none.

>Does this executable need to be run every time brltty is started?

No. Just use those .bat scripts as described above.

>Did we need to use the windows screen driver or will NVDA take care of that?

NVDA will take care of it when it's in control, but brltty will probably work
better on its own when in a console window. For that, yes, you do need to be
using the Windows screen driver.

-- 
I believe the Bible to be the very Word of God: http://Mielke.cc/bible/
Dave Mielke            | 2213 Fox Crescent | WebHome: http://Mielke.cc/
EMail: Dave at Mielke.cc  | Ottawa, Ontario   | Twitter: @Dave_Mielke
Phone: +1 613 726 0014 | Canada  K2A 1H7   |
-------------- next part --------------
Key Table: Alva Satellite [5nn] (small)
=======================================

Notes
* The keypads at either side of the top are named LeftPad and RightPad.
  The four inner keys of each are subnamed Left, Right, Up, and Down.
  The two outer keys of each are subnamed F1 and F2.
* The two long, flat keys are named Up and Down.
* The two long, bent keys are named Left and Right.
* The two round keys are named Home and Cursor.

Default Bindings
----------------

Special Modes
* enter/leave help display: RightPadF1
* enter/leave command learn mode: RightPadF2
* enter/leave preferences menu: RightPadLeft
* enter/leave status display: RightPadRight
* set display mode attributes/text: Status2B
* set screen image frozen/unfrozen: RightPadF1+RightPadLeft
* describe character: RoutingKey2

Cursor Functions
* go to screen cursor: Cursor
* go back after cursor tracking: Home
* bring screen cursor to character: RoutingKey1
* bring screen cursor to current line: RightPadF2+RightPadRight

Vertical Navigation
* go up one line: Up
* go down one line: Down
* go to top line: Cursor+Up
* go to bottom line: Cursor+Down
* go to beginning of top line: Home+Up
* go to beginning of bottom line: Home+Down
* go up to nearest line with different content: RightPadF1+Up
* go down to nearest line with different content: RightPadF1+Down
* go up to nearest line with different highlighting: RightPadF2+Up
* go down to nearest line with different highlighting: RightPadF2+Down
* go up to first line of paragraph: RightPadF1+RightPadUp
* go down to first line of next paragraph: RightPadF1+RightPadDown
* go up to previous command prompt: RightPadUp
* go down to next command prompt: RightPadDown
* go up to nearest line with less indent than character: Cursor+RoutingKey2
* go down to nearest line with less indent than character: Cursor+RoutingKey1

Horizontal Navigation
* go backward one braille window: Left
* go forward one braille window: Right
* go backward skipping blank braille windows: Cursor+Left
* go forward skipping blank braille windows: Cursor+Right
* go to beginning of line: Home+Left
* go to end of line: Home+Right
* go left one character: RightPadF1+Left
* go right one character: RightPadF1+Right
* go left half a braille window: RightPadF2+Left
* go right half a braille window: RightPadF2+Right

Clipboard Functions
* start new clipboard at character: RightPadF1+RoutingKey1
* append to clipboard from character: RightPadF1+RoutingKey2
* linear copy to character: RightPadF2+RoutingKey2
* rectangular copy to character: RightPadF2+RoutingKey1
* insert clipboard text after screen cursor: RightPadF2+RightPadLeft
* search backward for clipboard text: RightPadF2+RightPadUp
* search forward for clipboard text: RightPadF2+RightPadDown

Configuration Functions
* set text style 6-dot/8-dot: RightPadF1+RightPadRight
* set skipping of lines with identical content on/off: Status2A
* set skipping of blank braille windows on/off: Status2C
* set track screen cursor on/off: Home+Cursor
* set screen cursor visibility on/off: Status1A
* set attribute underlining on/off: Status1B
* set capital letter blinking on/off: Status1C

Speech Functions
* stop speaking: LeftPadLeft
* speak current line: LeftPadRight
* speak from top of screen through current line: LeftPadUp
* speak from current line through bottom of screen: LeftPadDown
* go to current speaking position: LeftPadF1
* decrease speaking volume: LeftPadF2+LeftPadDown
* increase speaking volume: LeftPadF2+LeftPadUp
* decrease speaking rate: LeftPadF2+LeftPadLeft
* increase speaking rate: LeftPadF2+LeftPadRight
* set autospeak on/off: LeftPadF2

Special Functions
* remember current braille window position: Home+RoutingKey2
* go to remembered braille window position: Home+RoutingKey1
* restart braille driver: RightPadF1+RightPadF2
* restart speech driver: LeftPadF1+LeftPadF2

Menu Bindings
-------------

Special Modes
* enter/leave preferences menu: Home+Cursor

Horizontal Navigation
* go backward one braille window: Left
* go forward one braille window: Right

Menu Operations
* go up to previous item: Up
* go down to next item: Down
* go up to first item: Home+Up
* go down to last item: Home+Down
* select previous choice: Home
* select next choice: Cursor
* restore preferences from disk: Home+Left
* save preferences to disk: Home+Right