@DATABASE "gfx2grob documentation"

@NODE MAIN "gfx2grob documentation"
@$VER: gfx2grob.guide v1.0 (21-Nov-1994)

			       gfx2grob v1.0


				is FreeWare

			 1994 by Alexandros Loghis


@{" Table Of Contents " Link Table_Of_Contents}

@{" Introduction " Link 1.}
@{" Requirements " Link 2.}
@{" Installation " Link 3.}
@{" Documentation " Link 4.}
@{" Disclaimer " Link 5.}
@{" History " Link 6.}
@{" Credits " Link 7.}
@{" Author " Link 8.}
@ENDNODE

@NODE Table_Of_Contents " Table Of Contents "
MAIN@{" gfx2grob documentation " Link MAIN}
  1.@{" Introduction " Link 1.}
  2.@{" Requirements " Link 2.}
  3.@{" Installation " Link 3.}
  4.@{" Documentation " Link 4.}
    4.1.@{" Usage " Link 4.1.}
    4.2.@{" Options " Link 4.2.}
    4.3.@{" Examples " Link 4.3.}
  5.@{" Disclaimer " Link 5.}
  6.@{" History " Link 6.}
    6.1.@{" Pre release v1.0 " Link 6.1.}
    6.2.@{" Release v1.0 " Link 6.2.}
  7.@{" Credits " Link 7.}
  8.@{" Author " Link 8.}
@ENDNODE

@NODE 1. "Introduction"

If you are a lucky owner of a HP-48 series pocket calculator (like S, SX, G
or GX) then this tool will help you to exchange graphics from your Amiga to
the HP-48 and vice versa.
It can convert IFF or RAW format graphics to HP-48's GROB format, and GROB
to IFF or RAW format of any size (it depends on your memory).


@ENDNODE

@NODE 2. "Requirements"

To use this tool you need,

Hardware: - HP-48
	  - serial cable (take a look in the comp.sys.hp48 newsgroup for do
	    it yourself instructions and other fine goodies)

Software: - iff.library for IFF <-> GROB conversion (included)
	  - file transfer program (KERMIT or XMODEM protocol) (I use the
	    Vt100 emulator from fish disk 330)


@ENDNODE

@NODE 3. "Installation"

Just click on the Install icon or copy gfx2grob to your c: and iff.library
to your libs: directory.

gfx2grob is pure and can be made resident.


@ENDNODE

@NODE 4. "Documentation"


@{" Usage " Link 4.1.}
@{" Options " Link 4.2.}
@{" Examples " Link 4.3.}
@ENDNODE

@NODE 4.1. "Usage"

gfx2grob can only be used from the CLI.
You have to transfer GROB files from and to the HP-48 in ascii (text) mode.
Therefore set the transfer mode in your file transfer program and the HP-48
to ascii (I/O -> SETUP on my HP-48S).


@ENDNODE

@NODE 4.2. "Options"

-g[Dimension]  RAW or IFF to GROB format. Dimension is WidthxHeight
	       Default is 131x64 (only RAW to GROB)
-r	       GROB to RAW format
-i	       GROB to IFF format

Put the case insensitive options in any order. Enter one option only
If no outputfile is entered then gfx2grob will create its own.


@ENDNODE

@NODE 4.3. "Examples"

- IFF or RAW to HP-48:
  gfx2grob -g foo.pic foo.src
  transfer foo.src to HP-48 in ascii (text) mode (I/O -> RECV on HP-48S)
  VAR -> foo.src puts graphic on the stack.
  PRG -> DSPL -> PICT STO GRAPH GRAPH shows the graphic, you can scroll
  around with the cursor HP-48's keys

- HP-48 to IFF:
  press STO to put the graphic on the stack (in the graphic screen)
  put the name of the graphic on the stack to, lets say `foo.src`
  STO VAR `` foo.src
  transfer it to the Amiga in ascii (text) mode (I/O -> SEND on HP-48S)
  gfx2grob -i foo.src foo.pic
  

@ENDNODE

@NODE 5. "Disclaimer"

This is Freeware, copy it freely as long as you give credit where it's due.
There is NO WARRANTY with this software as it is provided to you with no
charge.


@ENDNODE

@NODE 6. "History"


@{" Pre release v1.0 " Link 6.1.}
@{" Release v1.0 " Link 6.2.}
@ENDNODE

@NODE 6.1. "Pre release v1.0"

I finished a version that converts RAW <-> GROB back in Feb 94.	 But this
was not good enough because of the need of an IFF <-> RAW converter
program.  That's the historic reason for the RAW option -r (you don't need
it indeed) and for the name gfx2grob instead of iff2grob.
I didn't have had any information about the GROB format but I discovered
the ascii format by ...	 trial and error.  I know that the binary GROB
format is shorter and faster to transfer but as I said no information at
that time (another historic reason :).
In Feb 94 I didn't own a Internet account, so it was never released to the
public.


@ENDNODE

@NODE 6.2. "Release v1.0"

IFF support realised with the iff.library. All Amiga specific parts are in
#ifdef AMIGA, #endif, so that the RAW <-> GROB parts should be portable.


@ENDNODE

@NODE 7. "Credits"

- Christian A. Weber
  for the iff.library (v23.2)

- Joe Hart
  for the mksmk (v1.30)

- Stephan Sürken
  for the Text2Guide (v3.10)

- Joe Horn
  for his fine HP-48 software collections
  (I know the difference between *.gro and *.src files, the first are
   binary grobs :)


@ENDNODE

@NODE 8. "Author"

Alexandros Loghis 

E-mail:	 loal0011@rz03.fh-karlsruhe.de

@ENDNODE