pdf viewer control in asp net c# : Add photo to pdf online software control project winforms azure wpf UWP PDF32000_200839-part2357

© 
Adobe Systems Incorporated 2008 – All rights reserved
383
PDF 32000-1:2008
Table 164 –  Entries common to all annotation dictionaries  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; if 
present, shall be Annot for an annotation dictionary. 
Subtype
name
(Required) The type of annotation that this dictionary describes; see 
Table 169 for specific values. 
Rect
rectangle
(Required) The  annotation  rectangle, defining the location of the 
annotation on the page in default user space units. 
Contents
text string
(Optional) Text that shall be displayed for the annotation or, if this type of 
annotation  does  not  display  text,  an  alternate  description  of  the 
annotation’s contents in human-readable form. In either case, this text is 
useful  when  extracting  the  document’s  contents  in  support  of 
accessibility to users with disabilities or for other purposes (see 14.9.3, 
“Alternate  Descriptions”).  See  12.5.6,  “Annotation  Types”  for  more 
details on the meaning of this entry for each annotation type.
P
dictionary
(Optional  except as noted  below;  PDF 1.3; not used  in FDF files) An 
indirect  reference  to  the  page  object  with  which  this  annotation  is 
associated. 
This  entry  shall  be  present  in  screen  annotations  associated  with 
rendition  actions  (PDF 1.5;  see  12.5.6.18,  “Screen  Annotations”  and 
12.6.4.13, “Rendition Actions”).
NM
text string
(Optional;  PDF 1.4) The  annotation  name, a text string uniquely 
identifying it among all the annotations on its page. 
M
date or 
text string
(Optional; PDF 1.1) The date and time when the annotation was most 
recently  modified. The format should be a  date string as described in 
7.9.4, “Dates,” but conforming readers shall accept and display a string 
in any format. 
F
integer
(Optional; PDF 1.1) A set of flags specifying various characteristics of 
the annotation (see 12.5.3, “Annotation Flags”). Default value: 0. 
AP
dictionary
(Optional;  PDF 1.2) An  appearance  dictionary specifying how the 
annotation  shall  be  presented  visually  on  the  page  (see  12.5.5, 
“Appearance Streams”). Individual annotation handlers may ignore this 
entry and provide their own appearances.
AS
name
(Required  if  the  appearance  dictionary AP  contains  one  or  more 
subdictionaries;  PDF 1.2) The annotation’s  appearance  state, which 
selects  the  applicable  appearance  stream  from  an  appearance 
subdictionary (see Section 12.5.5, “Appearance Streams”). 
Add photo to pdf online - insert images into PDF in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Sample C# code to add image, picture, logo or digital photo into PDF document page using PDF page editor control
adding an image to a pdf in preview; how to add an image to a pdf in acrobat
Add photo to pdf online - VB.NET PDF insert image library: insert images into PDF in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide VB.NET Programmers How to Add Images in PDF Document
add an image to a pdf; adding images to a pdf document
PDF 32000-1:2008
384
© 
Adobe Systems Incorporated 2008 – All rights reserved
12.5.3
Annotation Flags
The value  of the annotation dictionary’s F  entry is an  integer  interpreted  as one-bit flags  specifying various 
characteristics of the annotation. Bit positions within the flag word shall be numbered from low-order to high-
order, with the lowest-order bit numbered 1. Table 165 shows the meanings of the flags; all other bits of the 
integer shall be set to 0. 
Border
array
(Optional) An array specifying the characteristics of the annotation’s 
border, which shall be drawn as a rounded rectangle. 
(PDF 1.0) The array consists of three numbers defining the horizontal 
corner radius, vertical corner radius, and border width, all in default user 
space units. If the corner radii are 0, the border has square (not rounded) 
corners; if the border width is 0, no border is drawn.
(PDF 1.1) The array may have a fourth element, an optional dash array
defining a pattern of dashes and gaps that shall be used in drawing the 
border. The dash array shall be specified in the same format as in the 
line  dash  pattern  parameter  of  the  graphics  state  (see 8.4.3.6,  “Line 
Dash Pattern”). 
EXAMPLE
Border value of [ 0  0  1  [ 3  2 ] ] specifies a border 1 
unit  wide,  with  square  corners,  drawn  with  3-unit 
dashes alternating with 2-unit gaps. 
NOTE
(PDF 1.2) The dictionaries for some annotation types (such 
as free text and polygon annotations) can include the BS
entry. That entry specifies a border style dictionary that has 
more settings than the array specified for the Border entry. 
If an annotation dictionary includes the BS entry, then the 
Border entry is ignored.
Default value: [ 0  0  1 ]. 
C
array
(Optional;  PDF 1.1) An array of numbers in the range 0.0 to 1.0, 
representing a colour used for the following purposes: 
The background of the annotation’s icon when closed 
The title bar of the annotation’s pop-up window 
The border of a link annotation
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 
StructParent
integer
(Required if the annotation is a structural content  item; PDF 1.3) The 
integer key of the annotation’s entry in  the structural parent tree  (see 
14.7.4.4, “Finding Structure Elements from Content Items”). 
OC
dictionary
(Optional;  PDF 1.5) An optional content group or optional content 
membership  dictionary  (see  8.11,  “Optional  Content”)  specifying  the 
optional content properties for the annot
ation. Before the annotation is 
drawn, its visibility shall be determined based on this entry as well as the 
annotation flags specified in the F entry (see 12.5.3, “Annotation Flags”). 
If it is determined to be invisible, the an
notation shall be skipped, as if it 
were not in the document.
Table 164 –  Entries common to all annotation dictionaries  (continued)
Key
Type
Value
VB.NET Image: Mark Photo, Image & Document with Polygon Annotation
VB.NET Imaging - Polygon Annotation Control. This online tutorial page aims to What's more, if coupled with .NET PDF document imaging add-on, the VB
how to add image to pdf file; how to add picture to pdf
VB.NET Image: Image Cropping SDK to Cut Out Image, Picture and
This online tutorial page will illustrate the image VB.NET image cropping method to crop picture / photo; size of created cropped image file, add antique effect
acrobat insert image in pdf; how to add image to pdf form
© 
Adobe Systems Incorporated 2008 – All rights reserved
385
PDF 32000-1:2008
Table 165 –  Annotation flags  
Bit 
position
Name
Meaning
1
Invisible
If set, do not display the annotation if it does not belong to one of the 
standard annotation  types  and no  annotation handler is available. If 
clear,  display  such  an  unknown  annotation  using  an  appearance 
stream  specified  by  its  appearance  dictionary,  if  any  (see  12.5.5, 
“Appearance Streams”). 
2
Hidden
(PDF 1.2) If set, do not display or print the annotation or allow it to 
interact with the user, regardless of its annotation type or whether an 
annotation handler is available. 
NOTE 1
In cases where screen space is limited, the ability to hide 
and  show  annotations  selectively  can  be  used  in 
combination  with  appearance  streams  (see  12.5.5, 
“Appearance  Streams”)  to  display  auxiliary  pop-up 
information similar in function to online help systems. 
3
Print
(PDF 1.2) If set, print the annotation when the page is printed. If clear, 
never print the annotation, regardless of whether it is displayed on the 
screen. 
NOTE 2
This can be useful for annotations representing interactive 
pushbuttons, which would serve no meaningful  purpose 
on the printed page. 
4
NoZoom
(PDF 1.3) If set, do not scale the annotation’s appearance to match the 
magnification of the page. The location of the annotation on the page 
(defined  by  the  upper-left  corner  of  its  annotation  rectangle)  shall 
remain  fixed,  regardless  of  the  page  magnification.  See  further 
discussion following this Table. 
5
NoRotate
(PDF 1.3) If set, do not rotate the annotation’s appearance to match 
the  rotation  of  the  page.  The  upper-left  corner  of  the  annotation 
rectangle shall remain in a fixed location on the page, regardless of the 
page rotation. See further discussion following this Table. 
6
NoView
(PDF 1.3) If set, do not display the annotation on the screen or allow it 
to interact with the user. The annotation may be printed (depending on 
the  setting  of  the  Print  flag)  but  should  be  considered  hidden  for 
purposes of on-screen display and user interaction. 
7
ReadOnly
(PDF 1.3) If set, do not allow the annotation to interact with the user. 
The annotation may be displayed or printed (depending on the settings 
of the NoView and Print flags) but should not respond to mouse clicks 
or change its appearance in response to mouse motions. 
This  flag  shall  be  ignored  for  widget  annotations;  its  function  is 
subsumed  by  the  ReadOnly  flag  of  the  associated  form  field  (see 
Table 221). 
8
Locked
(PDF  1.4) If set, do not allow the annotation to be deleted or its 
properties  (including  position  and  size)  to  be  modified  by  the  user. 
However,  this  flag  does  not  restrict  changes  to  the  annotation’s 
contents, such as the value of a form field. 
9
ToggleNoView
(PDF 1.5) If set, invert the interpretation of the NoView flag for certain 
events. 
NOTE 3
A typical use is to have an annotation that appears only 
when a mouse cursor is held over it.
10
LockedContents
(PDF 1.7) If set, do not allow the contents of the annotation to be 
modified  by  the  user.  This  flag  does  not  restrict  deletion  of  the 
annotation or changes to other annotation properties, such as position 
and size. 
VB.NET Image: Image Scaling SDK to Scale Picture / Photo
To help you know more about this VB.NET image scaling control add-on, we scaling control SDK API, developer can only scale one image / picture / photo at a
add photo pdf; add image pdf document
VB.NET Image: Image Resizer Control SDK to Resize Picture & Photo
VB.NET Image & Photo Resizing Overview. The practical this VB.NET image resizer control add-on, can powerful & profession imaging controls, PDF document, image
add picture to pdf in preview; add a picture to a pdf file
PDF 32000-1:2008
386
© 
Adobe Systems Incorporated 2008 – All rights reserved
If the NoZoom flag is set, the annotation shall always maintain the same fixed size on the screen and shall be 
unaffected by the magnification level at which the page itself is displayed. Similarly, if the NoRotate flag is set, 
the annotation  shall  retain  its original  orientation  on the screen  when the  page  is  rotated  (by  changing  the 
Rotate entry in the page object; see 7.7.3, “Page Tree”). 
In either case, the annotation’s position shall be determined by the coordinates of the upper-left corner of its 
annotation rectangle, as defined by the Rect entry in the annotation dictionary and interpreted in the default 
user space of the page.  When the default  user space  is scaled or  rotated,  the positions of  the  other  three 
corners of the annotation rectangle are different in the altered user space than they were in the original user 
space. The conforming reader shall perform this alteration automatically. However, it shall not actually change 
the  annotation’s Rect  entry,  which  continues  to  describe  the  annotation’s  relationship  with  the  unscaled, 
unrotated user space. 
NOTE
Figure 58 shows how an annotation whose NoRotate flag is set remains upright when the page it is on is 
rotated 90 degrees clockwise. The upper-left corner of the annotation remains at the same point in default user 
space; the annotation pivots around that point. 
Figure 58 –  Coordinate adjustment with the NoRotate flag
12.5.4
Border Styles
An annotation may optionally be surrounded by a border when displayed or printed. If present, the border shall 
be drawn completely inside the annotation  rectangle.  In PDF  1.1, the characteristics  of  the  border shall be 
specified by the Border entry in the annotation dictionary (see Table 164). Beginning with PDF 1.2, the border 
characteristics for some types of annotations may instead be specified in a border style dictionary designated 
by the annotation’s BS entry. Such dictionaries may also be used to specify the width and dash pattern for the 
lines drawn by line, square, circle, and ink annotations. Table 166 summarizes the contents of the border style 
dictionary. If neither the Border nor the BS entry is present, the border shall be drawn as a solid line with a 
width of 1 point. 
Table 166 –  Entries in a border style dictionary  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; if present, 
shall be Border for a border style dictionary. 
W
number
(Optional) The border width in points. If this value is 0, no border shall drawn. 
Default value: 1. 
Before page rotation
abcdefghijklm
nopqrstuvwxyz
(0, 0)
After page rotation
abcdefghijklm
nopqrstuvwxyz
(0, 0)
C# Image: How to Add Antique & Vintage Effect to Image, Photo
this C#.NET antique effect creating control add-on is widely used in modern photo editors, which powerful & profession imaging controls, PDF document, tiff
add picture to pdf preview; add picture to pdf file
VB.NET Image: How to Save Image & Print Image Using VB.NET
NET programmers save & print image / photo / picture from NET method and demo code to add image printing printing multi-page document files, like PDF and Word
add image to pdf; how to add image to pdf in acrobat
© 
Adobe Systems Incorporated 2008 – All rights reserved
387
PDF 32000-1:2008
Beginning with  PDF  1.5,  some annotations  (square,  circle,  and  polygon) may have  a BE  entry,  which  is  a 
border effect dictionary that specifies an effect that shall be applied to the border of the annotations. Beginning 
with PDF 1.6, the free text annotation may also have a BE entry. Table 167 describes the entries in a border 
effect dictionary.
12.5.5
Appearance Streams
Beginning with PDF 1.2, an annotation may specify one or more appearance streams as an alternative to the 
simple  border  and  colour  characteristics  available  in  earlier  versions.  Appearance  streams  enable  the 
annotation to be presented visually in different ways to reflect its interactions with the user. Each appearance 
stream is a form XObject (see 8.10, “Form XObjects”): a self-contained content stream that shall be rendered 
inside the annotation rectangle. 
The algorithm outlined in this sub-clause shall be used to map from the coordinate system of the appearance 
XObject (as defined by its Matrix entry; see Table 97) to the annotation’s rectangle in default user space:
S
name
(Optional) The border style: 
S
(Solid) A solid rectangle surrounding the annotation. 
D
(Dashed)  A  dashed  rectangle  surrounding  the  annotation.  The  dash 
pattern may be specified by the D entry. 
B
(Beveled) A simulated embossed  rectangle that  appears  to be  raised 
above the surface of the page. 
I
(Inset)  A  simulated  engraved  rectangle  that  appears  to  be  recessed 
below the surface of the page. 
U
(Underline) A single line along the bottom of the annotation rectangle. 
 conforming  reader  shall  tolerate  other  border  styles  that  it  does  not 
