Commits

David Boddie committed a524984

Removed outdated documentation.

Comments (0)

Files changed (1)

Doc/impression.html

-
-<!doctype html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html><head><title>Python: module impression</title>
-<style type="text/css"><!--
-TT { font-family: lucidatypewriter, lucida console, courier }
---></style></head><body bgcolor="#f0f0f8">
-
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
-<tr bgcolor="#7799ee">
-<td valign=bottom>&nbsp;<br>
-<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>impression</strong></big></big> (version 0.10, Tue 18th March 2003)</font></td
-><td align=right valign=bottom
-><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/david/Private/Python/Impression/impression.py">/home/david/Private/Python/Impression/impression.py</a></font></td></tr></table>
-    <p><tt>impression.py<br>
-Reads&nbsp;the&nbsp;document&nbsp;structure&nbsp;of&nbsp;Impression&nbsp;files.</tt></p>
-
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#aa55cc">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#fffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
-    
-<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;&nbsp;</td>
-<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="os.html">os</a><br>
-</td><td width="25%" valign=top><a href="string.html">string</a><br>
-</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
-</td><td width="25%" valign=top><a href="types.html">types</a><br>
-</td></tr></table></td></tr></table>
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ee77aa">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
-    
-<tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;&nbsp;</td>
-<td width="100%"><dl>
-<dt><font face="helvetica, arial"><a href="impression.html#Colour">Colour</a>
-</font></dt><dd>
-<dl>
-<dt><font face="helvetica, arial"><a href="impression.html#RGBTColour">RGBTColour</a>
-</font></dt></dl>
-</dd>
-<dt><font face="helvetica, arial"><a href="impression.html#Common">Common</a>
-</font></dt><dd>
-<dl>
-<dt><font face="helvetica, arial"><a href="impression.html#BBox">BBox</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Border">Border</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Content">Content</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#ContentCollection">ContentCollection</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Document">Document</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Frame">Frame</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#LineInfo">LineInfo</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Page">Page</a>
-</font></dt><dd>
-<dl>
-<dt><font face="helvetica, arial"><a href="impression.html#ChapterPage">ChapterPage</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#MasterPage">MasterPage</a>
-</font></dt></dl>
-</dd>
-<dt><font face="helvetica, arial"><a href="impression.html#PageCollection">PageCollection</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Style">Style</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#Text">Text</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#TextSetup">TextSetup</a>
-</font></dt><dt><font face="helvetica, arial"><a href="impression.html#UnknownPiece">UnknownPiece</a>
-</font></dt></dl>
-</dd>
-<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>
-</font></dt><dd>
-<dl>
-<dt><font face="helvetica, arial"><a href="impression.html#ImpressionError">ImpressionError</a>
-</font></dt></dl>
-</dd>
-<dt><font face="helvetica, arial"><a href="impression.html#StyleCollection">StyleCollection</a>
-</font></dt></dl>
- 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="BBox">class <strong>BBox</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#BBox">BBox</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-box&nbsp;=&nbsp;<a href="#BBox">BBox</a>(xmin,&nbsp;ymin,&nbsp;xmax,&nbsp;ymax)<br>
-&nbsp;<br>
-An&nbsp;object&nbsp;used&nbsp;for&nbsp;representing&nbsp;rectangular&nbsp;regions&nbsp;in&nbsp;Impression&nbsp;documents.<br>
-&nbsp;<br>
-The&nbsp;horizontal&nbsp;minimum&nbsp;(xmin),&nbsp;vertical&nbsp;minimum&nbsp;(ymin),&nbsp;horizontal&nbsp;maximum&nbsp;(xmax)<br>
-and&nbsp;vertical&nbsp;maximum&nbsp;(ymax)&nbsp;values&nbsp;are&nbsp;all&nbsp;specified&nbsp;in&nbsp;millipoints.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="BBox-__init__"><strong>__init__</strong></a>(self, xmin, ymin, xmax, ymax)</dt></dl>
-
-<dl><dt><a name="BBox-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="BBox-height"><strong>height</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="BBox-relative_to"><strong>relative_to</strong></a>(self, p, units<font color="#909090">='mpt'</font>)</dt></dl>
-
-<dl><dt><a name="BBox-width"><strong>width</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'BBox(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>box = BBox(xmin, ymin, x...ax) values are all specified in millipoints.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="BBox-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#BBox-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="BBox-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#BBox-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="BBox-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#BBox-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="BBox-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#BBox-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="BBox-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#BBox-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="BBox-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#BBox-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="BBox-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#BBox-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="BBox-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#BBox-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="BBox-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#BBox-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="BBox-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#BBox-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="BBox-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#BBox-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="BBox-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#BBox-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Border">class <strong>Border</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Border">Border</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-border&nbsp;=&nbsp;<a href="#Border">Border</a>(data,&nbsp;addr)<br>
-&nbsp;<br>
-A&nbsp;container&nbsp;for&nbsp;border&nbsp;data,&nbsp;which&nbsp;usually&nbsp;takes&nbsp;the&nbsp;form&nbsp;of&nbsp;a&nbsp;Drawfile.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.&nbsp;The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address<br>
-of&nbsp;the&nbsp;data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Border-__init__"><strong>__init__</strong></a>(self, data, addr)</dt></dl>
-
-<dl><dt><a name="Border-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Border(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>border = Border(data, ...he file from<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>which the data originated.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Border-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Border-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Border-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Border-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Border-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Border-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Border-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Border-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Border-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Border-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Border-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Border-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Border-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Border-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Border-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Border-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Border-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Border-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Border-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Border-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Border-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Border-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Border-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Border-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="ChapterPage">class <strong>ChapterPage</strong></a>(<a href="impression.html#Page">Page</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#ChapterPage">ChapterPage</a>(<a href="#Page">Page</a>)<br>
-&nbsp;<br>
-page&nbsp;=&nbsp;<a href="#ChapterPage">ChapterPage</a>(data,&nbsp;addr)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;describing&nbsp;the&nbsp;pages&nbsp;within&nbsp;an&nbsp;Impression&nbsp;document.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.&nbsp;The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address<br>
-of&nbsp;the&nbsp;data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%"><dl><dt>Method resolution order:</dt>
-<dd><a href="impression.html#ChapterPage">ChapterPage</a></dd>
-<dd><a href="impression.html#Page">Page</a></dd>
-<dd><a href="impression.html#Common">Common</a></dd>
-</dl>
-<hr>
-Methods defined here:<br>
-<dl><dt><a name="ChapterPage-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="ChapterPage-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'ChapterPage(Page)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>page = ChapterPage(... file from<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>which the data originated.  <font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Page">Page</a>:<br>
-<dl><dt><a name="ChapterPage-__init__"><strong>__init__</strong></a>(self, data, addr)</dt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="ChapterPage-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#ChapterPage-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#ChapterPage-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#ChapterPage-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#ChapterPage-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#ChapterPage-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#ChapterPage-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#ChapterPage-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#ChapterPage-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#ChapterPage-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#ChapterPage-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#ChapterPage-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="ChapterPage-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#ChapterPage-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Colour">class <strong>Colour</strong></a></font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Colour">Colour</a><br>
-&nbsp;<br>
-The&nbsp;base&nbsp;class&nbsp;for&nbsp;Impression&nbsp;colour&nbsp;classes.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Colour<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>The base class for Impression colour classes.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Common">class <strong>Common</strong></a></font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Common">Common</a><br>
-&nbsp;<br>
-A&nbsp;class&nbsp;containing&nbsp;a&nbsp;set&nbsp;of&nbsp;common&nbsp;functions&nbsp;which&nbsp;other&nbsp;classes&nbsp;will&nbsp;use.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Common-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Common-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Common-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Common-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Common-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Common-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Common-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Common-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Common-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Common-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Common-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Common-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Common-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Common-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Common-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Common-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Common-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Common-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Common-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Common-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Common-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Common-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Common-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Common-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Common<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>A class containing a set of common functions which other classes will use.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Content">Content</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-content&nbsp;=&nbsp;<a href="#Content">Content</a>(data,&nbsp;start,&nbsp;addr,&nbsp;strict&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;to&nbsp;represent&nbsp;a&nbsp;content&nbsp;area&nbsp;found&nbsp;in&nbsp;an&nbsp;Impression&nbsp;document.&nbsp;This&nbsp;class<br>
-is&nbsp;usually&nbsp;instantiated&nbsp;by&nbsp;a&nbsp;<a href="#ContentCollection">ContentCollection</a>&nbsp;object.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.<br>
-&nbsp;<br>
-The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address&nbsp;of&nbsp;the<br>
-data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from&nbsp;which<br>
-the&nbsp;data&nbsp;originated.<br>
-&nbsp;<br>
-The&nbsp;strict&nbsp;flag&nbsp;is&nbsp;used&nbsp;to&nbsp;determine&nbsp;whether&nbsp;blocks&nbsp;in&nbsp;the&nbsp;linked&nbsp;list&nbsp;used&nbsp;in<br>
-Impression&nbsp;document&nbsp;content&nbsp;areas&nbsp;should&nbsp;be&nbsp;interpreted&nbsp;strictly&nbsp;by&nbsp;their<br>
-declared&nbsp;lengths&nbsp;or&nbsp;whether,&nbsp;in&nbsp;the&nbsp;case&nbsp;of&nbsp;problems,&nbsp;the&nbsp;end&nbsp;of&nbsp;a&nbsp;bad&nbsp;block<br>
-should&nbsp;be&nbsp;sought.&nbsp;This&nbsp;approach&nbsp;was&nbsp;necessary&nbsp;when&nbsp;attempting&nbsp;to&nbsp;read&nbsp;a<br>
-particular&nbsp;Impression&nbsp;Junior&nbsp;document.<br>
-&nbsp;<br>
-An&nbsp;instance&nbsp;of&nbsp;this&nbsp;class&nbsp;will&nbsp;attempt&nbsp;to&nbsp;interpret&nbsp;the&nbsp;data&nbsp;provided&nbsp;and,&nbsp;in&nbsp;the<br>
-case&nbsp;of&nbsp;textual&nbsp;content,&nbsp;create&nbsp;a&nbsp;list&nbsp;containing&nbsp;pieces&nbsp;of&nbsp;content.&nbsp;This&nbsp;is<br>
-stored&nbsp;in&nbsp;the&nbsp;"pieces"&nbsp;attribute&nbsp;of&nbsp;the&nbsp;object.&nbsp;If&nbsp;the&nbsp;data&nbsp;represents&nbsp;a&nbsp;Drawfile<br>
-then&nbsp;the&nbsp;"content_type"&nbsp;object&nbsp;attribute&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;"Draw";&nbsp;if&nbsp;the&nbsp;data&nbsp;is<br>
-textual&nbsp;then&nbsp;"content_type"&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;"<a href="#Text">Text</a>";&nbsp;for&nbsp;Artworks&nbsp;illustrations,<br>
-it&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;"Artworks".<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, data, start, addr, strict<font color="#909090">=1</font>)</dt></dl>
-
-<dl><dt><a name="Content-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Content-after_text"><strong>after_text</strong></a>(self, i)</dt></dl>
-
-<dl><dt><a name="Content-info"><strong>info</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Content-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Content-seek_block"><strong>seek_block</strong></a>(self, i)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Content(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>content = Content(dat...trations,<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>it will be set to "Artworks".<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Content-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Content-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Content-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Content-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Content-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Content-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Content-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Content-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Content-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Content-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Content-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Content-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Content-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Content-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Content-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Content-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Content-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Content-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Content-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Content-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Content-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Content-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Content-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Content-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="ContentCollection">class <strong>ContentCollection</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#ContentCollection">ContentCollection</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-content_collection&nbsp;=&nbsp;<a href="#ContentCollection">ContentCollection</a>(<br>
-&nbsp;&nbsp;&nbsp;&nbsp;filename,&nbsp;offset_list,&nbsp;start_addr&nbsp;=&nbsp;None,&nbsp;content_index&nbsp;=&nbsp;None,&nbsp;strict&nbsp;=&nbsp;1<br>
-&nbsp;&nbsp;&nbsp;&nbsp;)<br>
-&nbsp;<br>
-A&nbsp;container&nbsp;for&nbsp;document&nbsp;content&nbsp;in&nbsp;an&nbsp;Impression&nbsp;document.<br>
-Actual&nbsp;content&nbsp;areas&nbsp;are&nbsp;supplied&nbsp;on&nbsp;demand&nbsp;rather&nbsp;than&nbsp;being&nbsp;created&nbsp;all&nbsp;at&nbsp;once.<br>
-&nbsp;<br>
-The&nbsp;filename&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;which&nbsp;the&nbsp;style<br>
-information&nbsp;resides.&nbsp;For&nbsp;old&nbsp;format&nbsp;documents,&nbsp;this&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;directory<br>
-which&nbsp;contains&nbsp;the&nbsp;document&nbsp;information.<br>
-&nbsp;<br>
-A&nbsp;list&nbsp;of&nbsp;offsets&nbsp;to&nbsp;content&nbsp;is&nbsp;provided&nbsp;from&nbsp;the&nbsp;information&nbsp;found&nbsp;in&nbsp;the&nbsp;original<br>
-document&nbsp;and&nbsp;specifies&nbsp;where&nbsp;in&nbsp;the&nbsp;original&nbsp;document&nbsp;the&nbsp;content&nbsp;areas&nbsp;reside.<br>
-For&nbsp;old&nbsp;format&nbsp;documents&nbsp;a&nbsp;virtual&nbsp;addressing&nbsp;scheme&nbsp;is&nbsp;used&nbsp;to&nbsp;reference&nbsp;content<br>
-which&nbsp;will&nbsp;be&nbsp;found&nbsp;in&nbsp;many&nbsp;files&nbsp;inside&nbsp;the&nbsp;document&nbsp;directory.<br>
-&nbsp;<br>
-The&nbsp;strict&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;each&nbsp;content&nbsp;area&nbsp;should&nbsp;be&nbsp;interpreted&nbsp;with<br>
-strict&nbsp;checks&nbsp;on&nbsp;its&nbsp;integrity.&nbsp;This&nbsp;flag&nbsp;is&nbsp;passed&nbsp;to&nbsp;each&nbsp;<a href="#Content">Content</a>&nbsp;object&nbsp;on&nbsp;its<br>
-creation&nbsp;for&nbsp;this&nbsp;purpose.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="ContentCollection-__getitem__"><strong>__getitem__</strong></a>(self, pair)</dt></dl>
-
-<dl><dt><a name="ContentCollection-__init__"><strong>__init__</strong></a>(self, filename, offset_list, content_index<font color="#909090">=None</font>, strict<font color="#909090">=1</font>)</dt></dl>
-
-<dl><dt><a name="ContentCollection-__len__"><strong>__len__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="ContentCollection-keys"><strong>keys</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="ContentCollection-read_word"><strong>read_word</strong></a>(self, addr<font color="#909090">=None</font>)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'ContentCollection(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>content_col...bject on its<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>creation for this purpose.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="ContentCollection-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#ContentCollection-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#ContentCollection-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#ContentCollection-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#ContentCollection-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#ContentCollection-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#ContentCollection-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#ContentCollection-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#ContentCollection-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#ContentCollection-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#ContentCollection-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="ContentCollection-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#ContentCollection-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Document">class <strong>Document</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Document">Document</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-document&nbsp;=&nbsp;<a href="#Document">Document</a>(filename,&nbsp;strict&nbsp;=&nbsp;1,&nbsp;verbose&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Reads&nbsp;the&nbsp;document&nbsp;stored&nbsp;in&nbsp;the&nbsp;file&nbsp;or&nbsp;directory&nbsp;specified&nbsp;by&nbsp;the&nbsp;filename&nbsp;string,<br>
-converting&nbsp;the&nbsp;structure&nbsp;and&nbsp;content&nbsp;into&nbsp;appropriate&nbsp;objects&nbsp;where&nbsp;possible.<br>
-&nbsp;<br>
-The&nbsp;borders&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;any&nbsp;frame&nbsp;borders&nbsp;found&nbsp;in&nbsp;the&nbsp;document&nbsp;should<br>
-be&nbsp;read.<br>
-&nbsp;<br>
-The&nbsp;integrity&nbsp;of&nbsp;content&nbsp;areas&nbsp;in&nbsp;the&nbsp;document&nbsp;can&nbsp;be&nbsp;checked&nbsp;by&nbsp;setting&nbsp;the<br>
-strict&nbsp;flag,&nbsp;which&nbsp;will&nbsp;be&nbsp;passed&nbsp;to&nbsp;<a href="#ContentCollection">ContentCollection</a>&nbsp;and&nbsp;<a href="#Content">Content</a>&nbsp;objects&nbsp;when<br>
-necessary.<br>
-&nbsp;<br>
-The&nbsp;process&nbsp;of&nbsp;reading&nbsp;and&nbsp;interpreting&nbsp;the&nbsp;document&nbsp;structure&nbsp;and&nbsp;content&nbsp;can&nbsp;be<br>
-monitored&nbsp;by&nbsp;setting&nbsp;the&nbsp;verbose&nbsp;flag.&nbsp;Progress&nbsp;will&nbsp;be&nbsp;printed&nbsp;as&nbsp;it&nbsp;is&nbsp;made.<br>
-&nbsp;<br>
-If&nbsp;the&nbsp;document&nbsp;is&nbsp;read&nbsp;without&nbsp;problems&nbsp;and&nbsp;the&nbsp;conversion&nbsp;process&nbsp;is&nbsp;successful,<br>
-a&nbsp;number&nbsp;of&nbsp;attributes&nbsp;will&nbsp;be&nbsp;created&nbsp;which&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;extract&nbsp;document<br>
-information&nbsp;for&nbsp;reuse.<br>
-&nbsp;<br>
-&nbsp;&nbsp;chapter_pages&nbsp;:&nbsp;A&nbsp;list&nbsp;of&nbsp;<a href="#ChapterPage">ChapterPage</a>&nbsp;objects&nbsp;corresponding&nbsp;to&nbsp;each&nbsp;page&nbsp;used&nbsp;in<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;document.&nbsp;Each&nbsp;of&nbsp;these&nbsp;objects&nbsp;contain<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Document-__init__"><strong>__init__</strong></a>(self, filename, borders<font color="#909090">=1</font>, strict<font color="#909090">=1</font>, verbose<font color="#909090">=0</font>)</dt></dl>
-
-<dl><dt><a name="Document-_old_read_coordinates"><strong>_old_read_coordinates</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-construct_page_offsets"><strong>construct_page_offsets</strong></a>(self, start_addr, end_addr)</dt></dl>
-
-<dl><dt><a name="Document-create_content_index"><strong>create_content_index</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-find_document_details"><strong>find_document_details</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-in_master_page"><strong>in_master_page</strong></a>(self, content_ref)</dt></dl>
-
-<dl><dt><a name="Document-info"><strong>info</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_borders"><strong>read_borders</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_chapter_pages_table"><strong>read_chapter_pages_table</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_content_table"><strong>read_content_table</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_document"><strong>read_document</strong></a>(self)</dt><dd><tt><a href="#Document-read_document">read_document</a>()<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;entire&nbsp;document,&nbsp;interpreting&nbsp;it&nbsp;as&nbsp;it&nbsp;is&nbsp;read.</tt></dd></dl>
-
-<dl><dt><a name="Document-read_mapping_area"><strong>read_mapping_area</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_master_pages"><strong>read_master_pages</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_master_pages_table"><strong>read_master_pages_table</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_offsets"><strong>read_offsets</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_string"><strong>read_string</strong></a>(self, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>, addr<font color="#909090">=None</font>)</dt></dl>
-
-<dl><dt><a name="Document-read_styles"><strong>read_styles</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Document-read_word"><strong>read_word</strong></a>(self, file<font color="#909090">=None</font>, addr<font color="#909090">=None</font>)</dt></dl>
-
-<dl><dt><a name="Document-require_resource"><strong>require_resource</strong></a>(self, path, name, directory, variations<font color="#909090">=0</font>)</dt><dd><tt>full_path&nbsp;=&nbsp;<a href="#Document-require_resource">require_resource</a>(self,&nbsp;path,&nbsp;name,&nbsp;directory,&nbsp;variations&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Return&nbsp;the&nbsp;full&nbsp;path&nbsp;of&nbsp;a&nbsp;file&nbsp;or&nbsp;directory&nbsp;in&nbsp;the&nbsp;path&nbsp;given&nbsp;with&nbsp;a<br>
-name&nbsp;which&nbsp;matches&nbsp;the&nbsp;specified&nbsp;value&nbsp;of&nbsp;"name",&nbsp;regardless&nbsp;of&nbsp;the<br>
-use&nbsp;of&nbsp;upper&nbsp;or&nbsp;lower&nbsp;case&nbsp;text.<br>
-The&nbsp;"directory"&nbsp;parameter,&nbsp;when&nbsp;non-zero&nbsp;indicates&nbsp;that&nbsp;a&nbsp;directory<br>
-is&nbsp;required.<br>
-&nbsp;<br>
-The&nbsp;variations&nbsp;flag,&nbsp;when&nbsp;set,&nbsp;allows&nbsp;files&nbsp;and&nbsp;directories&nbsp;to&nbsp;be<br>
-returned&nbsp;if&nbsp;their&nbsp;names&nbsp;begin&nbsp;with&nbsp;the&nbsp;name&nbsp;given.<br>
-&nbsp;<br>
-If&nbsp;no&nbsp;matching&nbsp;resource&nbsp;is&nbsp;found&nbsp;then&nbsp;an&nbsp;<a href="#ImpressionError">ImpressionError</a><br>
-exception&nbsp;is&nbsp;raised.</tt></dd></dl>
-
-<dl><dt><a name="Document-show_str"><strong>show_str</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Document(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>document = Document(... the document. Each of these objects contain<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Document-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Document-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Document-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Document-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Document-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Document-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Document-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Document-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Document-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Document-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Document-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Document-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Document-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Document-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Document-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Document-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Document-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Document-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Document-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Document-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Frame">class <strong>Frame</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Frame">Frame</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-frame&nbsp;=&nbsp;<a href="#Frame">Frame</a>(data,&nbsp;data_type,&nbsp;belongs_to,&nbsp;document_version)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;describing&nbsp;page&nbsp;layout&nbsp;frames&nbsp;in&nbsp;an&nbsp;Impression&nbsp;document.<br>
-&nbsp;<br>
-The&nbsp;frame&nbsp;data&nbsp;is&nbsp;supplied&nbsp;as&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;frame&nbsp;data&nbsp;from&nbsp;the<br>
-Impression&nbsp;document.&nbsp;The&nbsp;data_type&nbsp;is&nbsp;provided&nbsp;by&nbsp;the&nbsp;instantiating&nbsp;object&nbsp;as&nbsp;read<br>
-from&nbsp;the&nbsp;page&nbsp;descriptions.&nbsp;The&nbsp;belongs_to&nbsp;parameter&nbsp;is&nbsp;the&nbsp;page&nbsp;in&nbsp;which&nbsp;this<br>
-frame&nbsp;is&nbsp;used.<br>
-&nbsp;<br>
-The&nbsp;document&nbsp;version&nbsp;is&nbsp;obtained&nbsp;from&nbsp;the&nbsp;original&nbsp;document&nbsp;and&nbsp;is&nbsp;used&nbsp;to<br>
-control&nbsp;how&nbsp;the&nbsp;frame&nbsp;data&nbsp;is&nbsp;interpreted.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Frame-__init__"><strong>__init__</strong></a>(self, data, data_type, belongs_to, document_version)</dt></dl>
-
-<dl><dt><a name="Frame-info"><strong>info</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt><a href="#Frame-info">info</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Print&nbsp;basic&nbsp;information&nbsp;on&nbsp;the&nbsp;frame's&nbsp;properties&nbsp;using&nbsp;the&nbsp;units&nbsp;specified<br>
-where&nbsp;relevant.</tt></dd></dl>
-
-<dl><dt><a name="Frame-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Frame(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>frame = Frame(data, dat...<font color="#c040c0">\r</font>control how the frame data is interpreted. <font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Frame-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Frame-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Frame-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Frame-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Frame-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Frame-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Frame-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Frame-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Frame-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Frame-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Frame-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Frame-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Frame-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Frame-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Frame-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Frame-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Frame-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Frame-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Frame-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Frame-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Frame-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Frame-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Frame-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Frame-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="ImpressionError">class <strong>ImpressionError</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2>&nbsp;</td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = None</dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
-<dl><dt><a name="ImpressionError-__getitem__"><strong>__getitem__</strong></a>(...)</dt></dl>
-
-<dl><dt><a name="ImpressionError-__init__"><strong>__init__</strong></a>(...)</dt></dl>
-
-<dl><dt><a name="ImpressionError-__str__"><strong>__str__</strong></a>(...)</dt></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="LineInfo">class <strong>LineInfo</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#LineInfo">LineInfo</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-lineinfo&nbsp;=&nbsp;<a href="#LineInfo">LineInfo</a>(data)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;describing&nbsp;the&nbsp;vertical&nbsp;positioning&nbsp;of&nbsp;text&nbsp;lines&nbsp;on&nbsp;a&nbsp;page.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;is&nbsp;supplied&nbsp;as&nbsp;a&nbsp;string&nbsp;containing&nbsp;binary&nbsp;data&nbsp;from&nbsp;the&nbsp;original&nbsp;document.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="LineInfo-__init__"><strong>__init__</strong></a>(self, data)</dt></dl>
-
-<dl><dt><a name="LineInfo-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="LineInfo-read_string"><strong>read_string</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'LineInfo(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>lineinfo = LineInfo(...ning binary data from the original document.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="LineInfo-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#LineInfo-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#LineInfo-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#LineInfo-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#LineInfo-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#LineInfo-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#LineInfo-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#LineInfo-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#LineInfo-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#LineInfo-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#LineInfo-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="LineInfo-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#LineInfo-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="MasterPage">class <strong>MasterPage</strong></a>(<a href="impression.html#Page">Page</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#MasterPage">MasterPage</a>(<a href="#Page">Page</a>)<br>
-&nbsp;<br>
-page&nbsp;=&nbsp;<a href="#MasterPage">MasterPage</a>(data,&nbsp;addr)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;describing&nbsp;a&nbsp;master&nbsp;page&nbsp;within&nbsp;an&nbsp;Impression&nbsp;document.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.&nbsp;The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address<br>
-of&nbsp;the&nbsp;data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%"><dl><dt>Method resolution order:</dt>
-<dd><a href="impression.html#MasterPage">MasterPage</a></dd>
-<dd><a href="impression.html#Page">Page</a></dd>
-<dd><a href="impression.html#Common">Common</a></dd>
-</dl>
-<hr>
-Methods defined here:<br>
-<dl><dt><a name="MasterPage-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="MasterPage-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'MasterPage(Page)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>page = MasterPage(da... file from<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>which the data originated.  <font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Page">Page</a>:<br>
-<dl><dt><a name="MasterPage-__init__"><strong>__init__</strong></a>(self, data, addr)</dt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="MasterPage-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#MasterPage-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#MasterPage-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#MasterPage-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#MasterPage-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#MasterPage-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#MasterPage-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#MasterPage-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#MasterPage-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#MasterPage-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#MasterPage-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#MasterPage-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="MasterPage-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#MasterPage-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Page">class <strong>Page</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Page">Page</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-page&nbsp;=&nbsp;<a href="#Page">Page</a>(data,&nbsp;addr)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;containing&nbsp;methods&nbsp;common&nbsp;to&nbsp;the&nbsp;<a href="#MasterPage">MasterPage</a>&nbsp;and&nbsp;<a href="#ChapterPage">ChapterPage</a>&nbsp;classes.<br>
-This&nbsp;class&nbsp;should&nbsp;be&nbsp;subclassed&nbsp;rather&nbsp;than&nbsp;used&nbsp;directly.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.&nbsp;The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address<br>
-of&nbsp;the&nbsp;data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Page-__init__"><strong>__init__</strong></a>(self, data, addr)</dt></dl>
-
-<dl><dt><a name="Page-interpret"><strong>interpret</strong></a>(self, page_type)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Page(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>page = Page(data, addr)<font color="#c040c0">\n</font>... file from<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>which the data originated.  <font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Page-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Page-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Page-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Page-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Page-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Page-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Page-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Page-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Page-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Page-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Page-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Page-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Page-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Page-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Page-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Page-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Page-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Page-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Page-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Page-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Page-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Page-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Page-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Page-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="PageCollection">class <strong>PageCollection</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#PageCollection">PageCollection</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-page_collection&nbsp;=&nbsp;<a href="#PageCollection">PageCollection</a>(filename,&nbsp;page_offsets,&nbsp;PageClass,&nbsp;old_format,&nbsp;document_version)<br>
-&nbsp;<br>
-A&nbsp;container&nbsp;for&nbsp;page&nbsp;definitions&nbsp;from&nbsp;the&nbsp;descriptions&nbsp;found&nbsp;in&nbsp;an&nbsp;Impression&nbsp;document.<br>
-Actual&nbsp;page&nbsp;objects&nbsp;are&nbsp;supplied&nbsp;on&nbsp;demand&nbsp;rather&nbsp;than&nbsp;being&nbsp;created&nbsp;all&nbsp;at&nbsp;once.<br>
-&nbsp;<br>
-The&nbsp;filename&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;which&nbsp;the&nbsp;style<br>
-information&nbsp;resides.&nbsp;For&nbsp;old&nbsp;format&nbsp;documents,&nbsp;this&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;directory<br>
-which&nbsp;contains&nbsp;the&nbsp;document&nbsp;information.<br>
-&nbsp;<br>
-A&nbsp;list&nbsp;of&nbsp;page&nbsp;offsets&nbsp;is&nbsp;provided&nbsp;from&nbsp;the&nbsp;information&nbsp;found&nbsp;in&nbsp;the&nbsp;original&nbsp;document<br>
-and&nbsp;specifies&nbsp;the&nbsp;addresses&nbsp;within&nbsp;the&nbsp;file&nbsp;where&nbsp;the&nbsp;page&nbsp;definitions&nbsp;reside.<br>
-&nbsp;<br>
-The&nbsp;PageClass&nbsp;determines&nbsp;which&nbsp;class&nbsp;is&nbsp;used&nbsp;to&nbsp;instantiate&nbsp;page&nbsp;objects&nbsp;within&nbsp;this<br>
-collection&nbsp;and&nbsp;should&nbsp;be&nbsp;either&nbsp;<a href="#ChapterPage">ChapterPage</a>&nbsp;or&nbsp;<a href="#MasterPage">MasterPage</a>.<br>
-&nbsp;<br>
-The&nbsp;old_format&nbsp;flag,&nbsp;when&nbsp;set,&nbsp;specifies&nbsp;that&nbsp;the&nbsp;document&nbsp;is&nbsp;split&nbsp;into&nbsp;a&nbsp;number&nbsp;of<br>
-files&nbsp;contained&nbsp;in&nbsp;an&nbsp;application&nbsp;directory.&nbsp;The&nbsp;document_version&nbsp;is&nbsp;found&nbsp;from&nbsp;the<br>
-original&nbsp;document&nbsp;and&nbsp;will&nbsp;be&nbsp;used&nbsp;to&nbsp;determine&nbsp;how&nbsp;the&nbsp;style&nbsp;data&nbsp;is&nbsp;interpreted.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="PageCollection-__getitem__"><strong>__getitem__</strong></a>(self, n)</dt></dl>
-
-<dl><dt><a name="PageCollection-__init__"><strong>__init__</strong></a>(self, filename, page_offsets, PageClass, old_format, document_version)</dt></dl>
-
-<dl><dt><a name="PageCollection-__len__"><strong>__len__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="PageCollection-keys"><strong>keys</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="PageCollection-read_word"><strong>read_word</strong></a>(self, addr<font color="#909090">=None</font>)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'PageCollection(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>page_collectio...determine how the style data is interpreted.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="PageCollection-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#PageCollection-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#PageCollection-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#PageCollection-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#PageCollection-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#PageCollection-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#PageCollection-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#PageCollection-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#PageCollection-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#PageCollection-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#PageCollection-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="PageCollection-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#PageCollection-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="RGBTColour">class <strong>RGBTColour</strong></a>(<a href="impression.html#Colour">Colour</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#RGBTColour">RGBTColour</a>(<a href="#Colour">Colour</a>)<br>
-&nbsp;<br>
-colour&nbsp;=&nbsp;<a href="#RGBTColour">RGBTColour</a>(red,&nbsp;green,&nbsp;blue,&nbsp;trans)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;which&nbsp;is&nbsp;used&nbsp;to&nbsp;represent&nbsp;the&nbsp;way&nbsp;colours&nbsp;are&nbsp;stored&nbsp;in&nbsp;Impression&nbsp;documents.<br>
-&nbsp;<br>
-Red,&nbsp;green&nbsp;and&nbsp;blue&nbsp;values&nbsp;should&nbsp;be&nbsp;between&nbsp;zero&nbsp;and&nbsp;255&nbsp;inclusive.<br>
-&nbsp;<br>
-The&nbsp;transparent&nbsp;value&nbsp;is&nbsp;effectively&nbsp;a&nbsp;boolean&nbsp;value&nbsp;since&nbsp;only&nbsp;transparent&nbsp;and&nbsp;opaque<br>
-colours&nbsp;are&nbsp;supported.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="RGBTColour-__init__"><strong>__init__</strong></a>(self, red, green, blue, trans)</dt></dl>
-
-<dl><dt><a name="RGBTColour-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'RGBTColour(Colour)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>colour = RGBTColou...rent and opaque<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>colours are supported. <font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Style">class <strong>Style</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Style">Style</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-style&nbsp;=&nbsp;<a href="#Style">Style</a>(data,&nbsp;addr,&nbsp;document_version,&nbsp;base&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.&nbsp;The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address<br>
-of&nbsp;the&nbsp;data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.<br>
-&nbsp;<br>
-The&nbsp;document_version&nbsp;is&nbsp;found&nbsp;from&nbsp;the&nbsp;original&nbsp;document&nbsp;and&nbsp;will&nbsp;be&nbsp;used&nbsp;to<br>
-determine&nbsp;how&nbsp;the&nbsp;data&nbsp;is&nbsp;interpreted.<br>
-&nbsp;<br>
-The&nbsp;base&nbsp;flag&nbsp;also&nbsp;determines&nbsp;how&nbsp;the&nbsp;data&nbsp;will&nbsp;be&nbsp;interpreted&nbsp;by&nbsp;ignoring&nbsp;data<br>
-which&nbsp;the&nbsp;author&nbsp;could&nbsp;not&nbsp;decipher&nbsp;but&nbsp;which&nbsp;almost&nbsp;always&nbsp;appears&nbsp;in&nbsp;the<br>
-definition&nbsp;for&nbsp;the&nbsp;"BaseStyle"&nbsp;or&nbsp;"Normal"&nbsp;style,&nbsp;upon&nbsp;which&nbsp;all&nbsp;the&nbsp;other&nbsp;styles<br>
-are&nbsp;based.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Style-__init__"><strong>__init__</strong></a>(self, data, addr, document_version, base<font color="#909090">=0</font>)</dt></dl>
-
-<dl><dt><a name="Style-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Style-create_class"><strong>create_class</strong></a>(self)</dt><dd><tt>class&nbsp;=&nbsp;<a href="#Style-create_class">create_class</a>()<br>
-&nbsp;<br>
-Create&nbsp;a&nbsp;new&nbsp;class&nbsp;from&nbsp;an&nbsp;instance&nbsp;of&nbsp;this&nbsp;class&nbsp;with&nbsp;all&nbsp;the&nbsp;attributes&nbsp;which&nbsp;were<br>
-interpreted&nbsp;from&nbsp;the&nbsp;style&nbsp;definition&nbsp;filled&nbsp;in&nbsp;as&nbsp;default&nbsp;values.<br>
-&nbsp;<br>
-This&nbsp;scheme&nbsp;is&nbsp;useful&nbsp;when&nbsp;extracting&nbsp;style&nbsp;information&nbsp;from&nbsp;documents&nbsp;as&nbsp;it&nbsp;allows<br>
-styles&nbsp;to&nbsp;be&nbsp;layered&nbsp;by&nbsp;deriving&nbsp;a&nbsp;subclass&nbsp;from&nbsp;the&nbsp;existing&nbsp;style&nbsp;and&nbsp;the&nbsp;new&nbsp;style<br>
-to&nbsp;be&nbsp;applied.&nbsp;For&nbsp;example:<br>
-&nbsp;<br>
-#&nbsp;The&nbsp;new&nbsp;style&nbsp;attributes&nbsp;should&nbsp;override&nbsp;the&nbsp;old&nbsp;ones&nbsp;(left&nbsp;to&nbsp;right&nbsp;inheritance&nbsp;lookup).<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;class&nbsp;TextStyle(new_style,&nbsp;current_style):<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pass<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;current_style&nbsp;=&nbsp;TextStyle<br>
-&nbsp;<br>
-The&nbsp;newly&nbsp;redefined&nbsp;current_style&nbsp;can&nbsp;then&nbsp;be&nbsp;instantiated&nbsp;as&nbsp;required.</tt></dd></dl>
-
-<dl><dt><a name="Style-info"><strong>info</strong></a>(self, units<font color="#909090">='pt'</font>)</dt></dl>
-
-<dl><dt><a name="Style-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Style(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>style = Style(data, add...n which all the other styles<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>are based.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>justify_list</strong> = ['left', 'centre', 'right', 'full']<dd><tt>list()&nbsp;-&gt;&nbsp;new&nbsp;list<br>
-list(sequence)&nbsp;-&gt;&nbsp;new&nbsp;list&nbsp;initialized&nbsp;from&nbsp;sequence's&nbsp;items</tt></dl>
-
-<dl><dt><strong>tab_type_list</strong> = ['left', 'centre', 'right', 'decimal', 'vertical rule']<dd><tt>list()&nbsp;-&gt;&nbsp;new&nbsp;list<br>
-list(sequence)&nbsp;-&gt;&nbsp;new&nbsp;list&nbsp;initialized&nbsp;from&nbsp;sequence's&nbsp;items</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Style-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Style-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Style-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Style-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Style-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Style-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is&nbsp;returned&nbsp;as<br>
-part&nbsp;of&nbsp;the&nbsp;string.</tt></dd></dl>
-
-<dl><dt><a name="Style-read_word"><strong>read_word</strong></a>(self, offset)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Style-read_word">read_word</a>(offset)<br>
-&nbsp;<br>
-Read&nbsp;the&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;word&nbsp;stored&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset&nbsp;in&nbsp;the&nbsp;object's<br>
-data&nbsp;area&nbsp;and&nbsp;return&nbsp;it&nbsp;as&nbsp;an&nbsp;integer.</tt></dd></dl>
-
-<dl><dt><a name="Style-read_words"><strong>read_words</strong></a>(self, offset, endings, include<font color="#909090">=0</font>)</dt><dd><tt>words&nbsp;=&nbsp;<a href="#Style-read_word">read_word</a>(offset,&nbsp;endings,&nbsp;include&nbsp;=&nbsp;0)<br>
-&nbsp;<br>
-Read&nbsp;a&nbsp;sequence&nbsp;of&nbsp;four&nbsp;byte,&nbsp;little&nbsp;endian&nbsp;words&nbsp;beginning&nbsp;at&nbsp;the&nbsp;specified&nbsp;offset<br>
-in&nbsp;the&nbsp;object's&nbsp;data&nbsp;area&nbsp;and&nbsp;return&nbsp;them&nbsp;as&nbsp;a&nbsp;list&nbsp;of&nbsp;integers.<br>
-&nbsp;<br>
-The&nbsp;sequence&nbsp;will&nbsp;be&nbsp;terminated&nbsp;if&nbsp;an&nbsp;integer&nbsp;matching&nbsp;any&nbsp;of&nbsp;those&nbsp;in&nbsp;the&nbsp;endings<br>
-list&nbsp;is&nbsp;found.&nbsp;The&nbsp;terminating&nbsp;ending&nbsp;is&nbsp;included&nbsp;in&nbsp;the&nbsp;list&nbsp;of&nbsp;words&nbsp;if&nbsp;the<br>
-include&nbsp;flag&nbsp;is&nbsp;set.</tt></dd></dl>
-
-<dl><dt><a name="Style-str2num"><strong>str2num</strong></a>(self, size, s)</dt><dd><tt>integer&nbsp;=&nbsp;<a href="#Style-str2num">str2num</a>(size,&nbsp;string)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;representation&nbsp;of&nbsp;a&nbsp;little&nbsp;endian<br>
-integer&nbsp;into&nbsp;an&nbsp;integer.&nbsp;The&nbsp;operation&nbsp;is&nbsp;performed&nbsp;on&nbsp;"size"&nbsp;characters.</tt></dd></dl>
-
-<dl><dt><a name="Style-unit_to_cm"><strong>unit_to_cm</strong></a>(self, n)</dt><dd><tt>cm_value&nbsp;=&nbsp;<a href="#Style-unit_to_cm">unit_to_cm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;centimetres.</tt></dd></dl>
-
-<dl><dt><a name="Style-unit_to_in"><strong>unit_to_in</strong></a>(self, n)</dt><dd><tt>in_value&nbsp;=&nbsp;<a href="#Style-unit_to_in">unit_to_in</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;inches.</tt></dd></dl>
-
-<dl><dt><a name="Style-unit_to_mm"><strong>unit_to_mm</strong></a>(self, n)</dt><dd><tt>mm_value&nbsp;=&nbsp;<a href="#Style-unit_to_mm">unit_to_mm</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millimetres.</tt></dd></dl>
-
-<dl><dt><a name="Style-unit_to_mpt"><strong>unit_to_mpt</strong></a>(self, n)</dt><dd><tt>mpt_value&nbsp;=&nbsp;<a href="#Style-unit_to_mpt">unit_to_mpt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;millipoints.<br>
-This&nbsp;method&nbsp;simply&nbsp;returns&nbsp;the&nbsp;input&nbsp;value&nbsp;but&nbsp;is&nbsp;used&nbsp;for&nbsp;clarity&nbsp;and<br>
-to&nbsp;be&nbsp;consistent&nbsp;with&nbsp;the&nbsp;other&nbsp;conversion&nbsp;methods.</tt></dd></dl>
-
-<dl><dt><a name="Style-unit_to_pt"><strong>unit_to_pt</strong></a>(self, n)</dt><dd><tt>pt_value&nbsp;=&nbsp;<a href="#Style-unit_to_pt">unit_to_pt</a>(value)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;measurement&nbsp;in&nbsp;Impression&nbsp;file&nbsp;units&nbsp;to&nbsp;points.</tt></dd></dl>
-
-<dl><dt><a name="Style-word2rgb"><strong>word2rgb</strong></a>(self, word)</dt><dd><tt>colour&nbsp;=&nbsp;<a href="#Style-word2rgb">word2rgb</a>(word)<br>
-&nbsp;<br>
-Convert&nbsp;a&nbsp;word&nbsp;to&nbsp;RGB&nbsp;representation.&nbsp;The&nbsp;value&nbsp;returned&nbsp;will&nbsp;be&nbsp;an&nbsp;instance&nbsp;of<br>
-the&nbsp;<a href="#RGBTColour">RGBTColour</a>&nbsp;class.</tt></dd></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="StyleCollection">class <strong>StyleCollection</strong></a></font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#StyleCollection">StyleCollection</a><br>
-&nbsp;<br>
-style_collection&nbsp;=&nbsp;<a href="#StyleCollection">StyleCollection</a>(filename,&nbsp;offset_list,&nbsp;old_format,&nbsp;document_version)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;for&nbsp;managing&nbsp;text&nbsp;styles&nbsp;based&nbsp;on&nbsp;the&nbsp;tables&nbsp;of&nbsp;styles&nbsp;in&nbsp;the&nbsp;original<br>
-document.<br>
-&nbsp;<br>
-The&nbsp;filename&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;which&nbsp;the&nbsp;style<br>
-information&nbsp;resides.&nbsp;For&nbsp;old&nbsp;format&nbsp;documents,&nbsp;this&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;directory<br>
-which&nbsp;contains&nbsp;the&nbsp;document&nbsp;information.<br>
-&nbsp;<br>
-The&nbsp;offset_list&nbsp;is&nbsp;a&nbsp;list&nbsp;of&nbsp;addresses&nbsp;within&nbsp;the&nbsp;file&nbsp;mentioned,&nbsp;created&nbsp;by&nbsp;methods<br>
-of&nbsp;the&nbsp;main&nbsp;<a href="#Document">Document</a>&nbsp;class.<br>
-&nbsp;<br>
-The&nbsp;old_format&nbsp;flag,&nbsp;when&nbsp;set,&nbsp;specifies&nbsp;that&nbsp;the&nbsp;document&nbsp;is&nbsp;split&nbsp;into&nbsp;a&nbsp;number&nbsp;of<br>
-files&nbsp;contained&nbsp;in&nbsp;an&nbsp;application&nbsp;directory.&nbsp;The&nbsp;document_version&nbsp;is&nbsp;found&nbsp;from&nbsp;the<br>
-original&nbsp;document&nbsp;and&nbsp;will&nbsp;be&nbsp;used&nbsp;to&nbsp;determine&nbsp;how&nbsp;the&nbsp;style&nbsp;data&nbsp;is&nbsp;interpreted.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="StyleCollection-__getitem__"><strong>__getitem__</strong></a>(self, n)</dt></dl>
-
-<dl><dt><a name="StyleCollection-__init__"><strong>__init__</strong></a>(self, filename, offset_list, old_format, document_version)</dt></dl>
-
-<dl><dt><a name="StyleCollection-__len__"><strong>__len__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="StyleCollection-keys"><strong>keys</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'StyleCollection<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>style_collection = St...determine how the style data is interpreted.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-</td></tr></table> 
-<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
-<tr bgcolor="#ffc8d8">
-<td colspan=3 valign=bottom>&nbsp;<br>
-<font color="#000000" face="helvetica, arial"><a name="Text">class <strong>Text</strong></a>(<a href="impression.html#Common">Common</a>)</font></td></tr>
-    
-<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td>
-<td colspan=2><tt><a href="#Text">Text</a>(<a href="#Common">Common</a>)<br>
-&nbsp;<br>
-text&nbsp;=&nbsp;<a href="#Text">Text</a>(data,&nbsp;block_type,&nbsp;lineinfo,&nbsp;addr,&nbsp;first_line,&nbsp;trailing)<br>
-&nbsp;<br>
-A&nbsp;class&nbsp;used&nbsp;to&nbsp;describe&nbsp;the&nbsp;properties&nbsp;of&nbsp;a&nbsp;line&nbsp;of&nbsp;text&nbsp;found&nbsp;in&nbsp;a&nbsp;document.<br>
-&nbsp;<br>
-The&nbsp;data&nbsp;parameter&nbsp;is&nbsp;a&nbsp;string&nbsp;containing&nbsp;the&nbsp;binary&nbsp;page&nbsp;data&nbsp;from&nbsp;the&nbsp;Impression<br>
-document.<br>
-&nbsp;<br>
-The&nbsp;block_type&nbsp;describes&nbsp;whether&nbsp;the&nbsp;line&nbsp;is&nbsp;at&nbsp;the&nbsp;beginning&nbsp;or&nbsp;end&nbsp;of&nbsp;a&nbsp;paragraph<br>
-and&nbsp;is&nbsp;derived&nbsp;from&nbsp;the&nbsp;corresponding&nbsp;word&nbsp;found&nbsp;in&nbsp;the&nbsp;relevant&nbsp;content&nbsp;area.<br>
-&nbsp;<br>
-The&nbsp;addr&nbsp;parameter&nbsp;is&nbsp;a&nbsp;tuple;&nbsp;the&nbsp;first&nbsp;element&nbsp;of&nbsp;which&nbsp;is&nbsp;the&nbsp;address&nbsp;of&nbsp;the<br>
-data&nbsp;within&nbsp;the&nbsp;original&nbsp;document,&nbsp;the&nbsp;second&nbsp;is&nbsp;the&nbsp;name&nbsp;of&nbsp;the&nbsp;file&nbsp;from<br>
-which&nbsp;the&nbsp;data&nbsp;originated.&nbsp;&nbsp;<br>
-&nbsp;<br>
-The&nbsp;first_line&nbsp;and&nbsp;trailing&nbsp;flags&nbsp;actually&nbsp;specify&nbsp;whether&nbsp;the&nbsp;line&nbsp;is&nbsp;a&nbsp;leading<br>
-or&nbsp;trailing&nbsp;line&nbsp;in&nbsp;a&nbsp;paragraph&nbsp;and&nbsp;have&nbsp;usually&nbsp;been&nbsp;interpreted&nbsp;from&nbsp;the<br>
-block_type&nbsp;value.&nbsp;Note&nbsp;that&nbsp;the&nbsp;first_line&nbsp;flag&nbsp;is&nbsp;only&nbsp;really&nbsp;useful&nbsp;for&nbsp;the<br>
-first&nbsp;line&nbsp;in&nbsp;a&nbsp;frame.<br>
-&nbsp;<br>
-The&nbsp;text&nbsp;and&nbsp;various&nbsp;commands&nbsp;desribing&nbsp;the&nbsp;line&nbsp;content&nbsp;are&nbsp;stored&nbsp;in&nbsp;the&nbsp;"text"<br>
-attribute&nbsp;of&nbsp;the&nbsp;created&nbsp;object.&nbsp;This&nbsp;attribute&nbsp;is&nbsp;a&nbsp;list&nbsp;in&nbsp;which&nbsp;pieces&nbsp;of&nbsp;text<br>
-are&nbsp;represented&nbsp;as&nbsp;strings&nbsp;but&nbsp;where&nbsp;any&nbsp;other&nbsp;type&nbsp;of&nbsp;information&nbsp;is&nbsp;stored&nbsp;as<br>
-a&nbsp;sequence&nbsp;(a&nbsp;tuple&nbsp;or&nbsp;list).&nbsp;The&nbsp;first&nbsp;elements&nbsp;in&nbsp;these&nbsp;sequences&nbsp;may&nbsp;be&nbsp;treated<br>
-as&nbsp;a&nbsp;command&nbsp;with&nbsp;the&nbsp;other&nbsp;elements&nbsp;as&nbsp;arguments.&nbsp;Examples&nbsp;of&nbsp;these&nbsp;commands&nbsp;and<br>
-their&nbsp;arguments&nbsp;follow:<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;Command&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Arguments<br>
-&nbsp;&nbsp;"apply&nbsp;style"&nbsp;&nbsp;&nbsp;One&nbsp;or&nbsp;more&nbsp;tuples&nbsp;of&nbsp;the&nbsp;form&nbsp;(counter,&nbsp;style)&nbsp;of&nbsp;which&nbsp;the<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;first&nbsp;tuple&nbsp;is&nbsp;usually&nbsp;ignored.&nbsp;The&nbsp;style&nbsp;is&nbsp;an&nbsp;offset&nbsp;into<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;original&nbsp;document's&nbsp;style&nbsp;table&nbsp;but&nbsp;this&nbsp;information&nbsp;can<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;be&nbsp;used&nbsp;with&nbsp;a&nbsp;<a href="#StyleCollection">StyleCollection</a>&nbsp;object&nbsp;to&nbsp;obtain&nbsp;the&nbsp;appropriate<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;style.<br>
-&nbsp;<br>
-&nbsp;&nbsp;"page&nbsp;number"&nbsp;&nbsp;&nbsp;An&nbsp;string&nbsp;describing&nbsp;the&nbsp;format&nbsp;to&nbsp;be&nbsp;used&nbsp;when&nbsp;describing&nbsp;the<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;current&nbsp;page&nbsp;number.&nbsp;This&nbsp;will&nbsp;be&nbsp;"arabic",&nbsp;"roman"&nbsp;or&nbsp;"Roman"<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for&nbsp;numbers&nbsp;of&nbsp;the&nbsp;form&nbsp;"123",&nbsp;"iv"&nbsp;and&nbsp;"IV"&nbsp;respectively.<br>
-&nbsp;<br>
-&nbsp;"horizontal&nbsp;space"<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;An&nbsp;integer&nbsp;measurement&nbsp;of&nbsp;the&nbsp;number&nbsp;of&nbsp;millipoints&nbsp;between&nbsp;the<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;previous&nbsp;piece&nbsp;of&nbsp;text&nbsp;and&nbsp;the&nbsp;next.&nbsp;This&nbsp;integer&nbsp;may&nbsp;be<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;negative.<br>
-&nbsp;<br>
-&nbsp;"embedded&nbsp;frame"&nbsp;Six&nbsp;integers,&nbsp;the&nbsp;last&nbsp;two&nbsp;of&nbsp;which&nbsp;are&nbsp;the&nbsp;respective&nbsp;width<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;and&nbsp;height&nbsp;of&nbsp;the&nbsp;embedded&nbsp;frame.&nbsp;This&nbsp;is&nbsp;used&nbsp;to&nbsp;place&nbsp;gaps&nbsp;in<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;text&nbsp;and&nbsp;does&nbsp;not&nbsp;necessarily&nbsp;refer&nbsp;to&nbsp;the&nbsp;frame&nbsp;or&nbsp;its<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;content.<br>
-&nbsp;<br>
-&nbsp;"special&nbsp;character"<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A&nbsp;special&nbsp;character&nbsp;is&nbsp;given&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;"margins"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;left&nbsp;and&nbsp;right&nbsp;margins&nbsp;are&nbsp;given&nbsp;as&nbsp;integer&nbsp;adjustments,<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;specified&nbsp;in&nbsp;millipoints,&nbsp;to&nbsp;the&nbsp;horizontal&nbsp;frame&nbsp;boundaries<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;after&nbsp;horizontal&nbsp;frame&nbsp;inset&nbsp;has&nbsp;been&nbsp;taken&nbsp;into&nbsp;account.<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If&nbsp;the&nbsp;right&nbsp;margin&nbsp;is&nbsp;a&nbsp;positive&nbsp;value&nbsp;then&nbsp;it&nbsp;is&nbsp;measured&nbsp;as<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;a&nbsp;rightwards&nbsp;adjustment&nbsp;to&nbsp;the&nbsp;left&nbsp;hand&nbsp;frame&nbsp;boundary&nbsp;and<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;inset,&nbsp;otherwise&nbsp;it&nbsp;is&nbsp;measured&nbsp;from&nbsp;the&nbsp;right&nbsp;hand&nbsp;frame<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;boundary&nbsp;and&nbsp;inset.&nbsp;The&nbsp;left&nbsp;margin&nbsp;is&nbsp;always&nbsp;measured&nbsp;from&nbsp;the<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;left&nbsp;hand&nbsp;frame&nbsp;boundary&nbsp;and&nbsp;inset.<br>
-&nbsp;<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kern"&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;kerning&nbsp;applied&nbsp;to&nbsp;the&nbsp;following&nbsp;text&nbsp;given&nbsp;as&nbsp;horizontal<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;and&nbsp;vertical&nbsp;displacments,&nbsp;specified&nbsp;for&nbsp;the&nbsp;first&nbsp;two&nbsp;words&nbsp;in<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;thousandths&nbsp;of&nbsp;an&nbsp;em&nbsp;then,&nbsp;for&nbsp;the&nbsp;last&nbsp;two&nbsp;words,&nbsp;in<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;millipoints.<br>
-&nbsp;<br>
-Other&nbsp;commands&nbsp;are&nbsp;just&nbsp;the&nbsp;hexadecimal&nbsp;form&nbsp;of&nbsp;the&nbsp;words&nbsp;read&nbsp;from&nbsp;the&nbsp;original<br>
-document&nbsp;and&nbsp;given&nbsp;as&nbsp;strings.<br>&nbsp;</tt></td></tr>
-<tr><td>&nbsp;&nbsp;</td>
-<td width="100%">Methods defined here:<br>
-<dl><dt><a name="Text-__init__"><strong>__init__</strong></a>(self, data, block_type, lineinfo, addr, first_line, trailing)</dt></dl>
-
-<dl><dt><a name="Text-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
-
-<dl><dt><a name="Text-interpret"><strong>interpret</strong></a>(self)</dt></dl>
-
-<hr>
-Data and non-method functions defined here:<br>
-<dl><dt><strong>__doc__</strong> = 'Text(Common)<font color="#c040c0">\n</font>    <font color="#c040c0">\r\n</font>    <font color="#c040c0">\r</font>text = Text(data, block_...original<font color="#c040c0">\n</font>    <font color="#c040c0">\r</font>document and given as strings.<font color="#c040c0">\n</font>    '<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>__module__</strong> = 'impression'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>all_endings</strong> = '<font color="#c040c0">\x01\x02\x03\x04\x06\x07\x08\t\n\x0b\x0c\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f\x05\x00</font>'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>endings</strong> = '<font color="#c040c0">\x01\x02\x03\x04\x06\x07\x08\t\n\x0b\x0c\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f</font>'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<dl><dt><strong>formatting</strong> = '<font color="#c040c0">\x05</font>'<dd><tt>str(object)&nbsp;-&gt;&nbsp;string<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;nice&nbsp;string&nbsp;representation&nbsp;of&nbsp;the&nbsp;object.<br>
-If&nbsp;the&nbsp;argument&nbsp;is&nbsp;a&nbsp;string,&nbsp;the&nbsp;return&nbsp;value&nbsp;is&nbsp;the&nbsp;same&nbsp;object.</tt></dl>
-
-<hr>
-Methods inherited from <a href="impression.html#Common">Common</a>:<br>
-<dl><dt><a name="Text-convert"><strong>convert</strong></a>(self, units<font color="#909090">='pt'</font>)</dt><dd><tt>function&nbsp;=&nbsp;<a href="#Text-convert">convert</a>(units&nbsp;=&nbsp;'pt')<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;function&nbsp;or&nbsp;method&nbsp;suitable&nbsp;for&nbsp;converting&nbsp;Impression&nbsp;coordinates&nbsp;to&nbsp;the<br>
-units&nbsp;specified.&nbsp;The&nbsp;units&nbsp;parameter&nbsp;should&nbsp;be&nbsp;one&nbsp;of&nbsp;"pt",&nbsp;"mpt",&nbsp;"in",&nbsp;"cm",&nbsp;"mm".<br>
-An&nbsp;exception&nbsp;is&nbsp;raised&nbsp;if&nbsp;the&nbsp;units&nbsp;are&nbsp;not&nbsp;recognised.</tt></dd></dl>
-
-<dl><dt><a name="Text-count_bits"><strong>count_bits</strong></a>(self, word)</dt><dd><tt>number&nbsp;=&nbsp;<a href="#Text-count_bits">count_bits</a>(word)<br>
-&nbsp;<br>
-Count&nbsp;the&nbsp;number&nbsp;of&nbsp;consecutive&nbsp;bits&nbsp;which&nbsp;are&nbsp;set&nbsp;in&nbsp;the&nbsp;word&nbsp;from&nbsp;the&nbsp;lowest&nbsp;upwards.</tt></dd></dl>
-
-<dl><dt><a name="Text-read_string"><strong>read_string</strong></a>(self, offset, length<font color="#909090">=None</font>, ending<font color="#909090">=None</font>, include<font color="#909090">=1</font>)</dt><dd><tt>string&nbsp;=&nbsp;<a href="#Text-read_string">read_string</a>(offset,&nbsp;length&nbsp;=&nbsp;None,&nbsp;ending&nbsp;=&nbsp;None,&nbsp;include&nbsp;=&nbsp;1)<br>
-&nbsp;<br>
-Return&nbsp;a&nbsp;string&nbsp;from&nbsp;the&nbsp;object's&nbsp;internal&nbsp;data&nbsp;area,&nbsp;starting&nbsp;at&nbsp;the&nbsp;offset<br>
-specified.<br>
-&nbsp;<br>
-If&nbsp;an&nbsp;ending&nbsp;character&nbsp;is&nbsp;given&nbsp;then&nbsp;data&nbsp;will&nbsp;be&nbsp;read&nbsp;until&nbsp;the&nbsp;ending&nbsp;is<br>
-found.&nbsp;If&nbsp;a&nbsp;length&nbsp;is&nbsp;specified&nbsp;then&nbsp;this&nbsp;provides&nbsp;an&nbsp;additional&nbsp;constraint<br>
-on&nbsp;the&nbsp;amount&nbsp;of&nbsp;data&nbsp;returned&nbsp;as&nbsp;a&nbsp;string.<br>
-&nbsp;<br>
-The&nbsp;include&nbsp;flag&nbsp;determines&nbsp;whether&nbsp;the&nbsp;ending,&nbsp;if&nbsp;given,&nbsp;is