save pdf in folder c# : Pdf export bookmarks software Library cloud windows asp.net winforms class callas_pdfaPilot_CLI1-part899

Page 11
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
Get in touch
If some necessary information is not provided by this manual or if there 
are any questions or feedback please contact the product management by 
using the "Contact Support" form on www.callassoftware.com. 
You can also send an e-mail to support@callassoftware.com.
If you file a bug report please make sure your inquiry contains the follow-
ing information:
•  operating system
•  pdfaPilot version (call 
pdfaPilot --version
)
•  command line call
•  original PDF (please delete unnecessary pages to avoid long file trans-
fers), used profiles or configuration files
•  converted PDF (if available)
You can also visit the support section on www.callassoftware.com to get 
answers to common questions or find a reseller near you. The latter might 
be useful if you want to send a support request that is neither in English 
nor German.
Pdf export bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
export excel to pdf with bookmarks; pdf reader with bookmarks
Pdf export bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
display bookmarks in pdf; add bookmarks to pdf preview
Page 12
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
Processing
Input files from Office applications
pdfaPilot CLI is able to convert common file formats from Office applica-
tions directly to PDF/A. For more information and a list of supported appli-
cations and files have a look at: 
http://www.callassoftware.com/goto/apl_ENU_topdf
! Office file conversion is currently not supported on Solaris and AIX systems.
OpenOffice
--topdf_forceopenOffice
When defined, Microsoft Office files are processed with OpenOffice.
Create PDF for print
--topdf_print
The PDF will be created with image resolution sufficient for printing, thus 
leading to larger files. 
Excel-Sheets without removing white space
--topdf_useexcelpagelayout
Use Excel page layout, white space will not be removed. 
Special handling for Excel-Sheets
--topdf_parameter=[ShowHiddenColumns|ShrinkToFit]
Special parameters to achieve some special layouts for Excel files.
Parameters
ShowHiddenColumns
Show columns which are not visible 
due to small width or other settings.
ShrinkToFit
Shrinks the content of a cell so that 
the content fits inside.
When 
--topdf_useexcelpagelayout
is used, this parameter will not be 
respected.
Logging of dialogs in defined log file
--topdf_guiactionslog=<path>
Parameters
path 
Path to folder or logfile. 
All dialogs occuring during processing the office file will be logged within 
this file.
! See internet page (listed above) for further information about handling of 
dialogs from office applications.
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
document file. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. Also a preview
split pdf by bookmark; pdf export bookmarks
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
auto bookmark pdf; create bookmarks pdf file
Page 13
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
General options
Usually pdfaPilot CLI is started with:
pdfaPilot <PDF file>
Input file
May be one or a number of input files (PDF or Office files) to be analysed 
and converted.
If an input file spec is pointing to an existing folder, all files inside this 
folder are processed:
Process folders recursively
--recursive
If the file spec for the input file is pointing to an existing folder all PDF files 
inside the folder on all levels are processed
Empty the font cache
--emptyfontcache 
Removes all font files from the font cache folder of pdfaPilot CLI.
Incremental saving
--incremental
Allows to modify the input file, only writing the changes to the original 
PDF. This can increase the speed significantly since pdfaPilot CLI does not 
need to create a new copy of the file.
PDF structure and font optimization
--nooptimization
The internal PDF structure and fonts are not optimized when saving the 
PDF file.PDF structure and font optimization
Analyze only
-a --analyze
The input file is not being converted but is analyzed whether it is PDF/A 
compliant. 
Analyze only certain pagerange
-p --pagerange=<firstpage>[-<lastpage>]
Only applied when analyzing not when converting PDF files.
! When converting non-PDF documents the page range of the original docu-
ment can be specified.
Parameters
firstpage
Page where analysis should start
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Demo Code in VB.NET. The following VB.NET codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
create pdf with bookmarks from word; bookmarks in pdf reader
C# PDF File Compress Library: Compress reduce PDF size in C#.net
NET framework. Remove bookmarks, annotations, watermark, page labels and article threads from PDF while compressing. C# class demo
pdf bookmarks; bookmarks pdf
Page 14
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
lastpage
optional, page where analysis 
should end
Example:
--pagerange=5-33
Setting the cache folder
--cachefolder=<path>
Sets the cache folder path. This is set by default to:
Windows:  C:\Documents and Settings\<user>\Application data\ 
callas software\callas pdfaPilot CLI 
Macintosh:  /Users/<user>/Library/Preferences/callas software/ 
callas pdfaPilot CLI 
Unix: 
<home directory as defined in /etc/passwd>/.callas software/ 
callas pdfaPilot CLI
! This option is mandatory when running the CLI as a user without a home 
directory.
Parameters
path 
absolute path to custom cache folder
PDF/A specific options
PDF/A Compliancy level
--level=<level>
You can define which PDF/A level you need (default is 1b).
Parameters
level
3b, 3u, 3a, 2b, 2u, 2a, 1b or 1a
Deactivate removal of non-compliant metadata
--noxmpremoval
Normally, XMP Metadata which is not compliant with PDF/A is removed 
during conversion. This switch prevents the removal.
Force Conversion to PDF/A
Due to several reasons a regular conversion may not result in a  valid 
PDF/A document. To ensure conversion 3 additional steps can be per-
formed after a normal conversion if a file can not be converted to PDF/A 
within this first step. The order they will be performed is as listed below. 
After each step the resulting file is checked for compatibility with the 
choosen standard. Each step is optional.
--forceconversion_reconvert
Performs a re-conversion of the PDF via PostScript.
--forceconversion_pagestoimages
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
Export PDF images to HTML images. The HTML document file, converted by C#.NET PDF to HTML SDK, preserves all the original anchors, links, bookmarks and font
create bookmark pdf file; how to bookmark a pdf file
How to C#: Basic SDK Concept of XDoc.PDF for .NET
document. OutLines. This class describes bookmarks in a PDF document. Copyright © <2000-2016> by <RasterEdge.com>. All Rights Reserved.
adding bookmarks in pdf; add bookmarks pdf
Page 15
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
Convert pages with problems into images, while converting the text is 
transmuted into invisible text, which is correctly positioned to keep the 
text available for marking and copying. 
--forceconversion_doctoimages
Convert all pages into images, while converting the text is transmuted into 
invisible text, which is correctly positioned to keep the text available for 
marking and copying.
--forceconversion_resolution=<resolution in ppi>
Image resolution in ppi used for the rendered content. (Default = 100 ppi).
Font folders
If a font is not embedded and an embedding is required by a PDF/A-con-
version or a profile, pdfaPilot CLI will search the system font directories in 
order to find the needed font file, which are:
Windows
•  C:\Windows\Fonts
Macintosh
•  /Users/<user>/Library/Fonts
•  /Library/Fonts
•  /System/Library/Fonts
Linux, Solaris Sparc, Solaris x86, AIX •  /usr/lib/X11/fonts
•  /usr/local/X11R6/lib/X11/fonts
•  /usr/share/fonts
•  /<user home>/.fonts
Additionally the font folder installed together with pdfaPilot CLI will be 
searched. This folder lies next to the executable in "<callas pdfaPilot CLI 
directory>\etc\APDFL\Resource\Font".
ICC-profiles folders
The following folders are searched for required ICC-profiles, unless they 
are already contained in the .kfpx-profile already. 
These folders lies next to the executable in:
•  "<callas pdfaPilot CLI directory>\etc\ICC profiles"
•  "<callas pdfaPilot CLI directory>\etc\APDFL\Resource\Color\Profiles"
Some system folders for colors are searched addtionally:
MacOS: 
\Library\Application Support\Adobe\Color 
Windows:  \Windows\system32\spool\drivers\color
Set a processing timeout
--timeout=<seconds>
Sets the maximum processing time in seconds. If the process exceeds this 
duration, the execution process will be killed and the processing will result 
in an error.
VB.NET PDF: Basic SDK Concept of XDoc.PDF
document. OutLines. This class describes bookmarks in a PDF document. Copyright © <2000-2015> by <RasterEdge.com>. All Rights Reserved.
how to bookmark a pdf in reader; how to add bookmark in pdf
C# Create PDF Library SDK to convert PDF from other file formats
file. Create and save editable PDF with a blank page, bookmarks, links, signatures, etc. Create fillable PDF document with fields.
bookmarks pdf files; export pdf bookmarks
Page 16
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
File content options
Deactivate transparency flattening
--notransparencyflattening
This switches off both flattening of any contained transparency and setting 
the blend color space to sRGB.
Add XMP metadata
--addxmp=<path>
The XMP metadata is merged into any existing XMP metadata.
Parameters
path
Path to an XMP file
Add bookmarks
--addbookmarks=<path>
The bookmarks are embedded into the PDF file.
Parameters
path
Path to an XML file containing book-
marks
Set the OutputIntent
-i --OutputIntent=<path>
Path to a PDF file with an OutputIntent – forces use of this OutputIntent.
Parameters
path
Path to an OutputIntent
Define ICC profiles
CMYK
--defaultprofile_cmyk=<path>
The given profile is embedded as the default profile making device depen-
dent CMYK page objects device independent.
Parameters
path
Path to a CMYK ICC profile
RGB
--defaultprofile_rgb=<path>
The given profile is embedded as the default profile making device depen-
dent RGB page objects device independent.
Parameters
path
Path to an RGB ICC profile
Page 17
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
Gray
--defaultprofile_gray=<path>
The given profile is embedded as the default profile making device depen-
dent Gray page objects device independent.
Parameters
path
Path to a Gray ICC profile
Font Embedding
If a font is not embedded pdfaPilot CLI will search the system's font direc-
tories in order to find the needed font file, which are:
Windows
•  C:\Windows\Fonts
Macintosh
•  /Users/<user>/Library/Fonts
•  /Library/Fonts
•  /System/Library/Fonts
Linux, Solaris Sparc, Solaris x86, AIX •  /usr/lib/X11/fonts
•  /usr/local/X11R6/lib/X11/fonts
•  /usr/share/fonts
•  /<user home>/.fonts
Additionally the font folder installed together with pdfaPilot CLI will be 
searched. This folder lies next to the executable in "<callas pdfaPilot CLI 
directory>\etc\APDFL\Resource\Font".
Define an additional font folder
--fontfolder=<path> 
Additional folder to look up fonts for embedding.
Parameters
path
Path to config file
Example:
--fontfolder="C:\AdditionalFonts"
! You can force pdfaPilot CLI to only scan the folder defined by 
--fontfolder (and not search the system's font folders) by using the 
option --fontonly.
Substitute fonts
--substitute[=<path>]
Font substitution can be used when the original fonts used in a PDF file 
are not available. By default, the font substitution file pdfa.cfg stored in 
"etc/FontSubstitution/" provides the basis for substitution.
Alternatively, you can also enter a custom path to a fontsubstitution file, 
e.g.:
--substitute=C:\fontsubstitution.cfg
If you want to switch off font substitution completely, just hand over an 
invalid value, e.g.:
--substitute=no
Page 18
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
Parameters
path
Optional, path to config file
The following notations are allowed in the fontsubstitution.cfg:
SubstituteAll
Each font can be substituted by every other font of the entry.
SubstituteAll<tab>fontname<tab>fontname<tab>fontname...
SubstituteFirst
Only the first font of the entry can be substituted by the following fonts.
SubstituteFirst<tab>font to be substituted<tag>fontname 
<tab>...
Creating file packages
Some PDF standards allows the embedding of PDF- and also non-PDF-
files into another PDF file. Sometime these filepackages are also called 
collections. Using pdfaPilot CLI it is possible to create such file packages 
from a complete folder or to define different ways how a file which shall be 
embedded is handled. 
In general a file package is created with --collection  This will create 
an index document, which lists all embedded files from the given folder. 
Also an existing folder structure will be respected
--collection <folder>
In general a file package is created with --collection  This will create 
an index document, which lists all embedded files.
--collection <file> [<file>]
Settings for file embedding
--collection [--embedinto=[target],<file>] [--embedfile= 
[target,[relationship],<file>] [--embedwithlink= 
[area,<file>]
--embedinto
It is possible to use own templates or normal PDF for embedding files. The 
standard for the file where other files will be embedded can be defined 
using the conversion target (see below). If no file is defined, an index file 
is created.
Parameters 
target
A3b, A3u, A3a, A2b, A2u, A2a, A1b, 
A1a or No (Default)
Page 19
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
--embedfile
Also for files to embed a conversion target can be defined using the con-
version target. For PDF/A-3 standards also a relationship entry for each 
embedded file can be set.
Parameters 
target
A3b, A3u, A3a, A2b, A2u, A2a, A1b, 
A1a, PDF or No (Default)
Using the target "No", no conversion to PDF is done. (Only available for 
embedded files.)
relationship
Source, Data, Alternative, Supple-
ment, Unspecified (Default)
--embedwithlink
Alternatively, files can be embedded with defining an area in the contain-
ing document, where a link to the contained file is created. No conversion 
will take place with the file to embed.
Parameters 
area
X1,X2,Y1,Y2[pt, in, cm, mm]
Defines a rectangular area, based on the lower left corner of the page, 
where a link to the embedded file is inserted. Default unit is pt.
Example:
--collection --embedinto=A3b,<PDF file> --embedfile=A3b, 
Alternative,<file> --embedfile=A2b,Source,<Office file> 
--embedfile=No,Data,<file>
--collection --embedwithlink=10,10,100,100,<file> --emb
edwithlink=10mm,100mm,100mm,200mm,<file>
Converting e-mail files to PDF
Some common e-mail file formats (MSG, EML, EMLX) are supported for 
conversion to PDF. 
Some PDF standards do not allow embedding files (like PDF/A-1) but other 
allows the embedding of PDF- (PDF/A-2) and also non-PDF-files (PDF/A-3) 
into another PDF file. To match these different targets, using pdfaPilot CLI 
it is possible to define variety of different settings for handling attach-
ments of e-mails. 
In general a PDF is created with --emailtopdf 
This will create a PDF containing all attachments, those who can be con-
verted as PDF (like Office files or images), all other in ther native format.
--emailtopdf <e-mail file>
Settings for e-mail conversion
--emailtopdf [--level=<level>] [--attachments=<pa
rameter>,<parameter>,...] [--onerror=<parameter>] 
[--embedsource] [--noembed=<file type>,<file 
type>,...] [--noconvert=<file type>,<file type>,...] 
--template=<path to folder> <e-mail file>
Page 20
Manual
pdfaPilot CLI
a
© 1996-2015 by callas software gmbh · Schönhauser Allee 6/7 · D 10119 Berlin · Germany · info@callassoftware.com · www.callassoftware.com
--level
You can define the required PDF/A level (default is no PDF/A conversion).
Parameters 
level
A3b, A3u, A3a, A2b, A2u, A2a, A1b, 
A1a or No (default: no)
--attachments
Depending on the defined parameter, attachments will not be embedded 
or embedded in their original file format, converted to PDF or as pages. 
The parameters can be combined comma separated.
Parameters 
IGNORE
Attachments will be ignored and not 
converted or attached
ORIGINAL
Attachments will be embedded in 
their original file format
PDF
Attachments will be converted to 
PDF (if possible) (Default)
PAGES
Attachments will be converted (if 
possible) and attached as additional 
pages to the e-mail content
--onerror
If an attachment can not be converted to PDF, this setting allows the defi-
nition of handling such e-mail files.
Parameters 
ABORT
Aborts processing if an attachment 
can not be converted to PDF 
SKIP
Attachment will be skipped and 
reported on the CLI.
FALLBACK
Attachment will be embedded in 
original file format, if it can not be 
converted to PDF. If a PDF/A-level 
has been selected, PDF/A-3 with 
the respective sublevel will be used. 
(Default)
--embedsource
The e-mail-file itself will also be embedded in the resulting PDF.
--noembed
RegEx expression for file type extensions for attachments, which will not 
be embedded or converted to PDF although is attached to the e-mail file. 
Samples for valid RegEx (RegEx is case-sensitive, "(?i)" will make it case- 
insensitive. 
--noembed=".*.vir" 
matches extension "vir" in small letters 
--noembed=".*.(VIR|EXE)"  matches the listed extensions in big letters 
--noembed="(?i).*.VIR"   
matches all possible variations of "VIR"
Documents you may be interested
Documents you may be interested