Kyocera FS 1028DP User Manual

							1-3
Figure 1. 2.  Text Including PRESCRIBE Commands 
!R! RES; SLM 1; STM 1; SPD 0.03; FTMD 13; SFNT Helvetica-Bd; EXIT;
WELCOME TO WINDFALL NATIONAL PARK 
!R! SFNT Times-Rom; EXIT; The park entrance is located in the rolling hills of 
the Northern Woods, a forested area abundant in deer, 
elk, squirrel, rabbit, opossum, lynx, wolf, and other 
wildlife. It is the park’s most popular area, featuring 
excellent trails and campsites for hiking and backpacking.
!R! BOX 3.4, 0.55; FSET 1s5B; EXIT; Hikers should avoid this area during hunting season.
!R! SFNT Times-Rom; EXIT; Hikers in search of high-altitude adventure will find 
Mt.Baker a rewarding...
Figure 1. 3.  PRESCRIBE Example
The previous example contains five sequ ences of PRESCRIBE commands. The basic 
configuration of a PRESCRI BE command sequence is: 
!R! command; command; ...; command; EXIT; 
There is a limit to the number of commands you can include between the initial !R! and 
the final EXIT;. The initia l !R! must be followed by a space, and each command must 
end with a semicolon. 
Note
The use of PRESCRIBE commands  in document files is conditional on the behavior of your 
word processing software. Some word processing programs a dd control codes that inter-
fere with PRESCRIBE. If you ca nnot control software in this way, try using a non-word pro-
cessing mode (ASCII text function , for example) of the software.
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 1 Introduction to PRESCRIBE
1-4
Format of PRESCRIBE Commands 
The basic format of a PRESCRIBE command is: 
• • • or  • •  •  •  (command name) parameter, ..., parameter; 
The command names generally consist of three  or four letters. In most commands, the 
parameters must be followed by commas. Th e last parameter is always followed by a 
semicolon. Some commands (RES, for example) have no pa rameters. In this case, the 
command should be followed immediately by a semicolon ( RES;). 
The length of a single PRESCRIBE command is  limited to 255 characters, from the first 
letter of the command name through the final semicolon. Commands longer than 255 
characters are not executed. 
Spaces, carriage return codes,  and line feed codes are generally ignored in PRESCRIBE 
command sequences. These characters are not  generally counted in the command length.
( Exception:  Spaces are not ignored in quoted charact er strings.) To improve readability, 
place at least one space before each command  or place each command on a separate line.
Basic Concepts 
This section discusses a few basic concepts concerning how the printing system prints on 
the page. These concepts are: 
• Edge limits 
• Margins 
• Coordinate systems
• Text positioning/Character spacing
•Paths
• Logical page and physical page
• Page orientation and direction 
Edge Limits 
The printing system cannot place print on the ou tside edges of the paper. The edge limits 
to which printing is possible are located 5 mm inside the edges of the paper; or 6 mm 
(5mm in landscape orientation) from the left edge and 4 mm from the top of the paper in 
HP LaserJet emulation. Refer to the figure  Edge Limits and Margins on page 5. 
The edge limits adjust automatically to the size of the paper cassette (although not to the 
size of manually fed paper). The edge limits  can also be set to various standard sizes by 
the SPSZ (set paper size) command, or by th e equivalent HP LaserJet commands. In HP 
LaserJet emulation, the edge  limits slightly vary according to the page orientation (as 
also shown in  Edge Limits and Margins  on page 5). 
Margins 
The top and left margins are set in centimeters or inches in relation to the top and left 
edge limits of the page. The bottom and right margins can also be set as a distance from 
the top and left edge limits, or they can be set in terms of page width, page length, or 
lines per page.
Downloaded From ManualsPrinter.com Manuals 
						

							Basic Concepts
