man > ddbugtopbm(1)

Ddbugtopbm User Manual(1)              General Commands Manual             Ddbugtopbm User Manual(1)

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 in‐
       put.



AUTHOR
       Russell Marks (rus AT 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  distrib‐
       uted 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)