Short:        shapng (SHA256 to PNG)
Author:       Rupert Hausberger <naTmeg@gmx.net>
Uploader:     Rupert Hausberger <naTmeg gmx net>
Type:         util/misc
Version:      1.1
Replaces:     shapng.lha
Architecture: ppc-morphos

DESCRIPTION
===========
  "shapng" is a tool to convert a sha256-sum, gained from a string or file,
  into a 16x16 png-image. This image can be read visualy by robots...

  How does it work
  ----------------
  First, a sha256-sum is generated from the input. Then, this sum is converted
  into a array of 256 bits and converted more into a 16x16 bit-box. The first
  bit is assigned to the top-left and the last to the right-bottom.

  It it READ horizontaly, from left to right and line by line.


REQUIREMENTS
============
  - MorphOS 1.x


INSTALLATION
============
  Copy the executable to C:


USAGE
=====
  "shapng" does only work from a shell.

  Arguments
  ---------
  NAME/A,TO,S=SIZE/N,FG=FORGROUND/N,BG=BACKGROUND/N,PS=PRINTSUM/S

  NAME/A          - Filename or string for input.
                    If the string is a filename, it is handled as file,
                    else as string. (Mandatory)

  TO              - Output file.
                    If blank, "PROGDIR:<NAME/A>.sha.png" is created. (Optional)

  S=SIZE/N        - Size of the blocks in gfx.
                    Defaults to 4. (Optional)

  FG=FORGROUND/N  - Forground color as hex-number in the format 0x<RR><GG><BB>.
                    Defaults to 0x000000. (Optional)

  BG=BACKGROUND/N - Background color as hex-number in the format 0x<RR><GG><BB>.
                    Defaults to 0xffffff. (Optional)

  PS=PRINTSUM/S   - Also print the sha-sum to stdout.
                    Defaults to false. (Optional)


EXAMPES
=======
  From a shell
  ------------
  shapng "Hello World" ram:icon.png"   - creates "ram:icon.png" from the string.
  shapng shapng.readme                 - creates "shapng.readme.sha.png" in PROGDIR.
  shapng shapng.readme SIZE 10         - increase gfx-blocksize to 10.


AUTHOR
======
  Rupert Hausberger <naTmeg@gmx.net>


AVAILABILITY
============
  - WWW:
    http://naTmeg.webhop.net

  - Aminet, for example:
    ftp://ftp.germany.aminet.org/pub/aminet/util/misc/shapng-morphos.lha


LICENSE
=======
  shapng is "Freeware".

  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGES.


CHANGELOG
=========
v1.1 (08.09.2008)
-----------------
  - Now the sha256-sum is stored into the png-image as hex-string with
    the tag-id: "SHA256".

v1.0 (08.09.2008)
-----------------
  - Initial.