recognize and shall use the default value. 
D
array
(Optional) A dash array defining a pattern of dashes and gaps that shall be
used in drawing a dashed border (border style D in the S entry). The dash 
array  shall  be  specified  in  the  same  format  as  in  the  line  dash  pattern 
parameter of the graphics state (see 8.4.3.6, “Line Dash Pattern”). The dash 
phase is not specified and shall be assumed to be 0. 
EXAMPLE
D  entry of  [ 3  2 ] specifies  a border  drawn  with  3-point 
dashes alternating with 2-point gaps. 
Default value: [ 3 ]. 
Table 167 –  Entries in a border effect dictionary  
Key
Type
Value
S
name
(Optional) A name representing the border effect to apply. Possible values 
are:
S No effect: the border shall be as described by the annotation dictionary’s 
BS entry.
C The border should appear “cloudy”. The width and dash array specified by 
BS shall be honored.
Default value: S.
I
number
(Optional; valid only if the value of S is C) A number describing the intensity of 
the effect, in the range 0 to 2. Default value: 0.
Table 166 –  Entries in a border style dictionary  (continued)
Key
Type
Value
VB.NET Image: Tutorial for Flipping Image Using Our .NET Image SDK
version of .NET imaging SDK and add the following becomes a mirror reflection of the photo on the powerful & profession imaging controls, PDF document, tiff
adding an image to a pdf in acrobat; add multiple jpg to pdf
C# PDF remove image library: remove, delete images from PDF in C#.
Support removing vector image, graphic picture, digital photo, scanned signature, logo, etc. Remove Image from PDF Page Using C#. Add necessary references:
add an image to a pdf form; adding a png to a pdf
PDF 32000-1:2008
388
© 
Adobe Systems Incorporated 2008 – All rights reserved
Algorithm: Appearance streams
a) The  appearance’s  bounding  box  (specified  by  its BBox  entry)  shall  be  transformed,  using Matrix,  to 
produce a quadrilateral with arbitrary orientation. The transformed appearance box  is the smallest upright 
rectangle that encompasses this quadrilateral.
b) A matrix A shall be computed that scales and translates the transformed appearance box to align with the 
edges of the annotation’s rectangle (specified by the Rect entry). A maps the lower-left corner (the corner 
with the  smallest x  and y coordinates) and the upper-right  corner  (the corner with the  greatest x and y
coordinates)  of  the  transformed  appearance  box  to  the  corresponding  corners  of  the  annotation’s 
rectangle.
c) Matrix  shall  be concatenated  with A to form a matrix AA that maps from  the  appearance’s  coordinate 
system to the annotation’s rectangle in default user space:
AA = Matrix ¥ A
The annotation may  be further scaled and rotated if either the NoZoom or NoRotate flag is  set (see 12.5.3, 
“Annotation  Flags”).  Any  transformation  applied  to  the  annotation  as  a  whole  shall  also  applied  to  the 
appearance within it.
Starting  with  PDF  1.4,  an  annotation  appearance  may  include  transparency.  If  the  appearance’s  stream 
dictionary does not contain a Group entry,  it shall be treated  as a  non-isolated, non-knockout transparency 
group.  Otherwise,  the  isolated  and  knockout  values  specified  in  the  group  dictionary  (see  11.6.6, 
“Transparency Group XObjects”) shall be used.
The transparency group shall be composited with a backdrop consisting of the page content along with any 
previously painted annotations, using a blend mode of Normal, an alpha constant of 1.0, and a soft mask of 
None
NOTE 1
If  a  transparent  annotation  appearance  is  painted  over  an  annotation  that  is  drawn  without  using  an 
appearance stream, the effect is implementation-dependent. This is because such annotations are sometimes 
drawn by means that do not conform to the PDF imaging model. Also, the effect of highlighting a transparent 
annotation appearance is implementation-dependent. 
An annotation may define as many as three separate appearances: 
The normal appearance  shall  be  used  when  the  annotation  is  not  interacting  with  the  user.  This 
appearance is also used for printing the annotation. 
The rollover appearance  shall be used when the user moves the cursor into the annotation’s active area 
without pressing the mouse button. 
The down appearance  shall  be  used  when  the  mouse  button  is  pressed  or  held  down  within  the 
annotation’s active area. 
NOTE 2
As used here, the term mouse denotes a generic pointing device that controls the location of a cursor on the 
screen  and has at  least  one  button  that can  be pressed,  held  down,  and released. See 12.6.3,  “Trigger 
Events,” for further discussion. 
The normal, rollover, and down appearances shall be defined in an appearance dictionary, which in turn is the 
value  of  the  AP  entry  in  the  annotation  dictionary  (see  Table 164).  Table 168  shows  the  contents  of  the 
appearance dictionary. 
© 
Adobe Systems Incorporated 2008 – All rights reserved
389
PDF 32000-1:2008
Each entry in the appearance dictionary  may contain  either a single appearance stream  or  an appearance 
subdictionary. In the latter case, the subdictionary shall define multiple appearance streams corresponding to 
different appearance states of the annotation. 
EXAMPLE
An annotation representing an interactive check box may have two appearance states named On and Off. 
Its appearance dictionary may be defined as 
/AP <<   /N  <<   /On formXObject
1
/Off formXObject
2
  >>
 /D   <<   /On formXObject
