Description:
  AMOSPro AGA Extension is an unofficial extension for AMOS
  Professional on AGA-equipped Commodore Amiga computers, such
  as the A1200 and A4000, and on suitably configured WinUAE.

  It adds 53 native AMOS commands and functions for AGA graphics,
  without requiring a replacement for the original AMOS editor.

  Main features:
    - AGA indexed screens with 2 to 256 colours
    - IFF/ILBM picture loading and palette management
    - Double buffering and back-buffer drawing
    - Safe Blitter copy, fill and clear operations
      (R57 revised graphics.library fill/clear implementation)
    - Copper raster effects
    - 2D drawing: Plot, Draw, Box and Circle
    - Text rendering and AMOS font-bank selection
    - Keyboard and mouse input, including cursor visibility
      limited to the extension's own AGA window
    - AGAPAL palette banks, fades and palette cycling
    - AGAPIC compressed images in AMOS DATA banks, with CPU
      decoding, opaque/masked drawing and image capture
    - Bank-number convenience commands for images and fonts

  The cursor visibility command does not disable the Workbench
  pointer or mouse input in other windows.

  The R57 / v0.13.2 library has passed automated CPU/CI tests
  and WinUAE tests in both interpreted AMOS and newly compiled
  programs for the documented R57 scenarios.

  R57 improves back-buffer Fill and Clear performance. In one
  compiled WinUAE benchmark, median Fill time decreased from
  54 to 41 ticks and Clear from 115 to 58 ticks versus R55.
  These are emulator benchmark results, not measurements on
  physical Amiga hardware.

  Tests on a physical AGA Amiga have NOT yet been performed,
  and not every command combination has been exhaustively tested.

  Installation:
    1. Back up your existing AMOS configuration and libraries.
    2. Copy AMOSPro_AGA.Lib into your AMOS APSystem directory.
    3. In AMOS Professional, open Config / Set Interpreter /
       Set Loaded Extensions and register the library in a free
       extension slot (historically slot 14 in the project).
    4. Save the interpreter configuration and restart AMOS.
    5. Import .asc example files with Project / Merge ASCII.
       These files are plain text, not native tokenized .AMOS files.

  Some demos need the included IFF picture or font banks. See
  INSTALL.md and the examples documentation for details.

  Requirements:
    - AMOS Professional already installed
    - AGA chipset or AGA-enabled WinUAE configuration
    - An unused AMOS extension slot

  The code, native library, example source and technical
  documentation are released under the MIT License. Graphics,
  logos, IFF images and fonts have separate licensing terms;
  consult ASSETS_LICENSE.md and the relevant attribution files.

  Source, updates and documentation:
    https://github.com/anthea176/AMOSPro-AGA-Extension

  Developed by HWARF with assistance from ChatGPT (OpenAI) for
  programming, testing and documentation.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[MS-DOS]                  3316   12720  26.1% -lh5- 3b2c Nov 10 13:59 AGA_TEST_MODES/DBLNTSC_320x200.iff
