about summary refs log tree commit diff
path: root/ddbugtopbm.html
blob: 8bc6548c13017a2fee36b078e7e6f0fd6e0ea1ff (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Ddbugtopbm User Manual</TITLE></HEAD>
<BODY>
<H1>ddbugtopbm</H1>
Updated: 21st August, 2002
<BR>
<A HREF="#index">Table Of Contents</A>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
ddbugtopbm - convert Diddle or DiddleBug sketches to PBM files


<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>ddbugtopbm</B>

<A NAME="examples"></A>
<H2>EXAMPLES</H2>

<pre>
<B>ddbugtopbm &lt;/path/to/palm/backup/dir/DiddleBugDB.pdb</B>

<B>ddbugtopbm &lt;/path/to/palm/backup/dir/DiddleDB.pdb</B>

<B>ddbugtopbm &lt;/path/to/palm/backup/dir/DiddleIDB.pdb</B>
</pre>


<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>ddbugtopbm</b> converts all sketches present in a database used
by the PalmOS programs <b>Diddle</b> or <b>DiddleBug</b> into
appropriately-named PBM files.  The backup copy of DiddleBug's
database you should use as this program's input is usually called
<B>DiddleBugDB.pdb</b>.  Or if you use the original Diddle, it has two
separate DBs - <B>DiddleDB.pdb</B>, containing unnamed `scratch'
sketches, and <B>DiddleIDB.pdb</B>, 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.

<A NAME="lbAE">&nbsp;</A>
<H2>USING THE PROGRAM</H2>

<p>I recommend you <em>not</em> run <b>ddbugtopbm</b> 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.

<p>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 <B>sketch-0123.pbm</b>.

<p>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.)



<A NAME="lbAF">&nbsp;</A>
<H2>BUGS</H2>

<p>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.

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


<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>

Russell Marks (<A HREF="mailto:rus@svgalib.org">rus@svgalib.org</A>).

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



<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>

<p>
<a href="palmtopnm.html">palmtopnm</a>,
<A HREF="pbm.html">pbm</A>

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

<A NAME="history"></A>
<H2>HISTORY</H2>

<p><b>ddbugtopbm</b> was new in Netpbm 10.18 (August 2003).  It was written
and independently distributed in August 2002.

<HR>
<A NAME="index">&nbsp;</A><H2>Table Of Contents</H2>
<UL>
<LI><A HREF="#lbAB">NAME</A>
<LI><A HREF="#lbAC">SYNOPSIS</A>
<LI><A HREF="#lbAC">EXAMPLES</A>
<LI><A HREF="#lbAD">DESCRIPTION</A>
<LI><A HREF="#lbAE">USING THE PROGRAM</A>
<LI><A HREF="#lbAF">BUGS</A>
<LI><A HREF="#lbAG">AUTHOR</A>
<LI><A HREF="#lbAH">SEE ALSO</A>
</UL>
</BODY>
</HTML>