pdf viewer control in asp net c# : Adding image to pdf in preview software control dll windows web page html web forms PDF32000_200848-part2367

© 
Adobe Systems Incorporated 2008 – All rights reserved
473
PDF 32000-1:2008
12.8.2.4
FieldMDP
The FieldMDP transform method shall be used to detect changes to the values of a list  of form  fields.  The 
entries in its transform parameters dictionary are listed in Table 256. 
Form
array
(Optional) An array of names specifying additional form-field-related usage 
rights for the document. Valid names (PDF 1.5) are:
Add
Permits the user to add form fields to the document.
Delete
Permits the user to delete form fields to the document.
FillIn
Permits the user to save a document on which form fill-in 
has been done.
Import
Permits the user to import form data files in FDF, XFDF and 
text (CSV/TSV) formats.
Export
Permits the user to export form data files as FDF or XFDF.
SubmitStandalone Permits the user to submit form data when the document is 
not open in a Web browser.
SpawnTemplate  Permits  new pages to  be  instantiated  from  named  page 
templates.
The following  names (PDF 1.6) shall be permitted only when the signature 
dictionary is referenced from the UR3 entry of the permissions dictionary; see 
Table 258:
BarcodePlaintext Permits (PDF 1.6) text form field data to be encoded as a 
plaintext two-dimensional barcode. 
Online
Permits (PDF 1.6)  the  use  of  forms-specific  online 
mechanisms such as SOAP or Active Data Object.
Signature
array
(Optional) An array of names specifying additional signature-related usage 
rights for the document. The only defined value shall be Modify, which permits 
a user to apply a digital signature to an existing signature form field or clear a 
signed signature form field. 
EF
array
(Optional; PDF 1.6) An array of names specifying additional usage rights for 
named embedded files in the document. Valid names shall be Create, Delete, 
Modify, and Import, which shall permit the user to perform the named operation 
on named embedded files.
P
boolean
(Optional; PDF 1.6) If true, permissions for the document shall be restricted in 
all  consumer  applications  to  those  permissions  granted  by  a  conforming 
reader, while allowing permissions for rights enabled by other entries in this 
dictionary. Default value: false . 
Table 256 –  Entries in the FieldMDP transform parameters dictionary  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; if present, 
shall be TransformParams for a transform parameters dictionary.
Action
name
(Required) A name that, along with the Fields array, describes which form 
fields do not permit changes after the signature is applied.
Valid values shall be:
All
All form fields.
Include
Only those form fields that specified in Fields.
Exclude 
Only those form fields not specified in Fields.
Fields
array
(Required if Action is Include or Exclude) An array of text strings containing 
field names.
Table 255 –  Entries in the UR transform parameters dictionary  (continued)
Key
Type
Value
Adding image to pdf in preview - 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
add picture to pdf; add an image to a pdf in preview
Adding image to pdf in preview - 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 image to pdf file; add image to pdf java
PDF 32000-1:2008
474
© 
Adobe Systems Incorporated 2008 – All rights reserved
On behalf of a document author creating a document containing both form fields and signatures the following 
shall be supported by conforming writers: 
The  author  specifies  that  form  fields  shall  be  filled  in  without  invalidating  the  approval  or  certification 
signature. The P entry of the DocMDP transform parameters dictionary shall be set to either 2 or 3 (see 
Table 254).
The author can also specify that after a specific recipient has signed the document, any modifications to 
specific form fields shall invalidate that recipient’s signature. There shall be a separate signature field for 
each  designated  recipient,  each  having  an  associated  signature  field  lock  dictionary  (see  Table 233) 
specifying the form fields that shall be locked for that user.
When  the  recipient  signs  the  field,  the  signature,  signature  reference,  and  transform  parameters 
dictionaries shall be created. The Action and Fields entries in the transform parameters dictionary shall 
be copied from the corresponding fields in the signature field lock dictionary.
NOTE
This copying  is  done  because all  objects  in a signature dictionary  must be  direct objects  if the dictionary 
contains  a  byte  range  signature.  Therefore,  the  transform  parameters  dictionary  cannot  reference  the 
signature field lock dictionary indirectly. 
FieldMDP signatures shall be validated in a similar manner to DocMDP signatures. See Validating Signatures 
That Use the DocMDP Transform Method in 12.8.2.2, “DocMDP” for details.
12.8.3
Signature Interoperability
12.8.3.1
General
It  is intended  that  conforming  readers allow  interoperability  between  signature handlers;  that  is,  a  PDF file 
signed with a handler from one vendor shall be able to be validated with a handler from a different vendor.
If present, the SubFilter entry in the signature dictionary shall specify the encoding of the signature value and 
key information, while the Filter entry shall specify the preferred handler that should be used to validate the 
signature. When handlers are being registered according to Annex E they shall specify the SubFilter encodings 
they support enabling handlers other than the preferred handler to validate the signatures that the preferred 
handler creates.
There  are  several  defined  values  for  the SubFilter  entry,  all  based  on  public-key  cryptographic  standards 
published by RSA Security and also as part of the standards issued by the Internet Engineering Task Force 
(IETF) Public Key Infrastructure (PKIX) working group; see the Bibliography for references.
12.8.3.2
PKCS#1 Signatures
The  PKCS#1  standard  supports  several  public-key cryptographic  algorithms  and digest  methods, including 
RSA  encryption,  DSA  signatures,  and  SHA-1  and  MD5  digests  (see  the  Bibliography  for  references).  For 
signing PDF files using PKCS#1, the only value of SubFilter that should be used is adbe.x509.rsa_sha1, which 
uses the RSA encryption algorithm and SHA-1 digest method. The certificate chain of the signer shall be stored 
in the Cert entry.
V
name
(Optional: PDF 1.5 required) The transform parameters dictionary version. The 
value for PDF 1.5 and later shall be 1.2
NOTE
This value is a name object, not a number.
Default value: 1.2
Table 256 –  Entries in the FieldMDP transform parameters dictionary  (continued)
Key
Type
Value
C# Word - Insert Image to Word Page in C#.NET
Preview Document. Conversion. Convert Word to PDF. Convert Word to HTML5. VB.NET How-to, VB.NET PDF, VB.NET Word It's a demo code for adding image to word page using
adding an image to a pdf; how to add an image to a pdf in acrobat
C# PowerPoint - Insert Image to PowerPoint File Page in C#.NET
Preview Document. Conversion. Convert PowerPoint to PDF. Convert PowerPoint to Pages. Annotate PowerPoint. Text Search. Insert Image. Thumbnail Create.
add an image to a pdf; add image pdf document
© 
Adobe Systems Incorporated 2008 – All rights reserved
475
PDF 32000-1:2008
12.8.3.3
PKCS#7 Signatures as used in ISO 32000
12.8.3.3.1
General
When  PKCS#7  signatures  are  used,  the value  of Contents  shall  be  a  DER-encoded  PKCS#7  binary  data 
object  containing  the  signature.  The  PKCS#7  object  shall  conform  to  RFC3852  Cryptographic  Message 
Syntax. Different subfilters may be used and shall be registered in accordance with Annex E. SubFilter shall 
take one of the following values:
adbe.pkcs7.detached: The original signed message digest over the document’s byte range shall be 
incorporated  as  the  normal  PKCS#7  SignedData  field.  No  data  shall  be  encapsulated  in  the  PKCS#7 
SignedData field.
adbe.pkcs7.sha1: The SHA1 digest of the document’s byte range shall be encapsulated in the PKCS#7 
SignedData field with ContentInfo of type Data. The digest of that SignedData shall be incorporated as the 
normal PKCS#7 digest.
The PKCS#7 object shall conform to the PKCS#7 specification in Internet RFC 2315, PKCS #7: Cryptographic 
Message Syntax, Version 1.5 (see the Bibliography). At minimum, it shall include the signer’s X.509 signing 
certificate. This certificate shall be used to verify the signature value in Contents. 
The PKCS#7 object should contain the following: 
Time stamp information as an unsigned attribute (PDF 1.6): The timestamp token shall conform to RFC 
3161 and shall be computed and embedded into the PKCS#7 object as described in Appendix A of RFC 
3161. The specific treatment of timestamps and their processing is left to the particular signature handlers 
to define.
Revocation  information  as  an  signed  attribute (PDF 1.6):  This  attribute  may  include  all  the  revocation 
information  that  is  necessary  to  carry  out  revocation  checks  for  the  signer's  certificate  and  its  issuer 
certificates. Since revocation information is a signed attribute, it must be obtained before the computation 
of  the  digital signature. This  means that  the software  used  by the signer  must  be  able to  construct the 
certification path and the associated revocation information. If one  of  the  elements cannot be  obtained 
(e.g. no connection is possible), a signature with this attribute will not be possible.
(PDF 1.6). This differs from the treatment when using adbe.x509.rsa_sha1 when the certificates shall be 
placed in the Cert key of the signature dictionary as defined in Table 252.
One or more RFC 3281 attribute certificates associated with the signer certificate (PDF 1.7). The specific 
treatment of attribute certificates and their processing is left to the particular signature handlers to define.
NOTE
For maximum compatibility with earlier versions, conforming writers should follow this practice.
The  policy of how to  establish  trusted  identity  lists to  validate embedded  certificates  is up  to the validation 
signature handler. 
12.8.3.3.2
Revocation Information
The adbe Revocation Information attribute: 
adbe-revocationInfoArchival OBJECT IDENTIFIER ::= 
{ adbe(1.2.840.113583) acrobat(1) security(1) 8 }
The value of the revocation information attribute can include any of the following data types: 
Certificate Revocation Lists (CRLs), described  in RFC  3280 (see the Bibliography):  CRLs are generally 
large and therefore should not be embedded in the PKCS#7 object. 
C# PDF Page Insert Library: insert pages into PDF file in C#.net
applications. Support adding and inserting one or multiple pages to existing PDF document. Forms. Ability to add PDF page number in preview. Offer
add image to pdf form; add jpg to pdf form
C# PDF insert text Library: insert text into PDF content in C#.net
Supports adding text to PDF in preview without adobe reader installed in ASP.NET. Powerful .NET PDF edit control allows modify existing scanned PDF text.
adding image to pdf form; add picture pdf
PDF 32000-1:2008
476
© 
Adobe Systems Incorporated 2008 – All rights reserved
Online Certificate Status Protocol (OCSP) Responses, described in RFC 2560, X.509 Internet Public Key 
Infrastructure Online Certificate Status Protocol—OCSP (see the Bibliography): These are generally small 
and constant in size and should be the data type included in the PKCS#7 object. 
Custom  revocation  information:  The format  is  not prescribed  by  this  specification,  other  than that  it be 
encoded as an OCTET STRING. The application should be able to determine the type of data contained 
within the OCTET STRING by looking at the associated OBJECT IDENTIFIER.
adbe's Revocation Information attribute value has ASN.1 type RevocationInfoArchival:
RevocationInfoArchival ::= SEQUENCE {
crl    
[0] EXPLICIT SEQUENCE of CRLs, OPTIONAL
ocsp     
[1] EXPLICIT SEQUENCE of OCSP Responses, OPTIONAL
otherRevInfo [2] EXPLICIT SEQUENCE of OtherRevInfo, OPTIONAL
}
OtherRevInfo ::= SEQUENCE {
Type  OBJECT IDENTIFIER
Value OCTET STRING
}
For  byte  range  signatures, Contents  shall  be  a  hexadecimal  string  with  “<”  and  “>”  delimiters.  It  shall  fit 
precisely in the space between the ranges specified by ByteRange. Since the length of PKCS#7 objects is not 
entirely predictable, the value of Contents shall be padded with zeros at the end of the string (before the “>” 
delimiter) before writing the PKCS#7 to the allocated space in the file.
The format  for  encoding signature values should be adbe.pkcs7.detached.  This encoding  allows the most 
options in terms of algorithm use. The following table shows the algorithms supported for the various SubFilter
values. 
12.8.4
Permissions
The Perms entry in the document catalogue (see Table 28) shall specify a permissions dictionary (PDF 1.5). 
Each  entry  in  this  dictionary  (see  Table 258  for  the  currently  defined  entries)  shall  specify  the  name  of  a 
permission handler that controls access permissions for the document. These permissions are similar to those 
Table 257 –  SubFilter value algorithm support  
SubFilter value
adbe.pkcs7.detached
adbe.pkcs7.sha1
adbe.x509.rsa.sha1a
Message Digest
SHA1 (PDF 1.3)
SHA256 (PDF 1.6)
SHA384 (PDF 1.7)
SHA512 (PDF 1.7)
RIPEMD160 (PDF 1.7)
SHA1 (PDF 1.3)b
SHA1 (PDF 1.3)
SHA256 (PDF 1.6)
SHA384 (PDF 1.7)
SHA512 (PDF 1.7)
RIPEMD160 (PDF 1.7)
RSA Algorithm Support Up to 1024-bit (PDF 1.3)
Up to 2048-bit (PDF 1.5)
Up to 4096-bit (PDF 1.5)
See 
adbe.pkcs7.detached
See 
adbe.pkcs7.detached
DSA Algorithm Support Up to 4096-bits (PDF 1.6)
See 
adbe.pkcs7.detached
No
a
Despite the appearance of sha1 in the name of this SubFilter value, supported encodings shall not 
be limited to the SHA1 algorithm. The PKCS#1 object contains an identifier that indicates which al-
gorithm shall be used.
b
Other digest algorithms may be used to digest the signed-data field; however, SHA1 shall be used 
to digest the data that is being signed.
VB.NET PDF insert text library: insert text into PDF content in vb
Multifunctional Visual Studio .NET PDF SDK library supports adding text content to adobe PDF document in VB.NET Add text to PDF in preview without adobe
adding jpg to pdf; add image field to pdf form
C# Create PDF Library SDK to convert PDF from other file formats
Load PDF from existing documents and image in SQL server. Besides, using this PDF document metadata adding control, you can add some additional
adding a png to a pdf; add jpg to pdf
© 
Adobe Systems Incorporated 2008 – All rights reserved
477
PDF 32000-1:2008
defined  by  security  handlers  (see  Table 22)  but  do  not  require  that  the  document  be  encrypted.  For  a 
permission to be actually granted for a document, it shall be allowed by each permission handler that is present 
in the permissions dictionary as well as by the security handler.
NOTE
An example of a permission is the ability to fill in a form field.
12.8.5
Legal Content Attestations
The  PDF  language  provides  a  number  of  capabilities  that  can  make  the  rendered  appearance  of  a  PDF 
document vary. These capabilities could potentially be used to construct a document that misleads the recipient 
of  a  document,  intentionally  or  unintentionally.  These  situations  are  relevant  when  considering  the  legal 
implications of a signed PDF document. 
Therefore, a mechanism shall be provided by which a document recipient can determine whether the document 
can be trusted. The primary method is to accept only documents that contain certification signatures (one that 
has  a DocMDP  signature  that  defines  what  shall  be  permitted  to  change  in  a  document;  see  12.8.2.2, 
“DocMDP”). 
When  creating  certification  signatures,  conforming  writers  should  also  create  a legal attestation dictionary , 
whose entries are shown in Table 259. This dictionary shall be the value of the Legal entry in the document 
catalogue (see Table 28). Its entries shall specify  all content that  may result in unexpected rendering of the 
document contents. The author may provide further clarification of such content by means of the Attestation
entry. Reviewers should establish for themselves that they trust the author and contents of the document. In the 
case of a legal challenge  to the  document, any questionable  content  can be reviewed in  the context  of the 
information in this dictionary.
Table 258 –  Entries in a permissions dictionary  
Key
Type
Value
DocMDP
dictionary
(Optional) An indirect reference to a signature dictionary (see Table 252). 
This  dictionary  shall contain a Reference entry  that shall  be  a signature 
reference dictionary (see Table 252) that has a DocMDP transform method 
(see 12.8.2.2, “DocMDP”) and corresponding transform parameters. 
If this entry is present, consumer applications shall enforce the permissions 
specified by the P attribute in the DocMDP transform parameters dictionary 
and shall also validate the corresponding signature based on whether any of 
these permissions have been violated.
UR3
dictionary
(Optional) A signature dictionary that shall be used to specify and validate 
additional capabilities (usage rights) granted for this document; that is, the 
enabling  of  interactive  features  of  the  conforming  reader  that  are  not 
available by default. 
For example, A  conforming reader does  not  permit  saving  documents  by 
default,  but  an  agent  may  grant  permissions  that  enable  saving  specific 
documents.  The signature shall  be  used  to  validate  that  the permissions 
have been granted by the agent that did the signing. 
The  signature  dictionary shall  contain  a Reference  entry  that  shall  be  a 
signature  reference  dictionary  that  has  a UR  transform  method  (see 
12.8.2.3, “UR”). The transform parameter dictionary for this method indicates 
which  additional  permissions  shall  be  granted  for  the  document.  If  the 
signature  is  valid,  the  conforming  reader  shall  allow  the  specified 
permissions  for  the  document,  in  addition  to  the  application’s  default 
permissions.
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
Easy to generate image thumbnail or preview for Tiff to Tiff, like Word, Excel, PowerPoint, PDF, and images. assemblies into your C# project by adding reference
add photo to pdf in preview; how to add an image to a pdf file in acrobat
C# PowerPoint - Insert Blank PowerPoint Page in C#.NET
This C# .NET PowerPoint document page inserting & adding component from RasterEdge is written in managed C# code and designed particularly for .NET class
acrobat add image to pdf; acrobat insert image in pdf
PDF 32000-1:2008
478
© 
Adobe Systems Incorporated 2008 – All rights reserved
Table 259 –  Entries in a legal attestation dictionary  
Key
Type
Value
JavaScriptActions
integer
(Optional) The number of JavaScript actions found in the document 
(see 12.6.4.16, “JavaScript Actions”).
LaunchActions
integer
(Optional) The number of launch actions found in the document (see 
12.6.4.5, “Launch Actions”).
URIActions
integer
(Optional) The number of URI actions found in the document (see 
12.6.4.7, “URI Actions”).
MovieActions
integer
(Optional) The number of movie actions found in the document (see 
12.6.4.9, “Movie Actions”).
SoundActions
integer
(Optional) The number of sound actions found in the document (see 
12.6.4.8, “Sound Actions”).
HideAnnotationActions
integer
(Optional) The number of hide actions found in the document (see 
12.6.4.10, “Hide Actions”).
GoToRemoteActions
integer
(Optional) The number of remote go-to actions found in the 
document (see 12.6.4.3, “Remote Go-To Actions”).
AlternateImages
integer
(Optional) The number of alternate images found in the document 
(see 8.9.5.4, “Alternate Images”)
ExternalStreams
integer
(Optional) The number of external streams found in the document. 
TrueTypeFonts
integer
(Optional) The number of TrueType fonts found in the document (see 
9.6.3, “TrueType Fonts”).
ExternalRefXobjects 
integer
(Optional) The number of reference XObjects found in the document 
(see 8.10.4, “Reference XObjects”). 
ExternalOPIdicts
integer
(Optional) The number of OPI dictionaries found in the document 
(see 14.11.7, “Open Prepress Interface (OPI)”). 
NonEmbeddedFonts
integer
(Optional) The number of non-embedded fonts found in the 
document (see 9.9, “Embedded Font Programs””)
DevDepGS_OP
integer
(Optional) The number of references to the graphics state parameter 
OP found in the document (see Table 58).
DevDepGS_HT
integer
(Optional) The number of references to the graphics state parameter 
HT found in the document (see Table 58).
DevDepGS_TR
integer
(Optional) The number of references to the graphics state parameter 
TR found in the document (see Table 58).
DevDepGS_UCR
integer
(Optional) The number of references to the graphics state parameter 
UCR found in the document (see Table 58).
DevDepGS_BG
integer
(Optional) The number of references to the graphics state parameter 
BG found in the document (see Table 58).
DevDepGS_FL
integer
(Optional) The number of references to the graphics state parameter 
FL found in the document (see Table 58).
Annotations
integer
(Optional) The number of annotations found in the document (see 
12.5, “Annotations”).
OptionalContent
boolean
(Optional) true if optional content is found in the document (see 8.11, 
“Optional Content”).
Attestation
text string
(Optional) An attestation, created by the author of the document, 
explaining the presence of any of the other entries in this dictionary 
or the presence of any other content affecting the legal integrity of the 
document. 
© 
Adobe Systems Incorporated 2008 – All rights reserved
479
PDF 32000-1:2008
12.9
Measurement Properties
PDF documents, such as those created by CAD software, may contain graphics that are intended to represent 
real-world  objects.  Users  of  such  documents  often  require  information  about  the  scale  and  units  of 
measurement of the corresponding real-world objects and their relationship to units in PDF user space. 
This information enables users of conforming readers to perform measurements that yield results in the units 
intended by the creator of the document. A measurement in this context is the result of a canonical function that 
takes as input a set of n coordinate pairs
and  produces  a  single  number  as  output  depending  on  the  type  of  measurement.  For  example,  distance 
measurement is equivalent to 
for 
Beginning with  PDF 1.6, such information may be stored in a measure dictionary  (see  Table 261). Measure 
dictionaries provide information about measurement units associated with a rectangular area of the document 
known as a viewport
 viewport (PDF 1.6)  is  a  rectangular  region  of  a  page.  The  optional VP  entry  in  a  page  dictionary  (see 
Table 30)  shall  specify  an  array  of  viewport  dictionaries,  whose  entries  shall  be  as  shown  in  Table 260. 
Viewports allow different measurement scales (specified by the Measure entry) to be used in different areas of 
a page, if necessary.
The  dictionaries in the VP array shall  be  in  drawing  order. Since  viewports might overlap, to determine the 
viewport to use for any point on a page, the dictionaries in the array shall be examined, starting with the last 
one and iterating in reverse, and the first one whose BBox entry contains the point shall be chosen.
NOTE 1
Any measurement that potentially involves multiple viewports, such as one specifying the distance between 
two points, shall use the information specified in the viewport of the first point.
Table 260 –  Entries in a viewport dictionary  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; shall be 
Viewport for a viewport dictionary.
BBox
rectangle
(Required) A rectangle in default user space coordinates specifying the 
location of the viewport on the page. 
The two coordinate pairs of the rectangle shall be specified in normalized 
form;  that is,  lower-left followed  by  upper-right,  relative  to  the  measuring 
coordinate  system.  This  ordering  shall  determine  the  orientation  of  the 
measuring coordinate system (that is, the direction of the positive x and y
axes) in this viewport, which may have a different rotation from the page.
The  coordinates  of  this  rectangle  are  independent  of  the  origin  of  the 
measuring coordinate system, specified in the O entry (see Table 262) of the 
measurement dictionary specified by Measure
x
0
y
0
( ,
) …
x
n 1
y
n 1
,
(
)
, ,
{
}
x
i
x
i 1
+
( –
)
2
y
i
y
i 1
+
( –
)
2
+
i 0
=
n 2
n 2.
PDF 32000-1:2008
480
© 
Adobe Systems Incorporated 2008 – All rights reserved
A  measure  dictionary  shall  specify  an  alternate  coordinate  system  for  a  region  of  a  page.  Along  with  the 
viewport dictionary,  it shall  provide  the  information  needed  to  convert  coordinates  in the  page’s  coordinate 
system to coordinates in the measuring coordinate system. The measure dictionary shall provide information 
for formatting the resulting values into textual form for presentation in a graphical user interface. 
Table 261 shows the entries in a measure dictionary. PDF 1.6 defines only a single type of coordinate system, 
rectilinear coordinate system, that shall be specified by the value RL for the Subtype entry, which is defined 
as one in which the x and y axes are perpendicular and have units that increment linearly (to the right and up, 
respectively). Other subtypes may be used, providing the flexibility to measure using other types of coordinate 
systems.
Table 262 shows the additional entries in a rectilinear measure dictionary. Many of the entries in this dictionary 
shall be number format arrays, which are arrays of number format dictionaries (see Table 263). Each number 
format  dictionary  shall  represent  a  specific  unit  of  measurement  (such  as  miles  or  feet).  It  shall  contain 
information about how each unit shall be expressed in text and factors for calculating the number of units. 
Number format arrays specify all the units that shall be used when expressing a specific measurement. Each 
array shall contain one or more number format dictionaries, in descending order of granularity. If one unit of 
measurement X is larger than one unit of measurement Y then X has a larger order of granularity than Y. All the 
elements  in  the  array shall  contain  text  strings  that,  concatenated  together,  specify  how  the  units  shall be 
displayed. 
NOTE 2
For example, a measurement of 1.4505 miles might be expressed as “1.4505 mi”, which would require one 
number format dictionary for miles, or as “1 mi 2,378 ft 7 5/8 in”, which would require three dictionaries (for 
miles, feet, and inches).
EXAMPLE 1
A number format dictionary specifying feet should precede one specifying inches. 
Name
text string
(Optional) A descriptive text string or title of the viewport, intended for use in 
a user interface. 
Measure
dictionary
(Optional) A measure dictionary (see Table 261) that specifies the scale and 
units  that  shall  apply  to  measurements  taken  on  the  contents  within  the 
viewport. 
Table 261 –  Entries in a measure dictionary  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; shall be 
Measure for a measure dictionary.
Subtype
name
(Optional) A name specifying the type of coordinate system to use for 
measuring.
Default value: RL, which specifies a rectilinear coordinate system
Table 260 –  Entries in a viewport dictionary  (continued)
Key
Type
Value
© 
Adobe Systems Incorporated 2008 – All rights reserved
481
PDF 32000-1:2008
Table 262 –  Additional entries in a rectilinear measure dictionary  
Key
Type
Value
R
text string
(Required) A text string expressing the  scale  ratio of the drawing in the 
region  corresponding  to  this  dictionary.  Universally  recognized  unit 
abbreviations should be used, either matching those of the number format 
arrays in this dictionary or those of commonly used scale ratios. 
EXAMPLE 1
a common scale in architectural drawings is “1/4 in = 1 ft”, 
indicating  that  1/4  inches  in  default  user  space  is 
equivalent to 1 foot in real-world measurements. 
If  the  scale  ratio  differs  in  the x  and y directions,  both  scales  should be 
specified.
EXAMPLE 2
“in X 1 cm = 1 m, in Y 1 cm = 30 m”.
X
array
(Required) A number format array for measurement of change along the x
axis and, if Y is not present, along the y axis as well. The first element in the 
array shall contain the scale factor for converting from default user space 
units to the largest units in the measuring coordinate system along that axis.
The directions of the x and y axes are in the measuring coordinate system 
and  are  independent  of  the  page  rotation.  These  directions  shall  be
determined by the BBox entry of the containing viewport (see Table 260).
Y
array
(Required when the x and y scales have different units or conversion factors) 
A number format array for measurement of change along the y axis. The first 
element in the array shall contain the scale factor for converting from default 
user space  units to  the largest  units in the measuring  coordinate system 
along the y axis.
D
array
(Required) A number format array for measurement of distance in any 
direction. The first element in the array shall specify the conversion to the 
largest distance unit from units represented by the first element in X. The 
scale factors from X, Y (if present) and CYX (if Y is present) shall be used to 
convert from default user space to the appropriate units before applying the 
distance function.
A
array
(Required) A number format array for measurement of area. The first 
element in the array shall specify the conversion to the largest area unit from 
units represented by the first element in X, squared. The scale factors from 
XY (if present) and CYX (if Y is present) shall be used to convert from 
default user space to the appropriate units before applying the area function.
T
array
(Optional) A number format array for measurement of angles. The first 
element in the array shall  specify the conversion to the  largest  angle unit 
from degrees. The scale factor from CYX (if present) shall be used to convert 
from default user space to the appropriate units before applying the angle 
function.
S
array
(Optional) 
A number format array for measurement of the slope of a line. The 
first element in the array shall specify the conversion to the largest slope unit 
from units represented by the first element in Y divided by the first element in 
X. The scale factors from XY (if present) and CYX (if Y is present) shall be
used  to  convert  from  default  user  space  to  the  appropriate  units  before 
applying the slope function.
O
array
(Optional) An array of two numbers that shall specify the origin of the 
measurement  coordinate  system  in  default  user  space  coordinates.  The 
directions  by  which x  and y  increase  in  value  from  this  origin  shall  be
determined by the viewport’s BBox entry (see Table 260).
Default  value:  the first  coordinate  pair (lower-left  corner)  of  the rectangle 
specified by the viewport’s BBox entry.
PDF 32000-1:2008
482
© 
Adobe Systems Incorporated 2008 – All rights reserved
The X and Y entries in a measure dictionary shall be number format arrays that shall specify the units used for 
measurements in the x and y directions, respectively, and the ratio between user space units and the specified 
units. Y is present only when the x and y measurements are in different units or have different ratios; in this 
case, the CYX entry shall be used to convert y values to x values when appropriate.
CYX
number
(Optional; meaningful only when Y is present) A factor that shall be used to 
convert the largest units along the y axis to the largest units along the x axis. 
It shall be used for calculations (distance, area, and angle) where the units 
are be equivalent; if not specified, these calculations may not be performed 
(which would be the case in situations such as x representing time and y
representing temperature). Other calculations (change in x, change in y, and 
slope) shall not require this value.
Table 263 –  Entries in a number format dictionary  
Key
Type
Value
Type
name
(Optional) The type of PDF object that this dictionary describes; shall be 
NumberFormat for a number format dictionary.
U
text string
(Required) A text string specifying a label for displaying the units represented 
by  this  dictionary  in  a  user  interface;  the  label  should  use  a  universally 
recognized abbreviation. 
C
number
(Required) The conversion factor used to multiply a value in partial units of 
the previous number format array element to obtain a value in the units of 
this dictionary. When this entry is in the first number format dictionary in the 
array, its meaning (that is, what it shall be multiplied by) depends on which 
entry in the rectilinear  measure  dictionary  (see  Table 262) references the 
number format array.
F
name
(Optional; meaningful only for the last dictionary in a number format array) A 
name indicating whether and  in what manner to display a fractional value 
from the result of converting to the units of this dictionary by means of the C
entry. Valid values shall be:
D
Show as decimal to the precision specified by the D entry. 
Show as a fraction with denominator specified by the D entry. 
R
No fractional part; round to the nearest whole unit.
T
No fractional part; truncate to achieve whole units.
Default value: D.
D
integer
(Optional; meaningful only for the last dictionary in a number format array) A 
positive integer that shall specify the precision or denominator of a fractional 
amount:
When the value  of F is D, this  entry  shall  be the precision  of  a  decimal 
display; it shall be a multiple of 10. Low-order zeros may be truncated unless 
FD is true. Default value: 100 (hundredths, corresponding to two decimal 
digits).
When the value of F is F, this entry shall be the denominator of a fractional 
display. The fraction may be reduced unless the value of FD is true. Default 
value: 16. 
FD
boolean
(Optional; meaningful only for the last dictionary in a number format array) If 
true, a 
fractional value formatted according to the D entry may not have its 
denominator reduced or low-order zeros truncated.
Default value: false.
Table 262 –  Additional entries in a rectilinear measure dictionary  (continued)
Key
Type
Value
Documents you may be interested
Documents you may be interested