Palm Database ImageViewer - Revision history

Dexvertbot: /* Sample files */

2023-12-28T04:22:11Z

‎Sample files

Sembiance: /* Sample files */

2020-08-01T19:08:25Z

‎Sample files

Tekkno at 22:41, 26 April 2019

2019-04-26T22:41:31Z

Jsummers: /* Format details */

2017-10-15T14:04:06Z

‎Format details

Jsummers at 20:42, 14 October 2017

2017-10-14T20:42:58Z

Jsummers: /* RLE compression */

2017-10-14T15:23:49Z

‎RLE compression

Jsummers: /* Format details */

2017-10-14T15:07:26Z

‎Format details

Jsummers at 15:05, 14 October 2017

2017-10-14T15:05:04Z

Jsummers: Category:Palm OS Database

2017-09-06T16:31:22Z

Category:Palm OS Database

Jsummers: /* Discussion */

2017-09-04T14:32:09Z

‎Discussion

@@ Line 86: / Line 86: @@
 * [https://sourceforge.net/projects/imgvtopgm/ imgvtopgm-2.0.tar.gz] → samples/*.pdb
 * [http://www.memoware.com/ MemoWare] → [http://www.memoware.com/?screen=advanced_search Advanced search] → Search for "FireViewer" or "TinyViewer" format
-* https://telparia.com/fileFormatSamples/image/palmDatabase/
+* {{DexvertSamples|image/palmDatabase}}
 [[Category:Palm]]
 [[Category:Palm OS Database]]

@@ Line 86: / Line 86: @@
 * [https://sourceforge.net/projects/imgvtopgm/ imgvtopgm-2.0.tar.gz] → samples/*.pdb
 * [http://www.memoware.com/ MemoWare] → [http://www.memoware.com/?screen=advanced_search Advanced search] → Search for "FireViewer" or "TinyViewer" format
 [[Category:Palm]]
 [[Category:Palm OS Database]]

@@ Line 79: / Line 79: @@
 * [https://sourceforge.net/projects/imgvtopgm/ imgvtopgm/imgvtopnm]
 * [[XnView]]
 == Sample files ==

@@ Line 18: / Line 18: @@
 == Format details ==
-''This section is based on guesswork, and source code whose correctness is unverified. It is incomplete, and may be incorrect.''
+''This section is based on guesswork, and source code whose correctness is unverified. It is incomplete, and may be incorrect. It does not necessarily apply if the "version_etc" field is greater than 1. There is evidence that other versions exist that are quite different.''
 The file is a [[Palm OS Database|PDB]] file with certain characteristics. In the Palm database header, the type code is "vIMG", and the creator code is "View". There are 1 or 2 records: an "image" record, optionally followed by a "comment" record. The image record has its uniqueID field in the record list set to 0x6f8000. The comment record has uniqueID 0x6f8001.
@@ Line 24: / Line 24: @@
 === Image record data segment ===
 The image record's data segment consists of a 58-byte header, followed by the pixel data.
 {| class="wikitable"

@@ Line 20: / Line 20: @@
 ''This section is based on guesswork, and source code whose correctness is unverified. It is incomplete, and may be incorrect.''
-The file is a [[Palm OS Database|PDB]] file with certain characteristics. In the Palm database header, the type code is "vIMG", and the creator code is creator "View". There are 1 or 2 records: an "image" record, optionally followed by a "comment" record. The image record has its uniqueID field in the record list set to 0x6f8000. The comment record has uniqueID 0x6f8001.
+The file is a [[Palm OS Database|PDB]] file with certain characteristics. In the Palm database header, the type code is "vIMG", and the creator code is "View". There are 1 or 2 records: an "image" record, optionally followed by a "comment" record. The image record has its uniqueID field in the record list set to 0x6f8000. The comment record has uniqueID 0x6f8001.
 === Image record data segment ===
@@ Line 30: / Line 30: @@
 |N+0 || char[32] || name || || A name for the image. Same format as the main "database name" field at the beginning of the file, and usually a copy of that field.
 |-
-|N+32 || byte || version_etc || || cmpr_meth := (version_etc & 0x07)<br>cmpr_meth = 0 → Uncompressed<br>cmpr_meth = 1 → RLE compression
+|N+32 || byte || version_etc || || cmpr_meth := (version_etc & 0x07)<br>cmpr_meth: 0=Uncompressed, 1=RLE
 |-
-|N+33 || byte || type || || 0 → 2 bits/pixel grayscale<br>2 → 4 bits/pixel grayscale<br>other (typically 0xff) → 1 bit/pixel grayscale
+|N+33 || byte || type || || 0 = 2 bits/pixel grayscale<br>2 = 4 bits/pixel grayscale<br>other (typically 0xff) = 1 bit/pixel grayscale
 |-
 |N+34 || byte[4] || reserved || 0
@@ Line 55: / Line 55: @@
 |}
-=== RLE compression ===
+==== RLE compression ====
 The compressed data consists of a code byte, followed by one or more data bytes, followed by another code byte, and so on. To decompress:
@@ Line 65: / Line 65: @@
 |N ≥ 129 || Emit the next byte N−127 times.
 |}
 == Identification ==
@@ Line 73: / Line 76: @@
 * [[Netpbm]] (v10.52+): pdbimgtopam, pamtopdbimg
 * [https://sourceforge.net/projects/imgvtopgm/ imgvtopgm/imgvtopnm]
 == Sample files ==

← Older revision		Revision as of 15:05, 14 October 2017
Line 16:		Line 16:

	[[Netpbm]]'s code was derived from Howe's software. [[ImageMagick]] also has source code for reading and writing this format.		[[Netpbm]]'s code was derived from Howe's software. [[ImageMagick]] also has source code for reading and writing this format.
		+
		+	== Format details ==
		+	''This section is based on guesswork, and source code whose correctness is unverified. It is incomplete, and may be incorrect.''
		+
		+	The file is a [[PDB\|Palm OS Database]] file with certain characteristics. In the Palm database header, the type code is "vIMG", and the creator code is creator "View". There are 1 or 2 records: an "image" record, optionally followed by a "comment" record. The image record has its uniqueID field in the record list set to 0x6f8000. The comment record has uniqueID 0x6f8001.
		+
		+	=== Image record data segment ===
		+	The image record's data segment consists of a 58-byte header, followed by the pixel data.
		+
		+	{\| class="wikitable"
		+	! Offset !! Type !! Field !! Observed values !! Remarks
		+	\|-
		+	\|N+0 \|\| char[32] \|\| name \|\| \|\| A name for the image. Same format as the main "database name" field at the beginning of the file, and usually a copy of that field.
		+	\|-
		+	\|N+32 \|\| byte \|\| version_etc \|\| \|\| cmpr_meth := (version_etc & 0x07)<br>cmpr_meth = 0 → Uncompressed<br>cmpr_meth = 1 → RLE compression
		+	\|-
		+	\|N+33 \|\| byte \|\| type \|\| \|\| 0 → 2 bits/pixel grayscale<br>2 → 4 bits/pixel grayscale<br>other (typically 0xff) → 1 bit/pixel grayscale
		+	\|-
		+	\|N+34 \|\| byte[4] \|\| reserved \|\| 0
		+	\|-
		+	\|N+38 \|\| byte[4] \|\| note \|\| 0
		+	\|-
		+	\|N+42 \|\| uint16 \|\| last_x \|\| 0
		+	\|-
		+	\|N+44 \|\| uint16 \|\| last_y \|\| 0
		+	\|-
		+	\|N+46 \|\| byte[4] \|\| reserved \|\| 0
		+	\|-
		+	\|N+50 \|\| uint16 \|\| anchor_x \|\| 0xffff
		+	\|-
		+	\|N+52 \|\| uint16 \|\| anchor_y \|\| 0xffff
		+	\|-
		+	\|N+54 \|\| uint16 \|\| width \|\| \|\|rowspan="2"\| The pixel dimensions of the image.
		+	\|-
		+	\|N+56 \|\| uint16 \|\| height \|\|
		+	\|-
		+	\|N+58 \|\| bytes \|\| pixel data \|\| \|\| After decompression if necessary (see below), pixels are left-to-right, top-to-bottom. Rows are padded to the next byte boundary. A pixel value of 0 is white.
		+	\|}
		+
		+	=== RLE compression ===
		+	''[TODO]''

	== Identification ==		== Identification ==

@@ Line 4: / Line 4: @@
 |extensions={{ext|pdb}}
 }}
-'''Palm Database ImageViewer format''' is a type of [[PalmOS Database]] file. It contains a bitmap image, and is associated with the ''Image Viewer III'' application.
+'''Palm Database ImageViewer format''' is a type of [[Palm OS Database]] file. It contains a bitmap image, and is associated with the ''Image Viewer III'' application.
 It is also known as '''FireViewer''' format, and maybe also '''TinyViewer''' format.
@@ Line 32: / Line 32: @@
 [[Category:Palm]]

@@ Line 11: / Line 11: @@
 == Discussion ==
-The ImageViewer format has been decoded fairly completely, but as far as we can tell, no one has ever bothered to write any documentation about it – only source code.
+The ImageViewer format has been decoded fairly completely, but as far as we can tell, no one has ever bothered to write any documentation about it – only source code. Note that it is ''not'' a wrapper for [[Palm bitmap]] format.
 The ''imgvtopnm'' software (also called ''imgvtopgm'', apparently) by Eric Howe, released around 1997, is significant. See the README file in that software for information about its origins.