© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 50/69
By default, the service tries to process all files dropped into the drop-in folder, regardless of the extension. With this 
option, files with certain file extensions can be ignored.
Example: Ignore temporary files.
-wfi .temp.tmp
7.2.3
-wfs 
Process only files with certain extensions
Process only files with certain extensions:
-wfs ‹exts›
By default, the service tries to process all files dropped into the drop directory, regardless of the extension. With this 
option, the processing can be restricted to a set of known file extensions.
Example: Restrict the processing to JPEG and PNG files.
-wfs .jpeg.jpg.png
7.2.4
-wd 
Set the Drop-In Folder
Set the Drop-In Folder:
-wd
By default the drop-in folder is equal to the folder defined as watched folder using the option
-w
. If the input files 
should be taken from a different folder, this can be configured using
-wd
. All folders created by service including 
the output folder are at the directory defined by
-w
.
-wd C:\SomePath\DropIn
7.2.5
-w 
Set the Watched Folder
Set the Watched Folder:
-w
Use the option
-w
to define the path of the watched folder. This path should not contain mapped drives, since other
users (such as LocalSystem) do not recognize them. This parameter must always be the first parameter of a thread.
-w C:\output\watchedfolder
Note: The service supports path lengths including file name of up to 258 char­
acters. This includes the 21 characters of the job ticket. If a file name exceeds this
value, its file name is truncated at the end of the file name and before the file ex­
tension. It is therefore suggested that watched folder names are kept reasonably
short.
Pdf password encryption - C# PDF Password Library: add, remove, edit PDF file password in C#.net, ASP.NET, MVC, WinForms, WPF
Help to Improve the Security of Your PDF Document by Setting Password
pdf document password; add password to pdf document
Pdf password encryption - VB.NET PDF Password Library: add, remove, edit PDF file password in vb.net, ASP.NET, MVC, WinForms, WPF
Help to Improve the Security of Your PDF Document by Setting Password
pdf print protection; convert protected pdf to word
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 51/69
7.3 General Settings
7.3.1
-af 
Add associated file
Add associated file:
-af ‹i;r;m;d;f›
Add a file to the document’s embedded files. For PDF/A-3, the embedded file is associated with an object of the 
document, i.e. it is an associated file.
The file is embedded as-is. Embedding files is not allowed for PDF/A-1 and restricted to PDF/A compliant files for
PDF/A-2.
Description of the Parameter‹i;r;m;d;f›
i
The object to associate the embedded file with. -1 for none, 0 for document, number greater than 0 for respective 
page. Default: 0 for PDF/A-3 and -1 otherwise.
r
The relationship of the embedded file to the object associated, PDF/A-3 only.  Allowed values are “Source”,
“Data”,“Alternative”, “Supplement”, and“Unspecified”. Default: “Unspecified”.
m
Mime-type of the embedded file.  Default: “application/octet-stream”.  Other common values are “applica­
tion/pdf”, “application/xml”, or “application/msword”.
d
A description of the embedded file. This is presented to the user when viewing the list of embedded files.
f
The path (or URL) to the file to be embedded.
-cl pdfa-3a -af "0;Source;application/msword;The source document;input.doc"
7.3.2
-ef 
Add embedded file
Add embedded file:
-ef ‹file›
-ef "file"
is the same as
-af ";;;;file"
.
7.3.3
-ax 
Add XMP Metadata
Add XMP Metadata:
-ax ‹file›
Add XMP meta data from a file. Providing a path that does not exist or an invalid XMP file results in return code
3
.
-ax metadata.txt
7.3.4
-ma 
Analyze the Input File
Analyze the Input File:
-ma
Online Remove password from protected PDF file
Find your password-protected PDF and upload it. If there is no strong encryption on your file, it will be unlocked and ready to download within seconds.
adding a password to a pdf using reader; password on pdf file
C# PDF File Permission Library: add, remove, update PDF file
outputFilePath = Program.RootPath + "\\" 3_pw_a.pdf"; // Create a setting object with user password "Hello World". Hello World"); // Set encryption level to
add password to pdf; pdf password security
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 52/69
Analyze the input file and verify if it meets a certain compliance level. In order to get a report either the option
-rs
or
-rd
can be used in combination, otherwise only the return code it set.
An output file name must be provided, since the output name also specifies the name of the log file which is gener­
ated. However, no output PDF document is created. The analysis is equal to the analysis using the 3-Heights™ PDF
Validator and validating against PDF/A.
7.3.5
-cff 
Embed Type 1 Fonts as CFF
Embed Type 1 Fonts as CFF:
-cff
Convert Type1 (PostScript) fonts to Compact Font Format before embedding. This reduces the file size. This affects 
the embedding of fonts only, existing Type1 fonts of the input document will not be converted.
7.3.6
-mc 
Force Conversion even if there are Analysis Errors
Force Conversion even if there are Analysis Errors:
-mc
Setting this option forces the conversion even if there is a problem with the input file. A conversion to PDF/A can 
fail if the document stands in conflict with one of the following issues:
Non-conformance with the PDF Reference
Layers
Transparency
Missing or ambiguous annotation and form field appearances
Unknown annotation types (optional)
Multimedia annotations (optional)
Under the following circumstances the conversion is automatically downgraded to PDF/A-1b (in case PDF/A-1a was 
selected):
Missing Unicode information
Missing logical structure
7.3.7
-q 
Image Quality
Image Quality:
-q ‹n›
Set or get the image quality index for images that use a prohibited lossy compression type and must be recom­
pressed.
Example:
JPX is not allowed in PDF/A-1.  If a PDF contains a JPX compressed image, its compression type must be altered.
Thus the 3-Heights™ PDF to PDF/A Converter Service converts it to an image with regular JPEG compression and 
the image quality as defined by this switch.
Supported values are
1
to
100
. A higher value means better visual quality at the cost of a larger file size. Recom­
mended values range from
70
to
90
. The default value is
75
.
VB.NET PDF File Permission Library: add, remove, update PDF file
As String = Program.RootPath + "\\" 3_pw_a.pdf" ' Create a password setting object with user password "Hello World Hello World") ' Set encryption level to
pdf password; adding password to pdf
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
NET class. Also able to uncompress PDF file in VB.NET programs. Support PDF encryption in VB.NET class applications. A professional
change password on pdf; add password to pdf file without acrobat
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 53/69
7.3.8
-cem 
Mask Conversion Errors
Mask Conversion Errors:
-cem ‹mask›
The conversion error mask defines which operations and conditions are not allowed and consequently cause a 
conversion error (return value
5
).
Values for 
‹mask›
Value
Description
0
None (never return a conversion error)
1
Set this flag to prevent automatic upgrades from PDF/A-1 to PDF/A-2.  When converting a file to
PDF/A-1, transparency needs to be removed. This may cause significant visual differences.
Therefore, the default behavior of the 3-Heights™ PDF to PDF/A Converter Service is to convert the
file to PDF/A-2.
2
Set this flag to prevent automatic downgrades of the conformance level, e.g. from PDF/A-1a to
PDF/A-1b.  If this flag is not set, the level is downgraded under the following conditions:
Downgrade to level B: If a file contains text that is not extractable (i.e. missing ToUnicode
information).
Example:
Downgrade PDF/A-2u to PDF/A-2b.
Downgrade to level U (PDF/A-2 and PDF/A-3) or B (PDF/A-1): Level A requires logical structure
information (“tagging information”), so if a file contains no such information, its level is
downgraded.
Logical structure information in a PDF defines the structure of content, such as titles, paragraphs,
figures, reading order, tables or articles.  Logical structure elements can be “tagged” with
descriptions or alternative text. “Tagging”allows the contents of an image to be described to
the visually impaired.
It is not possible for the 3-Heights™ PDF to PDF/A Converter Service to add meaningful“tagging
information”.  Adding“tagging information”without prior knowledge about the input file’s
structure and content is neither possible nor allowed by the PDF/A standard.  For that reason,
the conformance level is automatically downgraded to level B or U.
Example:
Downgrade PDF/A-1a to PDF/A-1b.
4
(default) Visual differences in output file.
8
Resolve name collisions of colorants (PDF/A-2 and PDF/A-3 only).
16
(default) Remove optional content groups (layers) (PDF/A-1 only).
32
(default) Remove transparency (PDF/A-1 only).
64
(default) Remove embedded files.
128
(default) Remove non convertible XMP metadata.
256
(default) Error during linearization of output file.
VB.NET Word: How to Convert Word Document to PNG Image Format in
and document formats, including converting Word to PDF in VB protection by utilizing the modern Advanced Encryption Standard that converts a password to a
create password protected pdf from word; convert protected pdf to word online
C# Image: How to Annotate Image with Freehand Line in .NET Project
Tutorials on how to add freehand line objects to PDF, Word and TIFF SDK; Protect sensitive image information with redaction and encryption annotation objects;
creating password protected pdf; pdf password remover online
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 54/69
Values for 
‹mask›
512
Conversion of signed document forced removal of signatures.
1024
(default) Failed to create signature.
2048
Failed to add revocation information (OCSP or CRL) or TSP to signature.
4096
(default) The input document is corrupt and should be repaired.  The errors encountered are printed
to the log file.  Some errors can be repaired, but it is crucial to review the output file and perform the
post analysis.
8192
(default) OCR error occurred.
16384
Font substituted.
Add up all operations are conditions to define the conversion mask. The default is
13812
. In order to accept all 
conversion errors, set the mask to
0
.
-cem 0
7.3.9
-ow 
Optimize for the Web
Optimize for the Web:
-ow
Add so called linearization tags to the document. A linearized document has a slightly larger file size than a non-
linearized file, and provides the following features (among others):
When a document is opened through a PDF viewing application plug-in for an Internet browser, the first page 
can be viewed without downloading the entire PDF file.
When another page is requested by the user, that page is displayed as quickly as possible and incrementally as 
data arrives, without downloading the entire PDF file.
7.3.10
-mp 
Post-Analyze the Result
Post-Analyze the Result:
-mp
Analyze the created output file directly after the conversion to verify whether it meets the required compliance 
level. In order to get a report either the option
-rs
or
-rd
can be used in combination, otherwise only the return 
code it set. The post analysis is only executed if the conversion was successful. This switch is ignored if the switch
-ma
(Analysis only) is set. The post analysis can detect errors in the created output file that could not be predicted 
based on the analysis of the input file nor could they be detected during the conversion, because the conversion 
also depends on the input parameters (such as ICC profiles).
-mp -rs
The post-analysis is equal to the analysis using the 3-Heights™ PDF Validator and validating against PDF/A.
C# Image: C#.NET Code to Add HotSpot Annotation on Images
Protect sensitive information with powerful redaction and encryption annotation objects to provide powerful & profession imaging controls, PDF document, image
copy text from protected pdf; copy protected pdf to word converter online
C# Image: Add Watermark to Images Within RasterEdge .NET Imaging
powerful and reliable color reduction products, image encryption decryption, and even to provide powerful & profession imaging controls, PDF document, image to
adding a password to a pdf; copy text from protected pdf to word
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 55/69
7.3.11
-p 
Read an Encrypted PDF File
Read an Encrypted PDF File:
-p ‹password›
When the input PDF file is encrypted and has a user password set, (the password to open the PDF) the password 
can be provided with the option
-p
. If for example the user password were
"userpwd"
, then the command would 
look like this:
-p userpwd
When a PDF is encrypted and the user password is not provided or is incorrect,
pdf2pdf
cannot decrypt and read 
the file. Instead it will generate the following error message:
0x80410112 - E - The authentication failed due to a wrong password.
Couldn't open input file input.pdf.
7.3.12
-rd 
Report Conformance Violations in Detail
Report Conformance Violations in Detail:
-rd
This option lists all conformance violations per page. Each violation is listed with a page number (page 0 = document
level), error number, a description and a counter of how many times the error occurs. The option provides more 
detailed information than the summary (
-rs
). This option can be used in combination with
-mp
or
-ma
.
-rd
0, 0x80410604, "The key Metadata is required but missing.", 1
0, 0x80410604, "The key MarkInfo is required but missing.", 1
1, 0x00418704, "The font Arial-BoldMT must be embedded.", 1
1, 0x00418704, "The font Arial-BlackItalic must be embedded.", 1
1, 0x83410612, "The document does not conform to the requested standard.", 1
7.3.13
-rs 
Report Conformance Violations Summary
Report Conformance Violations Summary:
-rs
This option gives a summary of all conformance violations.  If any of the following violations is detected at least
once, it is reported (once). This option provides less detailed information than the detailed list per page (
-rd
). This 
option can be used in combination with
-mp
or
-ma
.
The file format (header, trailer, objects, xref, streams) is corrupted.
The document doesn’t conform to the PDF reference (missing required entries, wrong value types, etc.).
The file is encrypted and the password was not provided.
The document contains device-specific color spaces.
The document contains illegal rendering hints (unknown intents, interpolation, transfer and halftone functions).
The document contains alternate information (images).
The document contains embedded PostScript code.
The document contains references to external content (reference XObjects, file attachments, OPI).
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 56/69
The document contains fonts without embedded font programs or encoding information (CMAPs).
The document contains fonts without appropriate character to Unicode mapping information (ToUnicode 
maps).
The document contains transparency.
The document contains unknown annotation types.
The document contains multimedia annotations (sound, movies).
The document contains hidden, invisible, non-viewable or non-printable annotations.
The document contains annotations or form fields with ambiguous or without appropriate appearances.
The document contains actions types other than for navigation (launch, JavaScript, ResetForm, etc.).
The document’s meta data is either missing or inconsistent or corrupt.
The document doesn’t provide appropriate logical structure information.
The document contains optional content (layers).
7.3.14
-cl 
Set Conformance
Set Conformance:
-cl ‹compl›
Set the PDF/A conformance level.
Supported values for the parameters
‹compl›
are:
pdfa-1b
,
pdfa-1a
,
pdfa-2b
,
pdfa-2u
,
pdfa-2a
,
pdfa-
3b
,
pdfa-3u
,
pdfa-3a
. The default value is
pdfa-2b
.
Some files cannot be converted to the compliance requested. The 3-Heights™ PDF to PDF/A Converter Service can 
detect this and up- or downgrade the compliance automatically. Use the option
-cem
to prevent automatic up- or
downgrades.
The following example will set the conformance level to PDF/A-2u:
-cl pdfa-2u
7.3.15
-fd 
Set font directory
Set font directory:
-fd ‹dir›
All fonts must be embedded in order to create a valid PDF/A. If the input file contains a font which is not embedded,
the font folder is searched for a font with the same name. If such a font is found, the font is embedded.
If no valid font directory is added, the default font directories are used. If replacement fonts shall be taken from 
another location, this location can be set using the switch
-fd
:
-fd C:\MyFonts
See chapterFonts
for more information on the font directories and font handling of the 3-Heights™ PDF to PDF/A
Converter Service in general.
7.3.16
-uf 
Update the fonts’ Unicodes
Update the fonts’ Unicodes:
-uf ‹file›
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 57/69
Update the fonts’ Unicodes as specified by parameter
‹file›
 The file must contain the mapping of character
