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.
|