Pegasus Imaging's PDF Xpress v2 FAQ's

PDF Xpress™ v2 FAQ

Q1: How can I determine if I have the latest version of a Pegasus control?

Q2: What is the difference between the 2 editions of the PDF Xpress v2 product (Reader and Professional)?

Q3: What are the new features of PDF Xpress v2?

Q4: What are runtimes? How do I pay for them?

Q5: What version of PDF files does PDF Xpress v2 support?

Q6: What is XFDF and how does the schema import and export process function in PDFXpress v2?

Q7: I am moving from PDF Xpress v1 to PDF Xpress v2. What are the names of the new DLL’s that need to be referenced in my application?

Q8: Where can I find a sample that demonstrates creating a Searchable Image (Image with Hidden Text) PDF File?

Q9: How do I distribute my application?

Q10: What DLL’s do I need to distribute with my application?

Q11: Can PDFXpress V2 render a PDF file that has the copy content protection enabled in the file?

Q12: Where can I find additional “How To” type sample code that demonstrates the usage of the control?

Q1: How can I determine if I have the latest version of a Pegasus control?

Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page.

Q2: What is the difference between the 2 editions of the PDF Xpress v2 product (Reader and Professional)?

Please refer to the descriptions below:

Reader Edition
This edition allows application developers to read PDF documents (including the associated annotations and bookmarks), render pages, and extract content from PDFs. (The Reader Edition contains a subset of Professional Edition features.)

Professional Edition
This edition provides application developers the ability to create PDF documents and modify the PDF content, plus all of the Reader Edition features.

Q3: What are the new features of PDF Xpress v2?

Please refer to the information on the following page.

Q4: What are runtimes? How do I pay for them?

Licensing requirements for PDF Xpress are documented on the PDF Xpress pricing page.

Q5: What version of PDF files does PDF Xpress v2 support?

PDF Xpress v2 will open a well-formed PDF document of any version, if a valid user- or owner-password is provided, as required. The PDF specification is designed to be backwards compatible. Even earlier versions of Adobe Reader should open the newest PDFs; unknown features are typically ignored. Operations such as printing to EPS, rendering, etc are governed by the permissions associated with the password (if any) used to successfully open the PDF.

PDF Xpress v2 will create PDF v1.6.

PDF Xpress v2 will modify an open PDF document if permissions associated with the password used to open the document permit changes can be made.

Q6: What is XFDF and how does the schema import and export process function in PDFXpress v2?

XFDF (XML Forms Data Format) is an Adobe-created format for representing form data and annotations.

PDF Xpress created XFDF will contain only data for PDF Xpress supported annotations as follows in the chart listed below:

