deutsch

pnmview_grf: MANUAL




PURPOSE


The archive contains a program for displaying PBM, PGM and PPM images on the Graffiti video card.

ARCHIVE CONTENTS


The archive should enclose the following files (file lenght at the end of the line):

main directory

directory bin/

directory doc/

directory doc/gfx/

directory help/

directory libs/

If one of this files is missing, it would be better to get a full version of the archive, best you get it directly from my homepage.


SHAREWARE VERSION


This package is SHAREWARE. All files in this archive are copyrighted (except the file "graffiti.library" !), that means (c) Stefan Diener. You may freely redistibute this archive, but it is not allowed to modify the archive and to distibute the modified form. (It´s especially not allowed to remove this notice !)

Any exception requires my personal agreement.

This package contains:

REGISTERED VERSION


If you are using parts of this software regulary, it is your duty to register for this package. Your advantages:
Think about it and you will see, it is worth registering.

Prices:
First STIMP package - Germany
cash OR euro-chequeC.O.D.direct transfer to my account
via email10 DM-10 DM
by post15 DM23 DM15 DM


Second++ STIMP package - Germany
cash OR euro-chequeC.O.D.direct transfer to my account
via email6 DM-6 DM
by post11 DM19 DM11 DM


Germany only: If you want to transfer the money directly to my account, please use the following data. Please send me an email or a letter with your desire and your detailed adress too.

number of account: 422 689 000
name of bank: Bank 24
BLZ: 380 707 24
purpose: "your name"

My address: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen, Germany.


First STIMP package - Europe, World
cash OR euro-cheque
via email10 DM/6 US$
by post15 DM/9 US$
by air mail17 DM/11 US$


Second++ STIMP package - Europe, World
cash OR euro-cheque
via email6 DM/4 US$
by post11 DM/7 US$
by air mail13 DM/8 US$


My address: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen, Germany.

If you are a registered user you have to take a look at the different copyright definitions:

Any exception requires my personal agreement.


VERSION AND PLANS


This guide was made for the second release of this package. If you have a newer version of the whole archive just forget this file.

Plans:
- add file requester for easy file selection
- allow start from Workbench
- allow saving files (especially useful for reduced PPM files)
- text output directly onto the Graffiti screen, for instance during loading the next picture or dithering - ??? user proposals ... requests are welcome !

Important note:
The future of the program depends on how many people will register. So I suggest to register! If the user's support will be as low as after the last releases the development will be canceled. Please register!


GUARANTEE


Sorry, but there is no guarantee given. There´s no guarantee whether the program runs on your computer or that it will do the job you thought it should. Nobody gives any liability for damages caused by proper or inproper use of the program. There´s no guarantee that the program´s output will be correct. No liability too. You are using the program at your own risk.

BUT: I was heavily working to debug the program and I spent a lot of time for testing it. The chance of undiscovered bugs is still greater than zero.


REQUIREMENTS


pnmview_grf requires the following things:

INSTALLATION


  1. Use the Installer-script "Install" !

  2. You may install pnmview_grf by hand too, but on your own risk !
    I'm sorry, but I cannot give detailed instructions anymore.


USAGE OF THE PROGRAM


You can get the usage of the program by starting it without any options: "pnmview". If no usage appers, it is possible that the installation was not succesfull or any other error appeared ...

Note: The option "-?" is no longer available. 

Syntax: pnmview [-v|+v] [[+o] [-n|-o|-l|-e|-f] | [+t [-cColors]]]
                [-1|-2|-3] file1 [file2 ...]

Options:

During the display of the picture you may

Note: PPM-files will be reduced to 256 colors. Only in this case the +o, +t, -c, -n, -o, -l, -e and -f options are available.

Some hints for the "Syntax" line:


REDIRECTIONS


A new feature is the possibility to use input- and output-redirection. The only thing you have to do is replacing the (now useless) file name by a "-". Some examples:
  1. normal form:
    "pgmmedian lena.pgm result.pgm"
    (where lena.pgm is the input file and result.pgm the output file)
  2. output-redirection:
    "pgmmedian lena.pgm - >result.pgm"
  3. input-redirection:
    "pgmmedian - result.pgm <lena.pgm"
  4. input- and output-redirection:
    "pgmmedian - - <lena.pgm >result.pgm"
  5. using pipes (greets from UNIX):
    "pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
  6. or more complicated with 2 pipes:
    "pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
    (Note: You need a newer version than 0.01ß of the program pnmview to use the input-redirection ...)

I added this feature mainly for use with Ultraconv, but it is useful for running the programs on UNIX too.

Note: You need additional software to use pipes on AmigaOS.

ULTRACONV 3/4


You may install pnmview_grf as your default preview program in Ultraconv V3 or V4. Therefore you have to add the following line in "UConv:Ultraconv.info":

PREVVIEWER=STIMP:bin/pnmview -2 %f

You may set other options too, for instance ".../pnmview -2 +o -l %f". It only depends on your taste and the power of your CPU ;-)

Remember: If you think that this SHAREWARE version is a little bit too slow, just register and you will get an optimized version for your 680x0 processor. (PowerPC owners have to ask, because I have to buy a PowerUP board first ...)


RESTRICTIONS


Only the binary versions of PBM/PGM/PPM-files are supported. That means that you can not use file with the markers P1, P2 and P3 (text versions). I decided to do so because all programs of the NetPBM package write binary files and the text versions have the big fault to produce unneccessary big files. In practice this is no real restriction.

SOURCE CODE


The source code for this package is not available at the moment. Several things have to be improved. But, if you really want, you may ask me for the current version ...


WHAT MEANS STIMP ?


If you read the "Registered version" paragraph, you might be wondered by "STIMP". It´s quite simple: "STefan´s IMage Processing". Not surprising, isn´t it ?


ENVIRONMENT


Compiler:

Computer:

AUTHOR


name : Stefan Diener
e-mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
address : Wilhelmstr. 7, D-73433 Aalen, Germany