EdgeSnap

This is the AROS i386 build, for the 32-bit AROS with ABI v0, as on
AROS One x86; I tried it there. AROS x86_64 has
edgesnap.x86_64-aros-v11.lha here and the Raspberry Pi
edgesnap.aarch64-aros.lha; AmigaOS 4 and MorphOS have their own
archive, on Aminet, OS4Depot and MorphOS-Storage.

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. And on the 32-bit
AROS: an i386 build for ABI v0, as on AROS One x86, added to 0.42 with an
archive of its own.

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, aarch64 or i386, and stops
with an explanation when the archive is the one for another processor. On
the Raspberry Pi and on 32-bit AROS 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, aarch64 and i386) 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, AROS
One 1.3 x86_64 and AROS One x86, each time by installing the package. 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 32-bit AROS, 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