home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d738 / canonbjc.lha / CanonBJC / ReadMe < prev    next >
Text File  |  1992-09-26  |  57KB  |  1,407 lines
  1.                           Trademarks
  2.                           ----------
  3.  
  4.  
  5.  
  6.  
  7. Amiga is a registered trademark of Commodore-Amiga, Inc.
  8. Kickstart is a registered trademark of Commodore-Amiga, Inc.
  9. Workbench is a registered trademark of Commodore-Amiga, Inc.
  10. PostScript is a trademark of Adobe Systems Incorporated.
  11. PageStream is a registered trademark of Soft-Logik Publishing Co.
  12. Professional Page is a trademark of Gold Disk Inc.
  13. AGFA, Compugraphic and Intellifont is a registered trademark of AGFA
  14.  
  15. All  other  trademarked  product and company names used herein are
  16. used   for  identification  purposes  only.   No  infringement  of
  17. trademarks   is  intended.   Trademarks  remain  property  of  the
  18. trademark holder.
  19.  
  20.  
  21.  
  22.  
  23.           Warranty, Registration, Support and Upgrades
  24.           --------------------------------------------
  25.  
  26.  
  27.  
  28.  
  29. Copyright   ©   1992   Wolf  Faust.   All  rights  reserved.   All
  30. distribution-  and  marketing  rights to the software (driver) are
  31. vested in Canon Europa N.V.
  32.  
  33. The  driver  has  been  provided  to you strictly 'as is', without
  34. warranty  of  any  kind.   In no event shall Canon and/or Faust be
  35. held  liable  for  any  loss or damages arising out of any action,
  36. from  whatever  source, concerning the use or inability to use the
  37. driver.
  38.  
  39. For  obtaining a copy of the driver, or for more information about
  40. Amiga driver, please contact your local Canon representative.
  41.  
  42. Following driver revisions have been made:
  43.  
  44.  
  45. Preliminary:
  46.  
  47. Version 99
  48. Version 99a  - Formfeed allowed in native mode for CanonStudio/ADPro
  49. Version 99b  - TIFF compression now written in assembler
  50. Version 99c  - small bug in ink compensation fixed
  51.                (caused small color differences)
  52.              - CanonPref improved for KS 3.0 compatibility
  53.              - CanonPref font independent check now allows size >5 pix.
  54. Version 99d  - Supermode added
  55.              - CanonPref user interface improved and SuperMode added
  56.  
  57. FINAL:
  58.  
  59. 03.09.91     Version 1.0
  60.  
  61.  
  62.  
  63.  
  64.                           Thanks to
  65.                           ---------
  66.  
  67.  
  68.  
  69.  
  70.  
  71. Several  people were involved during the writing of the driver and
  72. documentation.   To  all of them, thank you!
  73.  
  74.  
  75.  
  76.  
  77.                            Contents
  78.                            --------
  79.  
  80.  
  81.  
  82.  
  83. The  CanonBJC  package  contains a printer driver for use with the
  84. Canon BJC800 and other Epson compatible printers.  Note, there are
  85. special  driver  version  available  for the BJ130,300,330,10, LBP
  86. printers!   Also,  the  CanonStudio  is  available  for  all Canon
  87. printer  drivers.   CanonStudio allows printing of IFF pictures in
  88. any  size  from disk (this means:  you don't need much memory like
  89. ADPro!).   Also  CanonStudio  offers some enhanced dither routines
  90. and 24/8 Bit accuracy.
  91.  
  92. The following files are included on the disk:
  93.  
  94. "CanonBJ-EC"  -  The printer driver revision 1
  95. "CanonPref" -  A KS 2.0 (or higher) driver preferences program
  96. "Install"   -  Workbench install program for the CanonBJ-EC800 driver
  97. "Report"    -  A report program telling your preferences/driver settings
  98. "Readme"    -  The documentation file (and/or printed manual)
  99. "Dither-Settings" - a drawer of predefined dither matrices
  100. "Color-Settings"  - a drawer of predefined "color adjustments"
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                Highlights of the CanonBJC package
  108.                ----------------------------------
  109.  
  110.  
  111.  
  112.  
  113.  
  114. - ink compensation
  115. - color and greyscale adjustment. 256 shades for each color component!
  116.   You are able to print a color corrected picture without loosing any
  117.   colors. Using the color adjustment you can control gamma correction,
  118.   brightness and contrast, or filter colors. Again: this driver is
  119.   not limited to max. 4096 colors as usual Amiga drivers!
  120. - free definable dither routines. The driver allows you to enter
  121.   any dither matrix for rect. disperesed /clustered dithers. Many dither
  122.   routines are included.
  123. - builtin support for the arXon electronic centronic switch box
  124. - very fast graphic dumps
  125. - Seperations are supported by the driver.
  126. - automaticly uses improved code for 68020/30 processors if available
  127. - fully supports WB 1.3, 2.0 and 2.1(!)
  128. - all paper margins are definable
  129. - mirror printing for T-Shirts...
  130. - paper size is freely definable
  131. - comes with an extra KS 2.0 preferences program for controlling the driver
  132. - install program supplied
  133. - full documentation
  134. - free definable tab stops
  135. - job end signal
  136. - text color selectable
  137. - while normal printer drivers are limited to 16 shades of grey,
  138.   the CanonBJ-EC driver supports up to 256 shades of grey simultaneously
  139.   (SuperMode)!
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.                       System requirements
  147.                       -------------------
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154. The  CanonBJ-EC driver is compatible with the entire family of Amiga
  155. computers.   These  include  the  A500, A500+, A600, A1000, A2000,
  156. A2500,  A2500/30  and A3000 computers.  The driver was designed to
  157. run  under  Workbench  versions  1.3,  2.0 and 2.1.  The CanonPref
  158. program was designed to run under Workbench 2.0 and 2.1.
  159.  
  160. The CanonBJ-EC driver was designed for the Canon BJC800 printer.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                          Installation
  168.                          ------------
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175. 1. Setup  and connect your BJC-800 as described in the BJC-800 User's
  176.    Manual.
  177. 2. Also make sure the BJC printer is setup as following:
  178.  
  179.    Function                 Setting
  180.   
  181.    o Printing Mode          As Appropriate. Start trying with Mode A!
  182.    o Set Parameter
  183.      ->Color                set by Amiga preferences
  184.      ->Character Space      set by Amiga preferences
  185.      ->Condensed Mode       set by Amiga preferences
  186.      ->Page Length          set by Amiga preferences
  187.      ->Line Length          set by Amiga preferences
  188.      ->Select Font          As Appropriate; May be set by using CanonPref
  189.      ->Graphic Table        Graphics
  190.      ->International        set to USA!; the driver will handle all national
  191.                             characters automaticly.
  192.      ->AutoLF               set to OFF
  193.      ->CR Code              set to NO PRINT
  194.   
  195. 3. Boot your Amiga with your usual System Disk
  196. 4. Insert  the  Canon  Driver  Disk  and  select the appropriate
  197.    "Drawer" for the printer.
  198. 5. Double Click on the "Install" program. The "Install" program
  199.    will copy the driver on to the system disk and saves the default
  200.    settings for the driver in env: and if available envarc:.
  201.    If there is not enough free disk space to install the
  202.    printer driver a requester will pop up saying so. In this
  203.    case free up some disk space on your system disk by
  204.    deleting unused files.
  205. 6. Start Preferences on your system disk (if you own Kickstart
  206.    2.0 use the printer preference program). Select the CanonBJ-EC
  207.    driver and adjust all other preference parameters to your
  208.    environment. See your system manual for more information
  209.    about the preference program. 
  210. 7. In case you use Workbench 2.0 (or higher) use the mouse to drag
  211.    the CanonPref, Color-Settings and Dither-Settings icon into your
  212.    Workbench prefs drawer. If your Workbench disk does not allow
  213.    this because no space is left on disk, you can simply drag the
  214.    programs to any other wanted drawer.
  215. 8. Start the Workbench "PrinterGfx" program and enable
  216.    "Order" dither, "Color" with density 7.
  217. 9. Start the Workbenh "Printer" preferences program.
  218.    Set the Page Length to 250 lines. This enables the
  219.    automatic page size setting of the driver.
  220. 10. Enter your application program and try printing. Have fun!
  221.  
  222.  
  223. Note:   the  install  program  will  erase  any previously
  224. installed CanonBJ-EC drivers and settings without asking you so.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                       Workbench Preferences
  232.                       ---------------------
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239. While  the Workbench preferences program is described in detail in
  240. your  system  manual,  there are three settings which belong to the
  241. driver documentation:
  242.  
  243. Density:
  244.  
  245. The driver supported graphic densities:
  246.  
  247. In mode Epson24:
  248.  
  249. Density   X-DPI    Y-DPI   X*Y-DPI
  250.  1         180     360       64800       (no color corrections...)
  251.  2         360     360      129600       (no color corrections...)
  252.  3         180     180       32400
  253.  4         120     180       21600
  254.  5         180     360       64800
  255.  6         360     180       64800        
  256.  7         360     360      129600
  257.  
  258. In mode Epson48:
  259.  
  260. Density   X-DPI    Y-DPI   X*Y-DPI
  261.  1         180     360       64800        48 pin mode (no color corrections...)
  262.  2         360     360      129600        48 pin mode (no color corrections...)
  263.  3         180     180       32400
  264.  4         120     180       21600
  265.  5         180     360       64800        48 pin mode
  266.  6         360     180       64800
  267.  7         360     360      129600        48 pin mode
  268.  
  269. In mode CanonBJC:
  270.  
  271. Density   X-DPI    Y-DPI   X*Y-DPI
  272.  1         180     180       32400        (no color corrections...)
  273.  2         360     360      129600        (no color corrections...)
  274.  3         180     180       32400
  275.  4         180     180       32400
  276.  5         180     180       32400
  277.  6         360     360      129600        
  278.  7         360     360      129600
  279.  
  280. The  desired density can be selected in Preferences or in case you
  281. use  Workbench  2  "PrinterGfx".   Most  application programs also
  282. allow you to select the density before doing a graphic dump.  This
  283. setting overrides temporarily the preferences density setting.
  284.  
  285. Paper Size:
  286.  
  287. Under  Workbench 2 and 2.1 (or later) this driver supports the new
  288. introduced papersizes.  Selecting paper sizes not supported by the
  289. printer device or the driver might need some knowledge.  So here a
  290. small  list on how to set most common paper sizes on a CanonBJC800
  291. printer.   Note:   the settings differ for other printers, but you
  292. mights start trying with these settings.
  293.  
  294. Specialy  CanonBJC800  users  should  note,  that  the CanonBJC800
  295. printer  is  a  single page printer.  The printer does not support
  296. endless  paper. Because of this you MUST define a page length! The
  297. way  how  this must be done depends on what emulation you use:
  298.  
  299. Epson  mode  - the page length can be defined by setting CanonForm
  300. to  ON  and defining the number of lines per page in preferences as
  301. 250  or  the  real  page  length.   Setting  page length to 250 is
  302. recommended.   In  this case the printer driver itself chooses the
  303. optimal page length for your selected paper size. For instance if
  304. you  select  DIN  A4  and  a  page length of 250 lines, the driver
  305. automaticly  chooses 65 lines per page at 6 lines per inch.  Note:
  306. the  CanonBJ-EC  Epson  emulation  stores the page length in inches.
  307. Because of this, small changes to the page length might not affect
  308. the output.
  309.  
  310. In  CanonBJC  mode,  the  driver  automaticly sets the page length
  311. similar  to  the  Epson modes "250" lines mode.  In CanonBJC mode,
  312. the  printer  is  able  to print on a greater area.  Also the page
  313. length can be defined in 1/10 accuracy. Again: use the CanonBJC
  314. mode for graphic dumps.
  315.  
  316. Note:   setting  paper  size  to  FANFOLD  automaticly defines the
  317. maximal page length of 22inch.
  318.  
  319. Note:   you  can  define your own page size by using the CanonResY
  320. and CanonResX under any emulation.
  321.  
  322. PaperType:
  323.  
  324. A  papertype  of  SINGLE will eject a sheet with a Form Feed after
  325. every  print.  Form Feed after a graphic dump is sent according to
  326. the  SPECIAL_NOFORMFEED  flag.   You can use the FANFOLD papertype
  327. setting  to force several dumps to appear on the same page.  Also,
  328. if you need to run InitPrinter often, you may choose the papertype
  329. FANFOLD to avoid printing empty pages. In BJC mode, FANFOLD sets
  330. the page height to the maximum size of 22 inch (55,88cm).
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                      The Driver in detail
  339.                      --------------------
  340.  
  341.  
  342.  
  343.  
  344.  
  345. Now  that  you have installed and adjusted the driver, printer and
  346. preference  setting,  there  are some details you should know when
  347. using the driver.
  348.  
  349. This   driver  automatically  checks  for  the  processor  in  use
  350. (68000,68010   or   68020,68030,68040)  and  optimizes  the  print
  351. routines  accordingly.   Because  of  this, there is no need for a
  352. special .020 version of the driver in order to get the most out of
  353. your turbo amiga.
  354.  
  355. Aborting  printing  may  often  leave  the  printer  in an unknown
  356. status.  This causes erronious printing on the next dump.  In case
  357. you  abort printing, also switch your printer off and on. Also run
  358. InitPrinter in order to bring back the printer in a known status.
  359.  
  360.  
  361.  
  362. The driver supports the unique Amiga commands shown below:
  363.  
  364. Name        Escape sequence        Function         Defined By
  365. aRIS             ESCc               reset              ISO
  366. aRIN             ESC#1           initialize           Amiga
  367. aIND             ESCD                lf                ISO
  368. aNEL             ESCE            return,lf             ISO
  369. aSGR0            ESC[0m        normal char set         ISO
  370. aSGR3            ESC[3m          italics on            ISO
  371. aSGR23           ESC[23m         italics off           ISO
  372. aSGR4            ESC[4m         underline on           ISO
  373. aSGR24           ESC[24m        underline off          ISO
  374. aSGR1            ESC[1m         boldface on            ISO
  375. aSGR22           ESC[22m        boldface off           ISO
  376. aSFC             SGR30-39    set foreground color      ISO
  377. aSHORP0          ESC[0w         normal pitch           DEC
  378. aSHORP2          ESC[2w           elite on             DEC
  379. aSHORP1          ESC[1w           elite off            DEC
  380. aSHORP4          ESC[4w        condensed fine on       DEC
  381. aSHORP3          ESC[3w         condensed off          DEC
  382. aSHORP6          ESC[6w          enlarged on           DEC
  383. aSHORP5          ESC[5w          enlarged off          DEC
  384. aDEN6            ESC[6"z       shadow print on         DEC
  385. aDEN5            ESC[5"z       shadow print off        DEC
  386. aDEN4            ESC[4"z       doublestrike on         DEC
  387. aDEN3            ESC[3"z       doublestrike off        DEC
  388. aDEN2            ESC[2"z           NLQ on              DEC
  389. aDEN1            ESC[1"z           NLQ off             DEC
  390. aSUS2            ESC[2v        superscript on         Amiga
  391. aSUS1            ESC[1v        superscript off        Amiga
  392. aSUS4            ESC[4v         subscript on          Amiga
  393. aSUS3            ESC[3v         subscript off         Amiga
  394. aSUS0            ESC[0v      normalize the line       Amiga
  395. aPLU             ESCL          partial line up         ISO
  396. aPLD             ESCK         partial line down        ISO
  397. aFNT0            ESC(B  Typeface  0 (default): Courier DEC
  398. aFNT1            ESC(R     Typeface  1  Sans Serif     DEC
  399. aFNT2            ESC(K     Typeface  2  Roman          DEC
  400. aFNT3            ESC(A        Typeface  3              DEC
  401. aFNT4            ESC(E        Typeface  4              DEC
  402. aFNT5            ESC(H        Typeface  5              DEC
  403. aFNT6            ESC(Y        Typeface  6              DEC
  404. aFNT7            ESC(Z        Typeface  7              DEC
  405. aFNT8            ESC(J        Typeface  8              DEC
  406. aFNT9            ESC(6        Typeface  9              DEC
  407. aFNT10           ESC(C        Typeface 10              DEC
  408. aPROP2           ESC[2p       proportional on         Amiga
  409. aPROP1           ESC[1p       proportional off        Amiga
  410. aJFY5            ESC[5 F      auto left justify        ISO
  411. aJFY7            ESC[7 F      auto right justify       ISO
  412. aJFY6            ESC[6 F      auto full justify        ISO
  413. aJFY0            ESC[0 F      auto justify off         ISO
  414. aJFY1            ESC[1 F      word fill(auto center)   ISO
  415. aVERP0           ESC[0z       1/8" line spacing        +++
  416. aVERP1           ESC[1z       1/6" line spacing        +++
  417. aSLPP            ESC[nt      set form length n         DEC
  418. aPERF            ESC[nq       perf skip n (n>0)       Amiga
  419. aPERF0           ESC[0q         perf skip off         Amiga
  420. aSLRM            ESC[Pn1;Pn2s   L&R margin             DEC
  421. aCAM             ESC#3         Clear margins          Amiga
  422. aTBC3            ESC[3g       Clear all h tabs         ISO
  423. aTBC4            ESC[4g        Clr all v tabs          ISO
  424. aTBCALL          ESC#4       Clr all h & v tabs       Amiga
  425. aTBSALL          ESC#5        Set default tabs        Amiga
  426. aRAW             ESC[Pn"r Next 'Pn' chars are raw     Amiga
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                        The CanonPref Program
  434.                        ---------------------
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441. Beside  all  the functions mentioned in the chapter "The Driver in
  442. detail",  there  are  some  more  options  unique  to the CanonBJ-EC
  443. driver.   These  options are controlled using commodore's standard
  444. environment  variables.   Those  variables can be set by using the
  445. CLI setenv command, or by using the CanonPref preferences program.
  446.  
  447. CanonPref  provides  a nice and intuitive user interface and needs
  448. at  least  Workbench  2 to run.  In case you don't use Workbench 2
  449. (V37  and  above), see the chapter "Environment options" on how to
  450. control  the  special options with a Kickstart 1.3 system.  If you
  451. don't  use these options, default values will be used.  The driver
  452. will read the arguments set by CanonPref on opening.
  453.  
  454. Note:   changes  to the options may not take place immediatly!!!!
  455. The  options  take  place with the next send aRIN or aRIS command.
  456. You  can send an aRIN command by using Initprinter or flushing the
  457. driver  out  of  memory  (WShell  users may use "Flush"; Commodore
  458. users  may  use the "Stack 40000000" command in order to do this).
  459. CanonPref  automatically flushes the driver out of memory for you.
  460. So  this  note  is  specialy  importent  for  CLI  users not using
  461. CanonPref.
  462.  
  463. CanonPref  can  be  controlled by the mouse and/or keyboard.  Each
  464. gadget  of the main program corresponds to the underscored letter.
  465. Pressing  that letter is equivalent to clicking on the gadget.  In
  466. the  case  of  a cycle gadget, you can use the upper or lower case
  467. letter  to  cycle  back  and  forth between them.  See your system
  468. manual  on  how to control the file- and fontrequester by keyboard
  469. or mouse.
  470.  
  471. All  windows  are opened directly under your mouse pointer, so you
  472. don't  have  to  move or scroll the screen to control the program.
  473. Also,  all  windows  are opened on the default public screen.  You
  474. may  specify  a  special  public  screen  by setting the Tool Type
  475. "PUBSCREEN=<screenname>"   (name   is  case  sensitive!)  and  the
  476. CanonPref  program  will  open  it's  windows  on your application
  477. programs  screen.   You  can  specify  a  screen from CLI with the
  478. PUBSCREEN option:
  479.  
  480.                    CanonPref PUBSCREEN <screenname>
  481.  
  482. For  instance,  if you use the ASDG text editor "CygnusEd" you may
  483. specify  "CanonPref  PUBSCREEN CygnusEdScreen1" and CanonPref will
  484. open  up  its  windows on the CEDPro screen.  Make sure the CEDPro
  485. screen is public before running the example.
  486.  
  487. After  starting,  the  main  window  will contain several gadgets,
  488. described  in  detail.  All those gadgets represent an environment
  489. variable  which  can  also  be  controlled  using  the  CLI setenv
  490. command.   I strongly recommend using CanonPref because it is user
  491. friendly and more secure.
  492.  
  493. CanonPref  is  font  independent.   It  uses  any  system font for
  494. displaying  the  gadgets  and windows.  You can force CanonPref to
  495. use  the  topaz 8 font under any circumstand by defining a "TOPAZ"
  496. Tool Type.  This is equal to using a "TOPAZ" CLI argument.
  497.  
  498. Handling  CanonPref  is not described in this readme file.  I feel
  499. there is simply nothing to describe.  This program is very easy to
  500. handle  and  to  understand.  In case you have problems, read your
  501. system  manuals.  These manuals cover nearly every aspect required
  502. to  control  the  CanonPref  program.  There are some basic things
  503. about  this driver, that should be explained in extra chapters and
  504. subsections.  These chapters/subsection will now follow...
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.                        The basics of printing
  512.                        ----------------------
  513.  
  514. This  chapter  describes the basic things needed for understanding
  515. the  way  this  driver  works.   There  are  several main steps in
  516. processing a color picture for printing.  Let's have a look at the
  517. processing steps:
  518.  
  519.  
  520.                               Picture
  521.  
  522.                                 ||
  523.                                 \/
  524.  
  525.                           Color Adjustment
  526.  
  527.                                 ||
  528.                                 \/
  529.  
  530.                           Ink compensation
  531.  
  532.                                 ||
  533.                                 \/
  534.  
  535.                              UCR / GCR
  536.  
  537.                                 ||
  538.                                 \/
  539.  
  540.                              Dithering
  541.  
  542.                                 ||
  543.                                 \/
  544.  
  545.                               Printer
  546.  
  547.  
  548.  
  549. Each step will now be described in an extra subsection:
  550.  
  551.  
  552.  
  553. I.
  554.  
  555.  
  556.                          Color Adjustment
  557.                          ----------------
  558.  
  559. Most  Amiga  drivers  simply  use  a  linear tone scale adjustment
  560. function for every picture.  This means the amount of printed dots
  561. on your printer is directly proportional to the tone scale of your
  562. picture.   The  brightness  of  printed  picture  using  a  linear
  563. adjustment  function  is often not satisfying.  There are two main
  564. reasons for this:
  565.  
  566. -  the tone scales shown on your monitor are not linear.  For
  567. instance,  the  difference  between two neighboring dark greyscale
  568. levels is not as big as between to brighter levels.
  569.  
  570. - the Canon BJ printers have a precise printerhead movement.  This
  571. gives  you  the possibility to print 360 dots per inch (dpi).  But
  572. there  is  one  drawback,  which most printers have:  a 1/360 inch
  573. huge  dot  can  not  be  printed.  The dot is a bit greater, which
  574. causes the dots to overlap each other.  This causes a dark printed
  575. picture and a loss of contrast.
  576.  
  577. To  compensate  these affects, the CanonBJ-EC driver allows you to
  578. customize  and adjust the tone scale adjustment function.  You can
  579. also  do  some art work (for instance pseudo colors) by using this
  580. function.
  581.  
  582. The  Amiga  printer.device  supports up to 16 color levels.  These
  583. levels  are  represented  by  values  from  0 (no ink of black for
  584. greyscale  pictures)  to  255  (full  ink  or  white for greyscale
  585. pictures).  Now let's have a look at the default linear conversion
  586. function:
  587.  
  588.  
  589.  
  590.   full ink or|white                        230
  591.              |                           214        
  592.           208| <- <- <- <- <- <- <- <- 208
  593. O            |                       192^
  594.              |                     176  |
  595. U            |                   160
  596.              |                 144      ^
  597. T            |                128       |
  598.              |              112
  599. P            |            96            ^
  600.              |          80              |
  601. U            |        64
  602.              |      48                  ^
  603. T            |    32                    |
  604.              |  16
  605.  no ink/black|0                         ^
  606.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  607.         no ink/black                   208 full ink or white
  608.  
  609.  
  610.                        I N P U T
  611.  
  612.  
  613.  
  614. As  you  can  easily  see,  every  tone  level is unchanged by the
  615. adjustment  function.   For instance, a value of 208 is unchanged.
  616. Now  we  could  simply  increase  the brightness of the output, by
  617. simply adding 16 to each value:
  618.  
  619.  
  620.        bright|
  621.              |                           214+230        
  622.           214| <- <- <- <- <- <- <- <- 208
  623. O            |                       192^
  624.              |                     176  |
  625. U            |                   160
  626.              |                  144     ^
  627. T            |                128       |
  628.              |              112
  629. P            |            96            ^
  630.              |          80              |
  631. U            |        64
  632.              |      48                  ^
  633. T            |    32                    |
  634.              |  16
  635.              |0                         ^
  636.  no ink/black|                          |
  637.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  638.           no ink/black                 208 full ink or white
  639.  
  640.                        I N P U T
  641.  
  642. Now  the  value  of  208  would be printed as 214.  A drawback for
  643. brightening  up a picture this way is the value 214 and 230.  Both
  644. levels  would  be  printed  with the same value of 230 which means
  645. white.   A  better  method  to  brighten  up  a picture is a gamma
  646. correction  function.   The  "gamma"  function  provides  a way to
  647. significantly brighten an image without losing much detail.
  648.  
  649. You can control gamma correction, brightness and contrast by using
  650. the sliders at the left side of the color adjustment window of the
  651. CanonPref program. Adjust them and press the "Set" buttom.
  652.  
  653. You can also individually adjust each of the 16 color sliders
  654. instead.
  655.  
  656. Using the color adjustment function, you are also able to
  657. filter out parts of a picture with a special color. Just try and
  658. I'm sure you'll be satisfied.
  659.  
  660. IMPORTANT:   while  each  of the 16 sliders can be adjusted to 256
  661. shades, it depends on the used dither routines wether you are able
  662. to  print  256  shades or not.  Please, have a look at the "dither
  663. routines"   subsection   for  more  information.   The  number  of
  664. printable  colors  depends  on  the colors supported by the dither
  665. matrix.   Normal  Workbench printer drivers only support 16 shades
  666. for each color (16*16*16 = max. 4096 colors).
  667.  
  668. To  make  sure  your  color  adjustment and dither routines do not
  669. result  in  a  loss  of colors, print the supplied "TEST.PIC" from
  670. your  usual  application  program.  Each color component should be
  671. printed with 16 distinguishable color shades.
  672.  
  673.  
  674.  
  675.  
  676. II.
  677.  
  678.  
  679.                          Ink compensation
  680.                          ----------------
  681.  
  682. This  driver  also  offers  the user complete control over its ink
  683. compensation  function.   Printer's  inks  are not completely pure
  684. materials.  For example, there is some amount of yellow mixed into
  685. the  magenta  ink.   And,  there  is  some amount of magenta which
  686. unavoidably is found in the cyan ink.  The ink compensation values
  687. will  correct for these impurities.  With Magenta Compensation you
  688. define  the  amount  of  magenta in the cyan ink in percent.  With
  689. Yellow Compensation you define the amount of yellow in the magenta
  690. ink in percent.
  691.  
  692. In  general,  set  the  ink  compensation value of magenta 31% and
  693. yellow to 40% for best results with Inkum Inks.
  694.  
  695. PS:   on  my  experience  15%  gives better violet shades with the
  696. original  Canon  BJC800  inks, but again...  it's best you ask the
  697. manufacturor of the ink for the right values.
  698.  
  699. NOTE:  The ink compensation function can be completely disabled by
  700. turning  it  ``off''  using density 1 or 2 for printing (or define
  701. 0%)  You will notice that without the ink compensation function, a
  702. blue sky will print as purple.  With the ink compensation function
  703. set at 31%, blue skies are blue again.
  704.  
  705. CanonStudio,  ADPro  and TruePrint users should use density 1 or 2
  706. for printing graphics.
  707.  
  708.  
  709. III.
  710.  
  711.                              UCR/GCR
  712.                              -------
  713.  
  714. UCR/GCR  is  used to replace colors with a black component, giving
  715. you  better  greyshades  and  more  contrast.   You have no direct
  716. control  over the UCR/GCR function of the printer driver.  Though,
  717. using  the  black  component  of  the  color adjustment and dither
  718. routines,  you  have  some  control  on the UCR/GCR function.  The
  719. Halftone-B  matrices  are a nice examples of how to handle UCR/GCR
  720. when developing a dither matrix.
  721.  
  722.  
  723.  
  724. IV.
  725.  
  726.  
  727.                           Dither Routines
  728.                           ---------------
  729.  
  730. Many  dithering  methods are supplied with the CanonBJ-EC package.
  731. These are described below.  In each case a larger dither mask size
  732. produces  a  print which can represent a wider range of colors but
  733. will  produce  less  spatial  information  per unit area of paper.
  734. Conversely,  a smaller dither mask size can reproduce fewer colors
  735. (or  shades)  but more closely approximates the true resolution of
  736. your printer.
  737.  
  738. Another  way  of  expressing  this  is  the following:  There is a
  739. tradeoff  between printing ``lots'' of colors and printing in high
  740. resolution.    Given  a  specific  printer  with  a  specific  DPI
  741. capability,  asking  for  ``lots''  of colors means using a larger
  742. dither  mask  size.   A  larger dither mask size cuts down on your
  743. effective  resolution.  For instance, using a dither mask of 16*16
  744. on  your 360dpi printer will result in 360/16 = 22.5 dpi with full
  745. color information.
  746.  
  747. Note  that  this can work to your advantage when blowing a picture
  748. up  in  size.  Blowing up a picture means that there are more dots
  749. to  work  with  which  offsets  the loss in resolution caused by a
  750. larger  dither mask size.  This added to the benefits to be had by
  751. being  able  to  reproduce more colors (or shades) means that your
  752. enlarged posters will look quite good.
  753.  
  754. Also note that many printers including most laser printers and dot
  755. matrix  printers  have  considerable dot gain.  For example, a 360
  756. DPI  laser printer does not actually print dots which are 1/360 of
  757. an  inch  in  size.   Rather,  its dots will be much larger.  This
  758. causes  some  dithers,  such  as  the  Floyd-Steinberg and Ordered
  759. dithers,  to  produce  intensely  over-saturated  or muddy prints.
  760. Other  dithers  such  as  the  two  halftone dithers overcome this
  761. problem with low-end printers.
  762.  
  763. NOTE:   The  amount of printable colors is usualy directly related
  764. to  the  size of the dither matrix.  The dither routines described
  765. below  usualy  exists  in  several sizes.  You can distinguish the
  766. dither  routines  by  their filenames.  For instance a filename of
  767. "Halftone-A-4" means:  Halftone A dither routine, 4 shades.  While
  768. "Halftone-A-256" means:  Halftone A dither routine, 256 shades.
  769.  
  770. NOTE:   The  dither routines can be completely disabled by turning
  771. it ``off'' using density 1 or 2 for printing.  Also note, that the
  772. custom  dither routines are only active when Workbench preferences
  773. is set to "ordered" dither!!!!!!!!
  774.  
  775. ADPro,  CanonStudio  or  TruePrint users should use density 1 or 2
  776. for printing graphics with ADPro.
  777.  
  778. To  make  sure  your  color  adjustment and dither routines do not
  779. result  in  a  loss  of colors, print the supplied "TEST.PIC" from
  780. your  usual  application  program.  Each color component should be
  781. printed   with  16  distinguishable  color  shades.   We  strongly
  782. recommend the use of a 64 color dither matrix.  This matrix allows
  783. the driver to do ink compensation, color adjustment with nearly no
  784. limitations.
  785.  
  786. Also,  if  you want to read more about dither routines and digital
  787. halftoning, here is a very good book to go for:
  788.  
  789. Robert Ulichney
  790. "Digital Halftoning"
  791. MIT Press
  792. ISBN 0-262-21009-6
  793.  
  794. The  book  is  easy  to  understand  and  does  come with lot's of
  795. samples.   Most of the dither routines described below are handled
  796. in  detail  in  this  book.   Surely one of the best books when it
  797. comes to digital halftoning.
  798.  
  799.  
  800. Now let's take a look at the supplied dither routines.
  801.  
  802.  
  803.               Halftone-A - <number of colors>
  804.               Halftone-B - <number of colors>
  805.  
  806.  
  807. The  halftone  dithers  (Halftone-A  and Halftone-B) differ in how
  808. they place a halftone matrix.
  809.  
  810. This  is the classical clustered halftone method used by most book
  811. publishers.   To improve the dither output, the halftone matrix is
  812. rotated  by  45 degree.  Halftone-A causes the halftone matrix for
  813. each  of  the  primary colors to be centered about the same point.
  814. This  means  that  the  primary  colors  will  overlap completely,
  815. leaving  a  lot  of  white  paper  showing  through.   This may be
  816. appropriate for some better dye sublimation type printers or other
  817. color printers with good registration where the inks mix well.
  818.  
  819. Halftone-B,  on  the  other  hand, staggers the halftone matrix of
  820. each  primary  color so that they do not overlap.  This is similar
  821. in  concept  to traditional color offset printing.  Halftone-B may
  822. produce better results on printers whose inks do not mix well, and
  823. on printers with less than perfect registration.
  824.  
  825. The  halftone  dithers can produce some extremely good results and
  826. compensate  for  the  dot  gain problems outlined above.  Try both
  827. halftone  dithers  to  see which one is better for your particular
  828. intention.
  829.  
  830. Also, in case you xerox your printing, using Halftone results in a
  831. much better copy.
  832.  
  833. To  use  Halftone-B  is  somehow  different  to  the  other dither
  834. matrices.   You  have  a  special  dither  matrix  for each color.
  835. Because of this, each dither filename includes the abbreviation of
  836. the  color  (C  =  cyan,  Y  =  yellow,  M = magenta, K = black or
  837. greyscale).   In case you use Halftone-B you also have to increase
  838. the  brightness  of  the  black  color  component by 50%.  Use the
  839. bright+ gadget in the CanonPref program for increasing brightness.
  840.  
  841. Halftone-B is a nice example for the relationship between color
  842. adjustment and dither routines. You have to consider both setting
  843. up your driver.
  844.  
  845.  
  846.  
  847.  
  848.             PrtDevice-Halftone-16
  849.             PrtDevice-Ordered-16
  850.  
  851.  
  852.  
  853. This dither matrix is the one used by the printer devices
  854. "Halftone" or "Ordered" dither.
  855.  
  856.  
  857.  
  858.                  Ordered-A - <number of colors>
  859.  
  860.  
  861.  
  862. The  ordered  dither produces a regular repeating pattern which is
  863. often  used for printing computer graphics.  The ordered dither is
  864. particularly  susceptible  to  over-saturation  due to dot gain in
  865. high resolutions. Though, you surely get nice outputs in 180DPI.
  866.  
  867.  
  868.                  Ordered-B - <number of colors>
  869.  
  870. This  dither  is  a mixture of a dispersed dither like Order and a
  871. clustered  dither like Halftone.  The dither is specialy addressed
  872. to  the  high  resolution  printers  with  dot gain problems.  For
  873. instance,   if   you  print  a  picture  with  360*360  dpi  using
  874. Ordered-Rect-B-64, you get a picture that seems to be printed with
  875. 180*180  dpi.   Now  while  graphics are printed emulating 180*180
  876. dpi,  all  black  parts  of the picture are printed using 360*360.
  877. Don't  be  confused,  the  printed  picture  is  still better than
  878. a     picture     in     real    180*180dpi    resolution.     The
  879. Ordered-Rectangular-B is specialy usefull for color DTP. You get
  880. nice color pictures with fine high quality text.
  881.  
  882.  
  883.  
  884.             Spiral-Dot-Screen  - <number of colors>
  885.  
  886.  
  887. A  wide  range  of  special  effects clustered dither matrices are
  888. available  in  the  graphic  arts  industry  and  all  are  easily
  889. simulated digitally.  Spiral-Dot is such a dither.
  890.  
  891. The spirol-dot dither is essentially half of the classical screen,
  892. with   dark   squares  growing  to  fill  the  plane  without  the
  893. laternating  light squares.  Spiral-Dot looks quiet similar to the
  894. Halftone-A matrix 0 degree rotated.
  895.  
  896.  
  897.  
  898.             Horizontal  - <number of colors>
  899.             Vertical    - <number of colors>
  900.             FwdDiagonal - <number of colors>
  901.             BckDiagonal - <number of colors>
  902.  
  903.  
  904. A  wide  range  of  special  effects clustered dither matrices are
  905. available  in  the  graphic  arts  industry  and  all  are  easily
  906. simulated digitally.  The Line dithers are such dithers.
  907.  
  908. The  horizontal  (as  well  as  the vertical, forward diagonal and
  909. backward  diagonal)  dither overcome much of the dot gain problems
  910. that the Floyd and Ordered dithers have with inexpensive printers.
  911. These  dithers  (especialy  the  diagonal dithers) are especialy
  912. good for large printings.
  913.  
  914.  
  915.  
  916.                            SuperMode
  917.                            ---------
  918.  
  919. SuperMode?   With  SuperMode  enabled, every color picture will be
  920. printed  as  greyscale picture in case you select color instead of
  921. greyscale  as  output  mode.   So,  what's  the difference between
  922. SuperMode's  printed  greyscale pictures and normal greyscale mode
  923. pictures?    In  SuperMode  it's  the  printer  drivers  task to
  924. convert  color  data  into greyscale data.  While this can also be
  925. done  by  the  printer  device  instead of the driver (like normal
  926. Workbench    drivers    do),   the   CanonBJ-EC   printer   driver
  927. color->greyscale  converting  routines are more precise and because
  928. of  this  you  can  print  a 4096 color HAM picture with up to 256
  929. greyshades  instead  of the normal 16 shades.  Again:  in case you
  930. want  to  print  more than 16 shades (and that's what SuperMode is
  931. all  about)  you  MUST  define a custom dither matrix in CanonPref
  932. that allows to print more than 16 shades.
  933.  
  934. With   SuperMode   enabled  you  simply  print  from  your  normal
  935. application  but instead of selecting Greyscale or B/W output mode
  936. you select Color.  The Color->Greyscale conversion will be done by
  937. the driver.
  938.  
  939.  
  940.  
  941.  
  942.                      Environment Options
  943.                      -------------------
  944.  
  945.  
  946.  
  947.  
  948. You  can  set  options  for  the  driver by using the "setenv" CLI
  949. command instead of the CanonPref program.  This command saves your
  950. option  in  the  "ENV:"  directory  using a file.  See your system
  951. manual  for  a  complete  description of the "setenv" and "getenv"
  952. command.   The  driver  will  read in the arguments on opening the
  953. printer  device.  In case you don't have enough memory, the driver
  954. refuses to open.
  955.  
  956. Note:   reading  the  options does not always mean they take place
  957. immediately.  So if you make changes by using "setenv", flush the
  958. driver  out  of  memory in order to let the driver know about your
  959. changes.  CanonPref will do this for you automatically.
  960.  
  961. Remember  that  environment  vars  (they  are stored in the "ENV:"
  962. directory)  are  normaly  erased by booting.  If you don't want to
  963. set  the  environment vars every time you boot, you can place them
  964. in  "ENVARC:"  (Workbench  2.0/2.1)  or  assign  "ENV:"  to  a non
  965. volatile  disk (KS 1.3).  Make sure you use the commodore "setenv"
  966. command  to set the environment vars!  Under KS 2 (or higher), the
  967. driver supports local and global environment vars!  Here is a list
  968. of  the  possible options and their meaning.  As usual, everything
  969. is case insensitve:
  970.  
  971.              SetEnv sbox_printer <0|1|2|3>  (Default: 0)
  972.  
  973. The  driver  supports  the  arXon  parallel switch box.  The arXon
  974. switch  box is an external 1 to 3 centronics switch controlable by
  975. software.   You  can  ask  the  driver  to automaticly switch to a
  976. wanted  port  for  printing and switch back to the previously used
  977. port after printing.  This enables you to use a scanner, digitizer
  978. and  printer  from  your  Amigas centronics port without switching
  979. between the devices "by hand".  Specify the wanted printer port in
  980. "sbox_printer"  and the default port (which should be set up after
  981. printing)  in  "sbox_active".   If  you specify 0 (default) as the
  982. port, no switching will take place.
  983.  
  984. Note:   "sbox_active" MUST be specified before using the driver in
  985. order  to  enable  the  "sbox_printer"  command.   This is because
  986. "sbox_active"  is  used  to  determine  weather  a  switch  box is
  987. installed or not.   Information  about  the  switch  box  can be
  988. obtained from:
  989.  
  990.                           arXon GmbH
  991.                       Assenheimer Str. 17
  992.                       D-W-6000 Frankfurt
  993.                             Germany
  994.                     Tel:  (++49)-69-7896891
  995.                     Fax:  (++49)-69-7896878
  996.  
  997.  
  998.               SetEnv CanonBeep  0|1|2|3  (Default: 0)
  999.  
  1000. If  the  printer device gets closed after a dump, you can tell the
  1001. driver to signal you the end of the print job.  This is especialy
  1002. usefull on huge graphic dumps which might require some time.  There
  1003. are  two  kinds  of signals.  You can cause a beep (CTRL-G) on the
  1004. printer, a DisplayBeep on the Amiga or both. When the printer is
  1005. set to CanonBJC mode, a printer beep is not possible and ignored.
  1006.  
  1007.                       0 = No Action (default)
  1008.                       1 = Printer beep (CTRL-G)
  1009.                       2 = DisplayBeep
  1010.                       3 = Printer beep + DisplayBeep
  1011.  
  1012. Note:    some   application   print   graphics  striped.   If  the
  1013. application  program closes the printer.device after every stripe,
  1014. you  will get a signal for each stripe.  So far, I havn't found an
  1015. application program with such bad behaviour.
  1016.  
  1017.                   SetEnv CanonResX <num>  (Default: 0 dots)
  1018.  
  1019. If  the preferences papersize is CUSTOM, this option allows you to
  1020. specify   the   horizontal  resolution  for  graphic  dumps.   For
  1021. instance,  if  you use Workbench 1.3, you can specify a resolution
  1022. of 2804 dots, which is equal to the DIN A4 size.  If you specify 0
  1023. (default)  as  resolution,  the  US-LETTER resolution of 2880 dots
  1024. will be used.  The allowed range for <num> is 0 to 65535 dots.
  1025.  
  1026.                   SetEnv CanonResY <num>  (Default: 0 dots)
  1027.  
  1028. If  the papersize is CUSTOM, this option allows you to specify the
  1029. vertical  size  of a page for graphic dumps.  For instance, if you
  1030. use Workbench 1.3, you can specify a resolution of 3950 (BJC mode:
  1031. 4212) dots, which is equal to the DIN A4 size. Do not misinterpret
  1032. this  setting!  The CanonResY value is only used for grapihc dumps
  1033. and  does  not  necessarily mean, your picture will be of the size
  1034. you specified here.  Sometimes CanonResY is only used to calculate
  1035. the aspect of the final picture.
  1036.  
  1037. The  CanonResY  setting  is  not necessarily importent under Epson
  1038. mode,  though  under  CanonBJC  the  value  becomes  an  importent
  1039. meaning.  The printer must know the physical page size in CanonBJC
  1040. mode  to  print  graphics.  Under CanonBJC mode CanonResY reflects
  1041. the physical page size, not the maximum printable area of the page
  1042. (logical  page  size).  The maximum allowed size for CanonBJC mode
  1043. is  7920  dots.  A value of 0 is equal to 11 inch (3960 dots).  If
  1044. you  want  to  set  the  physical page size in Epson mode, see the
  1045. CanonForm description.
  1046.  
  1047. For   more   information   see   the  "Paper  Size"  and  CanonEmu
  1048. description.
  1049.  
  1050.                   SetEnv CanonTime <num>  (Default: 0 seconds)
  1051.  
  1052. In  case  huge  amounts  of  data  are  transfered to the printer,
  1053. rendering a picture by the device is much faster than the transfer
  1054. of  the  picture  to  the  printer.  A requester may appear on the
  1055. screen,   saying  "Printer  trouble...".   The  requester  appears
  1056. because  the  printer device thinks no data got transfered because
  1057. of  a hard- or software failure.  With "CanonTime" you can specify
  1058. a  timeout until the printer device brings up the error requester.
  1059. The  "CanonTime"  var is especialy usefull when printing multiple
  1060. pages  or downloading huge fonts, using the drivers automatic font
  1061. download abilty.  If you specify 0 (default) as timeout, a timeout
  1062. of  30  seconds  will  be  used.  A value from 1 to 999 seconds is
  1063. allowed.   Instead  of  defining  a huge timeout, there is another
  1064. solution  available:   use  the  "CMD"  program (see you Workbench
  1065. disk)  to  redirect  the parallel/serial output to a file on disk.
  1066. After  this, use the copy command or a printer spooler to copy the
  1067. file  to  "par:".   Using this technique, you can safely specify a
  1068. small number of seconds before a timeout.
  1069.  
  1070.                  SetEnv CanonType <num>  (Default: 0)
  1071.  
  1072. Specifies the typeface to be selected on aRIS, aRIN and aFNT0.  If
  1073. you  select 0 (default) as typeface, the internal typeface will be
  1074. selected.   If an external font cartridge is selected without font
  1075. cartridge  installation,  the  printer  is  set to offline and the
  1076. specified font indicator blinks.  At the time of this writing, the
  1077. typefaces in table below are supported by the CanonBJC800 printer.
  1078.  
  1079.  <num>                 Meaning
  1080.    0          printer default internal typeface
  1081.    1                    Roman
  1082.    2                 Sans Serif
  1083.    3                   Courier
  1084.  
  1085. <num> may be in range of 0 to 255. Because of this, you may set
  1086. any wanted type supported by your printers ESC-k-<num-1> command.
  1087.  
  1088.        SetEnv CanonTab <num1-32>  (Default: 9, 17, 25,...)
  1089.  
  1090. This  environment  let  you  customize  the  horizontal  tab stops
  1091. settings  of  your  printer.  This is usefull for printing program
  1092. listings  and  tables.   For instance:  you can change the default
  1093. tab stops settings:
  1094.  
  1095.          1         2         3         4         5
  1096. 12345678901234567890123456789012345678901234567890
  1097.         T       T       T       T       T       T
  1098.  
  1099.  
  1100. with 'Setenv CanonTab "3 6 9 12 15 18" '  to:
  1101.  
  1102.          1         2         3         4         5
  1103. 12345678901234567890123456789012345678901234567890
  1104.   T  T  T  T  T  T
  1105.  
  1106. Up  to 32 tab stops may be defined.  All tab stops above the limit
  1107. of   32   are  ignored.   All  previous  tabulators  are  cleared.
  1108. Horizontal  tabs  are  selected and stored internally in character
  1109. spaces, not inches.  Thus, any change in the character spacing can
  1110. change  the physical locations of horizontal tabs on the line, but
  1111. the  logical  positions remain unchanged.  With PS fonts, a column
  1112. is defined as the width of the current space character at ASCII 32
  1113. ($20).
  1114.  
  1115.        SetEnv CanonPerf <0-form length-1>  (Default: 0 lines)
  1116.  
  1117. If CanonForm is set to ON, CanonPerf specifies the number of lines
  1118. that  the  printer skips at the end of each page.  This causes the
  1119. printer to skip the perforation between pages of continuous forms.
  1120. If  0  lines are specified, perforation skip will be disabled.  If
  1121. the specified CanonPerf value is greater than or equal to the form
  1122. length  (as  defined  in  the  WB  preferences  program), the skip
  1123. perforation  is  cancelled  and  the top and bottom margins become
  1124. inactive. This setting is not supported by the CanonBJC800 printer.
  1125.  
  1126.  
  1127.            SetEnv CanonForm  ON|OFF  (Default: OFF)
  1128.  
  1129. If  CanonForm  is  set to ON, page length (as set in preferences),
  1130. and perforation skip (defined by CanonPerf) will be defined by the
  1131. driver. 
  1132.  
  1133.  
  1134.            SetEnv CanonMirror  ON|OFF  (Default: OFF)
  1135.  
  1136. If set to on, graphics will be mirrored.  This is specialy usefull
  1137. if you want to print pictures intend for T-Shirt art.
  1138.  
  1139.  
  1140.            SetEnv CanonEmu  24|48|800  (Default: 24)
  1141.  
  1142. This driver supports up to 3 different emulations:
  1143.  
  1144. I.  if set to 24 (default), the printer driver will use the normal
  1145. Epson 24 pin graphic command as most Epson compatible printers do.
  1146. This  emulation  is  slow  and  does  have  some quailty problems,
  1147. because  360ydpi  graphics are printed in two passes causing "wet"
  1148. muddy  printings.   For  instance, this emulation may be used on a
  1149. BJ10ex, BJ20, BJ300 and BJ330 in Epson mode.
  1150.  
  1151. II.   if  set to 48, the driver supports additional 48 pin graphic
  1152. commands.   In  most  cases  these  48  pin commands (for instance
  1153. ESC-*-72...) are only supported by new 48 or 64 pin printers (like
  1154. the BJC800).  The commands offer a faster and better graphic dump,
  1155. because  48  pins  are  printed on each pass.  Also, line gaps are
  1156. creatly  reduced.   The  driver  will use the printers 48 pin mode
  1157. only  density 1,5 (180*360dpi) and 2,7 (360*360dpi).  On all other
  1158. density  settings  the  driver  behaves  like the 24 pin emulation
  1159. above.
  1160.  
  1161. III.   If  set  to  800,  the driver will print graphics using the
  1162. native  mode  of  the  BJC  8xx printer.  This setting is STRONGLY
  1163. recommended  for all BJC users.  This emulation (native mode) does
  1164. offer some special things:
  1165.  
  1166. Data  send  to  the  printer is compressed, resulting in much less
  1167. data.   The  time  saved  by  sending  less  data through the slow
  1168. centronics  port  may  be  huge.   So  it  decrease the print time
  1169. significantly (usualy 2-4 times compared to the 48 mode, which also
  1170. does some sort of compression).
  1171.  
  1172. In  the  800  mode the printer uses a "halfline" modus, causing no
  1173. gaps between printing lines to appear.
  1174.  
  1175. In  the  800  mode  you are also able to control the printers mode
  1176. through the driver using the CanonMode option.
  1177.  
  1178. In  the  800 emulation you have a smaller top margin, allowing you
  1179. to print in a bigger sized pictures.
  1180.  
  1181. In the 800 emulation, the printer must be set to a specific page
  1182. height by the driver. You are not able to print on endless paper.
  1183.  
  1184.                     !!!!!!   WARNING !!!!!
  1185. Beside  all  those  nice  things  from  the  800 mode, there is an
  1186. importent  drawback:   you are not allowed to print text after you
  1187. have  printed  graphics.   Also no text and graphics may appear on
  1188. the  same page.  So you can use the driver for normal text prints,
  1189. but  as  soon  as  you  have  dumped  a  graphic,  you must switch
  1190. emulation to print text or flush the driver out of memory by using
  1191. AVAIL  FLUSH  from  CLI/Shell (WShell users may simply use FLUSH).
  1192. This  limitation  shouldn't  be a huge problem for anybody, as you
  1193. can  switch  back  to  the  Epson 48 pin mode everytime you want.
  1194. This  mode  is  mainly for nice and fast graphic dumps and this is
  1195. what the BJC printers are build for.
  1196.  
  1197. Note:   CanonForm  is  automaticly  OFF in the 800 mode.  The page
  1198. size  may  be altered by using the CanonResX and CanonResY options
  1199. instead.   Also  a  "Beep"  as  job  end signal (see CanonBeep) is
  1200. ignored in 800 mode.
  1201.  
  1202.  
  1203.  
  1204.            SetEnv CanonColor  <color>  (Default: <color> = 0)
  1205.  
  1206. With CanonColor you may choose the default text color of the
  1207. printer.  Here are the allowed values:
  1208.  
  1209. <color>    BJC800 Color        Epson definition
  1210.  
  1211. 0          Black               Black
  1212. 1          Magenta             Magenta
  1213. 2          Cyan                Cyan
  1214. 3          Blue                Blue
  1215. 4          Yellow              Yellow
  1216. 5          Red                 Red
  1217. 6          Green               Green
  1218.  
  1219.  
  1220.            SetEnv CanonMode <mode>  (Default: 0)
  1221.  
  1222. In 800 mode (see CanonEmu option), you can set the printer mode
  1223. with CanonMode.  Following options are allowed:
  1224.  
  1225. <mode>  Meaning
  1226.   0     printer default mode
  1227.   1     Mode A: Color 100%, Black 100% (two scan printing)
  1228.   2     Mode B: Color 100% (two scan), Black 200% (four scan)
  1229.   3     Mode C: Same as B
  1230.   4     Mode D: Color 100%, Black 100% (two scan with 8 sec delay)
  1231.   5     Mode E: Color 100%, Black 100% (single scan printing)
  1232.  
  1233. See  you  BJC  user  manual  on how to choose a mode for a special
  1234. purpose.
  1235.  
  1236.  
  1237.  
  1238.  
  1239.            SetEnv CanonSep  C|M|Y|K  (Default: CMYK)
  1240.  
  1241. With  this  option  you  can  print  a  CYMK  color component of a
  1242. picture.  For instance, if you want to print the cyan component of
  1243. a  picture,  set  CanonSep  to  "C".  The combination of following
  1244. keywords are allowed:
  1245.  
  1246. C = Cyan
  1247. M = Magenta
  1248. Y = Yellow
  1249. K = Black
  1250.  
  1251. Using CanonSep you can print color pictures on a b/w printer using
  1252. color ribbons/ink.  Here's what to do:
  1253.  
  1254. 1. Get yourself a cyan, magenta, yellow and black color ribbon/ink.
  1255. 2. Set CanonSep to C and start printing your color picture
  1256. 3. reinsert the paper sheet with the printed graphics
  1257. 4. Repeat step 2-3 with M,Y, and K
  1258.  
  1259. Because  of the adjustment problems caused by using the same sheet
  1260. of  paper  several  times,  you  shouldn't use the high resolution
  1261. 360*360 dpi mode, or define a special dither matrix.
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267. SetEnv CanonGAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1268.                                          176,192,208,224,255)
  1269. SetEnv CanonKAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1270.                                          176,192,208,224,255)
  1271. SetEnv CanonKAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1272.                                          176,192,208,224,255)
  1273. SetEnv CanonCAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1274.                                          176,192,208,224,255)
  1275. SetEnv CanonYAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1276.                                          176,192,208,224,255)
  1277. SetEnv CanonMAdj <num0-255>  (Default: 0,16,32,48,64,80,96,112,128,144,160,
  1278.                                          176,192,208,224,255)
  1279.  
  1280. You  can  define various color adjustments for the graphic dump of
  1281. the  driver.  This allows you to make a picture brighter (which is
  1282. specialy  usefull  in  high  density  modes),  darker, increase or
  1283. decrease  contrast level, and do gamma correction.  Now using this
  1284. feature  is  easy,  understanding  might not.  Simply try it after
  1285. reading  the documentation!  You'll be extremly satisfied with the
  1286. results.   Also  note:  you can correct the colors of your picture
  1287. with  this  feature  and  in  conjunction with a customized dither
  1288. matrix  you  DON'T  LOOSE  ANY COLOR.  For instance, a 4096 can be
  1289. brighten  up  with  this  feature and you still get 4096 different
  1290. colors.
  1291.  
  1292. For general information see the "color adjustment" chapter!!!
  1293.  
  1294. You  must define exactly 16 values for Canon<color>Adj vars.  Each
  1295. value  must  be  in range from 0 to 255, were 0 means no color and
  1296. 255  full color.  The order of the 16 values goes from "no ink" to
  1297. "full  ink".   For  example, you want to define following function
  1298. (which is the default linear color adjustment of the driver):
  1299.  
  1300.  
  1301.   full ink or|white                        230
  1302.              |                           214        
  1303.           208| <- <- <- <- <- <- <- <- 208
  1304. O            |                       192^
  1305.              |                     176  |
  1306. U            |                   160
  1307.              |                 144      ^
  1308. T            |                128       |
  1309.              |              112
  1310. P            |            96            ^
  1311.              |          80              |
  1312. U            |        64
  1313.              |      48                  ^
  1314. T            |    32                    |
  1315.              |  16
  1316.        no ink|0                         ^
  1317.              --+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
  1318.              no ink                   208 full ink or white
  1319.  
  1320.  
  1321.                        I N P U T
  1322.  
  1323.  
  1324. As  you can easily see, a value of 208 is printed by the driver as
  1325. 208.   So  no  change.   To  define  this  linear color adjustment
  1326. conversion, you must enter in CLI:
  1327.  
  1328.  SetEnv CanonConv "0 16 32 48 64 80 96 112 128 144 160 176 192 208 214 230"
  1329.  
  1330. Next time you print graphics, the new adjustment function is used.
  1331. Defining  and  editing  a  greyscale conversion function using the
  1332. setenv  command  is  uncomfortable.  You can use the CanonPref for
  1333. editing and defining a function.  When finished with defining, you
  1334. can  get  the  values  set  in  CanonPref  by  using  the  "getenv
  1335. CanonPref" CLI command.
  1336.  
  1337.         SetEnv CanonGDit  <x-size> <y-size>  a11, a12, ..., amn
  1338.         SetEnv CanonKDit  <x-size> <y-size>  a11, a12, ..., amn
  1339.         SetEnv CanonCDit  <x-size> <y-size>  a11, a12, ..., amn
  1340.         SetEnv CanonYDit  <x-size> <y-size>  a11, a12, ..., amn
  1341.         SetEnv CanonMDit  <x-size> <y-size>  a11, a12, ..., amn
  1342.  
  1343. You  can  define a dither matrices.  It will replace the dispersed
  1344. ordered  dither  matrices  of  the  printer device.  To enable the
  1345. dither matrice you must print using the Workbench "ordered" dither
  1346. mode.  Also, all color dither matrices must be of same size.  It's
  1347. not  allowed  to define only one color dither matrix.  The allowed
  1348. <x-size>  and  <y-size> range must be between 1 and 64.  Also only
  1349. up to 512 matrix elements are allowed for each matrix.
  1350.  
  1351.  
  1352.            SetEnv CanonMagenta  <percent>  (Default: 0%)
  1353.  
  1354. This  driver  also  offers  the user complete control over its ink
  1355. compensation  function.   Printer's  inks  are not completely pure
  1356. materials.  For example, there is some amount of yellow mixed into
  1357. the  magenta  ink.   And,  there  is  some amount of magenta which
  1358. unavoidably is found in the cyan ink.  The ink compensation values
  1359. will  correct  for these impurities.  With CanonMagenta you define
  1360. the amount of magenta in the cyan ink in percent.
  1361.  
  1362. In  general,  set  this  ink  compensation  value  to 31% for best
  1363. results  with  Inkum  Inks.   The ink compensation function can be
  1364. completely disabled by turning it ``off'' using density 1 or 2 for
  1365. printing  (or  define  0%)  You  will  notice that without the ink
  1366. compensation  function, a blue sky will print as purple.  With the
  1367. ink compensation function set at 31%, blue skies are blue again.
  1368.  
  1369. PS:   on  my  experience  15%  gives better violet shades with the
  1370. original  Canon  BJC800  inks, but again...  it's best you ask the
  1371. manufacturor of the ink for the right values.
  1372.  
  1373.  
  1374.            SetEnv CanonYellow  <percent>  (Default: 0%)
  1375.  
  1376. This  driver  also  offers  the user complete control over its ink
  1377. compensation  function.   Printer's  inks  are not completely pure
  1378. materials.  For example, there is some amount of yellow mixed into
  1379. the  magenta  ink.   And,  there  is  some amount of magenta which
  1380. unavoidably is found in the cyan ink.  The ink compensation values
  1381. will  correct  for these impurities.  With CanonYellow you define
  1382. the amount of yellow in the magenta ink in percent.
  1383.  
  1384. In general, set this ink compensation value to 40% for Inkum Inks.
  1385. The  ink  compensation  function  can  be  completely  disabled by
  1386. turning  it  ``off''  using density 1 or 2 for printing (or define
  1387. 0%)  You  will  notice that without the ink compensation function,
  1388. blood wouldn't be printed attractiv enough for vampires.  With the
  1389. ink  compensation  function  set at 40%, vampires will eat up your
  1390. dumps.
  1391.  
  1392.  
  1393. NOTE:  ADPro users should use density 1 or 2 for printing graphics
  1394. with  ADPro.   Density 1 and 2 will turn off the color adjustment,
  1395. ink compensation, and dither routines used by the driver.  Instead
  1396. the  ADPro  dither, ink compensation and color adjustment routines
  1397. will be used.
  1398.  
  1399. NOTE:   the  BJC800  printer  is a single page orientated printer.
  1400. Because  of this, a page height must be defined by the driver.  In
  1401. CanonBJC  mode  the  height  defined  is  the  one you have set in
  1402. preferences  (for  instance  DIN A4 or US Letter).  If preferences
  1403. page  sizes  don't  match you needs, use the CUSTOM paper size and
  1404. set  the ResY to the needed size (in n/360 dpi).  The maximum page
  1405. height  is  22 inch (or 55,8cm), which can also be used by setting
  1406. the paper type to FANFOLD.
  1407.