Naming the layers

Hi, is there a way to (re-)name the layers, and have I missed some documentation on this?

With thanks

1 Like

No, you have to remember that Fn2 is your symbol layer (for example).

OK. Not really important anyway. Thank you for the quick response.

BTW, you can use any layer for everything. The mouse layer could be used for your symbols and the Mod layer could be used for macro’s. Sure it makes sense to put your stuff into layers, where the name fits. There is one distinction. The Shift-layer will not be displayed in the top LED, while the fn layers (all of them) will show up there as ‘fn’ and the mouse layer will be shown as ‘mouse’.

So there is no restriction what you really put into a layer. But the Shift, Ctrl… layers are there for overriding the default action of the related layers (held keys).

I wish you could rename layers, but no, it’s (currently) not possible.

Since you mention it, I am fascinated and as yet unclear what the distinction is between the ‘shift’ layer for example and the standard fn layers. So how would the ‘Shift’ and ‘Control’ layers be used then? In what way would they override the default actions, and of what? The defaul actions that occur when eg control is usually pressed? How is this an ‘override’ as opposed to just another layer?

I guess the difference is basically that unchanged Base layer keys will pass-through while activating the Shift/Control layers, as opposed to how a FN/MOD/MOUSE layer will change the entire layer.

For example, if you activate a FN/MOD/MOUSE layer, any blank (unmapped) key won’t do anything. Conversely, any key you remap on the Shift/Control layers will be remapped like any other layer, but only the remapped keys will be affected when using the Shift/Control keys. All other unchanged keys will pass-through normal (non-Shift/Control layer) functions while using the Shift/Control key.

That’s really clear, thank you. How does anyone know this? I have not found the documentation.

Very last entry of the entire reference-manual :wink:

Modifier Layers

Here’s an earlier thread on Modifier Layers where some examples are mentioned:
How Modifier Layers Work

We better clarify layer semantics in Agent because people consistently wonder about them.

Notice the added “?” icon. What should its tooltip contain? My proposal:

  • The Base layer is active by default and can’t be deleted.
  • Mod, Mouse, Fn, Fn2, Fn3, Fn4, Fn5 are regular layers that their layer switch actions can activate.
  • Shift, Control, Alt, Super are modifier layers that the related modifier keys can activate.

Looks good, guys? I’m summoning @maexxx because he’s been helpful in phrasing. Everyone else is welcome to suggest.

@mlac I heard the summon; I have to think about it a bit.

1 Like

I’m intrigued by what seem like endless possibilities to configure the layers. However, not being a programmer by background, reading the github documentation is tantalizing… I understand some of it but not most. It is one of those situations where someone might ask “What do you want to do?” and I would say “I don’t know, until I know what it is possible to do”. Is it possible that someone will feel the urge to produce a tutorial that does not assume prior knowledge, with examples to try etc? Or a course on a Udemy etc?

It might be worth adding example commands to the reference manual. We could collapse the examples by default so they do not occupy space.

If you think the tooltip is fine, we can implement it as it is.

You have been granted a wish :wink:

  • The Base layer is active by default (when no other layers are active). This layer can never be deleted.
  • Mod, Mouse, Fn, Fn2, Fn3, Fn4, Fn5 are layers activated by layer switch actions, often bound to keys such as Mouse, Mod, or Fn. When such a layer is active, keys produce what is defined on that layer.
  • Shift, Control, Alt, Super are modifier layers activated by related modifier keys. These layers override the normal action from the base layer. (e.g. Shift+a normally produces an uppercase A, but can be overridden by defining a different action on the Shift layer.) Keys left unconfigured on a modifier layer revert to their regular base layer + modifier action.

Feel free to take/modify/mangle my proposal.

1 Like

Thank you so much! :slight_smile: Just created Add layer explanation tooltip · Issue #2315 · UltimateHackingKeyboard/agent · GitHub

1 Like