1Ddbugtopbm User Manual(0)                            Ddbugtopbm User Manual(0)
2
3
4

NAME

6       ddbugtopbm - convert Diddle or DiddleBug sketches to PBM files
7
8
9

SYNOPSIS

11       ddbugtopbm
12
13

EXAMPLES

15       ddbugtopbm </path/to/palm/backup/dir/DiddleBugDB.pdb
16
17       ddbugtopbm </path/to/palm/backup/dir/DiddleDB.pdb
18
19       ddbugtopbm </path/to/palm/backup/dir/DiddleIDB.pdb
20
21
22

DESCRIPTION

24       This program is part of Netpbm(1).
25
26       ddbugtopbm converts all sketches present in a database used by the Pal‐
27       mOS programs Diddle or DiddleBug into  appropriately-named  PBM  files.
28       The  backup  copy  of  DiddleBug's database you should use as this pro‐
29       gram's input is usually called DiddleBugDB.pdb.   Or  if  you  use  the
30       original  Diddle,  it  has  two separate DBs - DiddleDB.pdb, containing
31       unnamed `scratch' sketches, and  DiddleIDB.pdb,  containing  the  saved
32       (and  named)  sketches which are listed by its `index' option.  You can
33       feed this program any of these three on standard input.
34
35

USING THE PROGRAM

37       I recommend you not run ddbugtopbm from  your  Palm  backup  directory,
38       i.e.  don't  run  it  from  the  directory  the DB will normally be in.
39       Instead, run it from some other directory (perhaps  you  could  make  a
40       directory purely to hold the PBM files, just to keep things simple) and
41       use an absolute or relative path to the DB.
42
43       The filenames used for the output PBMs are based on the names given  to
44       each sketch; if you have an unnamed sketch, it's given a name along the
45       lines of sketch-0123.pbm.
46
47       While the named sketches will overwrite any existing PBM file with  the
48       same  name,  the  unnamed  ones  won't - they'll just try using another
49       filename.  (I think this is probably the right approach, as  you  can't
50       really tell the unnamed sketches apart.)
51
52
53
54

LIMITATIONS

56       The  DiddleBug  DB reader is only known to work with DBs from DiddleBug
57       version 2.50. But it should probably work  on  later  versions,  and  I
58       think it'll work on DBs from version 2.15 as well.
59
60       It  might  fall  over if fed an empty database, and doesn't do much (if
61       any) checking of the input.
62
63
64

AUTHOR

66       Russell Marks (rus@svgalib.org).
67
68       Mitch Blevins's decompression code is directly from  DiddleBug  itself,
69       which like ddbugtopbm is distributed under the terms of the GNU GPL.
70
71

SEE ALSO

73       palmtopnm(1), pbm(1)
74
75       Jens-Chr. Heyer's `didcon' script does something similar.
76
77

HISTORY

79       ddbugtopbm  was  new in Netpbm 10.18 (August 2003).  It was written and
80       independently distributed in August 2002.
81
82
83
84netpbm documentation           21st August, 2002     Ddbugtopbm User Manual(0)