summaryrefslogtreecommitdiff
path: root/doc/developer/reference-html/c200.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/developer/reference-html/c200.html')
-rw-r--r--doc/developer/reference-html/c200.html156
1 files changed, 92 insertions, 64 deletions
diff --git a/doc/developer/reference-html/c200.html b/doc/developer/reference-html/c200.html
index cd26eae..ea024f7 100644
--- a/doc/developer/reference-html/c200.html
+++ b/doc/developer/reference-html/c200.html
@@ -1,27 +1,24 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Adding a new printer</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="The Developer's Guide to Gutenprint"
-HREF="index.html"><LINK
+HREF="book1.html"><LINK
REL="PREVIOUS"
TITLE="Reporting Bugs"
HREF="c194.html"><LINK
REL="NEXT"
TITLE="The driver file"
-HREF="x271.html"></HEAD
+HREF="x271.html"><META
+http-equiv="Content-Type"
+content="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="chapter"
-BGCOLOR="#FFFFFF"
-TEXT="#000000"
-LINK="#0000FF"
-VLINK="#840084"
-ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
@@ -72,6 +69,28 @@ CLASS="chapter"
NAME="AEN200"
></A
>Chapter 4. Adding a new printer</H1
+><DIV
+CLASS="TOC"
+><DL
+><DT
+><B
+>Table of Contents</B
+></DT
+><DT
+><A
+HREF="c200.html#AEN217"
+><TT
+CLASS="filename"
+>printers.xml</TT
+></A
+></DT
+><DT
+><A
+HREF="x271.html"
+>The driver file</A
+></DT
+></DL
+></DIV
><P
>&#13; This chapter covers adding a new ESCP/2, PCL, or Canon printer.
Writing a new driver module is not covered.
@@ -131,7 +150,7 @@ CLASS="sect1"
CLASS="sect1"
><A
NAME="AEN217"
->4.1. <TT
+><TT
CLASS="filename"
>printers.xml</TT
></A
@@ -155,6 +174,12 @@ CLASS="informalexample"
><A
NAME="AEN223"
></A
+><TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
><PRE
CLASS="programlisting"
>&#60;printer name="EPSON Stylus Color 1500" driver="escp2-1500"&#62;
@@ -163,30 +188,33 @@ CLASS="programlisting"
&#60;gamma value="0.597"/&#62;
&#60;density value="1.0"/&#62;
&#60;/printer&#62;</PRE
+></TD
+></TR
+></TABLE
><P
></P
></DIV
><P
>&#13; There are other tags that may be present. The only ones that
- are mandatory are <TT
+ are mandatory are <VAR
CLASS="literal"
->&#60;printer&#62;</TT
+>&#60;printer&#62;</VAR
>,
- <TT
+ <VAR
CLASS="literal"
->&#60;color&#62;</TT
+>&#60;color&#62;</VAR
> and
- <TT
+ <VAR
CLASS="literal"
->&#60;model&#62;</TT
+>&#60;model&#62;</VAR
>. The other optional parameters
- (<TT
+ (<VAR
CLASS="literal"
->&#60;gamma&#62;</TT
+>&#60;gamma&#62;</VAR
> and
- <TT
+ <VAR
CLASS="literal"
->&#60;density&#62;</TT
+>&#60;density&#62;</VAR
> in this case) can be used to
adjust control settings. This is probably not the right place
for them; the printer drivers themselves should contain this
@@ -213,75 +241,75 @@ CLASS="variablelist"
></P
><DL
><DT
-><TT
+><VAR
CLASS="literal"
->&#60;family&#62;</TT
+>&#60;family&#62;</VAR
></DT
><DD
><P
>&#13; This defines what driver module this printer uses. The
- attribute <TT
+ attribute <VAR
CLASS="literal"
->name</TT
+>name</VAR
> is the name of the
family driver to associate the printers with, for example
- <TT
+ <VAR
CLASS="literal"
->escp2</TT
->, <TT
+>escp2</VAR
+>, <VAR
CLASS="literal"
->pcl</TT
+>pcl</VAR
>,
- <TT
+ <VAR
CLASS="literal"
->canon</TT
->, <TT
+>canon</VAR
+>, <VAR
CLASS="literal"
->ps</TT
+>ps</VAR
> or
- <TT
+ <VAR
CLASS="literal"
->raw</TT
+>raw</VAR
>. This tag may only contain
- <TT
+ <VAR
CLASS="literal"
->&#60;printer&#62;</TT
+>&#60;printer&#62;</VAR
> elements.
</P
></DD
><DT
-><TT
+><VAR
CLASS="literal"
->&#60;printer&#62;</TT
+>&#60;printer&#62;</VAR
></DT
><DD
><P
>&#13; This starts the definition of a printer. It must contain
- the attributes <TT
+ the attributes <VAR
CLASS="literal"
->name</TT
+>name</VAR
> and
- <TT
+ <VAR
CLASS="literal"
->driver</TT
->. <TT
+>driver</VAR
+>. <VAR
CLASS="literal"
->name</TT
+>name</VAR
> should
be is the full name of the printer, and must be human
- readable. <TT
+ readable. <VAR
CLASS="literal"
->driver</TT
+>driver</VAR
> should consist of
alphanumerics and hyphens, and be fairly short.
- <TT
+ <VAR
CLASS="literal"
->name</TT
+>name</VAR
> is what will appear in the
user-visible listing of printers, and may be translated
- into the user's language, while <TT
+ into the user's language, while <VAR
CLASS="literal"
->driver</TT
+>driver</VAR
>
is what is actually used to key into the list of printers.
It is legal to have multiple printers with the same driver
@@ -289,43 +317,43 @@ CLASS="literal"
</P
></DD
><DT
-><TT
+><VAR
CLASS="literal"
->&#60;color&#62;</TT
+>&#60;color&#62;</VAR
></DT
><DD
><P
>&#13; This tag may not contain any content, but the
- <TT
+ <VAR
CLASS="literal"
->value</TT
+>value</VAR
> attribute may be set to
- <TT
+ <VAR
CLASS="literal"
->true</TT
-> or <TT
+>true</VAR
+> or <VAR
CLASS="literal"
->false</TT
+>false</VAR
>. This
indicates that this printer is capable of color, or is not
capable of color respectively.
</P
></DD
><DT
-><TT
+><VAR
CLASS="literal"
->&#60;model&#62;</TT
+>&#60;model&#62;</VAR
></DT
><DD
><P
>&#13; This defines a model number. This tag may not contain any
- content, but the <TT
+ content, but the <VAR
CLASS="literal"
->value</TT
+>value</VAR
> attribute may be
set to a positive integer. This is passed into the
driver, which may do whatever it cares to with
- it&#8212;index into a table, compute on, or whatever.
+ it—index into a table, compute on, or whatever.
This need not be unique.
</P
></DD
@@ -358,7 +386,7 @@ WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
-HREF="index.html"
+HREF="book1.html"
ACCESSKEY="H"
>Home</A
></TD