HP Pcl 5 Manual

							ENTemporary / Permanent Macros 12-5 The overlay environment consists of the current settings for the 
following features with the remainder of the environmental features 
set to their user default values: 
Refer to Chapter 3 for descriptions of environments.
NoteThe current active position (CAP, or cursor position) is not part of 
the modified print environment. Therefore, the cursor position is not 
saved when a macro is called, nor is it restored upon completion. The 
Push/Pop Cursor Position command can be used to save and recall a 
cursor position. 
Temporary / Permanent Macros 
During its definition, a macro is automatically designated as 
temporary. A temporary macro is deleted from user memory during 
a printer reset. A macro can be designated as permanent to prevent 
the printer from deleting it during a printer reset. A macro is 
designated as temporary or permanent by reference to its ID number, 
using the Macro Control command described later in this chapter.
NoteTemporary and permanent macros are removed from user memory 
whenever the printer’s power is turned off. Table 12-2
PCL CONTEXT:
Page length Paper source
Page size Number of copies
Orientation Cursor position stack
Registration 
HP-GL/2 CONTEXT:
Current Pen Position  Scaling Points
Hard Clip Limits  Soft Clip Window
Logical Page Boundaries  Fill Attributes
Line Attributes   
						

							12-6   MacrosEN
Deleting Macros 
There are several mechanisms provided by PCL macro control 
for explicit deletion of macros from user memory. These include 
commands to delete all macros, all temporary macros, or an 
individual macro by reference to its macro ID number, using the 
Macro Control command described later in this chapter.
Both temporary and permanent macros are deleted from memory 
whenever the printer’s power is turned off.
Macro ID 
The Macro ID command specifies an ID number for use in 
subsequent macro commands.
E
C & f # Y
#  =Macro ID number 
Default =0
Range =0 - 32767
This number is used in subsequent macro operations.
The factory default macro ID is 0.
Example
To establish a macro ID number of 5, send:
E
C & f 5 Y 
						

							ENMacro Control 12-7
