Suggestions to add to documentation

[acorazza]

I didn't quite understand the [X,Y,w,h] coordinates at first, so I thought I'd write an explanation simple enough that even I could understand it. Feel free to use it or modify it!

Grids can be written in two different ways: using the number of grid divisions (such as 4x2 for a grid that is 4 divisions wide by 2 divisions tall), or using a system of [X,Y,Width,Height]. The X and Y coordinates are a percentage of screen width and height that indicate the position of the top left corner of that division, and the Width and Height are a percentage of screen width extending to the right and height extending downward. You may create multiple divisions by separating them with a + sign. For example, 0,0,75,100+25,0,75,100+25,0,50,100 has three divisions:

0,0,75,100 starts at 0,0 (the top left corner of the monitor). It covers 75% of the monitor's width, and 100% of its height (basically, the left 3/4 of the screen).

25,0,75,100 starts at 25,0 (25% away from the monitor's left edge, and at the top of the screen). Like the previous division, it also covers 75% of the monitor's width and 100% of its height, but that 25% offset combined with its 75% width makes it aligned with the right edge of the screen instead of the left. Since this division and the previous one both cover 75% of the screen's width, they will overlap.

25,0,50,100 starts at 25,0 like the previous example and is also 100% of the screen's height, but only covers 50% of the width. The 50% width combined with the 25% offset means this division is centered in the middle of the monitor.

[rxappdev]

Thank you for your suggestion (merci).

Yeah I need to improve the description a bit.

Main issue is the limited space. Need to make is small enough so it fits among the settings.

I also complicated it (due to feature request) in latest release, you can now use both relative (% as in your examples above) and absolute (pixel) values starting with latest release.

I might have to add a separate screen with detailed explanation and examples.

I will add it once I'm done with the main features. Do not expect it this week or maybe event next. Got a list of 7 feature requests waiting. :)

[acorazza]

No worries, I definitely don't think this is a high priority - and I imagined it more for the readme here or a dedicated documentation page, rather than in the app. Thanks again for building this, I've been using it every day!

[rxappdev]

Cheers!

I can add a detailed documentation readme on github, and add a link to it from the settings.

Something like:

Set the layout for the Overlay mode. Valid format is either a grid [XxY] (example 4x2) or [X,Y,Width,Height] each value in percent (example 0,0,100,100 for a full screen tile equal to 1x1). The layout can be made of multiple grids and/or cells separated by a + (example 0,0,50,100+50,0,50,100 which is equal to a 2x1). (SEE REAL EXAMPLES HERE).

Where the SEE REAL EXAMPLES HERE would be better text and lead to a page that shows examples with pictures for instance how 4x2 and 2x2 layout looks.

Well I've added it to my todo.