1-5
Figure 1. 4.  Edge Limits and Margins
When the printing system passes the bottom margin while printing text, it prints the page 
and feeds to the next page. Spacing is carried over, so if the bottom margin does not 
occur at an exact number of  lines, excess space is printed at the top of the next page. 
If you are using word-processing software that sets the margins automatically, you 
should not set them with PRESCRIBE commands.
Page Orientation and Direction 
The term  page orientation refers to the direction in which text is placed on the page. In a 
vertical direction, it would be called portrait and a horizontal direction would be called 
landscape. The term  print direction, which follows this section, refers to the orientation 
of the logical page’s coordinate system with  respect to the current page orientation. 
Landscape orientation
Edge limits in HP emulation Portrait Orientation
Edge limits in HP emulation
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 1 Introduction to PRESCRIBE
1-6
Page Orientation 
Changing the page orientation automatically adjusts the margins so that they remain the 
same distance from the four edges of the paper. If the printing system cannot make these 
margin settings (for example, if the left margin would be to the right of the right margin), 
it sets the margins to the edge limits. 
Fonts are automatically rotated to match the current orientation.  
Figure 1. 5.  Page Orientations
Print Direction 
The print direction can be modified in 90°  increments. These page orientations are 
referred to as portrait, landscape, reverse po rtrait, and reverse landscape. Changing the 
print direction rotates the page coordinate system in the same manner as changing the 
page orientation. However, in this case,  portrait refers to the print direction in which the 
axes of the coordinate system are oriented  in the same direction as for the currently 
selected page orientation. 
Changing the print direction also changes th e margins to maintain the same printable 
area as prior to the change. The current positio n (the physical location in which the next 
character will be printed) and its coordinate  values remain the same as in the previous 
print direction. 
Changing the print direction also changes the orientation of any subsequent raster graph-
ics and PRESCRIBE vector grap hics. However, it does not affect the orientation of any 
subsequent HP-GL/2 graphics. (HP-GL/2 graphics can only be rotated with the HP-GL/2 
RO command or the LaserJet orientation command.)
Left
margin
To p
margin
Right
margin
Bottom margin
Right
margin
Bottom margin
Left
margin
Portrait Orientation
Downloaded From ManualsPrinter.com Manuals 
						

							Basic Concepts
1-7
Figure 1. 6.  Print Direction
Coordinate Systems 
With PRESCRIBE, positions on a page are described in terms of X and  Y coordinates. 
The origin of the coordinate system (the position at which X  and Y both equal  0) is 
located at the intersection  of the top margin and the left margin. Values of  X greater than 
0  indicate positions to the right of the origin, and values of  Y indicate positions below the 
origin. See the figure on page  10. When the top and left margins are changed, the physi-
cal position of the origin changes accordingly. 
Text Positioning 
The printing system always keeps track of its current position on  the page. The current 
position can be thought of as a cursor that moves as data is printed. At any instant, the 
Current Point
Left margin
Right margin Top
margin
Bottom margin
Current point
Top margin
Right margin
Leftmargin
Bottom margin
Right margin Top margin
Current point
Left margin
Bottom margin
Current Point
Left
margin
Right margin Top
margin
Bottom margin
Landscape print direction
Portrait print direction
Reverse portrait  print direction  Reverse landscape print direction
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 1 Introduction to PRESCRIBE
1-8
cursor indicates where the next character will be printed or the next graphics will be 
drawn. (The printing system does not have separate cursors for text and graphics.) 
Text and graphics can be positioned at arbitrary locations on the page by moving the cur-
sor with positioning commands (MAP, for example). 
Figure 1. 7.  Text Positioning 
TITLE
!R! BOX 1, 1; MRP 2, 1;
EXIT; LABEL
Character Spacing 
Each character is printed within an individua l cell as shown below. The character sits on 
a line called the baseline . Characters such as y descend below the base line . 
In some character fonts, all the character cel ls are the same size, so the number of charac-
ter positions per inch is fixed. In other fonts,  the size of character cells is proportional to 
the size of characters. These pr oportional fonts produce text that is easier to read. How-
ever, in order to align the right margin, you must use software that supports the printing 
system’s proportional spacing.
Carriage Return
Space after EXIT; Cursor ends here
MRP 2, 1;
BOX 1, 1;
Landscape Orientation 
Downloaded From ManualsPrinter.com Manuals 
						

							Basic Concepts
1-9
Figure 1. 8.  Character Spacing
Paths 
A path is a set of straight and curved line segments. Paths can be open, as in the case of 
lines, or closed, as in the case of rectangles , circles, or any fully enclosed area of any 
shape. The segments may be connected with  one another, or they may be disconnected. 
Further, a path may co ntain multiple closed subpaths, representing several areas, and 
they may intersect themselves in arbitrary ways. 
Paths can be used to draw lines and curves  or specify boundaries of filled areas, includ-
ing the outline of a character. 
Paths are explained mo re fully in section Path Mode Graphics  on page 16.
Logical Page and Physical Page 
The logical page defines the limits of the coordinates within which text and graphics can 
be located. There are two types of logical page, as shown in the following figure. The 
standard mode logical page imposes limits on specifiable coordinates. The coordinates 
have no limitations for the path mode logical page. 
Font height
Baseline 
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 1 Introduction to PRESCRIBE
1-10
Figure 1. 9.  Logical Page and Physical Page
With the standard mode  logical page, any position specification that lies outside of the 
logical limits is automatically adjusted to bring it within the limits. For example, the 
page on the upper left in the preceding figur e shows what happens if you attempt to draw 
a diagonal line from below the bottom edge limit to a point to the right of the right edge 
limit when the standard mode logical page is  used. The fine line represents the line as 
specified by the user; the thick line shows what  is actually drawn by the printing system. 
With the  path mode  logical page, coordinates are not adju sted even if they fall outside of 
the edge limits. In this case, as shown in the lower right page in  the preceding figure, the 
line is defined by the specified starting and ending points, but parts falling outside of the 
edge limits are clipped.
Command Parameters 
Numeric Parameters 
Many of the PRESCRIBE commands use number values to specify parameters. For 
example, numbers are used to specify distan ces in inches, centimeters, points, or dots. 
Negative numbers are also allowed. 
y x
(0,0)
− x
x
y
−
y
Standard Mode
Path Mode= Logical page
Downloaded From ManualsPrinter.com Manuals 
						

							Command Parameters
