Ricoh 337943-003 User Manual

PostScript

Programming

Guide

No part of this document may be reproduced without the express permission of Ricoh Printing Sy st em s America, Inc.

The material in this document is for informational purposes and is subject to change without notice. Ricoh Printing Systems America, Inc. assumes no responsibility for errors or omissions in this document . No liabilit y is assumed for any damages resul ting from the use of the information it contains.

TRADEMARK

Digital Document Publisher, DDP, DDP 70, DDP 70e, DDP 92, and their associated logo marks are trademarks of Ricoh Printing Systems America, I nc. All right s reserved.

All other terms and prod uct names may be trademar ks or registered t rademarks of thei r respective owners, and are hereby acknowledged.

NOTICE TO USER

In an effort to meet the demand s of a ra pidly changing t echnolog y, the manufac turer is continually developing new features and functions to meet your changing printing or printer needs. Please be sure to consult all manual updates or addenda when using this product’s documentation.

Table of Contents

Chapter 1. PostScript Languange Printer Commands

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1

Device Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Page Device Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Print Behavior With PJL Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-6

TraySwitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-7

FoldType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-7

Output Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-8

OutputTrayMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-8

Establishing Breaks Within a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-9

Interpreter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-10

User Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-10

MaxFontItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-10

System Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-11

MaxDisplayList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

MaxFontCache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

MaxPermanentVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

MaxRasterMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

MaxSourceList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

RamSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

Product Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1- 14

Model Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-14

Device Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-14

Device Parameters of Type /FileSystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-15

Parameters for Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-15

Parameters for ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-16

Parameters for Fontset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-17

Parameters for Scsi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-18

Categories and Resource Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-18

Regular Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-19

OutputDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-20

Resources Whose Instances Are Implicit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21

Resources Used in Defining New Resource Categories . . . . . . . . . . . . . . . . . . . . . . . . . .1-22

Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-23

Level 1 Compatibility Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-23

Compatibility Operator Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-24

Paper Size Compatibility Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-26

Paper Tray Compatibility Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-26

iii

Chapter 2. I/O Setup

Postscript I/O Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

TBCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1

Index

PostScript Languange Printer Commands

Overview

Printer com mands fo r Adobe PostSc rip t 3 provide a way for yo u to comm unica te with the printer to perform certain tasks.

This document provi des programming inf ormation about Adob e PostScript 3 and contains most of the PostScript commands. It is written for people who are familiar with the command structure of the PostScript language. Most software applications do not require you to enter printer commands. However, if needed, you should refer to your software docume ntation for information about how t o enter printer comman ds.

This document also describes the particular PostScript interpreter parameters and resources implemented for the printer. The printer has features and capabilities that might not be present in other PostScript printers and that are not documented elsewhere.

The foll owing documents are generally relev ant to the operation and progr amming of PostScript printers.

Chapter 1

PostScript Language Reference Manual, Third Edition (Addison-Wesley), (hereafter referred to as the Reference Manual), describes the programming language used to tell printers what and how to print. It describes features of the language available in all PostScript interpreters.

The PostScript Language Reference Manual Level 3 Version 3010 and 3011 Supplement (Adobe), (hereafter referred to as the Supplement), provides an up-to-

date catalog of standard page device, user, system, and device parameters. It includes parameters that have changed since their original description in the PostScript Language Reference Manual, Third Edition .

PostScript Language Tutorial and Co okbook (Addison-Wesley) contains explanatory and tutorial material to improve users’ understanding of the PostScript page description language. It introduces the PostScript language at a basic le vel .

PostScript Language P rogram Design (Addison-Wesley) teaches programming principles unique to the PostScript language with many usable samples. It is for programmers interested in the effective and efficient design of PostScript language pro grams and pri nte r dr i ver s .

PostScript Printer Description File Format Specification (Adobe) describes the PostScript Printer Description (or PPD) file format which pr ovides information in a machine-readable form about printer-specific features and about the fonts built into the printer.

PostScript Printer Description File for the Printer, available from the Adobe Developers Association, provides a device-independent way of invoking device-dependent features. It is needed by some drivers to offer complete device functionality to the user.

PostScript Languange Printer Commands 1-1

The documentation assumes a knowledge of the following:

How to reset the interpreter and page device parameters to their factory defaults.

How to physically connect a printer to a host computer or user system.

How to use the communications prot ocols and emulators implemented in the printer.

How to use the printer’s control panel.

1-2 PostScript Languange Print er Comma nds

Device Setup

The page device parameters represent particular raster output device features or processing options; the values represent the current settings of those features or options. The parameters and the current pagedevice operator is used to get the current values of these parameters.

setpagedevice operator is used to set the values of the page device

For more information about how the

setpagedevice operator is used to set up a raster

output device, refer to the Reference Manual.

Page Device Parameters

Printer

The following page device parameters are present in the printer. The semantics for the parameters appear in the Reference Manual and the Supplement.

The following table lists all the page device parameters for the

Page Device Parameters Table

Key Type Default For More Information

BeginPage

procedure {pop} See Chapter 6 of the Reference Manual.

Collate

boolean true

Duplex

boolean false See Chapter 6 of the Reference Manual.

EdgeToEdge

boolean false

EndPage

procedure {exch pop 2 ne} See Chapter 6 of the Reference Manual.

ExitJamRecovery