XFDF 2.0 (Draft) to PDF Data Binding in PDF Xpress v2
XFDF		PDF			Supported?
Symbol	Type	Dictionary	Key	Value	Supported?
annots	Element	FDF	Annots		Yes
appearance	Element	Annotation	AP		No
bits	Attribute	Sound object	B		No
caret	Element	Annotation	Subtype	Caret	Yes
channels	Attribute	Sound object	C		No
checksum	Attribute	Embedded file parameter	CheckSum		No
circle	Element	Annotation	Subtype	Circle	Yes
color	Attribute	Annotation	C		Yes
contents	Element	Annotation	Contents		Yes
contents-richtext	Element	Markup annotation	RC		Yes
coords	Attribute	Text markup annotation	QuadPoints		Yes
creation	Attribute	Embedded file parameter	CreationDate		No
creationdate	Attribute	Markup annotation	CreationDate		Yes
creator	Attribute	Mac OS file information	Creator		No
dashes	Attribute	Border style	D		Yes
data	Element				No
date	Attribute	Annotation	M		Yes
defaultappearance	Element	FreeText annotation	DA		Yes
defaultstyle	Element	FreeText annotation	DS		Yes
encoding	Attribute				No
encoding	Attribute	Sound object	Element		No
end	Attribute	Line annotation	L		Yes
f	Attribute	FDF	F		Yes
field	Element	FDF	Fields		No
fields	Element	FDF	Fields		No
file	Attribute	File specification	F		No
fileattachment	Element	Annotation	Subtype	FileAttachment	No
filter	Attribute	Stream	Filter		No
flags	Attribute	Annotation	F		Yes
freetext	Element	Annotation	Subtype	FreeText	Yes
fringe	Attribute	Caret annotation	RD		Yes
fringe	Attribute	Circle annotation	RD		Yes
fringe	Attribute	Square annotation	RD		Yes
gesture	Element	Ink annotation	InkList		Yes
head	Attribute	Line annotation	LE		Yes
highlight	Element	Annotation	Subtype	Highlight	Yes
href	Attribute	FDF	F		Yes
icon	Attribute	File attachment annotation	Name		No
icon	Attribute	Rubber stamp annotation	Name		No
icon	Attribute	Sound annotation	Name		No
icon	Attribute	Text annotation	Name		Yes
ids	Elemtent	FDS	ID		Yes
ink	Element	Annotation	Subtype	Ink	Yes
inklist	Element	Ink Annotation	InkList		Yes
inreplyto	Attribute	IRT	Markup annotation		Yes
intensity	Attribute	Border effect	I		Yes
interior-color	Attribute	Square annotation	IC		Yes
interior-color	Attribute	Circle annotation	IC		Yes
justification	Attribute	Freetext annotation	Q		Yes
length	Attribute	Stream	Length		No
line	Element	Annotation	Subtype	Line	Yes
mimetype	Attribute	Embedded file stream	Subtype		No
mode	Attribute				No
modification	Attribute	Embedded file parameter	ModDate		No
modified	Attribute	FDF	ID		Yes
name	Attribute	Annotations	NM		Yes
name	Element	FDF field	T		No
open	Attribute	Pop-up annotation	Open		Yes
oppacity	Attribute	Markup annotation	CA		Yes
original	Attribute	FDF	ID		Yes
page	Attribute	FDF file	Page		Yes
polygon	Element	Annotation	Subtype	Polygon	Yes
polyline	Element	Annotation	Subtype	Polyline	Yes
popup	Element	Annotation	Subtype	Popup	Yes
rate	Attribute	Sound object	R		No
rect	Attribute	Annotation	Rect		No
resource	Element	Mac OS file information	ResFork		No
rotation	Attribute	FreeText annotation	Rotate		Yes
rotation	Attribute	Stamp annotation	Rotate		No
size	Attribute	Embeded file parameter	Size		No
sound	Element	Annotation	Subtype	Sound	No
square	Element	Annotation	Subtype	Square	Yes
squiggly	Element	Annotation	Subtype	Squiggly	Yes
stamp	Element	Annotation	Subtype	Stamp	No
start	Attribute	Line annotation	L		Yes
state	Attribute	Text annotation	State		Yes
statemodel	Attribute	Text annotation	StateModel		Yes
strikeout	Element	Annotation	Subtype	StrikeOut	Yes
style	Attribute	Border style	S		S
subject	Attribute	Markup annotation	Subj		Yes
subtype	Attribute	Max OS file information	Subtype		No
symbol	Attribute	caret annotation	Sy		Yes
tail	Attribute	Line annotation	LE		Yes
text	Element	Annotation	Subtype	Text	Yes
title	Attribute	Annotation	T		Yes
underline	Element	Annotation	Subtype	Underline	Yes
value	Element	FDF Field	V		No
value-richtext	Element	Fields containing variable text	RV		No
vertices	Element	Polygon annotation	Vertices		Yes
vertices	Element	Polyline annotation	Vertices		Yes
width	Attribute	Border style	W		Yes
xfdf	Element	FDF	Root		Yes

Q7: I am moving from PDF Xpress v1 to PDF Xpress v2. What are the names of the new DLL’s that need to be referenced in my application?

If using .NET the version of the Assembly file is: PegasusImaging.WinForms.PdfXpress2.dll

If using the ActiveX version the name of the DLL is: PegasusImaging.ActiveX.PDFXpress2.dll

Q8: Where can I find a sample that demonstrates creating a Searchable Image (Image with Hidden Text) PDF File?

The Zip file here includes a sample (written in VB 6 and C#) that demonstrates this process.

Q9: How do I distribute my application?

Please note: You must have received unlock codes in order to distribute applications. These are received when runtimes are purchased. If you have not received them please Contact Sales.

1) If you are using the .NET interface you must call the UnlockRuntime method in the Licensing class where the application begins and pass the unlock codes as the parameters. For example:

PDFXpress2.Licensing.UnlockRuntime(1234,1234,1234,1234);

2) If you are using the ActiveX control you must call the UnlockRuntime method where your application begins and pass the unlock codes as the parameters. For example:

PDFXpress2.UnlockRuntime 1234,1234,1234,1234

Q10: What DLL’s do I need to distribute with my application?

1) If you are using the ActiveX interface please distribute the following DLLs:

     PegasusImaging.ActiveX.PDFXpress2.dll - ActiveX component - ActiveX Control for PDF document creation and text recognition

     PegasusImaging.Worker.PDFXpress2.dll - ActiveX component - ActiveX Worker Control for PDF creation and internal functionality.

Please Note: You must register the PegasusImaging.ActiveX.PDFXpress2.dll via your installation program or manually via the regsvr32.exe utility.

2) If you are using the .NET interface please distribute the following DLL:

     PegasusImaging.WinForms.PDFXpress2.dll - .NET component - Control for PDF document manipulation.

Q11: Can PDFXpress V2 render a PDF file that has the copy content protection enabled in the file?

Yes, Service Pack 1 of PDFXpress v2 added support for this functionality. The latest version of PDFXpress v2 can be obtained at the link listed below:

http://www.pegasusimaging.com/pdfxpress.htm

Note: Copy protected rendering functionality is to be used only for viewing of copy protected PDF documents. This functionality should not be used to violate or bypass PDF file security measures which prevent copying or editing the PDF documents.

Q12: Where can I find additional “How To” type sample code that demonstrates the usage of the control?

Please refer to the “How To” section in the Contents section of the appropriate help file (.NET or ActiveX) for sample code showing the use of the control.