[BRLTTY] Modification to the Canute 360 Driver for line update order

[Hollie Baker]

Dear Dave and the BRLTTY Community,

I am a Canute 360 Console user, and a friend of mine (Penn, his website is
https://hack5.dev/) has made an adjustment to the Canute driver such that
it updates the row containing the cursor first, then alternating rows below
and above the cursor, from closest to farthest, until all rows are
up-to-date. The Canute traditionally updates from the top down, so this is
a very nice optimisation for those editing text or working in the terminal.

I'm in touch with Ed and the team at Bristol Braille, and they like it.
Although we all agree that it should be possible to switch between modes at
runtime (we added an BrlAPI driver property for that). Eventually, we'd
like to merge our changes into the upstream BRLTTY briver  How do you (as
BRLTTY developers) feel about this?

I also have a question about the runtime parameter, and would very much
appreciate some advice, please.
We've added a braille-parameter, cn:update-order=<top-down,cursor-out> (set
via a command line argument or config file) and that works. We also added a
runtime property which can be set via BrlAPI. However, I am having trouble
with the runtime property at present, as I am attempting to set it vai the
canute-parameter script, which calls the following:
apiCommand set-parameter "${apiParameter}" "${newValue}"
The above calls the Java BrlAPI client. The driver-property-value expects
two arguments: subParameter and newValue. This is the point at which I got
stuck.
I can query the driver property's value (which indicates that my code
changes were correct, I hope), with
apiCommand set-parameter driver-property 0
(where 0 is the key of our new parameter), but I cannot seem to set the
value via apiCommand:
apiCommand set-parameter "${apiParameter}" "${newValue} ${apiSubParam}"
The quotes send the parameter and value as the argument, without the quotes
I receive the error
SetParameterClient: API error: Invalid parameter
With quotes, I get
SetParameterClient: driver-property-value value is not an integer: 0
(there is a space after the zero.)
I was wondering whether it is possible to send the value and subparameter
to SetParameterClient via the Canute script, or whether I'd be better off
writing a new script to call BrlAPI?

Thank you so much for your help, and for creating this very useful tool!

All the best,
Hollie
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://brltty.app/pipermail/brltty/attachments/20260819/20d800ea/attachment.htm>