[MS-DOS]                  3894   16558  23.5% -lh5- a3de Nov 10 13:59 AGA_TEST_MODES/DBLPAL_320x256.iff
[MS-DOS]                 12256   37556  32.6% -lh5- b4e4 Nov 10 13:59 AGA_TEST_MODES/HAM6_PAL_320x256.iff
[MS-DOS]                 21005   55858  37.6% -lh5- 7500 Nov 10 13:59 AGA_TEST_MODES/HAM8_PAL_320x256.iff
[MS-DOS]                  9297   46714  19.9% -lh5- ffea Nov 10 13:59 AGA_TEST_MODES/SHIRES_LACE_PAL_1280x512.iff
[MS-DOS]                  5948   23268  25.6% -lh5- 74fa Nov 10 13:59 AGA_TEST_MODES/SHIRES_PAL_1280x256.iff
[MS-DOS]                  1953   41274   4.7% -lh5- e033 Nov 10 20:47 AGA_TEST_MODES/TESTCARD_320x256x8.iff
[MS-DOS]                  1759    2880  61.1% -lh5- 7447 Nov 11 17:22 examples/AMCAF_FONT9.abk
[MS-DOS]                   551    1298  42.4% -lh5- f1ec Nov 10 21:52 examples/blitter.asc
[MS-DOS]                   802    1920  41.8% -lh5- 97cd Nov 10 22:51 examples/collide.asc
[MS-DOS]                   483    1294  37.3% -lh5- a9c3 Nov 10 21:52 examples/copper.asc
[MS-DOS]                  1953   41274   4.7% -lh5- e033 Nov 10 21:52 examples/demo.iff
[MS-DOS]                  1175    2881  40.8% -lh5- 873f Nov 11 15:25 examples/fade_to_bank_r33.asc
[MS-DOS]                  1114    2690  41.4% -lh5- 3320 Nov 12 00:17 examples/font_bank_r38.asc
[MS-DOS]                  2318    6714  34.5% -lh5- db35 Nov 12 11:39 examples/m15_2d_cursor.asc
[MS-DOS]                   554    1070  51.8% -lh5- e7aa Nov 10 21:52 examples/mouse.asc
[MS-DOS]                   442    1009  43.8% -lh5- 654e Nov 10 21:52 examples/picture.asc
[MS-DOS]                  4200    9625  43.6% -lh5- 9782 Nov 12 17:45 examples/README.fr.md
[MS-DOS]                  4211    9426  44.7% -lh5- e7a3 Nov 12 17:45 examples/README.md
[MS-DOS]                   303     481  63.0% -lh5- 8a73 Nov 10 21:52 examples/screen.asc
[MS-DOS]                  1682    4675  36.0% -lh5- 4231 Nov 11 10:14 examples/show.asc
[MS-DOS]                   120     146  82.2% -lh5- 33f5 Nov 12 17:45 examples/bank_number_r54/Hwarf-12xxS.licence
[MS-DOS]                  1955   12726  15.4% -lh5- 55e9 Nov 12 17:45 examples/bank_number_r54/Hwarf1252S.abk
[MS-DOS]                   494    1856  26.6% -lh5- 6220 Nov 12 17:45 examples/bank_number_r54/M16_AGAPIC_SAMPLE_BANK10.abk
[MS-DOS]                   977    2221  44.0% -lh5- d6d1 Nov 12 17:45 examples/bank_number_r54/M16_R54_BANK_NUMBER_01.asc
[MS-DOS]                   971    1628  59.6% -lh5- 7113 Nov 12 17:45 examples/bank_number_r54/README.fr.md
[MS-DOS]                   948    1584  59.8% -lh5- 03df Nov 12 17:45 examples/bank_number_r54/README.md
[MS-DOS]                  2199    5601  39.3% -lh5- ca0a Nov 12 13:42 examples/compiler_r46_all_in_one/COMPILER_R46_ALL_IN_ONE.asc
[MS-DOS]                   120     146  82.2% -lh5- 33f5 Nov 12 13:42 examples/compiler_r46_all_in_one/Hwarf-12xxS.licence
[MS-DOS]                  1955   12726  15.4% -lh5- 55e9 Nov 12 13:42 examples/compiler_r46_all_in_one/Hwarf1252S.abk
[MS-DOS]                   494    1856  26.6% -lh5- 6220 Nov 12 13:42 examples/compiler_r46_all_in_one/M16_AGAPIC_SAMPLE_BANK10.abk
[MS-DOS]                  1894    3645  52.0% -lh5- 89b2 Nov 12 13:59 examples/compiler_r46_all_in_one/README.md
[MS-DOS]                 85550  636228  13.4% -lh5- dc4f Nov 12 20:07 sources/AMOSPro_AGA_R57_C1_NATIVE.s
[MS-DOS]                  1631    3298  49.5% -lh5- bef6 Nov 12 19:57 AMOSProAGA.readme
[MS-DOS]                 15737   39115  40.2% -lh5- 01b7 Nov 12 19:21 README.md
[MS-DOS]                 16542   41453  39.9% -lh5- d8db Nov 12 19:21 README.fr.md
[MS-DOS]                 12774   32980  38.7% -lh5- d7ec Nov 12 19:06 AMOSPro_AGA.Lib
[MS-DOS]                  2616    5438  48.1% -lh5- 7421 Nov 12 17:45 INSTALL.md
[MS-DOS]                  2526    5380  47.0% -lh5- 471b Nov 12 17:45 INSTALL.fr.md
[MS-DOS]                   634    1083  58.5% -lh5- 194c Nov 10 21:00 license
[MS-DOS]                 74882   80776  92.7% -lh5- 17ed Nov 10 20:42 AGA_DEMO.iff
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        41 files  304235 1211071  25.1%            Nov 13 01:34