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 Pal-
mOS programs Diddle or DiddleBug into appropriately-named PBM files.
The backup copy of DiddleBug's database you should use as this pro-
gram's input is usually called DiddleBugDB.pdb. Or if you use the
original Diddle, it has two separate DBs - DiddleDB.pdb, containing un-
named `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 ⟨index.html#commonoptions⟩ .)
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. In-
stead, run it from some other directory (perhaps you could make a di-
rectory 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)
Generated by dwww version 1.15 on Sat Jun 29 02:18:29 CEST 2024.