NAME

       ddbugtopbm - convert Diddle or DiddleBug sketches to PBM files

SYNOPSIS

       ddbugtopbm

EXAMPLES

       ddbugtopbm </path/to/palm/backup/dir/DiddleBugDB.pdb

       ddbugtopbm </path/to/palm/backup/dir/DiddleDB.pdb

       ddbugtopbm </path/to/palm/backup/dir/DiddleIDB.pdb

DESCRIPTION

       This program is part of Netpbm(1).

       ddbugtopbm  converts  all  sketches present in a database used by the PalmOS programs Diddle or DiddleBug
       into appropriately-named PBM files.  The backup copy of DiddleBug's  database  you  should  use  as  this
       program's  input  is  usually  called  DiddleBugDB.pdb.   Or  if  you use the original Diddle, it has two
       separate DBs - DiddleDB.pdb, containing unnamed `scratch' sketches,  and  DiddleIDB.pdb,  containing  the
       saved  (and  named)  sketches  which  are listed by its `index' option.  You can feed this program any of
       these three on standard input.

OPTIONS

       There are no command line options defined specifically for ddbugtopbm,  but  it  recognizes  the  options
       common to all programs based on libnetpbm (See  Common Options .)

USING THE PROGRAM

       I  recommend you not run ddbugtopbm from your Palm backup directory, i.e. don't run it from the directory
       the DB will normally be in.  Instead, run it  from  some  other  directory  (perhaps  you  could  make  a
       directory  purely to hold the PBM files, just to keep things simple) and use an absolute or relative path
       to the DB.

       The filenames used for the output PBMs are based on the names given  to  each  sketch;  if  you  have  an
       unnamed sketch, it's given a name along the lines of sketch-0123.pbm.

       While  the named sketches will overwrite any existing PBM file with the same name, the unnamed ones won't
       - they'll just try using another filename.  (I think this is probably the right approach,  as  you  can't
       really tell the unnamed sketches apart.)

LIMITATIONS

       The  DiddleBug  DB  reader  is  only  known  to  work with DBs from DiddleBug version 2.50. But it should
       probably work on later versions, and I think it'll work on DBs from version 2.15 as well.

       It might fall over if fed an empty database, and doesn't do much (if any) checking of the input.

AUTHOR

       Russell Marks (rus@svgalib.org).

       Mitch Blevins's  decompression  code  is  directly  from  DiddleBug  itself,  which  like  ddbugtopbm  is
       distributed under the terms of the GNU GPL.

SEE ALSO

       palmtopnm(1), pbm(1)

       Jens-Chr. Heyer's `didcon' script does something similar.

HISTORY

       ddbugtopbm was new in Netpbm 10.18 (August 2003).  It was written and independently distributed in August
       2002.

DOCUMENT SOURCE

       This  manual  page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation
       is at

              http://netpbm.sourceforge.net/doc/ddbugtopbm.html

netpbm documentation                             21 August 2002                        Ddbugtopbm User Manual(1)