EdgeSnap

This is the AROS aarch64 build, for the native AROS on the Raspberry
Pi; I tried it on a Raspberry Pi 400. AROS x86_64 has
edgesnap.x86_64-aros-v11.lha here; AmigaOS 4 and MorphOS have their
own archive, on Aminet, OS4Depot and MorphOS-Storage.
The AROS images for the Raspberry Pi I tried have no LhA command: if
yours has none, unpack the archive on another computer and copy the
EdgeSnap drawer to the card.

WHAT IS NEW IN 0.42

EdgeSnap now runs on AROS for the Raspberry Pi as well: an aarch64 build,
with an archive of its own, tried on a Raspberry Pi 400.

Docks are recognised in two more shapes. A short dock standing along a side
of the screen was taken for a small widget, and a panel kept behind the
windows, as Ambient allows, was never looked at: windows snapped over both.
Now they keep their edge clear, so margins set by hand to keep a dock
uncovered can go back to 0.

Install recognises which AROS it runs on, x86_64 or aarch64, and stops with
an explanation when the archive is the one for the other processor. On the
Raspberry Pi it installs EdgeSnap by itself, with no Installer, as it does
on any AROS whose own Installer cannot copy files.

WHAT IT IS

EdgeSnap gives AmigaOS 4.x, MorphOS and AROS (x86_64 and aarch64) the window
snapping that Windows and macOS users reach for without thinking. Drag a
window against a screen edge or corner and it glides into that half or
quarter of the screen. A frame shows where it will land before you let go.

Two windows that end up side by side share a seam, and that seam can be
dragged: both windows are resized together, so half and half becomes sixty
and forty. Docks and panels are detected and never covered.

It installs as a commodity that starts with the system, so the behaviour is
simply there. Nobody has to launch anything.

THIS IS A BETA

Version 0.42 is still a beta. I checked it on real MorphOS hardware, on a
Raspberry Pi 400 with AROS aarch64, and under emulation on AmigaOS 4.1 and
AROS One 1.3 x86_64, each time by installing the package over an earlier
installation. On one AROS installation Wanderer's drawers can show black
areas after a snap; another program that moves windows does the same there,
and the AROS developers are looking into how Wanderer redraws a drawer. All
of it remains worth reporting.

The interface below 1.0 is not frozen. If EdgeSnap covers your dock, misses
your seam or draws something odd, please include the system, version banner,
steps and a screenshot in your report.

Report it here, or to the address at the top of this file:

https://github.com/kaffeine1/edgesnap/issues

INSTALLING

Unpack the archive and double-click Install. It recognises the system,
proposes the matching build, and asks before doing anything: the library
goes to LIBS: and the preferences window to SYS:Prefs/. On AmigaOS 4 and
MorphOS the commodity goes to C: with a line in S:User-Startup. On AROS it
goes to SYS:WBStartup with its icon, and the first preview's copy in C: is
stopped and removed. On the Raspberry Pi, and on any AROS whose own
Installer cannot copy files, Install does all of this by itself after one
question. Updating is just installing again: the running copy is stopped and
replaced, with no reboot, except that on the Raspberry Pi a new library
takes over at the next boot.

USING IT

  - Drag a window's title bar until the POINTER touches an edge or a
    corner, then release.
  - Grab the seam between two tiled windows - the pointer becomes a
    double arrow - and drag it to re-balance them.
  - ctrl alt cursor left/right/up snap the active window,
    ctrl alt cursor down puts it back where it was, ctrl alt c puts
    it in the middle at the size it has, and ctrl alt z opens a
    selector under the pointer with all of that on nine cells.
  - Settings live in SYS:Prefs/EdgeSnap, native on each system: ReAction
    on AmigaOS 4, MUI on MorphOS, Zune on AROS. EdgeSnap follows changes
    at once, without being restarted.
  - Exchange enables, disables or removes it, as with any commodity.
  - EdgeSnap QUIT stops it from a Shell or a script.

FOR PROGRAMMERS

The behaviour lives in edgesnap.library, not in the commodity: the commodity
is a client of it like any other program can be. Another program can place a
window in a zone or in any rectangle, find and move the seam between two
tiled windows, list the windows with their state, follow their changes and
lay out several windows in one call.

Since 2.10 the library also serves tiling window managers: one client owns
the interactive drag and any number own their layouts, work areas keep an
identity across a screen mode change, and a layout group can keep every
other program, the commodity's drag included, off its windows. Since 2.20 a
group can also keep gaps between its windows and margins from the edges of
the screen. The included esnaptest client exercises the whole API on every
system.

The library says 2.23 while EdgeSnap says 0.42, and that is not a mistake: a
library's version is its interface, not its product. While EdgeSnap is below
1.0 treat that interface as not frozen - methods are only ever appended,
never moved or removed, but names and arguments may still change.

THANKS

The icons are by Carlo Spadoni, who drew them for EdgeSnap and let me ship
them with it. The testers on the AROSWorld forum found the black areas in
Wanderer's drawers, the colour left along the seam and the traces of the
preview frame on one graphics driver, each with a video or a log that made
the cause findable.

LICENCE AND SOURCE

MIT. The full text is in the LICENSE file inside the archive.

Source, issues and the design notes: https://github.com/kaffeine1/edgesnap