ADPS Language Reference

<body background="images/gearsgr.jpg"> <table cellpadding="0" cellspacing="0" width="100%"> <tr> <td width="33%"><a href="printfrm.htm" target="_top"><img src="images/prntbtsm.gif" align="bottom" border="0" width="145" height="64"></a></td> <td rowspan="2" width="33%"><img src="images/titlew.gif" align="bottom" width="542" height="139"></td> <td width="34%"><a href="ilang.htm" target="_top"><img src="images/langbtns.gif" align="bottom" border="0" width="145" height="64"></a></td> </tr> <tr> <td width="33%"><a href="glos_frm.htm" target="_top"><img src="images/glsbtnsm.gif" align="bottom" border="0" width="145" height="64"></a></td> <td width="34%"><a href="isymfrm.htm" target="_top"><img src="images/symbtnsm.gif" align="bottom" border="0" width="145" height="64"></a></td> </tr> </table> <h1>Adobe PostScript Language Reference</h1> <h3>Operator Types </h3> <table border="1"> <tr> <td valign="top"><a href="ccaps.htm#Operand Stack Manipulation"><b>Operand Stack Manipulation</b></a></td> <td valign="top"><a href="ccaps.htm#Miscellaneous"><b>Miscellaneous Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Arithmetic and Math"><b>Arithmetic and Math Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Graphics State"><b>Graphics State Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Array"><b>Array Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Coordinate System and Matrix"><b>Coordinate System and Matrix</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Dictionary"><b>Dictionary Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Path Construction"><b>Path Construction Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#String"><b>String Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Painting"><b>Painting Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Relational, Boolean, and Bitwise"><b>Relational, Boolean, and Bitwise</b></a></td> <td valign="top"><a href="ccaps.htm#Device Setup and Output"><b>Device Setup and Output</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Control"><b>Control Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Character and Font"><b>Character and Font Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Type, Attribute, and Conversion"><b>Type, Attribute, and Conversion</b></a></td> <td valign="top"><a href="ccaps.htm#Font Cache"><b>Font Cache Operators</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#File"><b>File Operators</b></a></td> <td valign="top"><a href="ccaps.htm#Errors "><b>Errors</b></a></td> </tr> <tr> <td valign="top"><a href="ccaps.htm#Virtual Memory "><b>Virtual Memory Operators</b></a></td> <td valign="top"><a href="ccaps2.htm"><b>PostScript Level 2</b></a></td> </tr> </table> <p> </p> <h3><a name="Operand Stack Manipulation"><b>Operand Stack Manipulation</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">any <b>pop</b></td> <td valign="top">Discard top element.</td> </tr> <tr> <td valign="top">any1 any2 <b>exch</b></td> <td valign="top">Exchange top two elements.</td> </tr> <tr> <td valign="top">any <b>dup</b></td> <td valign="top">Duplicate top element.</td> </tr> <tr> <td valign="top">any1..anyn n <b>copy</b></td> <td valign="top">Duplicate top n elements.</td> </tr> <tr> <td valign="top">anyn any0 n <b>index</b></td> <td valign="top">Duplicate arbitrary element.</td> </tr> <tr> <td valign="top">an-1..a0 n j <b>roll</b></td> <td valign="top">Roll n elements up j times.</td> </tr> <tr> <td valign="top">any1..anyn <b>clear</b></td> <td valign="top">Discard all elements.</td> </tr> <tr> <td valign="top">any1..anyn <b>count</b></td> <td valign="top">Count elements on stack.</td> </tr> <tr> <td valign="top"><b>mark</b></td> <td valign="top">Push mark on stack.</td> </tr> <tr> <td valign="top">mark obj1..objn <b>cleartomark</b></td> <td valign="top">Discard elements down through mark.</td> </tr> <tr> <td valign="top">mark obj1..objn <b>counttomark</b></td> <td valign="top">Count elements down to mark.</td> </tr> </table> <p> </p> <h3><a name="Arithmetic and Math"><b>Arithmetic and Math</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">num1 num2 <b>add</b></td> <td valign="top">num1 plus num2.</td> </tr> <tr> <td valign="top">num1 num2 <b>div</b></td> <td valign="top">num1 divided by num2.</td> </tr> <tr> <td valign="top">int1 int2 <b>idiv</b></td> <td valign="top">Integer divide.</td> </tr> <tr> <td valign="top">int1 int2 <b>mod</b></td> <td valign="top">int1 mod int2.</td> </tr> <tr> <td valign="top">num1 num2 <b>mul</b></td> <td valign="top">num1 times num2.</td> </tr> <tr> <td valign="top">num1 num2 <b>sub</b></td> <td valign="top">num1 minus num2.</td> </tr> <tr> <td valign="top">num1 <b>abs</b></td> <td valign="top">Absolute value of a num1.</td> </tr> <tr> <td valign="top">num1 <b>neg</b></td> <td valign="top">Negative of num1.</td> </tr> <tr> <td valign="top">num1 <b>ceiling</b></td> <td valign="top">Ceiling of num1.</td> </tr> <tr> <td valign="top">num1 <b>floor</b></td> <td valign="top">Floor of num1.</td> </tr> <tr> <td valign="top">num1 <b>round</b></td> <td valign="top">Round num1 to nearest integer.</td> </tr> <tr> <td valign="top">num1 <b>truncate</b></td> <td valign="top">Remove fractional part of num1.</td> </tr> <tr> <td valign="top">num <b>sqrt</b></td> <td valign="top">Square root of num.</td> </tr> <tr> <td valign="top">num den <b>atan</b></td> <td valign="top">Arctangent of num/den in degrees.</td> </tr> <tr> <td valign="top">angle <b>cos</b></td> <td valign="top">Cosine of angle (degrees).</td> </tr> <tr> <td valign="top">angle <b>sin</b></td> <td valign="top">Sine of angle (degrees).</td> </tr> <tr> <td valign="top">base exponent <b>exp</b></td> <td valign="top">Raise base to exponent power.</td> </tr> <tr> <td valign="top">num <b>ln</b></td> <td valign="top">Natural logarithm (base e).</td> </tr> <tr> <td valign="top">num <b>log</b></td> <td valign="top">Logarithm (base 10).</td> </tr> <tr> <td valign="top"><b>rand</b></td> <td valign="top">Generate pseudo-random integer.</td> </tr> <tr> <td valign="top">int <b>srand</b></td> <td valign="top">Set random number seed.</td> </tr> <tr> <td valign="top"><b>rrand</b></td> <td valign="top">Return random number seed.</td> </tr> </table> <p> </p> <h3><a name="Array"><b>Array</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">int <b>array</b></td> <td valign="top">Create array of length int.</td> </tr> <tr> <td valign="top"><b>[</b></td> <td valign="top">Start array construction.</td> </tr> <tr> <td valign="top">mark obj0..objn-1 <b>]</b></td> <td valign="top">End array construction.</td> </tr> <tr> <td valign="top">array <b>length</b></td> <td valign="top">Number of elements in array.</td> </tr> <tr> <td valign="top">array index <b>get</b></td> <td valign="top">Get array element indexed by index.</td> </tr> <tr> <td valign="top">array index any <b>put</b></td> <td valign="top">Put any into array at index.</td> </tr> <tr> <td valign="top">array index count <b>getinterval</b></td> <td valign="top">Subarray of array starting at index for count.</td> </tr> <tr> <td valign="top">array1 index array2 <b>putinterval</b></td> <td valign="top">Replace subarray of array1 starting at index by array2.</td> </tr> <tr> <td valign="top">array <b>aload</b></td> <td valign="top">Push all elements of array on stack.</td> </tr> <tr> <td valign="top">any0..anyn-1 array <b>astore</b></td> <td valign="top">Pop elements from stack into array.</td> </tr> <tr> <td valign="top">array1 array2 <b>copy</b></td> <td valign="top">Copy elements of array1 to initial subarray of array2.</td> </tr> <tr> <td valign="top">array proc <b>forall</b></td> <td valign="top">Execute proc for each element of array.</td> </tr> </table> <p> </p> <h3><a name="Dictionary"><b>Dictionary</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">int <b>dict</b></td> <td valign="top">Create dictionary with capacity for int.</td> </tr> <tr> <td valign="top">dict <b>length</b></td> <td valign="top">Number of key-value pairs in dict.</td> </tr> <tr> <td valign="top">dict <b>maxlenth</b></td> <td valign="top">Capacity of dict.</td> </tr> <tr> <td valign="top">dict <b>begin</b></td> <td valign="top">Push dict on dict stack.</td> </tr> <tr> <td valign="top"><b>end</b></td> <td valign="top">Pop dict stack.</td> </tr> <tr> <td valign="top">key value <b>def</b></td> <td valign="top">Associate key and value in current dict.</td> </tr> <tr> <td valign="top">key <b>load</b></td> <td valign="top">Search dict stack for key and return associated value.</td> </tr> <tr> <td valign="top">key value <b>store</b></td> <td valign="top">Replace topmost definition of key.</td> </tr> <tr> <td valign="top">dict key <b>get</b></td> <td valign="top">Get value associated with key in dict.</td> </tr> <tr> <td valign="top">dict key value <b>put</b></td> <td valign="top">Associate key with value in dict.</td> </tr> <tr> <td valign="top">dict key <b>known</b></td> <td valign="top">Test whether key is in dict.</td> </tr> <tr> <td valign="top">key <b>where</b></td> <td valign="top">Find dict in which key is defined.</td> </tr> <tr> <td valign="top">dict1 dict2 <b>copy</b></td> <td valign="top">Copy contents of dict1 to dict2.</td> </tr> <tr> <td valign="top">dict proc <b>forall</b></td> <td valign="top">Execute proc for each element of dict.</td> </tr> <tr> <td valign="top"><b>errordict</b></td> <td valign="top">Push errordict on operand stack.</td> </tr> <tr> <td valign="top"><b>systemdict</b></td> <td valign="top">Push systemdict on operand stack.</td> </tr> <tr> <td valign="top"><b>userdict</b></td> <td valign="top">Push userdict on operand stack.</td> </tr> <tr> <td valign="top"><b>currentdict</b></td> <td valign="top">Push current dict on operand stack.</td> </tr> <tr> <td valign="top"><b>countdictstack</b></td> <td valign="top">Count elements on dict stack.</td> </tr> <tr> <td valign="top">array <b>dictstack</b></td> <td valign="top">Copy dict stack into array.</td> </tr> </table> <p> </p> <h3><a name="String"><b>String</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">int <b>string</b></td> <td valign="top">Create string of length int.</td> </tr> <tr> <td valign="top">string <b>length</b></td> <td valign="top">Number of elements in string.</td> </tr> <tr> <td valign="top">string index <b>get</b></td> <td valign="top">Get string element indexed by index.</td> </tr> <tr> <td valign="top">string index int <b>put</b></td> <td valign="top">Put int into string at index.</td> </tr> <tr> <td valign="top">string index count <b>getinterval</b></td> <td valign="top">Substring of string starting at index for count elements.</td> </tr> <tr> <td valign="top">string1 index string2 <b>putinterval</b></td> <td valign="top">Replace substring of string1 starting at index by string2.</td> </tr> <tr> <td valign="top">string1 string2 <b>copy</b></td> <td valign="top">Copy elements of string1 to initial substring of string2.</td> </tr> <tr> <td valign="top">string proc <b>forall</b></td> <td valign="top">Execute proc for each element of string.</td> </tr> <tr> <td valign="top">string seek <b>anchorsearch</b></td> <td valign="top">Determine if seek is initial substring of string.</td> </tr> <tr> <td valign="top">string seek <b>search</b></td> <td valign="top">Search for seek in string.</td> </tr> <tr> <td valign="top">string <b>token</b></td> <td valign="top">Read token from start of string.</td> </tr> </table> <p> </p> <h3><a name="Relational, Boolean, and Bitwise"><b>Relational, Boolean, and Bitwise</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">any1 any2 <b>eq</b></td> <td valign="top">Test equal.</td> </tr> <tr> <td valign="top">any1 any2 <b>ne</b></td> <td valign="top">Test not equal.</td> </tr> <tr> <td valign="top">num1|str1 num2|str2 <b>ge</b></td> <td valign="top">Test greater or equal.</td> </tr> <tr> <td valign="top">num1|str1 num2|str2 <b>gt</b></td> <td valign="top">Test greater than.</td> </tr> <tr> <td valign="top">num1|str1 num2|str2 <b>le</b></td> <td valign="top">Test less or equal.</td> </tr> <tr> <td valign="top">num1|str1 num2|str2 <b>lt</b></td> <td valign="top">Test less than.</td> </tr> <tr> <td valign="top">bool1|int1 bool2|int2 <b>and</b></td> <td valign="top">Logical | bitwise and.</td> </tr> <tr> <td valign="top">bool1|int1 <b>not</b></td> <td valign="top">Logical | bitwise not.</td> </tr> <tr> <td valign="top">bool1|int1 bool2|int2 <b>or</b></td> <td valign="top">Logical | bitwise inclusive or.</td> </tr> <tr> <td valign="top">bool1|int1 bool2|int2 <b>xor</b></td> <td valign="top">Logical | bitwise exclusive or.</td> </tr> <tr> <td valign="top"><b>true</b></td> <td valign="top">Push boolean value true.</td> </tr> <tr> <td valign="top"><b>false</b></td> <td valign="top">Push boolean value false.</td> </tr> <tr> <td valign="top">int1 shift <b>bitshift</b></td> <td valign="top">Bitwise shift of int1.</td> </tr> </table> <p> </p> <h3><a name="Control"><b>Control</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">any <b>exec</b></td> <td valign="top">Execute arbitrary object.</td> </tr> <tr> <td valign="top">bool proc <b>if</b></td> <td valign="top">Execute proc if bool is true.</td> </tr> <tr> <td valign="top">bool proc1 proc2 <b>ifelse</b></td> <td valign="top">Execute proc1 if bool is true, proc2 if bool is false.</td> </tr> <tr> <td valign="top">init incr limit proc <b>for</b></td> <td valign="top">Execute proc with values from init by steps of incr to limit.</td> </tr> <tr> <td valign="top">int proc <b>repeat</b></td> <td valign="top">Execute proc int times</td> </tr> <tr> <td valign="top">proc <b>loop</b></td> <td valign="top">Execute proc an indefinite number of times.</td> </tr> <tr> <td valign="top"><b>exit</b></td> <td valign="top">Exit innermost active loop.</td> </tr> <tr> <td valign="top"><b>stop</b></td> <td valign="top">Terminate stopped context.</td> </tr> <tr> <td valign="top">any <b>stopped</b></td> <td valign="top">Establish context for catching stop.</td> </tr> <tr> <td valign="top"><b>countexecstack</b></td> <td valign="top">Count elements on exec stack.</td> </tr> <tr> <td valign="top">array <b>execstack</b></td> <td valign="top">Copy exec stack into array.</td> </tr> <tr> <td valign="top"><b>quit</b></td> <td valign="top">Terminate interpreter.</td> </tr> <tr> <td valign="top"><b>start</b></td> <td valign="top">Executed at interpreter startup.</td> </tr> </table> <p> </p> <h3><a name="Type, Attribute, and Conversion"><b>Type, Attribute, and Conversion</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">any <b>type</b></td> <td valign="top">Return name identifying any's type.</td> </tr> <tr> <td valign="top">any <b>cvlit</b></td> <td valign="top">Make object be literal.</td> </tr> <tr> <td valign="top">any <b>cvx</b></td> <td valign="top">Make object be executable.</td> </tr> <tr> <td valign="top">any <b>xcheck</b></td> <td valign="top">Test executable attribute.</td> </tr> <tr> <td valign="top">array|file|string <b>executeonly</b></td> <td valign="top">Reduce access to execute-only.</td> </tr> <tr> <td valign="top">array|dict|file|string <b>noaccess</b></td> <td valign="top">Disallow any access.</td> </tr> <tr> <td valign="top">array|dict|file|string <b>readonly</b></td> <td valign="top">Reduce access to read-only.</td> </tr> <tr> <td valign="top">array|dict|file|string <b>rcheck</b></td> <td valign="top">Test read access.</td> </tr> <tr> <td valign="top">array|dict|file|string <b>wcheck</b></td> <td valign="top">Test write access.</td> </tr> <tr> <td valign="top">num|string <b>cvi</b></td> <td valign="top">Convert to integer.</td> </tr> <tr> <td valign="top">string <b>cvn</b></td> <td valign="top">Convert to name.</td> </tr> <tr> <td valign="top">num|string <b>cvr</b></td> <td valign="top">Convert to real.</td> </tr> <tr> <td valign="top">num radix string <b>cvrs</b></td> <td valign="top">Convert to string with radix.</td> </tr> <tr> <td valign="top">any string <b>cvs</b></td> <td valign="top">Convert to string.</td> </tr> </table> <p> </p> <h3><a name="File"><b>File</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">string1 string2 <b>file</b></td> <td valign="top">Open file identified by string1 with access string2.</td> </tr> <tr> <td valign="top">file <b>closefile</b></td> <td valign="top">Close File.</td> </tr> <tr> <td valign="top">file <b>read</b></td> <td valign="top">Read one Character from file.</td> </tr> <tr> <td valign="top">file int <b>write</b></td> <td valign="top">Write one Character to file.</td> </tr> <tr> <td valign="top">file string <b>readhexstring</b></td> <td valign="top">Read hex from file into string.</td> </tr> <tr> <td valign="top">file string <b>writehexstring</b></td> <td valign="top">Write string to file as hex.</td> </tr> <tr> <td valign="top">file string <b>readstring</b></td> <td valign="top">Read string from file.</td> </tr> <tr> <td valign="top">file string <b>writestring</b></td> <td valign="top">Write characters of string to file.</td> </tr> <tr> <td valign="top">file string <b>readline</b></td> <td valign="top">Read line from file into string.</td> </tr> <tr> <td valign="top">file <b>token</b></td> <td valign="top">Read token from file.</td> </tr> <tr> <td valign="top">file <b>bytesavailable</b></td> <td valign="top">Number of bytes available to read.</td> </tr> <tr> <td valign="top"><b>flush</b></td> <td valign="top">Send buffered data to standard output file.</td> </tr> <tr> <td valign="top">file <b>flushfile</b></td> <td valign="top">Send buffered data or read to EOF.</td> </tr> <tr> <td valign="top">file <b>resetfile</b></td> <td valign="top">Discard buffered characters.</td> </tr> <tr> <td valign="top">file <b>status</b></td> <td valign="top">Return status of file.</td> </tr> <tr> <td valign="top">string <b>run</b></td> <td valign="top">Execute contents of named file.</td> </tr> <tr> <td valign="top"><b>currentfile</b></td> <td valign="top">Return file currently being executed.</td> </tr> <tr> <td valign="top">string <b>print</b></td> <td valign="top">Write characters of string to standard output file.</td> </tr> <tr> <td valign="top">any <b>=</b></td> <td valign="top">Write text representation of any to standard output file.</td> </tr> <tr> <td valign="top">any1...anyn <b>stack</b></td> <td valign="top">Print stack nondestructively using =.</td> </tr> <tr> <td valign="top">any <b>==</b></td> <td valign="top">Write syntactic representation of any to standard output file.</td> </tr> <tr> <td valign="top">any1...anyn <b>pstack</b></td> <td valign="top">Print stack nondestructively using ==.</td> </tr> <tr> <td valign="top"><b>prompt</b></td> <td valign="top">Executed when ready for interactive input.</td> </tr> <tr> <td valign="top">bool <b>echo</b></td> <td valign="top">Turn on/off echoing.</td> </tr> </table> <p> </p> <h3><a name="Virtual Memory "><b>Virtual Memory Operators</b> </a></h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>save</b></td> <td valign="top">Create VM snapshot.</td> </tr> <tr> <td valign="top">save <b>restore</b></td> <td valign="top">Restore VM snapshot.</td> </tr> <tr> <td valign="top"><b>vmstatus</b></td> <td valign="top">Level used maximum.</td> </tr> </table> <p> </p> <h3><a name="Miscellaneous"><b>Miscellaneous</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">proc <b>Bindbind</b></td> <td valign="top">Replace operator names in proc by operators.</td> </tr> <tr> <td valign="top"><b>null</b></td> <td valign="top">Push null on operand stack.</td> </tr> <tr> <td valign="top"><b>usertime</b></td> <td valign="top">Return time in milliseconds.</td> </tr> <tr> <td valign="top"><b>version</b></td> <td valign="top">Interpreter version.</td> </tr> </table> <p> </p> <h3><a name="Graphics State"><b>Graphics State</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>gsave</b></td> <td valign="top">Save graphics state.</td> </tr> <tr> <td valign="top"><b>grestore</b></td> <td valign="top">Restore graphics state.</td> </tr> <tr> <td valign="top"><b>grestoreall</b></td> <td valign="top">Restore to bottommost graphics state.</td> </tr> <tr> <td valign="top"><b>initgraphics</b></td> <td valign="top">Reset graphics state parameters.</td> </tr> <tr> <td valign="top">num <b>setlinewidth</b></td> <td valign="top">Set line width.</td> </tr> <tr> <td valign="top"><b>currentlinewidth</b></td> <td valign="top">Return current line width.</td> </tr> <tr> <td valign="top">int <b>setlinecap</b></td> <td valign="top">Set shape of line ends for stroke.</td> </tr> <tr> <td valign="top"><b>currentlinecap</b></td> <td valign="top">Return current line cap.</td> </tr> <tr> <td valign="top">int <b>setlinejoin</b></td> <td valign="top">Set shape of corners for stroke.</td> </tr> <tr> <td valign="top"><b>currentlinejoin</b></td> <td valign="top">Return current line join.</td> </tr> <tr> <td valign="top">num <b>setmiterlimit</b></td> <td valign="top">Set miter length limit.</td> </tr> <tr> <td valign="top"><b>currentmiterlimit</b></td> <td valign="top">Return current miter limit.</td> </tr> <tr> <td valign="top">array offset <b>setdash</b></td> <td valign="top">Set dash pattern for stroking.</td> </tr> <tr> <td valign="top"><b>currentdash</b></td> <td valign="top">Return current dash pattern.</td> </tr> <tr> <td valign="top">num <b>setflat</b></td> <td valign="top">Set flatness tolerance.</td> </tr> <tr> <td valign="top"><b>currentflat</b></td> <td valign="top">Return current flatness.</td> </tr> <tr> <td valign="top">num <b>setgray</b></td> <td valign="top">Set color to gray value from 0 (black) to 1 (white).</td> </tr> <tr> <td valign="top"><b>currentgray</b></td> <td valign="top">Return current gray.</td> </tr> <tr> <td valign="top">hue sat brt <b>sethsbcolor</b></td> <td valign="top">Set color given hue, saturation, brightness.</td> </tr> <tr> <td valign="top"><b>currenthsbcolor</b></td> <td valign="top">Return current color hue, saturation, brightness.</td> </tr> <tr> <td valign="top">red green blue <b>setrgbcolor</b></td> <td valign="top">Set color given red, green, blue.</td> </tr> <tr> <td valign="top"><b>currentrgbcolor</b></td> <td valign="top">Return current color red, green, blue.</td> </tr> <tr> <td valign="top">freq angle proc <b>setscreen</b></td> <td valign="top">Set halftone screen.</td> </tr> <tr> <td valign="top"><b>currentscreen</b></td> <td valign="top">Return current halftone screen.</td> </tr> <tr> <td valign="top">proc <b>settransfer</b></td> <td valign="top">Set gray transfer function.</td> </tr> <tr> <td valign="top"><b>currenttransfer</b></td> <td valign="top">Return current transfer function.</td> </tr> </table> <p> </p> <h3><a name="Coordinate System and Matrix"><b>Coordinate System and Matrix</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>matrix</b></td> <td valign="top">Create identity matrix.</td> </tr> <tr> <td valign="top"><b>initmatrix</b></td> <td valign="top">Set CTM to device default.</td> </tr> <tr> <td valign="top">matrix <b>identmatrix</b></td> <td valign="top">Fill matrix with identity transform.</td> </tr> <tr> <td valign="top">matrix <b>defaultmatrix</b></td> <td valign="top">Fill matrix with device default matrix.</td> </tr> <tr> <td valign="top">matrix <b>currentmatrix</b></td> <td valign="top">Fill matrix with CTM.</td> </tr> <tr> <td valign="top">matrix <b>setmatrix</b></td> <td valign="top">Replace CTM by matrix.</td> </tr> <tr> <td valign="top">tx ty <b>translate</b></td> <td valign="top">Translate user space by (tx, ty).</td> </tr> <tr> <td valign="top">tx ty matrix <b>translate</b></td> <td valign="top">Define translation by (tx, ty).</td> </tr> <tr> <td valign="top">sx sy <b>scale</b></td> <td valign="top">Scale user space by sx and sy.</td> </tr> <tr> <td valign="top">sx sy matrix <b>scale</b></td> <td valign="top">Define Scalingscaling by sx and sy.</td> </tr> <tr> <td valign="top">angle <b>rotate</b></td> <td valign="top">Rotate user space by angle degrees.</td> </tr> <tr> <td valign="top">angle matrix <b>rotate</b></td> <td valign="top">Define rotation by angle degrees.</td> </tr> <tr> <td valign="top">matrix <b>concat</b></td> <td valign="top">Replace CTM by matrix X CTM.</td> </tr> <tr> <td valign="top">matrix1 matrix2 matrix3 <b>concatmatrix</b></td> <td valign="top">Fill matrix3 with matrix1 X matrix2.</td> </tr> <tr> <td valign="top">x y <b>transform</b></td> <td valign="top">Transform (x, y) by CTM.</td> </tr> <tr> <td valign="top">x y matrix <b>transform</b></td> <td valign="top">Transform (x, y) by matrix.</td> </tr> <tr> <td valign="top">dx dy <b>dtransform</b></td> <td valign="top">Transform distance (dx, dy) by CTM.</td> </tr> <tr> <td valign="top">dx dy matrix <b>dtransform</b></td> <td valign="top">Transform distance (dx, dy) by matrix.</td> </tr> <tr> <td valign="top">x' y' <b>itransform</b></td> <td valign="top">Inverse transform (x', y') by CTM.</td> </tr> <tr> <td valign="top">x' y' matrix <b>itransform</b></td> <td valign="top">Inverse transform (x', y') by matrix.</td> </tr> <tr> <td valign="top">dx' dy' <b>idtransform</b></td> <td valign="top">Inverse transform distance (dx', dy') by CTM.</td> </tr> <tr> <td valign="top">dx' dy' matrix <b>idtransform</b></td> <td valign="top">Inverse transform distance (dx', dy') by matrix.</td> </tr> <tr> <td valign="top">matrix1 matrix2 <b>invertmatrix</b></td> <td valign="top">Fill matrix2 with inverse of matrix1.</td> </tr> </table> <p> </p> <h3><a name="Path Construction"><b>Path Construction</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>newpath</b></td> <td valign="top">Initialize current path to be empty.</td> </tr> <tr> <td valign="top"><b>currentpoint</b></td> <td valign="top">Return current point coordinate.</td> </tr> <tr> <td valign="top">x y <b>moveto</b></td> <td valign="top">Set current point to (x, y).</td> </tr> <tr> <td valign="top">dx dy <b>rmoveto</b></td> <td valign="top">Relative moveto.</td> </tr> <tr> <td valign="top">x y <b>lineto</b></td> <td valign="top">Append straightline to (x, y).</td> </tr> <tr> <td valign="top">dx dy <b>rlineto</b></td> <td valign="top">Relative lineto.</td> </tr> <tr> <td valign="top">x y r ang1 ang2 <b>arc</b></td> <td valign="top">Append counterclockwise arc.</td> </tr> <tr> <td valign="top">x y r ang1 ang2 <b>arcn</b></td> <td valign="top">Append clockwise arc.</td> </tr> <tr> <td valign="top">x1 y1 x2 y2 r <b>arcto</b></td> <td valign="top">Append tangent arc.</td> </tr> <tr> <td valign="top">x1 y1 x2 y2 x3 y3 <b>curveto</b></td> <td valign="top">Append Bezier cubic section</td> </tr> <tr> <td valign="top">dx1 dy1 dx2 dy2 dx3 dy3 <b>rcurveto</b></td> <td valign="top">Relative curveto.</td> </tr> <tr> <td valign="top"><b>closepath</b></td> <td valign="top">Connect subpath back to its starting point.</td> </tr> <tr> <td valign="top"><b>flattenpath</b></td> <td valign="top">Convert curves to sequences of straight lines.</td> </tr> <tr> <td valign="top"><b>reversepath</b></td> <td valign="top">Reverse direction of current path.</td> </tr> <tr> <td valign="top"><b>strokepath</b></td> <td valign="top">Compute outline of stroked path.</td> </tr> <tr> <td valign="top">string bool <b>charpath</b></td> <td valign="top">Append Character outline to current path.</td> </tr> <tr> <td valign="top"><b>clippath</b></td> <td valign="top">Set current path to Clippingclipping path.</td> </tr> <tr> <td valign="top"><b>pathbox</b></td> <td valign="top">Return Bounding Boxbounding of current path.</td> </tr> <tr> <td valign="top">move line curve close <b>pathforall</b></td> <td valign="top">Enumerate current path.</td> </tr> <tr> <td valign="top"><b>initclip</b></td> <td valign="top">Set clip path to device default.</td> </tr> <tr> <td valign="top"><b>clip</b></td> <td valign="top">Establish new Clippingclipping path.</td> </tr> <tr> <td valign="top"><b>eoclip</b></td> <td valign="top">Clip using even-odd inside rule.</td> </tr> </table> <p> </p> <h3><a name="Painting"><b>Painting</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>erasepage</b></td> <td valign="top">Paint current page white.</td> </tr> <tr> <td valign="top"><b>fill</b></td> <td valign="top">Fill current path with current color.</td> </tr> <tr> <td valign="top"><b>eofill</b></td> <td valign="top">Fill using even-odd rule.</td> </tr> <tr> <td valign="top"><b>stroke</b></td> <td valign="top">Draw line along current path.</td> </tr> <tr> <td valign="top">width height bits/sample matrix proc <b>image</b></td> <td valign="top">Render sampled image onto current page.</td> </tr> <tr> <td valign="top">width height invert matrix proc <b>imagemask</b></td> <td valign="top">Render mask onto current page.</td> </tr> </table> <p> </p> <h3><a name="Device Setup and Output"><b>Device Setup and Output</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>showpage</b></td> <td valign="top">Output and reset current page.</td> </tr> <tr> <td valign="top"><b>copypage</b></td> <td valign="top">Output current page.</td> </tr> <tr> <td valign="top">matrix width height proc <b>banddevice</b></td> <td valign="top">Install Bandband Bufferbuffer device.</td> </tr> <tr> <td valign="top">matrix width height proc <b>framedevice</b></td> <td valign="top">Install frame Bufferbuffer device.</td> </tr> <tr> <td valign="top"><b>nulldevice</b></td> <td valign="top">Install no-output device.</td> </tr> <tr> <td valign="top">proc <b>renderbands</b></td> <td valign="top">Enumerate bands for output to device.</td> </tr> </table> <p> </p> <h3><a name="Character and Font"><b>Character and Font</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top">key Font <b>definefont</b></td> <td valign="top">Register Font as a font dictionary.</td> </tr> <tr> <td valign="top">key <b>findfont</b></td> <td valign="top">Return Font dict identified by key.</td> </tr> <tr> <td valign="top">Font scale <b>scalefont</b></td> <td valign="top">Scale Font by scale to produce new font'.</td> </tr> <tr> <td valign="top">Font matrix <b>makefont</b></td> <td valign="top">Transform Font by matrix to produce new font'.</td> </tr> <tr> <td valign="top">Font <b>setfont</b></td> <td valign="top">Set Font dictionary.</td> </tr> <tr> <td valign="top"><b>currentfont</b></td> <td valign="top">Return current Font dictionary.</td> </tr> <tr> <td valign="top">string <b>show</b></td> <td valign="top">Print characters of string on page.</td> </tr> <tr> <td valign="top">ax ay string <b>ashow</b></td> <td valign="top">Add (ax, ay) to width of each char while showing string.</td> </tr> <tr> <td valign="top">cx cy char string <b>widthshow</b></td> <td valign="top">Add (cx, cy) to width of char while showing string.</td> </tr> <tr> <td valign="top">cx cy char ax ay string <b>awidthshow</b></td> <td valign="top">Combined effect of ashow and widthshow.</td> </tr> <tr> <td valign="top">proc string <b>kshow</b></td> <td valign="top">Execute proc between characters show from string.</td> </tr> <tr> <td valign="top">string <b>stringwidth</b></td> <td valign="top">Width of string in current Font.</td> </tr> <tr> <td valign="top"><b>FontDirectory</b></td> <td valign="top">Dictionary of Font dictionaries.</td> </tr> <tr> <td valign="top"><b>StandardEncoding</b></td> <td valign="top">Standard Font encoding vector.</td> </tr> </table> <p> </p> <h3><a name="Font Cache"><b>Font Cache</b></a><b> Operators</b> </h3> <table border="1"> <tr> <td valign="top"><b>Operator Syntax</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>cachestatus</b></td> <td valign="top">Return cache status and paramaters.</td> </tr> <tr> <td valign="top">wx wy llx lly urx ury <b>setcachedevice</b></td> <td valign="top">Declare cached Character metrics.</td> </tr> <tr> <td valign="top">wx wy <b>setcharwidth</b></td> <td valign="top">Declare uncached Character metrics.</td> </tr> <tr> <td valign="top">num <b>setcachelimit</b></td> <td valign="top">Set max bytes in cached Character.</td> </tr> </table> <p> </p> <h3><a name="Errors "><b>Errors</b> </a></h3> <table border="1"> <tr> <td valign="top"><b>Error</b></td> <td valign="top"><b>Description</b></td> </tr> <tr> <td valign="top"><b>dictfull</b></td> <td valign="top">No more room in dictionary.</td> </tr> <tr> <td valign="top"><b>dictstackoverflow</b></td> <td valign="top">To many begins.</td> </tr> <tr> <td valign="top"><b>dictstackunderflow</b></td> <td valign="top">Too many ends.</td> </tr> <tr> <td valign="top"><b>execstackoverflow</b></td> <td valign="top">Exec nesting too deep.</td> </tr> <tr> <td valign="top"><b>handleerror</b></td> <td valign="top">Called to report error information.</td> </tr> <tr> <td valign="top"><b>interrupt</b></td> <td valign="top">External interrupt request.</td> </tr> <tr> <td valign="top"><b>invalidaccess</b></td> <td valign="top">Attempt to violate access attribute.</td> </tr> <tr> <td valign="top"><b>invalidexit</b></td> <td valign="top">Exit not in loop.</td> </tr> <tr> <td valign="top"><b>invalidfileaccess</b></td> <td valign="top">Unacceptable access string.</td> </tr> <tr> <td valign="top"><b>invalidfont</b></td> <td valign="top">Invalid Font name or dict.</td> </tr> <tr> <td valign="top"><b>invalidrestore</b></td> <td valign="top">Improper restore.</td> </tr> <tr> <td valign="top"><b>ioerror</b></td> <td valign="top">Input/output error occurred.</td> </tr> <tr> <td valign="top"><b>limitcheck</b></td> <td valign="top">Implementation limit exceeded.</td> </tr> <tr> <td valign="top"><b>nocurrentpoint</b></td> <td valign="top">Current point is undefined.</td> </tr> <tr> <td valign="top"><b>rangecheck</b></td> <td valign="top">Operand out of bounds.</td> </tr> <tr> <td valign="top"><b>stackoverflow</b></td> <td valign="top">Operand stack overflow.</td> </tr> <tr> <td valign="top"><b>stackunderflow</b></td> <td valign="top">Oper stack underflow.</td> </tr> <tr> <td valign="top"><b>syntaxerror</b></td> <td valign="top">Syntax error in PostScriptpostscript program text.</td> </tr> <tr> <td valign="top"><b>Timeouttimeout</b></td> <td valign="top">Time limit exceeded.</td> </tr> <tr> <td valign="top"><b>typecheck</b></td> <td valign="top">Operand of wrong type.</td> </tr> <tr> <td valign="top"><b>undefined</b></td> <td valign="top">Name not known.</td> </tr> <tr> <td valign="top"><b>undefinedfilename</b></td> <td valign="top">File not found.</td> </tr> <tr> <td valign="top"><b>undefinedresult</b></td> <td valign="top">Over/underflow or meaningless result.</td> </tr> <tr> <td valign="top"><b>unmatchedmark</b></td> <td valign="top">Expected mark not on stack.</td> </tr> <tr> <td valign="top"><b>unregistered</b></td> <td valign="top">Internal error.</td> </tr> <tr> <td valign="top"><b>VMerror</b></td> <td valign="top">VM exhausted.</td> </tr> </table> </body>