~ubuntu-branches/debian/experimental/cups-filters/experimental

« back to all changes in this revision

Viewing changes to README

  • Committer: Package Import Robot
  • Author(s): Didier Raboud
  • Date: 2015-01-15 18:06:05 UTC
  • mfrom: (1.2.25)
  • mto: This revision was merged to the branch mainline in revision 39.
  • Revision ID: package-import@ubuntu.com-20150115180605-fnfbqv85k3y5zggk
Tags: upstream-1.0.62
ImportĀ upstreamĀ versionĀ 1.0.62

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
README - OpenPrinting CUPS Filters v1.0.34 - 2013-04-10
 
1
README - OpenPrinting CUPS Filters v1.0.62 - 2015-01-14
2
2
-------------------------------------------------------
3
3
 
4
4
Looking for compile instructions?  Read the file "INSTALL.txt"
55
55
IMAGE PRINTING DEFAULT CHANGED TO "SCALE TO FIT"
56
56
 
57
57
    Compared to the PostScript-based original CUPS filters there is a
58
 
    change of deafults: The imagetopdf and imagetoraster filters print
 
58
    change of defaults: The imagetopdf and imagetoraster filters print
59
59
    in "scale-to-fit" mode (image is scaled to fill one page but
60
60
    nothing of the image being cut off) by default.
61
61
 
92
92
    Therefore there are two possibilities to configure pdftops at
93
93
    runtime:
94
94
 
95
 
    1. Selection of the renderer: Ghostscript, Poppler, or Adobe Reader
 
95
    1. Selection of the renderer: Ghostscript, Poppler, pdftocairo, or
 
96
    Adobe Reader
96
97
 
97
98
    Ghostscript has better color management and is generally optimized
98
99
    more for printing. Poppler produces a PostScript which is
99
100
    compatible with more buggy built-in PostScript interpreters of
100
101
    printers and it leads to a somewhat quicker workflow when
101
102
    graphical structures of the input PDF has to be turned into
102
 
    bitmaps. Adobe Reader is the PDF renderer from Adobe, the ones
103
 
    who created PDF and PostScript.
 
103
    bitmaps. Adobe Reader is the PDF renderer from Adobe, the ones who
 
104
    created PDF and PostScript. pdftocairo is a good choice for the
 
105
    PDF output of Cairo (for example when printing from evince).  It
 
106
    is less resource-consuming when rasterizing graphical elements
 
107
    which cannot be represented in PostScript (like
 
108
    transparency). Note that pdftocairo only supports PDF input using
 
109
    DeviceRGB, DeviceGray, RGB or sGray and is not capable of
 
110
    generating PostScript level 1. So its support is only experimental
 
111
    and distributions should not choose it as default.
104
112
 
105
113
    The selection is done by the "pdftops-renderer" option, setting it
106
 
    to "gs", "pdftops", or "acroread":
 
114
    to "gs", "pdftops", "pdftocairo", "acroread", or "hybrid":
107
115
 
108
116
    Per-job:           lpr -o pdftops-renderer=pdftops ...
109
117
    Per-queue default: lpadmin -p printer -o pdftops-renderer-default=gs
112
120
    By default, pdftops uses Ghostscript if this does not get changed
113
121
    at compile time, for example by the Linux distribution vendor.
114
122
 
 
123
    Hybrid means Ghostscript for most printers, but Poppler's pdftops
 
124
    for Brother, Minolta, and Konica Minolta. Printer make and model
 
125
    information comes from the PPD or via the "make-and-model" option.
 
126
 
115
127
    2. Limitation of the image rendering resolution
116
128
 
117
129
    If graphical structures of the incoming PDF file have to be
168
180
    This option does not change anything if Poppler's pdftops is used
169
181
    as renderer.
170
182
 
171
 
HELPER DAEMON FOR BROWSING REMOTE CUPS PRINTERS
 
183
HELPER DAEMON FOR BROWSING REMOTE CUPS PRINTERS AND IPP NETWORK PRINTERS
172
184
 
173
185
    From version 1.6.0 on in CUPS the CUPS broadcasting/browsing
174
186
    facility was dropped, in favour of Bonjour-based broadcasting of
220
232
    For maximum security cups-browsed uses IPPS (encrypted IPP)
221
233
    whenever possible.
222
234
 
 
235
    In addition, cups-browsed is also capable of discovering IPP
 
236
    network printers (native printers, not CUPS queues) with known
 