codes to Unicodes for specific fonts.
7.4 Color Profiles
See the dedicated sectionColor Spaces
for more information on the topic.
7.4.1
-cs 
ICC Profile for Device-Specific Color Spaces
ICC Profile for Device-Specific Color Spaces:
-cs ‹profile›
This ICC profile represents the color profile of the scanner. It is required if a color space is used that is different from 
color ICC profile of the output intent. Initially there is a default color profile for RGB (sRGB) and CMYK (
USWebCoat-
edSWOP.icc
) defined in the 3-Heights™ PDF to PDF/A Converter. This switch can be used to set both, the RGB and 
the CMYK color profile. If an RGB color profile is passed as argument, it is set as new RGB color space. If a CMYK color
is provided, it is set as new CMYK color space. If an invalid file is provided, it results in error code
3
. To set the color
profile for both color spaces, use the switch
-cs
twice.
The following command sets the standard sRGB color profile as color space:
-cs "C:\WINNT\system32\spool\drivers\color\sRGB Color Space Profile.icm"
If a required color space profile is not available, a conversion error is generated.
7.4.2
-oi 
ICC Profile for Output Intent
ICC Profile for Output Intent:
-oi ‹profile›
The ICC profile for the output intent describes the color profile of the device (monitor or display). An output intent is 
required for PDF/A compatibility when converting images that do not have an embedded color profile. If no output
intent is specified, a default color profile is embedded. The default color profile is the“sRGB Color Space Profile.icm”.
If the input document already contains an output intent, the existing output intent is kept. Providing a path that
does not exist or an invalid ICC color profile file results in return code 3.
-oi "C:\WINNT\system32\spool\drivers\color\sRGB Color Space Profile.icm"
7.5 Digital Signatures
For more information on digital signatures in general, see sectionDigital Signatures
. For more information on how
to create digital signatures, see sectionHow to Create Digital Signatures
.
7.5.1
-abg 
Signature Background Image
Signature Background Image:
-abg ‹image›
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 58/69
This is the background image that is added to the signature. The image is centered and scaled down proportionally
to fit into the given rectangle. If the path is NULL, or the image does not exist, the appearance’s background is a 
filled rectangle using the colors fill color and stroke color. Note that for the output file to be PDF/A, the image’s color
space must match the document’s output intent.
In order to create a signature with the image only, set the signature texts 1 and 2 to
""
.
7.5.2
-af1 
Signature Font Name 1
Signature Font Name 1:
-af1 ‹font name›
This defines the font used in upper text, i.e.  the text that is set by the property
-at1
 The font can either