3
/Off formXObject
4
 >>
 >>
where formXObject
1
and formXObject
2
define the check box’s normal appearance in its checked and 
unchecked states, and formXObject
3
and formXObject
4
provide visual feedback, such as emboldening its 
outline, when the user clicks it. (No R entry is defined because no special appearance is needed when the 
user moves the cursor over the check box without pressing the mouse button.) The choice between the 
checked and unchecked appearance states is determined by the AS entry in the annotation dictionary 
(see Table 164). 
NOTE 3
If a conforming reader does not have native support for a particular annotation type conforming readers shall 
display  the  annotation  with  its  normal  (N)  appearance. Conforming  readers  shall  also  attempt to  provide 
reasonable behavior (such as displaying nothing) if an annotation’s AS entry designates an appearance state 
for which no appearance is defined in the appearance dictionary. 
For convenience in managing appearance streams that are used repeatedly, the AP entry in a PDF document’s 
name dictionary (see 7.7.4, “Name Dictionary”) may contain a name tree mapping name strings to appearance 
streams. The name strings have no standard meanings; no PDF objects may refer to appearance streams by 
name. 
12.5.6
Annotation Types
12.5.6.1
General
PDF supports the standard annotation types listed in Table 169. The following sub-clauses describe each of 
these types in detail. 
The values in the first column of Table 169 represent the value of the annotation dictionary’s Subtype entry. 
The third column indicates whether the annotation is a markup annotation, as described in 12.5.6.2, “Markup 
Annotations.”  The  sub-clause  also  provides  more  information  about  the  value  of  the Contents  entry  for 
different annotation types.
Table 168 –  Entries in an appearance dictionary  
Key  Type 
Value
N
stream or dictionary
(Required) The annotation’s normal appearance. 
R
stream or dictionary
(Optional) The annotation’s rollover appearance. Default value: the 
value of the N entry. 
D
stream or dictionary
(Optional) The annotation’s down appearance. Default value: the value 
of the N entry. 
PDF 32000-1:2008
390
© 
Adobe Systems Incorporated 2008 – All rights reserved
Table 169 –  Annotation types  
Annotation type
Description
Markup
Discussed in sub-clause
Text
Text annotation 
Yes
12.5.6.4, “Text Annotations”
Link
Link annotation 
No
12.5.6.5, “Link Annotations”
FreeText
(PDF 1.3) Free text annotation 
Yes
12.5.6.6, “Free Text Annotations”
Line
(PDF 1.3) Line annotation 
Yes
12.5.6.7, “Line Annotations”
Square
(PDF 1.3) Square annotation 
Yes
12.5.6.8, “Square and Circle 
Annotations”
Circle
(PDF 1.3) Circle annotation 
Yes
12.5.6.8, “Square and Circle 
Annotations”
Polygon
(PDF 1.5) Polygon annotation 
Yes
12.5.6.9, “Polygon and Polyline 
Annotations”
PolyLine
(PDF 1.5) Polyline annotation 
Yes
12.5.6.9, “Polygon and Polyline 
Annotations”
Highlight
(PDF 1.3) Highlight annotation 
Yes
12.5.6.10, “Text Markup Annotations”
Underline
(PDF 1.3) Underline 
annotation 
Yes
12.5.6.10, “Text Markup Annotations”
Squiggly
(PDF 1.4) Squiggly-underline 
annotation 
Yes
12.5.6.10, “Text Markup Annotations”
StrikeOut
(PDF 1.3) Strikeout annotation 
Yes
12.5.6.10, “Text Markup Annotations”
Stamp
(PDF 1.3) Rubber stamp 
annotation 
Yes
12.5.6.12, “Rubber Stamp Annotations”
Caret
(PDF 1.5) Caret annotation
Yes
12.5.6.11, “Caret Annotations”
Ink
(PDF 1.3) Ink annotation 
Yes
12.5.6.13, “Ink Annotations”
Popup
(PDF 1.3) Pop-up annotation 
No
12.5.6.14, “Pop-up Annotations”
FileAttachment
(PDF 1.3) File attachment 
annotation 
Yes
12.5.6.15, “File Attachment Annotations”
Sound
(PDF 1.2) Sound annotation 
Yes
12.5.6.16, “Sound Annotations”
Movie
(PDF 1.2) Movie annotation 
No
12.5.6.17, “Movie Annotations”
Widget
(PDF 1.2) Widget annotation 
No
12.5.6.19, “Widget Annotations”
Screen
(PDF 1.5) Screen annotation
No
12.5.6.18, “Screen Annotations”
PrinterMark
(PDF 1.4) Printer’s mark 
annotation 
No
12.5.6.20, “Printer’s Mark Annotations”
TrapNet
(PDF 1.3) Trap network 
annotation 
No
12.5.6.21, “Trap Network Annotations”
Watermark
(PDF 1.6) Watermark 
annotation
No
12.5.6.22, “Watermark Annotations”
3D
(PDF 1.6) 3D annotation
No
13.6.2, “3D Annotations”
Redact
(PDF 1.7) Redact annotation
Yes
12.5.6.23, “Redaction Annotations”
© 
Adobe Systems Incorporated 2008 – All rights reserved
391
PDF 32000-1:2008
12.5.6.2
Markup Annotations
As mentioned in 12.5.2, “Annotation Dictionaries,” the  meaning of an annotation’s Contents entry varies by 
annotation type. Typically, it is the text that shall be displayed for the annotation or, if the annotation does not 
display text, an alternate description of the annotation’s contents in human-readable form. In either case, the 
Contents entry is useful when extracting the document’s contents in support of accessibility to users with 
disabilities or for other purposes (see 14.9.3, “Alternate Descriptions”).
Many annotation types are defined as markup annotations because they are used primarily to mark up PDF 
documents (see Table 170). These annotations have text that appears as part of the annotation and may be 
displayed in other ways by a conforming reader, such as in a Comments pane. 
Markup annotations may be divided into the following groups:
Free  text  annotations  display  text  directly  on  the  page.  The  annotation’s Contents  entry  specifies  the 
displayed text.
Most other markup annotations have an associated pop-up window that may contain text. The annotation’s 
Contents entry specifies the text that shall be displayed when the pop-up window is opened. These 
include text, line, square, circle, polygon, polyline, highlight, underline, squiggly-underline, strikeout, rubber 
stamp, caret, ink, and file attachment annotations.
Sound  annotations  do  not  have  a pop-up  window  but may also  have  associated  text  specified  by  the 
Contents entry.
When separating text into  paragraphs, a CARRIAGE RETURN (0Dh) shall be used and not, for example, a 
LINE FEED character (0Ah).
NOTE 1
A subset of markup annotations is called text markup annotations (see 12.5.6.10, “Text Markup Annotations”).
The remaining annotation types are not considered markup annotations:
The pop-up annotation type shall not appear by itself; it shall be associated with a markup annotation that uses it to 
display text. 
NOTE 2
If an annotation has no parent, the Contents entry shall represent the text of the annotation, otherwise it shall 
be ignored by a conforming reader.
For all other annotation types (LinkMovieWidget, PrinterMark, and TrapNet), the Contents entry shall 
provide an alternate representation of the annotation’s contents in human-readable form, which is useful 
when extracting the document’s contents in support of accessibility to users with disabilities or for other 
purposes (see 14.9.3, “Alternate Descriptions”).
Table 170 lists entries that apply to all markup annotations. 
Table 170 –  Additional entries specific to markup annotations  
Key
Type
Value
T
text string
(Optional; PDF 1.1) The text label that shall be displayed in the title bar of 
the annotation’s pop-up window when open and active. This entry shall 
identify the user who added the annotation.
Popup
dictionary
(Optional;  PDF 1.3) An indirect reference to a pop-up annotation for 
entering or editing the text associated with this annotation. 
PDF 32000-1:2008
392
© 
Adobe Systems Incorporated 2008 – All rights reserved
CA
number
(Optional;  PDF 1.4) The constant opacity value that shall be used in 
painting the annotation (see Sections 11.2, “Overview of Transparency,”
and 11.3.7, “Shape and Opacity Computations”). This value shall apply to 
all  visible  elements  of  the  annotation  in  its  closed  state  (including  its 
background and border) but not to the pop-up window that appears when 
the annotation is opened. 
The specified value shall not used if the annotation has an appearance 
stream (see 12.5.5, “Appearance Streams”); in that case, the appearance 
stream shall specify any transparency. (However, if the compliant viewer 
regenerates the annotation’s appearance stream, it may incorporate the 
CA value into the stream’s content.)
The implicit blend mode (see 11.3.5, “Blend Mode””) is Normal. Default 
value: 1.0. 
If no explicit appearance stream is defined for the annotation, it may be
painted  by  implementation-dependent  means  that  do  not  necessarily 
conform to the PDF imaging model; in this case, the effect of this entry is 
implementation-dependent as well. 
RC
text string 
or text 
stream
(Optional; PDF 1.5) A rich text string (see 12.7.3.4, “Rich Text Strings”) 
that  shall  be  displayed  in  the  pop-up  window  when  the  annotation  is 
opened.
CreationDate
date
(Optional;  PDF  1.5) The date and time (7.9.4, “Dates”) when the 
annotation was created.
IRT
dictionary
(Required  if  an RT  entry  is  present,  otherwise  optional;  PDF  1.5) A 
reference  to  the  annotation  that  this  annotation  is  “in  reply  to.”  Both 
annotations shall be on the same page of the document. The relationship 
between the two annotations shall be specified by the RT entry.
If this entry is present in an FDF file (see 12.7.7, “Forms Data Format”), its 
type shall not be a dictionary but a text string containing the contents of 
the NM entry of the annotation being replied to, to allow for a situation 
where the annotation being replied to is not in the same FDF file. 
Subj
text string
(Optional; PDF 1.5) Text representing a short description of the subject 
being addressed by the annotation. 
RT
name
(Optional; meaningful only if IRT  is present; PDF 1.6) A name specifying 
the  relationship  (the  “reply  type”)  between  this  annotation  and  one 
specified by IRT . Valid values are:
R
The annotation shall be considered a reply to the annotation 
specified by IRT . Conforming readers shall not display replies 
to  an  annotation  individually  but  together  in  the  form  of 
threaded comments.
Group
The annotation shall be grouped with the annotation specified 
by IRT ; see the discussion following this Table.
Default value: R.
IT
name
(Optional;  PDF  1.6) A name describing the  intent of the markup 
annotation.  Intents  allow  conforming  readers  to  distinguish  between 
different uses and behaviors of a single markup annotation type. If this 
entry is not present or its value is the same as the annotation type, the 
annotation shall have no explicit intent and should behave in a generic 
manner in a conforming reader.
Free text annotations (Table 174), line annotations (Table 175), polygon 
annotations (Table 178), and (PDF 1.7) p
olyline annotations (Table 178) 
have defined intents, whose values are enumerated in the corresponding 
t
ables.
Table 170 –  Additional entries specific to markup annotations  (continued)
Key
Type
Value
Documents you may be interested
Documents you may be interested