The Color RLE format is a simple run-length encoding scheme for color images with a limited number of distinct colors. The data always begin with a text header composed of the two characters "R6", the number of columns, the number of rows, and the number of color palette entries. All numbers are expressed in decimal ASCII. These four items are separated by blank characters (space, tab, carriage return, or linefeed) or by comment lines introduced by character "#". The last number is followed by exactly one character which usually is a linefeed character.

The header is followed by the color palette containing three bytes per color entry. The bytes represent the red, green, and blue components of the color.

The palette is followed by a collection of four bytes integers (most significant bit first) representing runs of pixels with an identical color. The twelve upper bits of this integer indicate the index of the run color in the palette entry. The twenty lower bits of the integer indicate the run length. Color indices greater than 0xff0 are reserved. Color index 0xfff is used for transparent runs. Each row is represented by a sequence of runs whose lengths add up to the image width. Rows are encoded starting with the top row and progressing toward the bottom row.

The Bitonal RLE format is a simple run-length encoding scheme for bitonal images. The data always begin with a text header composed of the two characters "R4", the number of columns, and the number of rows. All numbers are expressed in decimal ASCII. These three items are separated by blank characters (space, tab, carriage return, or linefeed) or by comment lines introduced by character "#". The last number is followed by exactly one character which usually is a linefeed character.

The rest of the file encodes a sequence of numbers representing the lengths of alternating runs of transparent and black pixels. Lines are encoded starting with the top line and progressing toward the bottom line. Each line starts with a white run. The decoder knows that a line is finished when the sum of the run lengths for that line is equal to the number of columns in the image. Numbers in range 0 to 191 are represented by a single byte in range 0x00 to 0xbf. Numbers in range 192 to 16383 are represented by a two byte sequence: the first byte, in range 0xc0 to 0xff, encodes the six most significant bits of the number, the second byte encodes the remaining eight bits of the number. This scheme allows for runs of length zero, which are useful when a line starts with a black pixel, and when a very long run (whose length exceeds 16383) must be split into smaller runs.

The Portable Pixmap format is a well known format for representing color images. Check the ppm(1) man page for complete information.

The data always begin with a text header composed of the two characters "P6", the number of columns, the number of rows, and the maximal value of a color component (usually 255). All numbers are expressed in decimal ASCII. These three items are separated by blank characters (space, tab, carriage return, or linefeed) or by comment lines introduced by character "#". The last number is followed by exactly one character which usually is a linefeed character.

The rest of the file encodes all the pixels. Each pixel is represented by three bytes representing the red, green and blue component of the pixel. Pixels are ordered in left to right, top to bottom.

Each page is followed by an arbitrary number of comment lines starting with character "#" and terminated by a linefeed character. Comment lines whose first word starts with a capital letter have special meanings. The following constructs are currently defined:

*

# T px:py dx:dy wxh+x+y (string)

This constructs indicates that the piece of text string must be associated with an area of size wxh at position x,y relative to the lower left corner of the page. The string is UTF-8 encoded. Special characters can be escaped as in PostScript using the backslash character. Integers px, and py represent the position of the current point on the text baseline before the text was drawn. The drawing operation then moves the current point by dx, and dy pixels.

*

# L wxh+x+y (url)

This construct indicates that an hyperlink to url url should be associated with area of size wxh at position x,y. This is not currently supported by csepdjvu.

*

# B count (string) (#pageno)

This constructs provides outline information for the document. An outline entry entitled string is associated with page pageno. Integer count indicates how many of the following outline entries must be attached to the current entry as subentries. This is not currently supported by csepdjvu.