asp.net pdf viewer control c# : Create thumbnails from pdf files SDK software service wpf winforms html dnn ibex14-part1623

Extensions
135
Chapter22
Extensions
This chapter details Ibex-specific extensions to XSL-FO. Typically these extensions
implement functionality such as password protecting a document which is not part of
the XSL-FO standard.
The Ibex extensions have a namespace which is specified using the xmlns attribute as
shown in Figure 22-1.
22.1 Document security
Ibex supports encryption of PDF documents and the setting of various document
permissions. This is done using the ibex:security elementas shown in Figure22-1.
Figure 22-1:
FOusingthe
ibex:securityelement
<root xmlns="http://www.w3.org/1999/XSL/Format"
xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
<ibex:security deny-print='true' deny-extract='true'
deny-modify='true' user-password='user' owner-password='owner'/>
...
Two levels of encryption are available, 40 bit and 128 bit. When using 40 bit encryption
available permissions which can be set including deny-print, deny-extract and
deny-modify. When using 128 bit encyption additional permissions can be set including
deny-assembly and deny-print-high-resolution. These options are details in the sections
below.
The level of encryption is specified using thebits attribute of the ibex:security element.
This defaults to "40", so specify 128 bitencryption specify bits="128".
If used the ibex:security element must occur beforeany page-sequenceelements.
Create thumbnails from pdf files - application Library tool:C# PDF Thumbnail Create SDK: Draw thumbnail images for PDF in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
www.rasteredge.com
Create thumbnails from pdf files - application Library tool:VB.NET PDF Thumbnail Create SDK: Draw thumbnail images for PDF in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
www.rasteredge.com
Ibex PDF Creator
Developers Guide
136
Extensions
22.1.1 40 bit encryption security options
When the number of bits of encryption is set to 40 or not specified, the attributes of the
ibex:security elementare:
Attribute
Values
Meaning
user-password
Specifies a password required to open the
documentin Acrobat. Once thedocument
is opened with the correctuser password,
access is limited to permissions given
using the attributes below.
owner-password
Specifies a password required to get all
rights to the document in Acrobat.Once
the documentis opened with the correct
owner password theuser has totalcontrol
of the document.
deny-print
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to print thedocument.
deny-extract
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to usecut-and-paste functionality
to copy partof the document.
deny-modify
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to modify the document.
Setting any of theattributes listed abovewill cause Ibexto encrypt thedocument.
Specifying the user-password but not the owner-password will set the owner-password
to the same value as the user-password. This means anyone who can open the
document using the user password has completecontrolof thedocument.
Specifying the owner-password but notthe user-password is common usage. This means
the user can open the document with limited rights without needing a password, but
cannotthen change or exceed those rights withoutknowing the owner password.
application Library tool:C# HTML5 PDF Viewer SDK to view PDF document online in C#.NET
Images. File and Page Process. File: Merge, Append PDF Files. File: Split PDF Document. File: Compress PDF. Page: Create Thumbnails. Page: Insert PDF Pages. Page
www.rasteredge.com
application Library tool:C# PDF Convert to Jpeg SDK: Convert PDF to JPEG images in C#.net
Turn multiple pages PDF into single jpg files respectively online. Support of converting from any single one PDF page and multiple pages. Thumbnails can be
www.rasteredge.com
Ibex PDF Creator
Developers Guide
Extensions
137
22.1.2 128 bit encryption security options
When the number of bits of encryption is set to 128, the attributes of the ibex:security
elementare:
Attribute
Values
Meaning
user-password
Specifies a password required to open the
documentin Acrobat. Once thedocument
is opened with the correctuser password,
access is limited to permissions given
using the attributes below.
owner-password
Specifies a password required to get all
rights to the document in Acrobat.Once
the documentis opened with the correct
owner password theuser has totalcontrol
of the document.
deny-print
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to print thedocument.
deny-print-high-
resolution
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to print a high resolution copy of
the document. They willonly be able to
print a low resolution (150dpi) version. If
deny-print="true" this attribute has no
effect and the document cannotbe
printed.
deny-extract
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to usecut-and-paste functionality
to copy partof the document.
deny-modify
true
false
If this is setto true a user who opens the
documentwith the user password will not
be able to modify the document butcan
still"assemble" it. See deny-assembly
below.
deny-assembly
true
false
If deny-modify="true" and
deny-assembly="false" then the user
cannotchangethedocument, butcan
"assemble" it, which means insert, rotate
or delete pages and create bookmarks or
thumbnail images. Setting
deny-modify="true" and
deny-assembly="true" prevents assembly.
Setting any of theattributes listed abovewill cause Ibexto encrypt thedocument.
application Library tool:C# PDF Convert to Images SDK: Convert PDF to png, gif images in C#
Turn multipage PDF file into single image files respectively in .NET framework. Converter control easy to create thumbnails from PDF pages.
www.rasteredge.com
application Library tool:C# PDF File Compress Library: Compress reduce PDF size in C#.net
and decompression method and Image files compression and Embedded page thumbnails. Program.RootPath + "\\" 3_optimized.pdf"; // create optimizing options
www.rasteredge.com
Ibex PDF Creator
Developers Guide
138
Extensions
Specifying the user-password but not the owner-password will set the owner-password
to the same value as the user-password. This means anyone who can open the
document using the user password has completecontrolof thedocument.
Specifying the owner-password but notthe user-password is common usage. This means
the user can open the document with limited rights without needing a password, but
cannotthen change or exceed those rights withoutknowing the owner password.
22.2 Standard document properties
Ibex allows you to set the various properties associated with a PDF document. These
properties can be viewed in Acrobat by using the File | Document Properties | Summary
menu option or just pressing control-d.
Figure 22-2 shows FO for setting the document properties using the ibex:properties
element.
Figure 22-2:
FOusing
ibex:properties
<root xmlns="http://www.w3.org/1999/XSL/Format"
xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
<ibex:properties
title="Ibex User Manual"
subject="Ibex"
author="visual programming limited"
keywords="xml,pdf" creator="xtransform" />
...
If used the ibex:security element must occur beforeany page-sequenceelements.
Theattributes of the ibex:properties elementare:
Attribute
Values
Meaning
title
Specifies a string which becomes the title
property of the document.
subject
Specifies a string which becomes the
subject property of the document.
author
Specifies a string which becomes the
author property of thedocument.
keywords
Specifies a string which becomes the
keywords property of the document.
Separate individual keywords with
commas.
creator
Specifies a string which becomes the
creator property of the document. This
should bethename of theapplication
which created theXSL-FO documentfrom
which the PDF file was created.
application Library tool:VB.NET Create PDF from Word Library to convert docx, doc to PDF in
Images. File & Page Process. File: Merge, Append PDF Files. File: Split PDF Document. File: Compress PDF. Page: Create Thumbnails. Page: Insert PDF Pages. Page
www.rasteredge.com
application Library tool:VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
File: Merge, Append PDF Files. |. Home ›› XDoc.PDF ›› VB.NET PDF: Merge and Append PDF. VB.NET Demo code to Combine and Merge Multiple PDF Files into One.
www.rasteredge.com
Ibex PDF Creator
Developers Guide
Extensions
139
Attribute
Values
Meaning
page-mode
Specifies how Acrobatwilldisplay the
documentwhen it is firstopened.If set to
'bookmarks' then if the documenthas
bookmarks they willbe displayed. If set to
'thumbs' then thethumbnails tab in
Acrobat will be displayed. If setto
'fullscreen' the documentwill be displayed
without any toolbar, border etc.
Following the PDF standard, the document creator property should be the name of the
product which converted the content to PDF format, so this is always Ibex. Other
document properties such as creation and modification date are populated
automatically by Ibex.
22.3 Custom Document Properties
Acrobat supports the display and editing of custom document properties. These
properties are a set of name value pairs stored within the PDF file. In Acrobat 6.0 these
properties can be viewed by using the File | Document Properties menu option and
clicking on the"Custom"entry in thelist boxto display a screen like this:
These custom properties are inserted into the PDF using the ibex:custom element as
shown in Figure 22-3.
Figure 22-3:
FOusingthe
ibex:customelement
<root xmlns="http://www.w3.org/1999/XSL/Format"
xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
<ibex:properties title="Ibex User Manual">
<ibex:custom name="favourite color" value="blue"/>
</ibex:properties>
...
Each property must have a name and valueattribute.
application Library tool:VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to
Images. File & Page Process. File: Merge, Append PDF Files. File: Split PDF Document. File: Compress PDF. Page: Create Thumbnails. Page: Insert PDF Pages. Page
www.rasteredge.com
application Library tool:VB.NET Create PDF from CSV to convert csv files to PDF in vb.net
Images. File & Page Process. File: Merge, Append PDF Files. File: Split PDF Document. File: Compress PDF. Page: Create Thumbnails. Page: Insert PDF Pages. Page
www.rasteredge.com
Ibex PDF Creator
Developers Guide
140
Extensions
22.4 Image processing
22.4.1 Image resolution
Ibex adds the dpi attribute to the external-graphic elementto permit managing the dots
per inch resolution of images. See
Image resolutiononpage100.
22.4.2 Anti-aliasing
Ibex adds the ibex:anti-alias attribute to the external-graphic element to permit
disabling anti-aliasing in order to achieve clearer images. See
Image anti-aliasingonpage
100.
22.4.3 Multi-page TIFF image processing
Ibex adds the ibex:page attribute to the external-graphic element to specify which page
of a muti-page TIFF image should be included in the PDF file. See
Multi-page TIFF images
on page105.
22.5 Bookmarks
XSL-FO 1.0 had no support for creating bookmarks in the PDF file. XSL 1.1 now has this
feature so theibex:bookmark element is no longer supported.
TheXSL 1.1 implementation of bookmarks is described on page129 .
22.6 Document base URL
The PDF format supports setting a base URL for links created with abasic-link element.
This base URL is prepended to the destination specified with anexternal-destination
attribute if (and onlyif) the specified destination does notstartwith a '/' character.
Figure 22-4 shows FO which creates a document with "http://www.xmlpdf.com" as the
base URL and a link to the page "index.html". When theuser clicks on thelink in the PDF
file, it will go to "http://www.xmlpdf.com/index.html".
Figure22-4:
FOsettingthe
documentbase URL
<ibex:document-base-url value="http://www.xmlpdf.com"/>
..
<block>
<basic-link external-destination='url(index.html)'>
index.html
</basic-link>
</block>
ThebaseURL is a document-wide property and can be set only once.
Ibex PDF Creator
Developers Guide
Extensions
141
This property should not be confused with the Settings.BaseURI value which specifies a
base URI to be used when Ibexretrieves images, stylesheets and XML during creation of
the PDF file.
22.7 Ibex version
The ibex:version element inserts the version number of Ibex used to create the PDF file.
This is an inline element which inserts characters into the document. Figure 22-5 shows
FO which uses this element and the outputappears in Figure22-6.
Figure 22-5:
FOusingibex:version
<block xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
created with Ibex version <ibex:version/>
</block>
Figure 22-6:
Outputfrom
ibex:version
created with Ibex version 4.7.7.6
22.8 PDF/X
Ibex can create PDF files which comply with the PDF/X standard. This is described in
detail on page143.
22.9 Viewer Preferences
Ibex can set flags on the PDF file which control how the viewer application, such as
AcrobatReader, willdisplay thePDF file.
These flags are set using the ibex:viewer-preferences element as shown in Figure22-7.
Figure 22-7:
FOusingthe
ibex:viewer-
preferenceselement
<root xmlns="http://www.w3.org/1999/XSL/Format"
xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
<ibex:viewer-preferences hide-toolbar="true"/>
...
Theattributes for the ibex:viewer-preferences element are:
Attribute
Values
Meaning
hide-toolbar
true
false
Setto true to hidetheviewer application's
tool bars
hide-menubar
true
false
Setto true to hidetheviewer application's
menu bar
hide-window-ui
true
false
Setto true to hidetheUI and justdisplay
the documentcontent
fit-window
true
false
Setto true to resize the viewer window to
fitthedocument page size
Ibex PDF Creator
Developers Guide
142
Extensions
Attribute
Values
Meaning
center-window
true
false
Setto true to center the viewer window
on the screen
display-doc-title
true
false
Setto true to havetheviewer display the
documenttitle in theviewer framerather
than thefilename. The document titleis
set using the title attribute of the
ibex:properties element as detailed on
page138 .
PDF/X
143
Chapter 23
PDF/X
This chapter details Ibex-specific extensions to the XSL-FO XML to support creation of
PDF files which conform to the PDF/X standard.
Ibeximplements thePDF/X standard using theibex:pfdx elementas shown in Figure23-1.
Figure 23-1:
PDF/X
<root xmlns="http://www.w3.org/1999/XSL/Format"
xmlns:ibex="http://www.xmlpdf.com/2003/ibex/Format">
<ibex:pdfx color-profile-name="WideGamutRGB.icc"/>
...
The Ibex extensions have a namespace which is specified using the xmlns attribute as
shown above.
Theibex:pdfx elementmustoccur beforeany outputis generated.
Using theibex:pdfx elementwill automatically setthe document color spaceto CMYK.
The existence of the ibex:pdfx element causes Ibex to create a PDF/X compatible PDF
file. The field Settings.PDFXMode used in earlier releases has been removed.
Theattributes of the ibex:pdfxelement are:
Attribute
Values
Meaning
color-profile-file-name
Full or relative path to a ICC color profile
file
registry-name
Registry Name used in the PDF
OutputIntents structure. If notspecified
this defaults to "http://www.color.org".
info
Optionaltextwhich willbecome theInfo
value in the firstOutputIntents array
entry.
output-condition-
identifier
Optionaltextwhich willbecome the
OutputConditionIdentifier valuein the first
OutputIntents array entry. This defaults to
"Custom"
Ibex PDF Creator
Developers Guide
144
PDF/X
Attribute
Values
Meaning
output-condition
Optionaltextwhich willbecome the
OutputCondition value in the first
OutputIntents array entry. This defaults to
"Custom".Acrobatproposes values such
as "TR001 SWOP/CGATS".
The color profiles is read from the specified ICC file, compressed, and embedded in the
PDF file.
23.1 Media box
The MediaBox size within the PDF file will be set to the size of the page as specified on
the simple-page-master for thatpage.
23.2 Bleed box
The BleedBox size defaults to the MediaBox size. The BleedBox can be specified as a
change from the MediaBox by specifying the ibex:bleed-width attribute on the
simple-page-master. This attribute specifies the distance by which the BleedBox is
smaller than theMediaBoxas shown in Figure 23-2.
Figure 23-2:
Settingthe bleedbox
size
<simple-page-master page-height="313mm" page-width="226mm"
master-name="page" ibex:bleed-width="3mm">
If one value is used it applies to all sides of the page, if two values are used the top and
bottom edges use the first value and theleft and right edges use the second. If there are
three values the top is set to the first value, the sides are set to the second value, and
the bottom is set to the third value. If there are four values, they apply to the top, right,
bottom and leftedges in thatorder.
The following attributes can be specified to set each side explicitly: bleed-top-width,
bleed-bottom-width, bleed-right-width, bleed-left-width.
23.3 Trim box
The TrimBox size defaults to the BleedBox size. The TrimBox can be specified as a
change from the BleedBox by specifying the ibex:trim-width attribute on the
simple-page-master. This attribute specifies the distance by which the TrimBox is smaller
than the BleedBox as shown in Figure23-3.
Figure23-3:
Settingthetrim box
size
<simple-page-master page-height="313mm" page-width="226mm"
master-name="page" ibex:trim-width="3mm">
Documents you may be interested
Documents you may be interested