boolean false See Chapter 4 of the Supplement.

Fold

integer 0 See Chapter 2 of the Supplement.

See Chapter 6 of the Reference Manual and print behavior information on page 1-6.

Use:

<</PostRenderingEnhance true /PostRenderingEnhanceDetails <</EdgeToEdge true>> >> setpagedevice

Instead of:

<</EdgeToEdge true >> setpagedevice

/Printer device.

PostScript Languange Printer Commands 1-3

Page Device Parameters Table (Continued)

Key Type Default For More Information

FoldDetails

dictionary

HWResolution

array [600 600] See Chapter 6 of the Reference Manual.

ImagingBBox

array or null null See Chapter 6 of the Reference Manual.

InputAttributes

dictionary See below See Chapter 6 of the Reference Manual.

Install

Procedure See below. See Chapter 6 of the Reference Manual. Jog integer 0 See Chapter 4 of the Supplement and below. LeadingEdge

integer or

null ManualFeed boolean false See Chapter 6 of the Reference Manual. ManualFeedTimeout

integer 300 See Chapter 4 of the Supplement. Margins

array [0 0] See Chapter 4 of the Supplement. MediaType

string or

null MediaWeight

number or

null NumCopies

integer or

null = Value is read-only but changes.

<</Type 2 /FoldType 0>>

null See chapter 4 of the Supplement.

(plain) See Chapter 6 of the Reference Manual.

null See below.

See Chapter 2 of the Supplement.

See Chapter 6 of the Reference Manual and print behavior information on page 1-6.

1-4 PostScript Languange Print er Comma nds

Page Device Parameters Table (Continued)

Key Type Default For More Information

OutputAttributes

dictionary See below See Chapter 6 of the Reference Manual. OutputDevice

name or

string OutputFaceUp boolean false See Chapter 6 of the Reference Manual. OutputPage

boolean true See Chapter 4 of the Supplement. OutputType

string or

null PageDeviceName

string or

null PageSize

array See below See Chapter 4 of the Supplement. Policies

dictionary

ProcessColorModel

name or

string Staple

integer 0 See Chapter 4 of the Supplement and below. StapleDetails

dictionary See below See Chapter 4 of the Supplement and below. TraySwitch

boolean true See Chapter 4 of the Supplement and below. Tumble

boolean false See Chapter 6 of the Reference Manual. = Value is read-only but changes.

/Printer See Chapter 4 of the Supplement.

(Stacker 2) See Chapter 6 of the Reference Manual.

null See Chapter 4 of the Supplement.

<</HWResolution 0 /PolicyNotFound 1 /LeadingEdge 2 /MediaWeight 2 /OutputDevice 0 /Medi aType 2 /PolicyReport{pop} /ProcessColorModel 0 /Separations 0 /PageSize 2>>

/DeviceGray See Chapter 4 of the Supplement.

See Chapter 6 of the Reference Manual. See Chapter 4 of the Supplement and below.

PostScript Languange Printer Commands 1-5

Print Behavior With PJL Environment Variables

The following table summarizes the behavior of the /NumCopies and /Collate print parameters when used with PJL environment variables QTY and COPIES.

Using PJL Environment Variables

PJL Environment Variable PostScript Device Parameter Behavior

QTY COPIES /NumCopies /Collate

- - - - n/a n/a

- - - true n/a n/a

- - - false n/a n/a a - - - a n/a a - - true a n/a a - - false a n/a

- b - - b n/a

- b - true b n/a

- b - false n/a b

- - c - c n/a

- - c true c n/a

- - c false n/a c a b - - a*b n/a a b - true a*b n/a a b - false a b a - c - a*c n/a

Collated

Copies

Uncollated

Copies

a - c true a*c n/a a - c false a c

- b c - c n/a

- b c true c n/a

- b c false n/a c a b c - a*c n/a a b c true a*c n/a a b c false n/a c

- Parameter not set. a Numeric value entered for PJL QTY environment variable. b Numeric value entered for PJL COPIES environment variable. c Numeric value entered for PostScript /NumCopies parameter. n/a Not applicable.

1-6 PostScript Languange Print er Comma nds

Location Numbers and Corresponding Staple Location

Finisher Option

0 invalid 1* <Saddle Stitch> 2<Center> 3 <Front Corner> 4 <Rear Corner> 5 invalid 10 <Top Left> Top/Bottom 11 <Top Center> Center 12 <Top Right> Bottom + 180° rotation/Top 13 <Center Right> Center + 180° rotation 14 <Bottom Right> Top + 180° /Bottom + 180° rotation 15 <Bottom Center> Center + 180° rotation 16 <Bottom Left> Bottom + 180° rotation 17 <Center Left> Center * Booklet Finisher and Publishing Finisher only.

TraySwitch

Location Staple Location

Physical Staple

Position (LEF/SEF)

FoldType

This boolean controls whether other trays of the same paper size and media type are used when the current tray empties. The MBT is not used for this switching. If this parameter is true, then, when a tray empties the printer searches for a tray containing the same paper size and media type starting with Tray 1 and searches in order through HCF , except MBT and Inserter Tray s. The value of Priority is not used to determine the tray switching order.

Value Folding Type

0 No folding 2 Center folding

PostScript Languange Printer Commands 1-7

+ 25 hidden pages