1-11
For computer code values beyond four decimal places, the fifth and subsequent decimal 
places are ignored. 
Examples:
Some commands have angle parameters. Angles are specified in degrees. (The printing 
system does not recognize radians). The printing  system rounds off all angles to the near-
est integral degree. Only angles in the rang e from -360 degrees to 360 degrees are recog-
nized. Angles less than -360 degrees are igno red, and angles greater than 360 degrees are 
treated as the remainder of the angle divided by 360.
Examples: 
The printing system does not accept the exponential notation us ed in some computer lan-
guages. For example, do not specify 1E-3 instead of 0.001. 
Character Strings 
PRESCRIBE text-printing commands have para meters that consist of character strings. 
A character string is any stri ng of characters enclosed by quot ation marks or apostrophes, 
such as shown in the example below. 
TEXT ’You are about to enter PRESCRIBE.’; 
PRESCRIBE allows character strings to be enclosed in either single quotation marks 
(apostrophes) or double quotation marks. The following example has exactly the same 
meaning as the one above. 
TEXT You are about to enter PRESCRIBE.; 
The beginning of a character st ring is recognized when the first single or double quota-
tion mark appears. If the beginning quotation mark is a single quotation mark, the string 
does not end until the next single quotation mark. If the beginning quotation mark is a 
double quotation mark, the string does not end until the next double quotation mark. 
Whatever comes in the middle of a charact er string, including commas, semicolons, and 
even PRESCRIBE command names, is recognized  as part of the character string, and not 
as part of the PRESCRIBE command languag e. For example, the expression EXIT; in 
the following string is just text; it does not cause the printing system to exit from the 
PRESCRIBE mode. 
TEXT ’NO EXIT; NO RETURN.’; 
When the string itself contains one type of quotation mark, the quotation mark must be 
enclosed in quotes of the othe r type. Here are two examples: 
Number output by computer Number used by printing system 
1234.1234
1234.1234 
-1234.1234 -1234.1234 
0.123456 0.1234
Angle output by comput er Angle used by printing system (degrees)
90 90 
-90 -90 
90.4 90 
90.5 91 
-400 Ignored
Downloaded From ManualsPrinter.com Manuals 
						

							Chapter 1 Introduction to PRESCRIBE
1-12
TEXT You’re about to enter PRESCRIBE.; 
TEXT ’    ’; 
In the first command above, the character string starts with a double quotation mark. The 
printing system therefore expe cts the string to end with a double quotation mark, and 
regards the apostrophe in the word  Yo u ’ r e as an ordinary character, not as the string ter-
minator. 
Similarly, the double quotation marks in the second command above are recognized as 
ordinary characters, not as string terminators. 
Since an apostrophe or  quotation mark can start a char acter string anywhere in a PRE-
SCRIBE command sequence, it is important not  to start character strings unintentionally. 
The following examples demonstrate incorrect use of apostrophes and double quotation 
marks. 
Incorrect: 
!R! CMNT Don’t leave stray apostrophes; EXIT; 
Incorrect:  !R! CMNT The symbol  means inches; EXIT; 
In both of the above cases, th e printing system assumes that  the expression EXIT; is part 
of a character string started  by the preceding apostrophe or quotation mark, and fails to 
exit the PRESCRIBE mode. The correct way to write these comments is: 
Correct:
!R! CMNT Don’t leave stray apostrophes; EXIT; 
Correct: !R! CMNT ’The symbol  means inches’; EXIT;
Character strings must not exceed the 255-ch aracter limit on total command length. If a 
character string exceeds this lim it, the printing system terminates it forcibly and begins 
looking for the next PRESCRIBE command. 
Upper and Lowercase Letters
Regarding upper and lowercase characters, PR ESCRIBE follows the same rule as many 
computer programming languages: it discri minates case inside character strings and 
ignores it elsewhere. You can type co mmand names in upper or lowercase.
Correct: 
!R! TEXT ’A’; CIR 1; EXIT; 
Also correct: !R! text ’A’; cir 1; exit; 
Also correct:
Downloaded From ManualsPrinter.com Manuals