be specified as a path to the font file, e.g.
"C:\Windows\Fonts\arial.ttf"
, or as a font name, such as
"Times New Roman,Bold"
 When using a font name, the corresponding font must be present in one of the 
font directories described in chapterFonts
.
7.5.3
-af2 
Signature Font Name 2
Signature Font Name 2:
-af2 ‹font name›
This is the font used in lower text, i.e. the text that is set by
-at2
. The option works analogously to
-af1
.
7.5.4
-ap 
Signature Page Number
Signature Page Number:
-ap ‹page›
Set the page number of where the visual appearance of the digital signature should be placed. The default is the 
last page. The last page can also be set using
-1
as argument.
7.5.5
-ar 
Signature Annotation Rectangle
Signature Annotation Rectangle:
-ar ‹x› ‹y› ‹w› ‹h›
This option allows positioning the digital signature annotation. The default location is in the lower left corner. The 
units are PDF points (A4 = 595x842 points, Letter = 612x792 points).
Example: Create a 200 by 60 points rectangle in the upper left corner of an A4 page.
-cn "..." -ar 10 770 200 60
In order to create an invisible signature use the following rectangle:
-ar 0 0 0 0
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF to PDF/A Converter Service, March 24, 2016 59/69
7.5.6
-at1 
Signature Text 1
Signature Text 1:
-at1 ‹text›
This is the upper text that is added to the signature.
If this property is not set, the signing certificate’s name set with
-cn
is added to the upper text line of the visual 
signature.
See sectionHow to Create a Visual Appearance of a Signature
for more information on customizing the appearance 
of digital signatures.
7.5.7
-at2 
Signature Text 2
Signature Text 2:
-at2 ‹text›
This is the lower text that is added to the signature. The text can be multi-lined by using carriage returns.
If this property is not set, a three-line text is constructed that consists of:
A statement who applied to signature
The reason of the signature. This can be set using
-cr
.
The date
See sectionHow to Create a Visual Appearance of a Signature
for more information on customizing the appearance 
of digital signatures.
7.5.8
-cci 
Signer contact info
Signer contact info:
-cci ‹info›
Add a descriptive text as signer contact info, e.g. a phone number. This enables a recipient to contact the signer to 
verify the signature. This is not required in order to create a valid signature.
7.5.9
-cfp 
Certificate Fingerprint
Certificate Fingerprint:
-cfp ‹fp›
Set the hex string representation of the signer certificate’s sha1 fingerprint. All characters outside the ranges
0-9
,
a-f
and
A-F
are ignored.  In the Microsoft Management Console, the “Thumbprint” value can be used without
conversion, if the“Thumbprint algorithm” is“sha1”. E.g. “b5 e4 5c 98 5a 7e 05 ff f4 c6 a3 45 13 48 0b c6 9d e4 5d f5”.
This property can be used to select the signer certificate for signing (see description ofCryptographic Provider
).
7.5.10
-ci 
Certificate Issuer
Certificate Issuer:
-ci ‹issuer›
Documents you may be interested
Documents you may be interested