79
©
Adobe Systems Incorporated 2008 – All rights reserved
409
PDF 32000-1:2008
The MK entry may be used to provide an appearance characteristics dictionary containing additional
information for constructing the annotation’s appearance stream. Table 189 shows the contents of this
dictionary.
A
dictionary
(Optional; PDF 1.1) An action that shall be performed when the
annotation is activated (see 12.6, “Actions”).
AA
dictionary
(Optional; PDF 1.2) An additional-actions dictionary defining the
annotation’s behaviour in response to various trigger events (see 12.6.3,
“Trigger Events”).
BS
dictionary
(Optional; PDF 1.2) A border style dictionary (see Table 166) specifying
the width and dash pattern that shall be used in drawing the annotation’s
border.
The annotation dictionary’s AP entry, if present, shall take precedence
over the L and BS entries; see Table 168 and 12.5.5, “Appearance
Streams.”
Parent
dictionary
(Required if this widget annotation is one of multiple children in a field;
absent otherwise) An indirect reference to the widget annotation’s parent
field. A widget annotation may have at most one parent; that is, it can be
included in the Kids array of at most one field
Table 189 – Entries in an appearance characteristics dictionary
Key
Type
Value
R
integer
(Optional) The number of degrees by which the widget annotation shall
be rotated counterclockwise relative to the page. The value shall be a
multiple of 90. Default value: 0.
BC
array
(Optional) An array of numbers that shall be in the range 0.0 to 1.0
specifying the colour of the widget annotation’s border. The number of
array elements determines the colour space in which the colour shall be
defined:
0 No colour; transparent
1 DeviceGray
3 DeviceRGB
4 DeviceCMYK
BG
array
(Optional) An array of numbers that shall be in the range 0.0 to 1.0
specifying the colour of the widget annotation’s background. The number
of array elements shall determine the colour space, as described for BC.
CA
text string
(Optional; button fields only) The widget annotation’s normal caption,
which shall be displayed when it is not interacting with the user.
Unlike the remaining entries listed in this Table, which apply only to
wid
get annotations associated with pushbutton fields (see Pushbuttons in
12.7.4.2, “Button Fields”), the CA entry
may be used with any type of
button field, including check boxes (see Check Boxes in 12.7.4.2, “Button
Fields”) and radio buttons (Radio Buttons in 12.7.4.2, “Button Fields”).
RC
text string
(Optional; pushbutton fields only) The widget annotation’s rollover
caption, which shall be displayed when the user rolls the cursor into its
active area without pressing the mouse button.
AC
text string
(Optional; pushbutton fields only) The widget annotation’s alternate
(down) caption, which shall be displayed when the mouse button is
pressed within its active area.
Table 188 – Additional entries specific to a widget annotation (continued)
Key
Type
Value
65
PDF 32000-1:2008
410
©
Adobe Systems Incorporated 2008 – All rights reserved
12.5.6.20
Printer’s Mark Annotations
A printer’s mark annotation (PDF 1.4) represents a graphic symbol, such as a registration target, colour bar, or
cut mark, that may be added to a page to assist production personnel in identifying components of a multiple-
plate job and maintaining consistent output during production. See 14.11.3, “Printer’s Marks,” for further
discussion.
12.5.6.21
Trap Network Annotations
A trap network annotation (PDF 1.3) may be used to define the trapping characteristics for a page of a PDF
document.
NOTE
Trapping is the process of adding marks to a page along colour boundaries to avoid unwanted visual artifacts
resulting from misregistration of colorants when the page is printed.
A page shall have no more than one trap network annotation, whose Subtype entry has the value TrapNet and
which shall always be the last element in the page object’s Annots array (see 7.7.3.3, “Page Objects”). See
14.11.6, “Trapping Support,” for further discussion.
12.5.6.22
Watermark Annotations
A watermark annotation (PDF 1.6) shall be used to represent graphics that shall be printed at a fixed size and
position on a page, regardless of the dimensions of the printed page. The FixedPrint entry of a watermark
annotation dictionary (see Table 190) shall be a dictionary that contains values for specifying the size and
position of the annotation (see Table 191).
I
stream
(Optional; pushbutton fields only; shall be an indirect reference) A form
XObject defining the widget annotation’s normal icon, which shall be
displayed when it is not interacting with the user.
RI
stream
(Optional; pushbutton fields only; shall be an indirect reference) A form
XObject defining the widget annotation’s rollover icon , which shall be
displayed when the user rolls the cursor into its active area without
pressing the mouse button.
IX
stream
(Optional; pushbutton fields only; shall be an indirect reference) A form
XObject defining the widget annotation’s alternate (down) icon, which
shall be displayed when the mouse button is pressed within its active
area.
IF
dictionary
(Optional; pushbutton fields only) An icon fit dictionary (see Table 247)
specifying how the widget annotation’s icon shall be displayed within its
annotation rectangle. If present, the icon fit dictionary shall apply to all of
the annotation’s icons (normal, rollover, and alternate).
TP
integer
(Optional; pushbutton fields only) A code indicating where to position the
text of the widget annotation’s caption relative to its icon:
0 No icon; caption only
1 No caption; icon only
2 Caption below the icon
3 Caption above the icon
4 Caption to the right of the icon
5 Caption to the left of the icon
6 Caption overlaid directly on the icon
Default value: 0.
Table 189 – Entries in an appearance characteristics dictionary (continued)
Key
Type
Value
68
©
Adobe Systems Incorporated 2008 – All rights reserved
411
PDF 32000-1:2008
Watermark annotations shall have no pop-up window or other interactive elements. When displaying a
watermark annotation on-screen, conforming readers shall use the dimensions of the media box as the page
size so that the scroll and zoom behaviour is the same as for other annotations.
NOTE
Since many printing devices have non printable margins, such margins should be taken into consideration
when positioning watermark annotations near the edge of a page.
When rendering a watermark annotation with a FixedPrint entry, the following behaviour shall occur:
•
The annotation’s rectangle (as specified by its Rect entry) shall be translated to the origin and transformed
by the Matrix entry of its FixedPrint dictionary to produce a quadrilateral with arbitrary orientation.
•
The transformed annotation rectangle shall be defined as the smallest upright rectangle that encompasses
this quadrilateral; it shall be used in place of the annotation rectangle referred to in steps 2 and 3 of
"Algorithm: Appearance streams".
In addition, given a matrix B that maps a scaled and rotated page into the default user space, a new matrix shall
be computed that cancels out B and translates the origin of the printed page to the origin of the default user
space. This transformation shall be applied to ensure the correct scaling and alignment.
Table 190 – Additional entries specific to a watermark annotation
Key
Type
Value
Subtype
name
(Required) The type of annotation that this dictionary describes; shall be
Watermark for a watermark annotation.
FixedPrint
dictionary
(Optional) A fixed print dictionary (see Table 191) that specifies how this
annotation shall be drawn relative to the dimensions of the target media. If
this entry is not present, the annotation shall be drawn without any special
consideration for the dimensions of the target media.
If the dimensions of the target media are not known at the time of
drawing, drawing shall be done relative to the dimensions specified by the
page’s MediaBox entry (see Table 30).
Table 191 – Entries in a fixed print dictionary
Key
Type
Value
Type
name
(Required) Shall be FixedPrint.
Matrix
array
(Optional) The matrix used to transform the annotation’s rectangle before
rendering.
Default value: the identity matrix [ 1 0 0 1 0 0 ].
When positioning content near the edge of a page, this entry should be
used to provide a reasonable offset to allow for nonburnable margins.
H
number
(Optional) The amount to translate the associated content horizontally, as
a percentage of the width of the target media (or if unknown, the width of
the page’s MediaBox). 1.0 represents 100% and 0.0 represents 0%.
Negative values should not be used, since they may cause content to be
drawn off the page.
Default value: 0.
V
number
(Optional) The amount to translate the associated content vertically, as a
percentage of the height of the target media (or if unknown, the height of
the page’s MediaBox). 1.0 represents 100% and 0.0 represents 0%.
Negative values should not be used, since they may cause content to be
drawn off the page.
Default value: 0.
65
PDF 32000-1:2008
412
©
Adobe Systems Incorporated 2008 – All rights reserved
EXAMPLE
The following example shows a watermark annotation that prints a text string one inch from the left and
one inch from the top of the printed page.
8 0 obj
% Watermark appearance
<<
/Length ...
/Subtype /Form
/Resources ...
/BBox ...
>>
stream
...
BT
/F1 1 Tf
36 0 0 36 0 -36 Tm
(Do Not Build) Tx
ET
...
endstream
endobj
9 0 obj
% Watermark annotation
<<
/Rect ...
/Type /Annot
/Subtype /Watermark
/FixedPrint 10 0 R
/AP <</N 8 0 R>>
>>
% in the page dictionary
/Annots [9 0 R]
10 0 obj
% Fixed print dictionary
<<
/Type /FixedPrint
/Matrix [1 0 0 1 72 -72]
% Translate one inch right and one inch down
/H 0
/V 1.0
% Translate the full height of the page vertically
>>
endobj
In situations other than the usual case where the PDF page size equals the printed page size, watermark
annotations with a FixedPrint entry shall be printed in the following manner:
•
When page tiling is selected in a conforming reader (that is, a single PDF page is printed on multiple
pages), the annotations shall be printed at the specified size and position on each page to ensure that any
enclosed content is present and legible on each printed page.
•
When n-up printing is selected (that is, multiple PDF pages are printed on a single page), the annotations
shall be printed at the specified size and shall be positioned as if the dimensions of the printed page were
limited to a single portion of the page. This ensures that any enclosed content does not overlap content
from other pages, thus rendering it illegible.
12.5.6.23
Redaction Annotations
A redaction annotation (PDF 1.7) identifies content that is intended to be removed from the document. The
intent of redaction annotations is to enable the following process:
a) Content identification. A user applies redact annotations that specify the pieces or regions of content that
should be removed. Up until the next step is performed, the user can see, move and redefine these
annotations.
Documents you may be interested
Documents you may be interested