File: README

package info (click to toggle)
imgvtopgm 1.2-1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 636 kB
  • ctags: 268
  • sloc: ansic: 1,557; makefile: 100; sh: 95
file content (75 lines) | stat: -rw-r--r-- 3,071 bytes parent folder | download
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
These programs are GPL'ed, see COPYING-2.0 for license details.

The PDB header record was figured out/compiled by Theodore Ts'o <tytso@mit.edu>
(the PDB header is the same as the PRC application header),
the layout of the Image Viewer image header was figured out by
Eric.Arnold@sun.com (I kinda' stole the format from his ppmtoIVpdb program
which was posted to the pilot-unix mailing list).  I figured out
the compression format, notes, and monochrome format and wrapped it all
together as ipdb*.c.  The programs are pretty thin wrappers around ipdb*.c.

This package was developed on i486-unknown-linux but I have tested the code
on a SPARC-10, HP-PA, and DEC Alpha to check for byte order and type size
problems.  All the code is pretty strict ANSI so I don't expect any
difficulties on any modern unixen (YMMV anywhere else).  On 64 bit systems
you may have to fiddle with the u1/u2/u4 typedefs in slop.h but the current
ones should work on both 32- and 64-bit systems.

If you know what byte order your machine is (Intel and Alpha are LITTLEENDIAN,
just about everything else is BIGENDIAN), then set the SEX variable in the
Makefile appropriately; if you don't know anything about the byte order,
just leave the SEX setting alone and the programs will figure it out at
run-time.

Notes on the Image Viewer pdb format can be found in ipdb*.[ch].

I don't really have any use for the Pilot Image Viewer program, I just did
this out of curiosity (and because I find GUI only converters a little
silly).  These programs have no connection with the Image Viewer author
so don't send problem reports to him (unless it is a bug in Image Viewer),
I just decoded the files from hex dumps.

I don't guarantee that the converted images will be correct but I think
they will be okay (I have tested all the images in samples with the viewer
without incident).  Don't blame me if any of the converted images crash your
pilot, if one does and you find out why, let me know so I can fix the tools
(or just send me a patch).

If you're looking for a nagless image viewer for your Pilot, check out
Tiny Viewer (http://www.sunlabs.com/~shirriff/pilot/tv.html).


Requirements
============

Libraries and headers for the pbm and pgm packages
(ftp://ftp.x.org/contrib/utilities/netpbm-1mar1994.p1.tar.gz).

ANSI C compiler and POSIX libraries.


Changes
=======

Version 1.2, 1998.06.02:
	- minor cleanups in the shell scripts
	- ppmimgvquant now runs the quantified PPM file through ppmtopgm
	  to ensure a PGM output file

Version 1.1, 1998.03.03:
	- Added optional run-time byte order detection.

Version 1.0.2, 1997.10.02:
	- Renamed all the mystery stuff to rechdr.  I've been browsing
	  the pilot-link sources; now that I know what the mystery bytes
	  are, I've changed the names to make more sense.

Version 1.0.1, 1997.09.28:
	- Fixed a stupid off-by-one error in ipdb_err(), the problem was
	  non-fatal.
	- Fixed up URLs to point at my current net.home.
	- The "-h" switches, programs, and man pages now agree with each
	  other.

Version 1.0, 1997.09.24:
	Initial release.