237
    page description languages (PWG Raster, PDF, PostScript, PCL XL,
 
238
    PCL 5c/e) in the local network and auto-create PPD-less print
 
239
    queues for them (using a System V interface script to control the
 
240
    filter chain). Clients have to IPP-poll the capabilities of the
 
241
    printer and send option settings as standard IPP attributes. We do
 
242
    not poll the capabilities by ourselves to not wake up the printer
 
243
    from power-saving mode when creating the queues. Jobs have to be
 
244
    sent in PDF format. Other formats are not accepted. This
 
245
    functionality is primarily for mobile devices running CUPS to not
 
246
    need a printer setup tool nor a collection of printer drivers and
 
247
    PPDs.
 
248
 
 
249
    cups-browsed can also be started on-demand, for example to save
 
250
    resources on mobile devices. For this, cups-browsed can be set
 
251
    into an auto shutdown mode so that it stops automatically when it
 
252
    has no remote printers to take care of any more, especially if an
 
253
    on-demand running avahi-daemon stops. Note that CUPS must stay
 
254
    running for cups-browsed removing its queues and so being able to
 
255
    shut down. Ideal is if CUPS stays running another 30 seconds after
 
256
    finishing its last job so that cups-browsed can take down the
 
257
    queue. For how to set up and control this mode via command line,
 
258
    configuration directives, or sending signals see the man pages
 
259
    cups-browsed(8) and cups-browsed.conf(5).
 
260
 
223
261
    The configuration file for cups-browsed is
224
262
    /etc/cups/cups-browsed.conf.  This file can include limited forms
225
263
    of the original CUPS BrowseRemoteProtocols, BrowseLocalProtocols,
226
 
    BrowsePoll, and BrowseAllow directives.
 
264
    BrowsePoll, and BrowseAllow directives. It also can contain the
 
265
    new CreateIPPPrinterQueues to activate discovering of IPP network
 
266
    printers and creating PPD-less queues for them.
 
267
 
 
268
    Note that cups-browsed does not work with remote CUPS servers
 
269
    specified by a client.conf file. It always connects to the local
 
270
    CUPS daemon by setting the CUPS_SERVER environment variable and so
 
271
    overriding client.conf. If your local CUPS daemon uses a
 
272
    non-standard domain socket as only way of access, you need to
 
273
    specify it via the DomainSocket directive in
 
274
    /etc/cups/cups-browsed.conf.
227
275
 
228
276
    The "make install" process installs init scripts which make the
229
277
    daemon automatically started during boot. You can also manually
240
288
    queue set as system default, to not loose its system default
241
289
    state).
242
290
 
243
 
    Here is some info on how cups-browsed works internally )first concept of a
 
291
    On systems using systemd use a
 
292
    /usr/lib/systemd/system/cups-browsed.service file like this:
 
293
 
 
294
        [Unit]
 
295
        Description=Make remote CUPS printers available locally
 
296
        After=cups.service avahi-daemon.service
 
297
        Wants=cups.service avahi-daemon.service
 
298
 
 
299
        [Service]
 
300
        ExecStart=/usr/sbin/cups-browsed
 
301
 
 
302
        [Install]
 
303
        WantedBy=multi-user.target
 
304
 
 
305
    On systems using Upstart use an /etc/init/cups-browsed.conf file like this:
 
306
 
 
307
        start on (filesystem
 
308
                  and (started cups or runlevel [2345]))
 
309
        stop on runlevel [016]
 
310
 
 
311
        respawn
 
312
        respawn limit 3 240
 
313
 
 
314
        pre-start script
 
315
            [ -x /usr/sbin/cups-browsed ]
 
316
        end script
 
317
 
 
318
        exec /usr/sbin/cups-browsed
 
319
 
 
320
    These files are included in the source distribution as
 
321
    utils/cups-browsed.service and utils/cups-browsed-upstart.conf.
 
322
 
 
323
    In the examples we start cups-browsed after starting
 
324
    avahi-daemon. This is not required. if cups-browsed starts first,
 
325
    the Bonjour/DNS-SD browsing kicks in as soon as avahi-daemon comes
 
326
    up. cups-browsed is also robust against any shutdown and restart
 
327
    of avahi-daemon.
 
328
 
 
329
    Here is some info on how cups-browsed works internally (first concept of a
244
330
    daemon which does only Bonjour browsing):
245
331
 
246
332
    - Daemon start
327
413
    below) as the ...tops filter calls the ....topdf filter plus
