Ami-printscreen

=============
 Description
=============

NAME
    Ami-PrintScreen is a Shell command to save the current visible screen to
clipboard.
    It allows you to easily and quickly Copy & Paste screen shots among
applications.

USAGE
    This is best used if assigned to a user defined keyboard key via the FKey
system commodity.
    Example settings:
    - Key sequence=PrintScreen
    - Command=Run program
    - Command parameters=run > NIL: SYS:C/Ami-PrintScreen >
"CON:0/20/640/120/Ami-PriScr log/AUTO/CLOSE/WAIT/INACTIVE"
    You can also have it at startup via the WBStartup system preferences tool.

    On success, it saves the result to RAM:Clipboards/0 and it flashes the
display when the work is done.
    On failure, you get an error message to log window.

==============
 Requirements
==============

AmigaOS 4.x running on PowerPC based computers.

==========
 Features
==========

- It supports Picasso96 Retargetable Graphics System
- It works with chunky screens, supported RGB formats are:
  - 16-bit R5G6B5 R5G5B5
  - 24-bit RGB BGR
  - 32-bit ARGB ABGR RGBA BGRA
- Output file format is uncompressed IFF-ILBM 24-bit
- It can grab pulled down menus
- Tested OK with MemGuard and Sashimi
- Written in C language from scratch, source code supplied

==================
 Releases history
==================

- Version 52.0 released 31-Oct-2010, first public release

- Version 52.1 released 05-Nov-2010:
  * added support for 16-bit screens

- Version 52.2 released 26-Nov-2010:
  * a minor issue fixed:
    now bitmap Width is always correct and it is not affected by alignment
restrictions anymore
  * improved error handling
  * few minor changes and improvements

========
 Author
========

Massimiliano Scarano
E-mail: mscarano()libero.it