Macro Control 
The macro control command provides mechanisms for definition, 
invocation, and deletion of macros.
E
C & f # X 
NotesA macro may call or execute another macro, which in turn may call or 
execute another macro; two levels of “nesting” are allowed.
Other than call and execute, no macro control operations may occur 
within a macro.
A printer reset command (
E
CE or UEL) is not allowed in a macro.
HP-GL/2 commands are not supported within macros on all 
HP LaserJet printers. Refer to the “PCL Feature Support Matrix” in 
Chapter 1 of the &cguide; for specifics. HP-GL/2 commands as well 
as the PCL command “Enter HP-GL/2 mode” (
E
C%#B) and the PCL 
picture frame directives are not recommended within a macro.
PCL macro control commands are not allowed while in HP-GL/2 
context. Table 12-3
# =  0 - Start macro definition (last ID specified)
1 - Stop macro definition
2 - Execute macro (last ID specified)
3 - Call macro (last ID specified)
4 - Enable macro for automatic overlay
     (last ID specified)
5 - Disable automatic overlay
6 - Delete all macros
7 - Delete all temporary macros
8 - Delete macro (last ID specified)
9 - Make macro temporary (last ID specified)
10 - Make macro permanent (last ID specified) 
						

							12-8   MacrosEN
ROM-Based Macros 
Macros can be supplied in ROM (read only memory), such as custom 
macro cartridges or on SIMM modules. The following considerations 
apply to all ROM-based macros.
zROM-based macros include the macro ID numbers for their 
macros. These numbers cannot be changed. It is possible for 
a downloaded macro to be assigned the same ID number as 
a ROM macro. If this occurs, the downloaded macro has 
precedence. To access the ROM macro, the downloaded 
macro must be deleted.
zThe ID numbers for ROM-based macros range from 0-32767.
zIn case of conflicting ID numbers in ROM-based macros, the 
following priorities apply: 
1Cartridge macros. (In printers that have two cartridge slots, 
one cartridge has priority over the other. This priority 
depends on the printer. Refer to Appendix E of the PCL 5 
Comparison Guide for the macro cartridge priority.) 
2SIMM macros. SIMM 1=highest, then SIMM 2, etc. 
Example
To define a macro with an ID of 7, send:
E
C&f7y0X
z
z
z
escape sequences, control codes, and data
z
z
z
To stop the macro definition, send:
E
C&f1X
To make the macro with an ID of 7 permanent, send:
E
C&f7y10X 
						

							ENMacro Control Example 12-9 To enable the macro with an ID of 7 for automatic overlay, send:
E
C&f7y4X
To delete the macro with an ID of 7, send:
E
C&f7y8X
Macro Control Example 
The following illustrates the definition of a letterhead macro.
Table 12-4
E
C&f1YSpecify the Macro ID as one.
E
C&f0X Start Macro Definition.
E
C&a540h360V Position logo at (540, 360) 
decipoints in the PCL coordinate 
system.
E
C*t150R Set graphics resolution to
150 dots-per-inch.
E
C*r1A Start raster image of logo.
E
C*b60W [Raster data] Send the first raster line.



E
C*b60W [Raster data] Send the last raster line.
E
C*rC Stop raster graphics.
E
C&a540h780V Position for lettering at (540, 780) 
decipoints.
E
C(1X Select font with ID of 1.
ABC Corp.  Text
Post Office Box 15  Text 
						

							12-10   MacrosEN
This macro now can be executed, called, or enabled for automatic 
overlay. Fred, Texas 83707  Text
E
C&a540h960V Position first rule at (540, 960) 
decipoints
.
E
C*c10v4680H Set rule height and width.
E
C*c0P Print the first rule.
E
C&a540h980V Position second rule at (540, 980) 
decipoint
s.
E
C*c&zero;P Print second rule.
E
C&a54&zero;h12&zero;&
zero;V Position for first line of text at (540, 
1200) decipoints.
E
C&f1X Stop Macro Definition. Table 12-4  (continued) 
						

							ENIntroduction  13-1
13
The PCL Print Model
Introduction 
The Print Model feature allows images and characters to be 
filled with any of the printer’s predefined shading or cross-hatch 
patterns, or with a user-defined pattern. Images include any 
raster graphic, such as one created with PCL raster graphics 
commands (as described in Chapter 15, Raster Graphics); a 
rectangular fill area (as described in Chapter 14, PCL 
Rectangular Area Fill Graphics); or a character or characters 
selected from any font.
Print model operation defines a pattern, source image, and 
destination image. These images are applied to each other 
using the print model’s transparent and opaque modes to 
produce a resulting image that is a combination of the others. 
The print model features, listed below, are illustrated in Figure 
13-1 and Figure 13-2, and described on the following pages.
zPattern 
zSource Image 
zDestination Image 
zSource Transparency Mode 
zPattern Transparency Mode 
Figure 13-1 Print Model Imaging 
						

							13-2   The PCL Print ModelEN
Pattern
The design which is “painted” through the black (“1” bits) area of 
the source image onto the destination image. For patterns, the Print 
Model uses one of the printer’s internal predefined eight shading 
patterns (see Figure 13-4) or one of the six cross-hatch patterns 
(see Figure 13-5), or a user-defined pattern.
NotesWhen printing a page, text and raster images are printed using the 
current pattern. The default current pattern is 100% black. The print 
model allows the current pattern to be changed to white, to one of 
the six predefined cross-hatch patterns, to one of the eight shading 
patterns, or to a user-defined pattern. Once the current pattern is 
changed, it stays in effect until another is selected or the printer is 
reset. A reset returns the current pattern to its default value (100% 
black).
The current pattern does not always apply to rectangular area fill, 
which uses patterns defined by the rectangular area fill pattern 
commands. Refer to “Transparency Mode and Rectangular Area 
Fills” at the end of this chapter for additional information.
Source Image
 An image in which the black (“1” bits) are replaced by the specified 
pattern. This is like a stencil through which the pattern is applied to 
the destination image. The source image may be defined as a 
rectangular fill area, a raster graphics image, or characters.
Destination Image
The image onto which the source image/pattern combination is 
placed. The destination image is the result of any previous 
operations.
Source Transparency Mode 
The transparency or opaqueness of the source image’s white pixels 
(the “0” bits) as they are applied to the destination image. Setting the 
source transparency mode to 1 (opaque) applies the source image’s 
white pixels to the destination image; with a setting of 0 (transparent), 
these pixels have no effect on the destination. 
						

							ENIntroduction 13-3
Pattern Transparency Mode
The transparency or opaqueness of the white pixels in the pattern. 
When set to 0 (transparent), these pixels have no effect on the 
destination; when set to 1 (opaque), they are applied through the 
black pixels of the source pattern to the destination.
Figure 13-2 Opaque and Transparency Modes
Figure 13-3 illustrates the effects of the source and pattern 
transparency modes on the final image.
In the first example (1a), the transparency mode for both the source 
image and the pattern is transparent. Since the source mode is 
“transparent,” only the black-pixeled region (the circle) of the source 
image is overlaid on the destination. Since the pattern mode is also 
transparent, the patterned source image is applied only to the white 
areas of the destination image.
In the second example (1b), the source mode is still “transparent,” 
but the pattern mode is “opaque” — so the pattern’s white pixels are 
applied to the destination. The resulting image shows the entire circle 
region visible and patterned.
In the third example (1c), the source mode is “opaque” and the 
pattern mode is transparent. Since the source mode is opaque, the 
entire source image (the circle and the surrounding square) appears 
overlaid onto the destination. The pattern, however, is allowed to pour 
through only onto the white-pixeled area of the destination. The circle 
is visible in the result, but only two opposing quarters appeared 
patterned.
In the fourth example (1d), both source and pattern modes are 
“opaque.” The entire source image is overlaid onto the destination, 
and the entire circle is patterned. 
						

							13-4   The PCL Print ModelEN
Figure 13-3 Effect of Transparency Modes on Images