Kyocera FS 1028DP User Manual

							KPDL Operators
7-119
currentdictdictPush current dictionary on oper- 
and stack 
currentfile fileGet file currently being 
executed 
currentflat numGet current flatness tolerance 
currentfont fontGet current font dictionary 
2 currentglobal boolReturn the VM allocation mode 
currently in effect 
currentgray numGet current gray level 
gstate 2currentgstate gstateCopy the current graphics state 
2 currenthalftone halftoneReturn the curren t halftone 
dictionary 
currenthsbcolor hue  sat  brt Get current hue, saturation, and 
brightness 
currentlinecap intGet current line end type 
currentlinejoin intGet current corner type 
currentlinewidth numGet current line width 
matrix currentmatrix matrixReplace matrix with current 
transform matrix 
currentmiterlimit numGet current miter length limit 
2 currentobjectformat int Return the object format 
parameter currently in effect 
2 currentoverprint boolReturn the value of the overprint 
parameter 
2 currentpacking boolReturn the current array packing 
mode 
2 currentpagedevice dict Return a device parameter on 
the current page 
currentpoint x  yGet coordinates of current point 
currentrgbcolor red green blue Get current red/green/blue 
levels 
currentscreen freq angle proc Get current halftone screen 
currentshared Return the current stroke adjust 
parameter
3 currentsmoothness num Returns the current arc 
smoothness
2 currentstrokeadjust bool Return the current stroke adjust 
parameter 
2 currentsystemparams dict Return current values of all 
system parameters 
currenttransfer procGet current gray transfer 
function 
2 currentundercolorremoval  proc Return the under color removal 
function 
2 currentuser params dict Return current values of all user 
parameters 
x1 y1 x2 y2 x3 y3 curveto Create Bézier cubic curve from 
current point to (x3, y3) 
num/string cvi intConvert number or string to 
integer
obj cvlit objConvert object to literal 
string cvn nameConvert string to name 
num/string cvr realConvert number or string to real 
num radix string cvrs substring Convert number to 
representation in radix 
obj string cvs substring Convert object to substring of 
string 
obj cvx objConvert object to executable 
object 
key value def Place key and value in current 
dictionary 
Table 7.45.  KPDL Page Description Operators (Sheet 3 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 7 Emulation
7-120
matrixdefaultmatrix matrixReplace matrix with device 
default matrix 
key  font definefont fontDefine font as a font dictionary 
associated with key 
key instance category 2defineresource instanceDefine a resource in a specified 
category 
index any 2defineuserobject Establish an user object 
filename 2deletefile Remove the specified file 
int dict dictCreate dictionary with capacity 
for  int entries 
array dictstack subarray Copy dictionary stack to array 
num1 num2 div quotientDivide num1 by num2 
dx  dy dtransform dx’  dy’Transform distance from user to 
device space 
dx dy matrix dtransform dx’ dy’Transform distance by matrix 
obj dup obj objDuplicate top object on stack 
bool echo Turn interactive echoing on/off 
end Pop dictionary stack 
eoclip Clip using even-odd rule 
eofill Fill using even-odd rule 
any1 any2 eq boolPop two objects from the stack 
and pushes the boolean value 
true if they are equal, false if not 
erasepage Erase the current page 
obj1 obj2 exch obj2 obj1 Exchange top two objects on 
stack 
obj exec Execute preceding object 
form 2execform Paint a form 
array execstack subarray Copy execution stack into array 
index  2execuserobject Execute the user object 
array/file/string executeonly array/file/string Enable execution access only 
exit Exit innermost loop 
base exponent exp realRaise base to exponent 
false falsePush boolean value false on 
stack 
string1 string2  file fileOpen file named string1 in 
string2 access mode 
template proc scratch 2filenameforall Enumerate all files whose 
names match 
file 2fileposition positionReturn the current position in a 
file 
fill Fill current path with current 
color 
src|tgt 
param1...paramn name  2
filter fileCreate a filtered file 
name
string 3
findcolorrendering name bool Find the color rendering 
resource as spcified by 
argument
key 2findencoding arrayObtain an encoding vector 
key findfont fontGet a font dictionary identified 
by key 
key category 2findresource instanceObtain a named resource 
instance in a specified category 
flattenpath Convert curves to piecewise 
linear segments 
num1 floor num2Find greatest integer not 
exceeding num1 
flush Send data in buffer to standard 
output 
file flushfile Send data in buffer to output 
file, or read and discard rest of 
input file 
Table 7.45.  KPDL Page Description Operators (Sheet 4 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							KPDL Operators
7-121
FontDirectorydictPush directory of font 
dictionaries on stack 
init incr limit proc for Execute proc for init  to limit  in 
steps of  incr 
array proc forall Do proc for each array element 
dict  proc forall Do proc for each element of dict 
string proc forall Do proc for each element of 
string 
any 2gcheck boolReturn residence mode of any 
num/string1 
num/string2 ge
boolTest whether num/string1 is 
greater than or equal to 
num/string2 
array index get objGet array element at index 
location 
dict key get objGet value associated with key in 
dictionary 
string index get intGet string element at index 
location 
string index count getinterval substring Get substring. Index and count 
are starting location and length 
of substring
array index count getinterval subarray Get subarray. Index and count 
are starting element and length 
of subarray 
2 globaldict dictCreate a new dictionary object 
2 GlobalFontDirectory dict Push a dictionary of defined 
font 
name 2glyphshow Show a single character 
grestore Restore saved graphics state 
grestoreall Restore to bottommost graphics 
state 
gsave Save graphics state 
2 gstate gstateCreate a new graphics state 
object 
num/string1 
num/string2 gt
boolTest whether num/string1 > 
num/string2 
matrix identmatrix matrixReplace matrix with identity 
transform 
int1 int2 idiv quotientDivide int1 by int2 ; integer 
quotient 
dx’  dy’ idtransform dx  dyTransform distance from device 
to user space 
dx’ dy’ matrix idtransform dx dyTransform distance by inverse 
of matrix 
bool proc if Do proc  if bool  is true 
bool proc1 proc2 ifelse Do proc1  if bool  is true; 
otherwise do  proc2 
dict image Print bit-mapped image 
wd ht bits matrix proc image 
dict imagemask Print binary mask 
wd ht invt matrix proc imagemask 
objn...obj0  n index objn...obj0  objn Copy n-th object to top of stack 
x y userpath 2ineofill
ineofill bool
Test the current path on the 
even- odd rule for insideness 
x y userpath 2infill
infill bool
Test the current path for 
insideness 
initclip Initialize clipping path 
initgraphics Reset graphics state parameters 
initmatrix Initialize current transfer matrix 
x y userpath 2instroke
instroke bool
Test pixels in the current path 
for insideness 
Table 7.45.  KPDL Page Description Operators (Sheet 5 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 7 Emulation
7-122
x y userpath 
userpath1 userpath22
inueofill
inueofill bool Test the user path on the even-
odd rule for insideness 
x y userpath 
userpath1 userpath2 2
inufill
inufill  bool
Test the user path for insideness 
x y userpath  2inustroke 
x y userpath ma trix inustroke
userpath1 userpath2
userpath1 userpath2 inustroke 
inustroke bool
Test pixels in the user path for 
insideness 
matrix 
matrix1 matrix2 invertmatrix matrix2Replace matrix2 with inverse of 
matrix1 
2 ISOLatin1Encoding array Push the ISO Latin-1 encoding 
vector 
x’ y’ itransform x yTransform coordinates from 
device to user space 
x’ y’ matrix itransform x yTransform coordinates by 
inverse of matrix 
dict  key known boolTest whether key is in dictionary 
proc string kshow Print string, executing proc 
between characters 
2 languagelevel int Return the language level 
num/string1
num/string2 le
boolTest whether num/string1 is less 
than or equal to num/string2
array length intGet number of elements in array 
dict length intGet number of key-value pairs 
in dict 
string length intGet length of string 
name length intGet length of name 
x  y lineto Create line from current point to 
(x, y) 
num ln realGet natural logarithm 
key load valueSearch dictionary stack for key 
and return value 
num log realGet logarithm 
proc loop Do proc until exit is 
encountered 
num/string1
num/string2 lt
boolTest whether num/string1 < 
num/string2 
font matrix makefont font’Generate new font by matrix 
transformation 
dict matrix 2makepattern patternCreate an instance from a 
prototype pattern 
mark markPush mark on stack 
matrix matrixCreate identity matrix 
dict maxlength intGet capacity of dict 
int1 int2 mod remainder Find int1 module int2 (integers) 
x y moveto Move current point to (x, y) 
num1 num2 mul productMultiply num1 by num2 
obj1 obj2 ne boolTest whether obj1 is not equal to 
obj2 
num1 neg num2Get negative of num1 
newpath Initialize current path to null 
path 
array/dict/file/string noaccess array/dict/file/strin
g Disable all access
int/bool1 not int/bool2 Bitwise or logical not 
null nullPush null on operand stack 
nulldevice Install no-output device 
int/bool1 int/bool2 or int/bool3 Bitwise or logical OR 
obj0...objn-1 n 2packedarray packedarray Create a packed array 
Table 7.45.  KPDL Page Description Operators (Sheet 6 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							KPDL Operators
7-123
pathbboxllx lly urx ury Get bounding box of current 
path 
move line curve close pathfor all Do named procedures for 
current path elements 
obj pop Discard top object on stack 
string print Write string to standard output 
obj tag 2printobject Write a binary object sequence 
to the standard output 
2 product stringGet product name 
prompt Prompt for interactive input 
pstack Write entire stack to standard 
out put 
array index object put Insert object int array at index 
location 
dict key value put Place key and value in 
dictionary 
string index int put Replace character in string at 
index location 
array1 index array2 putinterval Replace subarray of array1 
starting at  index by array2  
string1 index string2 putinterval Replace substring of string1 
starting at  index by string2  
quit Terminate KPDL interpreter 
rand intGenerate pseudo-random 
integer 
array/dict/file/string rcheck boolTest if object is read-accessible 
dx1 dy1 dx2 dy2 dx3 
dy3 rcurveto
Create Bézier cubic curve to 
relative point 
file read int true or false Read one character from file; 
return false if end of file 
file string readhexstring substring bool Read hexadecimal characters 
from file into string 
file string readline substring bool Read line from file into string; 
return true if filled 
array/dict/file/string readonly array/dict/file/ 
string  Enable read access only 
file string readstring substring bool Convert file of hexadecimal 
character codes into character 
string; return true if string is 
filled 
2 realtime intReturn the real time clock value 
x y width height
numarray/numstring 2
rectclip
rectclip  Clip with a rectangular path 
x y width height
numarray/numstring 2
rectfill
rectfill Fill with a rectangular path
x y width height
x y width height matrix 
numarray
numarray matrix
numstring
numstring matrix 2
rectstroke
rectstroke
rectstroke
rectstroke
rectstroke
rectstroke Stroke with a rectangular path
old new  2renamefile Change the name of a file 
int proc repeat Do proc int times 
file resetfile Clear buffer for file 
template proc scratch 
category 2
resourceforall Enumerate all instances of a 
specified resource category 
key category 2resourcestatus status size
true (false) Return status information about 
a named resource instance 
save restore Restore saved virtual memory 
reversepath Reverse direction of current 
path printing system’s software 
2 r
evision intGet product revision 
Table 7.45.  KPDL Page Description Operators (Sheet 7 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 7 Emulation
7-124
dx  dyrlineto Create line from current point to 
relative point 
dx dy rmoveto  Move current point by relative 
amount 
ob(n-1)...ob0 n i roll ob(i-1)..ob0
ob(n01)..obi Roll top n objects on stack by 
i
(mod  n) 
2 rootfont fontReturn a root composite 
dictionary 
angle matrix rotate matrixRotate matrix transformation by 
angle (degrees) 
angle rotate Rotate user space by angle 
(degrees) 
num1 round num2Round off num1 to nearest 
integer 
rrand intGet random number seed 
string run Execute file 
save saveSave virtual memory 
sx sy matrix scale matrixDefine scaling matrix 
sx sy  scale Scale user space 
font scale scalefont font’Generate new font by scaling 
old font 
any 2scheck boolSame as gcheck 
string target search post match head 
true or string false  Search for target substring in 
string 
key scale 2selectfont Select a font and establish the 
font dictionary 
2 serialnumber intReturn the serial number to 
represent the machine 
llx lly urx ury 2setbbox Establish a bounding box for the 
current path 
proc 2setblackgeneration Set the black generation 
function parameter 
wx wy llx lly urx ury setcachedevic e Declare width and bounds of 
cached character 
w0x w0y llx lly urx
ury w1x w1y vx vy 2
setcachedevice2 Declare width and bounds of 
cached character 
num setcachelimit Declare maximum byte size of 
cached character 
mark size lower upper 2setcacheparams Set the font cache parameters 
wx wy setcharwidth Declare width and bounds of 
uncached character 
cyan magenta yellow 
black 2
setcmykcolor Set the color space to Device 
CMYK 
comp1 comp2 ... comp 
n 2
setcolor Set the current color parameter 
dict 2setcolorrendering Establish a CIE-based color 
rendering dictionary 
redfreq redang redproc
greenfreq greenang
greenproc bluefreq
blueang blueproc 
grayfreq grayang 
grayproc 2
setcolorscreen Set the halftone parameter
array (name) 2setcolorspace Specify a color space 
redproc greenproc
blueproc grayproc 2
setcolortransfer Set the transfer function 
parameter 
array offset setdash Set dash pattern for lines 
string dict 2setdevparams  Set parameters for I/O device 
file position 2setfileposition Reposition  a file 
num setflat Set flatness tolerance 
(smoothness of curves) 
font setfont Set current font dictionary 
Table 7.45.  KPDL Page Description Operators (Sheet 8 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							KPDL Operators
7-125
bool2setglobal Set the VM allocation mode 
num setgray Set gray level from 0 (black) to 
1 (white) 
gstate 2setgstate Replace the current graphics 
state 
halftone 2sethalftone Establish a halftone dictionary 
hue sat brt sethsbcolor Set hue, saturation, and 
brightness 
(converted to gray) 
int setlinecap Set butt (0), round (1), or square 
(2) line ends 
int setlinejoin Set miter (0), round (1), or bevel 
(2) corner type 
num setlinewidth Set line width 
matrix setmatrix Replace current transform 
matrix with given matrix 
num setmiterlimit Set miter length limit 
int 2setobjectformat Establish the number 
representation 
bool 2setoverprint Set the overprint parameter 
bool 2setpacking Set the array packing mode 
dict 2setpagedevice Install a page output device. 
Parameters for this operator is 
fully detailed in  KPDL Page 
Device Parameters  on page 
135.
pattern 2setpattern Establish the specified pattern 
as the current color 
red green blue setrgbcolor Set red/green/blue levels 
(converted to gray level) 
freq angle proc setscreen Set halftone screen 
bool  2setshared Same as setglobal 
num 3setsmoothness Set the smoothness to num
bool 2setstrokeadjust Set the stroke adjust parameter 
dict 2setsystemparams Set the system parameters for 
interpreter 
proc settransfer Set mapping from user gray 
scale to device gray scale 
mark blimit 2setucacheparams Set user path cache parameters 
proc 2setundercolor  removal Set the under color removal 
function parameter 
dict 2setuserparams Set user parameters for each 
context 
int 2setvmthreshold Set the allocation threshold used 
to trigger garbage collector 
2 shareddict dictSame as globaldict 
2 SharedFontDirectory  dict Same as GlobalFontDirectory 
dict 3shfill Fill the current clipping path 
with the shading defined by 
shading dictionary
string show Print string on page 
showpage Print and reset current page 
angle sin realFind sin of angle (in degrees) 
num sqrt realFind square root of number 
int srand Set random number seed 
stack Write entire stack to standard 
output as text 
StandardEncoding array Push standard  character 
code/name array on stack 
start Make KPDL interpreter ready 
bo

ol passwd 2startjob boolStart a new job with condition 
file status boolTest if file is open 
Table 7.45.  KPDL Page Description Operators (Sheet 9 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 7 Emulation
7-126
statusdictdictPush statusdict on operand stack 
stop Terminate procedure executed 
by stopped operator 
obj stopped  boolExecute object. Return true if 
stop operator is executed in 
object, false if object completes 
normally 
key value store Replace topmost definition of 
key 
int string stringCreate string of length int
string stringwidth wx wyGet width of string in current 
font 
stroke Draw line along current path 
strokepath Compute outline of path 
num1 num2 sub difference Subtract num2 from num1 
systemdict dictPush systemdict on operand 
stack 
file token token true or false  Read and interpret token in file; 
return false if file is empty 
string token tail token true or 
false Read and interpret token in 
string return false if string is 
empty 
x y transform x’ y’Transform coordinates from 
user to device space 
x y matrix transform x’ y’Transform coordinates by 
matrix 
tx ty translate Translate user space 
tx ty matrix translate matrix Define translation matrix 
true truePush boolean value true on 
stack 
num1 truncate num2Discard fraction part of num1 
obj type nameGet name identifying type of 
object 
userpath 2uappend Append the user path to the 
current path 
2 ucache Declare to cache the user path 
2 ucachestatus mark bsize bmax 
rsize rmax blimit Return user path cache 
parameters 
userpath 2ueofill Fill a user path using the 
evenodd rule 
userpath 2ufill  Interprets a user path to fill 
dict key 2undef  Remove key and value from 
dictionary 
key 2undefinefont  Remove a font definition 
key category 2undefineresource  Remove the named resource 
index 2undefineuserobject Undefi ne an user object 
bool 2upath  userpath Create a user path equivalent to 
the current path 
userdict dictPush userdict on operand stack 
2 UserObjects  arrayReturn the current user object 
array 
2 usertime intReturn time in milliseconds 
userpath
userpath matrix 2
ustroke 
2 ustroke  Draw a line along a user path 
userpath
userpath matrix  2
ustrokepath 
2 ustrokepath  Compute outline of a user path 
version stringReturn version of KPDL 
interpreter 
int 2vmreclaim  Control the garbage collector 
Table 7.45.  KPDL Page Description Operators (Sheet 10 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							KPDL Operators
7-127
KPDL Status Operators 
The operations in the table below can be used when the status dictionary is open. Some 
also require a password. 
vmstatus level used 
maximum Return virtual memory status: 
current save nesting depth, 
bytes used, and maximum byte 
size 
array/dict/file/string wcheck boolTest if object is write-accessible 
key where dict true or false Find dictionary in which key is 
defined 
cx cy char string widthshow Print string with adjusted 
spacing for specified character 
file int write Write one character to file 
file string writehexstring Convert string into file of 
hexadecimal character codes 
file obj tag 2writeobject  Write a binary object sequence 
to file 
file string writestring Write string characters to file 
obj xcheck boolTest if object is executable 
int/bool1 int/bool2 xor int/bool3 Bitwise or logical exclusive OR 
string numarray 2xshow  Print characters with x 
displacement 
string numarray 2xyshow  Print characters with x/y 
displacements 
string numarray 2yshow  Print characters with y 
displacement
Table 7.46.  KPDL Status Operators (Sheet 1 of 5)
Preceding stack Operator  Result  Description
buildtime intIdentify the build of the interpreter 
byteorder boolGet the native order in binary encoded tokens 
(true: low-order byte first, false: high-order 
byte first)
int  (string) checkpassword bool Check printing system’ s password (true: valid 
password, false: invalid password) 
defaulttimeouts job manual wait  Get timeout values 
diskonline boolCheck disk online (t rue: disk unit online, false: 
disk unit offline) 
diskstatus free total Report total disk space and free space 
dostartpage boolSee whether printing system is set to print 
status page at power-up  (true: output status, 
false: do not output) 
dosysstart boolSee whether Sys/Start file is executed at 
power-up (true: execute Sys/Start, false: do 
nothing) 
pages action initializedisk Format all writable disks 
jobname string Get current job name 
jobtimeout intGet number of seconds to job timeout (0: 
never) 
manualfeed boolTest whether printing system is in manual-feed 
mode (true: manual feed  on, false: manual feed 
off) 
manualfeedtimeout int Get manual-feed time-out value 
margins top left Get top and left calibration margins 
newsheet Feed out the single side printed page in duplex 
mode 
pagecount intGet number of pages printed so far 
(nonresettable) 
Table 7.45.  KPDL Page Description Operators (Sh eet 11 of 11)
Preceding stack Operator  Result Description 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 7 Emulation
7-128
pagestackorder boolGet current stack tray
(true: face down, false: face up) 
papersize name bool Get current paper size and orientation 
string printername substring Get printing system name 
product string Get printing system type 
ramsize intCheck available RAM size 
realformat string Get native representation for real numbers in 
binary tokens 
revision intGet KPDL revision number 
[integer ... integer] setcollatorst ackerSet sorter to collator mode 
job manual wait setdefaulttimeo utsSet timeout values. 
bool setdoprinterrors Set error-printing mode (true: print errors, 
false: do nothing) 
int setdoret Set KIR level 
bool setdostartpage Select whether to print status page at power-up 
(true: output power-on status, false: do not 
output) 
bool setdosysstart Set Sys/Start file reading mode at power-up 
(true: execute Sys/Start, false: do nothing) 
int setjobtimeout Set time-out value of current job 
[integer ... integer ] setmailboxs tackerSet sorter to mailbox mode 
top left setmargins Set top and left calibration margins 
int setmultirayid Set mail box identifier 
bool setpagestackorder Set stack tray
(true: face down, false: face up) 
old new setpassword boolSet printing system’ s password 
string setprintername Assign string as printing system name 
[integer ... integer] setsorterst acker Set sorter to sorting mode 
int setuserdiskpercent Adjust disk size for use with KPDL 
waittimeout intGet wait time-out value 
a3  Set imageable area to A3 size. See KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
b4  Set imageable area to B4 size. See KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
a4 Set imageable area to A4 size. See KPDL 
Printable Area. This operator is in userdict. 
a4small Set imageable area to small A4 size. See  KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
b5 Set imageable area to B5 size. See KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
dlenvelope
(110 x 220 envelope) Set imageable area to International DL size. 
See 
KPDL Printable Area  on page 140. This 
operator is in userdict. 
11x17 Set imageable area to 11 x 17 (Ledger) size. 
See  KPDL Printable Area  on page 140. This 
operator is in userdict. 
legal Set imageable area to legal size. See KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
letter Set imageable area to letter size. See KPDL 
Printable Area  on page 140. This operator is in 
userdict. 
lettersmall Set imageable area to small letter size. See 
KPDL Printable Area  on page 140. This 
operator is in userdict. 
executivepage Set imageable area to executive size. See 
KPDL Printable Area  on page 140. This 
operator is in userdict. 
Table 7.46.  KPDL Status Operators (Sheet 2 of 5)
Preceding stack Operator  Result  Description
Downloaded From ManualsPrinter.com Manuals