328
414
    Ghostscript's pdf2ps.
329
415
 
 
416
 
330
417
IMAGETOPDF
 
418
==========
331
419
 
332
420
1. INTRODUCTION
333
421
 
424
512
Collate:
425
513
  If Collate is defined, "imagetopdf" judges the printer supports Collate.
426
514
Copies:
427
 
  If cupsManualCopies is defined as False, "imagetopdf" judges the printer
 
515
  If cupsManualCopies is defined as True, "imagetopdf" judges the printer
428
516
  does not support Copies feature.
429
517
 
430
518
Duplex:
612
700
is "/tmp".
613
701
 
614
702
 
615
 
PDFTOPDF.OLD
 
703
PDFTOPDF (OLD)
 
704
==============
616
705
 
617
706
0. DEPRECATION NOTICE
 
707
 
618
708
This filter is being replaced by a new implementation that does not
619
709
depend on poppler. Therefore it has been renamed "pdftopdf.old",
620
710
but the references in the following sections have not been updated.
663
753
inject.  They must be injecting JCL code ("*JCLOpenUI:
664
754
... ... *JCLCloseUI: ...").
665
755
 
666
 
A sample PPD file, HP-Color_LaserJet_CM3530_MFP-PDF.ppd is included.
 
756
Sample PPD files are included:
 
757
 
 
758
- Fuji_Xerox-DocuPrint_CM305_df-PDF.ppd
 
759
- Generic-PDF_Printer-PDF.ppd
 
760
- HP-Color_LaserJet_CM3530_MFP-PDF.ppd
667
761
 
668
762
3. LICENSE
669
763
 
697
791
 
698
792
"pdftopdf" accepts the following CUPS standard options;
699
793
 
700
 
fiplot
 
794
fitplot
701
795
mirror
702
796
PageSize
703
797
page-left, page-right, page-bottom, page-top
770
864
Collate:
771
865
  If Collate is defined, "pdftopdf" judges the printer supports Collate.
772
866
Copies:
773
 
  If cupsManualCopies is defined as False, "pdftopdf" judges the printer
 
867
  If cupsManualCopies is defined as True, "pdftopdf" judges the printer
774
868
  does not support Copies feature.
775
869
Duplex:
776
870
  If Duplex is defined, "pdftopdf" judges the printer supports Duplex.
899
993
 
900
994
and NO "*cupsFilter:" line which accepts PostScript input.
901
995
 
902
 
A sample PPD file for a native PDF printer,
903
 
HP-Color_LaserJet_CM3530_MFP-PDF.ppd is included.
 
996
Sample PPD file for native PDF printer are included:
 
997
 
 
998
- Fuji_Xerox-DocuPrint_CM305_df-PDF.ppd
 
999
- Generic-PDF_Printer-PDF.ppd
 
1000
- HP-Color_LaserJet_CM3530_MFP-PDF.ppd
904
1001
 
905
1002
When a printer does not support PS nor PDF, you can use Ghostscript (GS).
906
1003
In this case, you can specify device options like a PS printer.
986
1083
is "/tmp".
987
1084
 
988
1085
PDFTOPDF  -- new implementation
 
1086
===============================
989
1087
 
990
1088
A new implementation of the pdftopdf filter is available. 
991
1089
It depends on libqpdf to read/write pdf files.
1007
1105
- more testing needs to be done
1008
1106
- documentation largely missing
1009
1107
 
 
1108
 
1010
1109
TEXTTOPDF
 
1110
=========
1011
1111
 
1012
1112
This implements a texttopdf filter, and is derived from cups' texttops.
1013
1113
 
1068
1168
 
1069
1169
 
1070
1170
PDFTORASTER
 
1171
===========
1071
1172
 
1072
1173
1. INTRODUCTION
1073
1174
 
1134
1235
 
1135
1236
 
1136
1237
PDFTOIJS
 
1238
========
1137
1239
 
1138
1240
1. INTRODUCTION
1139
1241
 
1199
1301
 
1200
1302
 
1201
1303
PDFTOOPVP
 
1304
=========
1202
1305
 
1203
1306
1. INTRODUCTION
1204
1307
 
1369
1472
 
1370
1473
 
1371
1474
URFTOPDF
 
1475
========
1372
1476
 
1373
1477
"urftopdf" is a filter to convert Apple's proprietary URF raster
1374
1478
format into PDF. URF raster is generated by some iOS applications when