doc/help/options.html

   1 <HTML>
   2 <!-- SECTION: Getting Started -->
   3 <HEAD>
   4         <TITLE>Command-Line Printing and Options</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>CUPS provides both the System V (<A
   9 HREF="man-lp.html">lp(1)</A>) and Berkeley (<A
  10 HREF="man-lpr.html">lpr(1)</A>) printing commands for printing
  11 files. In addition, it supported a large number of standard and
  12 printer-specific options that allow you to control how and where
  13 files are printed.</P>
  14
  15
  16 <H2 CLASS="title"><A NAME="BASICS">Printing Files</A></H2>
  17
  18 <P>CUPS understands many different types of files directly,
  19 including text, PostScript, PDF, and image files. This allows you
  20 to print from inside your applications or at the command-line,
  21 whichever is most convenient! Type either of the following
  22 commands to print a file to the default (or only) printer on the
  23 system:</P>
  24
  25 <PRE CLASS="command">
  26 lp filename
  27 lpr filename
  28 </PRE>
  29
  30 <H3><A NAME="PRINTER">Choosing a Printer</A></H3>
  31
  32 <P>Many systems will have more than one printer available to the
  33 user. These printers can be attached to the local system via a
  34 parallel, serial, or USB port, or available over the network. Use
  35 the <A HREF="man-lpstat.html">lpstat(1)</A> command to see a list
  36 of available printers:</P>
  37
  38 <PRE CLASS="command">
  39 lpstat -p -d
  40 </PRE>
  41
  42 <P>The <CODE>-p</CODE> option specifies that you want to see a
  43 list of printers, and the <CODE>-d</CODE> option reports the
  44 current default printer or class.</P>
  45
  46 <P>Use the <CODE>-d</CODE> option with the <B>lp</B> command to
  47 print to a specific printer:</P>
  48
  49 <PRE CLASS="command">
  50 lp -d printer filename
  51 </PRE>
  52
  53 <P>or the <CODE>-P</CODE> option with the <B>lpr</B> command:</P>
  54
  55 <PRE CLASS="command">
  56 lpr -P printer filename
  57 </PRE>
  58
  59 <H3><A NAME="DEFAULT">Setting the Default Printer</A></H3>
  60
  61 <P>If you normally use a particular printer, you can tell CUPS to
  62 use it by default using the <A
  63 HREF="man-lpoptions.html">lpoptions(1)</A> command:</P>
  64
  65 <PRE CLASS="command">
  66 lpoptions -d printer
  67 </PRE>
  68
  69 <H3><A NAME="PIPE">Printing the Output of a Program</A></H3>
  70
  71 <P>Both the <B>lp</B> and <B>lpr</B> commands support printing
  72 from the standard input:</P>
  73
  74 <PRE CLASS="command">
  75 program | lp
  76 program | lp -d printer
  77 program | lpr
  78 program | lpr -P printer
  79 </PRE>
  80
  81 <P>If the program does not provide any output, then nothing will
  82 be queued for printing.</P>
  83
  84 <H3><A NAME="WITHOPTIONS">Specifying Printer Options</A></H3>
  85
  86 <P>For many types of files, the default printer options may be
  87 sufficient for your needs. However, there may be times when you
  88 need to change the options for a particular file you are
  89 printing.</P>
  90
  91 <P>The <B>lp</B> and <B>lpr</B> commands allow you to pass
  92 printer options using the <CODE>-o</CODE> option:</P>
  93
  94 <PRE CLASS="command">
  95 lp -o landscape -o scaling=75 -o media=A4 filename.jpg
  96 lpr -o landscape -o scaling=75 -o media=A4 filename.jpg
  97 </PRE>
  98
  99 <P>The available printer options vary depending on the printer.
 100 The standard options are described in the "<A
 101 HREF="#OPTIONS">Standard Printing Options</A>" section
 102 below. Printer-specific options are also available and can be
 103 listed using the <B>lpoptions</B> command:</P>
 104
 105 <PRE CLASS="command">
 106 lpoptions -p printer -l
 107 </PRE>
 108
 109 <H3><A NAME="INSTANCES">Creating Saved Options</A></H3>
 110
 111 <P>Saved options are supported in CUPS through <em>printer
 112 instances</em>. Printer instances are, as their name implies, copies
 113 of a printer that have certain options associated with them. Use the
 114 <B>lpoptions</B> command to create a printer instance:</P>
 115
 116 <PRE CLASS="command">
 117 lpoptions -p printer/instance -o name=value ...
 118 </PRE>
 119
 120 <P>The <CODE>-p printer/instance</CODE> option provides the name of
 121 the instance, which is always the printer name, a slash, and the
 122 instance name which can contain any printable characters except
 123 space and slash. The remaining options are then associated with the
 124 instance instead of the main queue. For example, the following
 125 command creates a duplex instance of the LaserJet queue:</P>
 126
 127 <PRE CLASS="command">
 128 lpoptions -p LaserJet/duplex -o sides=two-sided-long-edge
 129 </PRE>
 130
 131 <P>Instances <em>do not</em> inherit lpoptions from the main
 132 queue.</P>
 133
 134 <H3><A NAME="COPIES">Printing Multiple Copies</A></H3>
 135
 136 <P>Both the <B>lp</B> and <B>lpr</B> commands have options for
 137 printing more than one copy of a file:</P>
 138
 139 <PRE CLASS="command">
 140 lp -n <EM>num-copies</EM> filename
 141 lpr -#<EM>num-copies</EM> filename
 142 </PRE>
 143
 144 <P>Copies are normally <EM>not</EM> collated for you. Use the
 145 <CODE>-o Collate=True</CODE> option to get collated copies:</P>
 146
 147 <PRE CLASS="command">
 148 lp -n <EM>num-copies</EM> -o Collate=True filename
 149 lpr -#<EM>num-copies</EM> -o Collate=True filename
 150 </PRE>
 151
 152
 153 <H2 CLASS="title"><A NAME="CANCEL">Canceling a Print Job</A></H2>
 154
 155 <P>The <A HREF="man-cancel.html">cancel(1)</A> and <A
 156 HREF="man-lprm.html">lprm(1)</A> commands cancel a print job:</P>
 157
 158 <PRE CLASS="command">
 159 cancel <EM>job-id</EM>
 160 lprm <EM>job-id</EM>
 161 </PRE>
 162
 163 <P>The <EM>job-id</EM> is the number that was reported to you by
 164 the <B>lp</B> command. You can also get the job ID using the <A
 165 HREF="man-lpq.html">lpq(1)</A> or <A
 166 HREF="man-lpstat.html">lpstat</A> commands:</P>
 167
 168 <PRE CLASS="command">
 169 lpq
 170 lpstat
 171 </PRE>
 172
 173
 174 <H2 CLASS="title"><A NAME="LPMOVE">Moving a Print Job</A></H2>
 175
 176 <P>The <A HREF="man-lpmove.html">lpmove(8)</A> command moves a print
 177 job to a new printer or class:</P>
 178
 179 <PRE CLASS="command">
 180 lpmove <EM>job-id</EM> <i>destination</i>
 181 </PRE>
 182
 183 <P>The <EM>job-id</EM> is the number that was reported to you by
 184 the <B>lp</B> or <B>lpstat</B> commands. <i>Destination</i> is the
 185 name of a printer or class that you want to actually print the job.
 186
 187 <BLOCKQUOTE><B>Note:</B>
 188
 189 <P>The <B>lpmove</B> command is located in the system command
 190 directory (typically <VAR>/usr/sbin</VAR> or <VAR>/usr/local/sbin</VAR>),
 191 and so may not be in your command path. Specify the full path to the
 192 command if you get a "command not found" error, for example:
 193
 194 <PRE CLASS="command">
 195 /usr/sbin/lpmove foo-123 bar
 196 </PRE>
 197
 198 </BLOCKQUOTE>
 199
 200
 201 <H2 CLASS="title"><A NAME="OPTIONS">Standard Printing Options</A></H2>
 202
 203 <P>The following options apply when printing all types of
 204 files.</P>
 205
 206 <H3><A NAME="MEDIA">Selecting the Media Size, Type, and Source</A></H3>
 207
 208 <P>The <CODE>-o media=xyz</CODE> option sets the media size,
 209 type, and/or source:</P>
 210
 211 <PRE CLASS="command">
 212 lp -o media=Letter filename
 213 lp -o media=Letter,MultiPurpose filename
 214 lpr -o media=Letter,Transparency filename
 215 lpr -o media=Letter,MultiPurpose,Transparency filename
 216 </PRE>
 217
 218 <P>The available media sizes, types, and sources depend on the
 219 printer, but most support the following options (case is not
 220 significant):</P>
 221
 222 <UL>
 223
 224         <LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm)
 225
 226         <LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm)
 227
 228         <LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm)
 229
 230         <LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or
 231         241x105mm)
 232
 233         <LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm)
 234
 235         <LI><CODE>Transparency</CODE> - Transparency media type or source
 236
 237         <LI><CODE>Upper</CODE> - Upper paper tray
 238
 239         <LI><CODE>Lower</CODE> - Lower paper tray
 240
 241         <LI><CODE>MultiPurpose</CODE> - Multi-purpose paper tray
 242
 243         <LI><CODE>LargeCapacity</CODE> - Large capacity paper tray
 244
 245 </UL>
 246
 247 <P>The actual options supported are defined in the printer's PPD
 248 file in the <CODE>PageSize</CODE>, <CODE>InputSlot</CODE>, and
 249 <CODE>MediaType</CODE> options. You can list them using the
 250 <B>lpoptions(1)</B> command:</P>
 251
 252 <PRE CLASS="command">
 253 lpoptions -p printer -l
 254 </PRE>
 255
 256 <P>When <CODE>Custom</CODE> is listed for the <CODE>PageSize</CODE> option, you can specify custom media sizes using one of the following forms:</P>
 257
 258 <PRE CLASS="command">
 259 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM> filename
 260 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>in filename
 261 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>cm filename
 262 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>mm filename
 263 </PRE>
 264
 265 <P>where "WIDTH" and "LENGTH" are the width and length of the media in points, inches, centimeters, or millimeters, respectively.</P>
 266
 267
 268 <H3><A NAME="ORIENTATION">Setting the Orientation</A></H3>
 269
 270 <P>The <CODE>-o landscape</CODE> option will rotate the page 90
 271 degrees to print in landscape orientation:</P>
 272
 273 <PRE CLASS="command">
 274 lp -o landscape filename
 275 lpr -o landscape filename
 276 </PRE>
 277
 278 <P>The <CODE>-o orientation-requested=N</CODE> option rotates the
 279 page depending on the value of N:</P>
 280
 281 <UL>
 282
 283         <LI><CODE>-o orientation-requested=3</CODE> - portrait
 284         orientation (no rotation)</LI>
 285
 286         <LI><CODE>-o orientation-requested=4</CODE> - landscape
 287         orientation (90 degrees)</LI>
 288
 289         <LI><CODE>-o orientation-requested=5</CODE> - reverse
 290         landscape or seascape orientation (270 degrees)</LI>
 291
 292         <LI><CODE>-o orientation-requested=6</CODE> - reverse
 293         portrait or upside-down orientation (180 degrees)</LI>
 294
 295 </UL>
 296
 297
 298 <H3><A NAME="SIDES">Printing On Both Sides of the Paper</A></H3>
 299
 300 <P>The <CODE>-o sides=two-sided-short-edge</CODE> and <CODE>-o
 301 sides=two-sided-long-edge</CODE> options will enable two-sided
 302 printing on the printer if the printer supports it. The <CODE>-o
 303 sides=two-sided-short-edge</CODE> option is suitable for
 304 landscape pages, while the <CODE>-o
 305 sides=two-sided-long-edge</CODE> option is suitable for portrait
 306 pages:</P>
 307
 308 <PRE CLASS="command">
 309 lp -o sides=two-sided-short-edge filename
 310 lp -o sides=two-sided-long-edge filename
 311 lpr -o sides=two-sided-long-edge filename
 312 </PRE>
 313
 314 <P>The default is to print single-sided:</P>
 315
 316 <PRE CLASS="command">
 317 lp -o sides=one-sided filename
 318 lpr -o sides=one-sided filename
 319 </PRE>
 320
 321
 322 <H3><A NAME="JOBSHEETS">Selecting the Banner Page(s)</A></H3>
 323
 324 <P>The <CODE>-o jobsheets=start,end</CODE> option sets the banner
 325 page(s) to use for a job:</P>
 326
 327 <PRE CLASS="command">
 328 lp -o job-sheets=none filename
 329 lp -o job-sheets=standard filename
 330 lpr -o job-sheets=classified,classified filename
 331 </PRE>
 332
 333 <P>If only one banner file is specified, it will be printed
 334 before the files in the job. If a second banner file is
 335 specified, it is printed after the files in the job.</P>
 336
 337 <P>The available banner pages depend on the local system
 338 configuration; CUPS includes the following banner files:</P>
 339
 340 <UL>
 341
 342         <LI><CODE>none</CODE> - Do not produce a banner page.
 343
 344         <LI><CODE>classified</CODE> - A banner page with a "classified"
 345         label at the top and bottom.
 346
 347         <LI><CODE>confidential</CODE> - A banner page with a
 348         "confidential" label at the top and bottom.
 349
 350         <LI><CODE>secret</CODE> - A banner page with a "secret" label
 351         at the top and bottom.
 352
 353         <LI><CODE>standard</CODE> - A banner page with no label at the
 354         top and bottom.
 355
 356         <LI><CODE>topsecret</CODE> - A banner page with a "top secret"
 357         label at the top and bottom.
 358
 359         <LI><CODE>unclassified</CODE> - A banner page with an
 360         "unclassified" label at the top and bottom.
 361
 362 </UL>
 363
 364
 365 <H3><A NAME="JOBHOLDUNTIL">Holding Jobs for Later Printing</A></H3>
 366
 367 <P>The <CODE>-o job-hold-until=when</CODE> option tells CUPS to
 368 delay printing until the "when" time, which can be one of the
 369 following:</P>
 370
 371 <UL>
 372
 373         <LI><CODE>-o job-hold-until=indefinite</CODE>; print only
 374         after released by the user or an administrator</LI>
 375
 376         <LI><CODE>-o job-hold-until=day-time</CODE>; print from
 377         6am to 6pm local time</LI>
 378
 379         <LI><CODE>-o job-hold-until=night</CODE>; print from
 380         6pm to 6am local time</LI>
 381
 382         <LI><CODE>-o job-hold-until=second-shift</CODE>; print from
 383         4pm to 12am local time</LI>
 384
 385         <LI><CODE>-o job-hold-until=third-shift</CODE>; print from
 386         12am to 8am local time</LI>
 387
 388         <LI><CODE>-o job-hold-until=weekend</CODE>; print on Saturday
 389         or Sunday</LI>
 390
 391         <LI><CODE>-o job-hold-until=HH:MM</CODE>; print at the specified
 392         UTC time</LI>
 393
 394 </UL>
 395
 396 <H3><A NAME="RELEASEJOB">Releasing Held Jobs</A></H3>
 397
 398 <P>Aside from the web interface, you can use the <B>lp</B> command
 399 to release a held job:</P>
 400
 401 <PRE CLASS="command">
 402 lp -i <em>job-id</em> -H resume
 403 </PRE>
 404
 405 <P>where "job-id" is the job ID reported by the <B>lpstat</B>
 406 command.</P>
 407
 408
 409 <H3><A NAME="JOBPRIORITY">Setting the Job Priority</A></H3>
 410
 411 <P>The <CODE>-o job-priority=NNN</CODE> option tells CUPS to
 412 assign a priority to your job from 1 (lowest) to 100 (highest),
 413 which influences where the job appears in the print queue. Higher
 414 priority jobs are printed before lower priority jobs, however
 415 submitting a new job with a high priority will not interrupt an
 416 </P>
 417
 418
 419 <H3><A NAME="OUTPUTORDER">Specifying the Output Order</A></H3>
 420
 421 <P>The <CODE>-o outputorder=normal</CODE> and <CODE>-o outputorder=reverse</CODE> options specify the order of the pages. Normal order prints page 1 first, page 2 second, and so forth. Reverse order prints page 1 last.</P>
 422
 423
 424 <H3><A NAME="PAGERANGES">Selecting a Range of Pages</A></H3>
 425
 426 <P>The <CODE>-o page-ranges=pages</CODE> option selects a range
 427 of pages for printing:</P>
 428
 429 <PRE CLASS="command">
 430 lp -o page-ranges=1 filename
 431 lp -o page-ranges=1-4 filename
 432 lp -o page-ranges=1-4,7,9-12 filename
 433 lpr -o page-ranges=1-4,7,9-12 filename
 434 </PRE>
 435
 436 <P>As shown above, the <CODE>pages</CODE> value can be a single page, a
 437 range of pages, or a collection of page numbers and ranges separated by
 438 commas. The pages will always be printed in ascending order, regardless
 439 of the order of the pages in the <CODE>page-ranges</CODE> option.
 440
 441 <P>The default is to print all pages.
 442
 443 <blockquote><b>Note:</b>
 444
 445 <p>The page numbers used by <code>page-ranges</code> refer to the output
 446 pages and not the document's page numbers. Options like <code>number-up</code>
 447 can make the output page numbering not match the document page numbers.</p>
 448
 449 </blockquote>
 450
 451
 452 <H3><A NAME="PAGESET">Selecting Even or Odd Pages</A></H3>
 453
 454 <P>Use the <CODE>-o page-set=set</CODE> option to select the even or odd pages:</P>
 455
 456 <PRE CLASS="command">
 457 lp -o page-set=odd filename
 458 lp -o page-set=even filename
 459 lpr -o page-set=even filename
 460 </PRE>
 461
 462 <P>The default is to print all pages.
 463
 464 <H3><A NAME="NUMBERUP">N-Up Printing</A></H3>
 465
 466 <P>The <CODE>-o number-up=value</CODE> option selects N-Up
 467 printing. N-Up printing places multiple document pages on a
 468 single printed page. CUPS supports 1, 2, 4, 6, 9, and 16-Up
 469 formats; the default format is 1-Up:</P>
 470
 471 <PRE CLASS="command">
 472 lp -o number-up=1 filename
 473 lp -o number-up=2 filename
 474 lp -o number-up=4 filename
 475 lpr -o number-up=16 filename
 476 </PRE>
 477
 478 <P>The <CODE>-o page-border=value</CODE> option chooses the
 479 border to draw around each page:</P>
 480
 481 <UL>
 482         <LI><CODE>-o page-border=double</CODE>; draw two hairline borders around each page</LI>
 483         <LI><CODE>-o page-border=double-thick</CODE>; draw two 1pt borders around each page</LI>
 484         <LI><CODE>-o page-border=none</CODE>; do not draw a border (default)</LI>
 485         <LI><CODE>-o page-border=single</CODE>; draw one hairline border around each page</LI>
 486         <LI><CODE>-o page-border=single-thick</CODE>; draw one 1pt border around each page</LI>
 487 </UL>
 488
 489 <P>The <CODE>-o number-up-layout=value</CODE> option chooses the
 490 layout of the pages on each output page:</P>
 491
 492 <UL>
 493         <LI><CODE>-o number-up-layout=btlr</CODE>; Bottom to top, left to right</LI>
 494         <LI><CODE>-o number-up-layout=btrl</CODE>; Bottom to top, right to left</LI>
 495         <LI><CODE>-o number-up-layout=lrbt</CODE>; Left to right, bottom to top</LI>
 496         <LI><CODE>-o number-up-layout=lrtb</CODE>; Left to right, top to bottom (default)</LI>
 497         <LI><CODE>-o number-up-layout=rlbt</CODE>; Right to left, bottom to top</LI>
 498         <LI><CODE>-o number-up-layout=rltb</CODE>; Right to left, top to bottom</LI>
 499         <LI><CODE>-o number-up-layout=tblr</CODE>; Top to bottom, left to right</LI>
 500         <LI><CODE>-o number-up-layout=tbrl</CODE>; Top to bottom, right to left</LI>
 501 </UL>
 502
 503 <H3><A NAME="FIT_TO_PAGE">Scaling to Fit</A></H3>
 504
 505 <P>The <CODE>-o fit-to-page</CODE> option specifies that the document
 506 should be scaled to fit on the page:</P>
 507
 508 <PRE CLASS="command">
 509 lp -o fit-to-page filename
 510 lpr -o fit-to-page filename
 511 </PRE>
 512
 513 <P>The default is to use the size specified in the file.</P>
 514
 515 <BLOCKQUOTE><B>Note:</B>
 516
 517 <P>This feature depends upon an accurate size in
 518 the print file. If no size is given in the file, the page may be
 519 scaled incorrectly!
 520
 521 </BLOCKQUOTE>
 522
 523 <H3><A NAME="OUTPUTORDER">Printing in Reverse Order</A></H3>
 524
 525 <P>The <CODE>-o outputorder=reverse</CODE> option will print the
 526 pages in reverse order:</P>
 527
 528 <PRE CLASS="command">
 529 lp -o outputorder=reverse filename
 530 lpr -o outputorder=reverse filename
 531 </PRE>
 532
 533 <P>Similarly, the <CODE>-o outputorder=normal</CODE> option will
 534 print starting with page 1:</P>
 535
 536 <PRE CLASS="command">
 537 lp -o outputorder=normal filename
 538 lpr -o outputorder=normal filename
 539 </PRE>
 540
 541 <P>The default is <CODE>-o outputorder=normal</CODE> for
 542 printers that print face down and <CODE>-o outputorder=reverse</CODE>
 543 for printers that print face up.
 544
 545 <H3><A NAME="MIRROR">Printing Mirrored Pages</A></H3>
 546
 547 <P>The <CODE>-o mirror</CODE> option flips each page along the
 548 vertical access to produce a mirrored image:</P>
 549
 550 <PRE CLASS="command">
 551 lp -o mirror filename
 552 lpr -o mirror filename
 553 </PRE>
 554
 555 <P>This is typically used when printing on T-shirt transfer
 556 media or sometimes on transparencies.</P>
 557
 558 <H3><A NAME="RAW">Raw or Unfiltered Output</A></H3>
 559
 560 <P>The <CODE>-o raw</CODE> option allows you to send files
 561 directly to a printer without filtering. This is sometimes
 562 required when printing from applications that provide their own
 563 "printer drivers" for your printer:</P>
 564
 565 <PRE CLASS="command">
 566 lp -o raw filename
 567 lpr -o raw filename
 568 </PRE>
 569
 570 <P>The <CODE>-l</CODE> option can also be used with the
 571 <B>lpr</B> command to send files directly to a printer:</P>
 572
 573 <PRE CLASS="command">
 574 lpr -l filename
 575 </PRE>
 576
 577
 578 <H2 CLASS="title"><A NAME="TEXTOPTIONS">Text Options</A></H2>
 579
 580 <P>CUPS supports several options that are only used when printing
 581 plain text files. These options have absolutely no effect on
 582 PostScript, PDF, HP-GL/2, or image files.</P>
 583
 584 <H3><A NAME="CPI">Setting the Number of Characters Per Inch</A></H3>
 585
 586 <P>The <CODE>-o cpi=value</CODE> option sets the number of
 587 characters per inch:</P>
 588
 589 <PRE CLASS="command">
 590 lp -o cpi=10 filename
 591 lp -o cpi=12 filename
 592 lpr -o cpi=17 filename
 593 </PRE>
 594
 595 <P>The default characters per inch is 10.</P>
 596
 597 <H3><A NAME="LPI">Setting the Number of Lines Per Inch</A></H3>
 598
 599 <P>The <CODE>-o lpi=value</CODE> option sets the number of lines
 600 per inch:</P>
 601
 602 <PRE CLASS="command">
 603 lp -o lpi=6 filename
 604 lpr -o lpi=8 filename
 605 </PRE>
 606
 607 <P>The default lines per inch is 6.</P>
 608
 609 <H3><A NAME="COLUMNS">Setting the Number of Columns</A></H3>
 610
 611 <P>The <CODE>-o columns=value</CODE> option sets the number of
 612 text columns:</P>
 613
 614 <PRE CLASS="command">
 615 lp -o columns=2 filename
 616 lpr -o columns=3 filename
 617 </PRE>
 618
 619 <P>The default number of columns is 1.</P>
 620
 621 <H3><A NAME="MARGINS">Setting the Page Margins</A></H3>
 622
 623 <P>Normally the page margins are set to the hard limits of the
 624 printer. Use the <CODE>-o page-left=value</CODE>, <CODE>-o
 625 page-right=value</CODE>, <CODE>-o page-top=value</CODE>, and
 626 <CODE>-o page-bottom=value</CODE> options to adjust the page
 627 margins:</P>
 628
 629 <PRE CLASS="command">
 630 lp -o page-left=<EM>value</EM> filename
 631 lp -o page-right=<EM>value</EM> filename
 632 lp -o page-top=<EM>value</EM> filename
 633 lp -o page-bottom=<EM>value</EM> filename
 634 lpr -o page-left=<EM>value</EM> -o page-right=<EM>value</EM> -o page-top=<EM>value</EM> -o page-bottom=<EM>value</EM> filename
 635 </PRE>
 636
 637 <P>The <CODE>value</CODE> argument is the margin in points; each
 638 point is 1/72 inch or 0.35mm.</P>
 639
 640 <H3><A NAME="PRETTYPRINT">Pretty Printing</A></H3>
 641
 642 <P>The <CODE>-o prettyprint</CODE> option puts a header at the
 643 top of each page with the page number, job title (usually the
 644 filename), and the date. Also, C and C++ keywords are
 645 highlighted, and comment lines are italicized:</P>
 646
 647 <PRE CLASS="command">
 648 lp -o prettyprint filename
 649 lpr -o prettyprint filename
 650 </PRE>
 651
 652 <H3><A NAME="WRAP">Turning Off Text Wrapping</A></H3>
 653
 654 <P>The <CODE>-o nowrap</CODE> option disables wrapping of long lines:</P>
 655
 656 <PRE CLASS="command">
 657 lp -o nowrap filename
 658 lpr -o nowrap filename
 659 </PRE>
 660
 661
 662 <H2 CLASS="title"><SPAN CLASS="info">Not Supported on Mac OS X</SPAN><A NAME="IMAGEOPTIONS">Image Options</A></H2>
 663
 664 <P>CUPS supports several options that are only used when printing
 665 image files. These options have absolutely no effect on PostScript, PDF,
 666 HP-GL/2, or text files.</P>
 667
 668 <H3><A NAME="position">Positioning Images</A></H3>
 669
 670 <P>The <CODE>-o position=name</CODE> option specifies the position of the
 671 image on the page:
 672
 673 <UL>
 674
 675         <LI><CODE>center</CODE> - Center the image on the page (default)
 676
 677         <LI><CODE>top</CODE> - Print the image centered at the top of the page
 678
 679         <LI><CODE>left</CODE> - Print the image centered on the left of page
 680
 681         <LI><CODE>right</CODE> - Print the image centered on the right of the page
 682
 683         <LI><CODE>top-left</CODE> - Print the image at the top left corner of
 684         the page
 685
 686         <LI><CODE>top-right</CODE> - Print the image at the top right corner of
 687         the page
 688
 689         <LI><CODE>bottom</CODE> - Print the image centered at the bottom of
 690         the page
 691
 692         <LI><CODE>bottom-left</CODE> - Print the image at the bottom left
 693         corner of the page
 694
 695         <LI><CODE>bottom-right</CODE> - Print the image at the bottom right
 696         corner of the page
 697
 698 </UL>
 699
 700 <H3><A NAME="scaling">Scaling Images</A></H3>
 701
 702 <P>The <CODE>-o scaling=percent</CODE>, <CODE>-o
 703 ppi=value</CODE>, and <CODE>-o natural-scaling=percent</CODE>
 704 options change the size of a printed image:
 705
 706 <PRE CLASS="command">
 707 lp -o scaling=<EM>percent</EM> filename
 708 lp -o ppi=<EM>value</EM> filename
 709 lpr -o natural-scaling=<EM>percent</EM> filename
 710 </PRE>
 711
 712 <P>The <CODE>scaling=percent</CODE> value is a number from 1 to 800
 713 specifying the size in relation to the page (<EM>not</EM> the image.) A
 714 scaling of 100 percent will fill the page as completely as the image
 715 aspect ratio allows. A scaling of 200 percent will print on up to 4
 716 pages.
 717
 718 <P>The <CODE>ppi=value</CODE> value is a number from 1 to 1200 specifying the
 719 resolution of the image in pixels per inch. An image that is 3000x2400
 720 pixels will print 10x8 inches at 300 pixels per inch, for example. If
 721 the specified resolution makes the image larger than the page, multiple
 722 pages will be printed to satisfy the request.
 723
 724 <P>The <CODE>natural-scaling=percent</CODE> value is a number
 725 from 1 to 800 specifying the size in relation to the natural
 726 image size. A scaling of 100 percent will print the image at its
 727 natural size, while a scaling of 50 percent will print the image
 728 at half its natural size. If the specified scaling makes the
 729 image larger than the page, multiple pages will be printed to
 730 satisfy the request.
 731
 732
 733 <H2 CLASS="title"><A NAME="HPGL2OPTIONS">HP-GL/2 Options</A></H2>
 734
 735 <P>CUPS supports several options that are only used when printing
 736 HP-GL/2 files. These options have absolutely no effect on PostScript, PDF,
 737 image, or text files.</P>
 738
 739 <H3><A NAME="blackplot">Printing in Black</A></H3>
 740
 741 <P>The <CODE>-o blackplot</CODE> option specifies that all pens should
 742 plot in black:</P>
 743
 744 <PRE CLASS="command">
 745 lp -o blackplot filename
 746 lpr -o blackplot filename
 747 </PRE>
 748
 749 <P>The default is to use the colors defined in the plot file or the
 750 standard pen colors defined in the HP-GL/2 reference manual from
 751 Hewlett Packard.
 752
 753 <H3><A NAME="penwidth">Setting the Default Pen Width</A></H3>
 754
 755 <P>The <CODE>-o penwidth=value</CODE> option specifies the default pen
 756 width for HP-GL/2 files:</P>
 757
 758 <PRE CLASS="command">
 759 lp -o penwidth=<EM>value</EM> filename
 760 lpr -o penwidth=<EM>value</EM> filename
 761 </PRE>
 762
 763 <P>The pen width <CODE>value</CODE> specifies the pen width in micrometers.
 764 The default value of 1000 produces lines that are 1 millimeter in width.
 765 Specifying a pen width of 0 produces lines that are exactly 1 pixel wide.</P>
 766
 767 <BLOCKQUOTE><B>Note:</B>
 768
 769 <P>This option is ignored when the pen widths are set in the plot
 770 file.
 771
 772 </BLOCKQUOTE>
 773
 774 </BODY>
 775 </HTML>