Public Member Functions | |
PDFDoc () throws com.foxit.sdk.PDFException | |
Constructor. More... | |
PDFDoc (String path) throws com.foxit.sdk.PDFException | |
Constructor, from an existing PDF file path. More... | |
PDFDoc (byte[] buffer) throws com.foxit.sdk.PDFException | |
Constructor, from a memory buffer. More... | |
PDFDoc (FileReaderCallback file_read, boolean is_async) throws com.foxit.sdk.PDFException | |
Constructor, with a file read callback object. More... | |
PDFDoc (PDFDoc arg0) | |
Constructor, with another PDF document object. | |
int | addIndirectObject (PDFObject pdf_object) throws com.foxit.sdk.PDFException |
Add a PDF object to current PDF document, to be an indirect object. More... | |
int | checkPassword (byte[] password) throws com.foxit.sdk.PDFException |
Check the type of a specified password. More... | |
int | checkPassword (String password) throws com.foxit.sdk.PDFException |
(Only supported in PDF 2.0) Check the type of a specified unicode password. More... | |
void | clearRenderCache () throws com.foxit.sdk.PDFException |
Clear the cache used during rendering, to reduce the memory usage. More... | |
Bookmark | createRootBookmark () throws com.foxit.sdk.PDFException |
Create new bookmark root node. More... | |
void | deleteIndirectObject (int object_number) throws com.foxit.sdk.PDFException |
Delete an indirect object by indirect object number. More... | |
boolean | doJSOpenAction () throws com.foxit.sdk.PDFException |
Perform JavaScript actions when the document is opened. More... | |
boolean | exportAnnotToFDF (Annot pdf_annot, FDFDoc fdf_doc) throws com.foxit.sdk.PDFException |
Export specified annotation to a FDF/XFDF document. More... | |
boolean | exportToFDF (FDFDoc fdf_doc, int types, Range page_range) throws com.foxit.sdk.PDFException |
Export form fields and annotations to a FDF/XFDF document. More... | |
PDFDictionary | getCatalog () throws com.foxit.sdk.PDFException |
Get the catalog dictionary. More... | |
CertificateEncryptData | getCertificateEncryptData () throws com.foxit.sdk.PDFException |
Get encrypt data of certificate encryption. More... | |
CustomEncryptData | getCustomEncryptData () throws com.foxit.sdk.PDFException |
Get encrypt data of custom encryption. More... | |
int | getDisplayMode () throws com.foxit.sdk.PDFException |
Get the display mode. More... | |
String | getDocURI () throws com.foxit.sdk.PDFException |
Get the URI of connected PDF if current PDF is a connected PDF. More... | |
DRMEncryptData | getDRMEncryptData () throws com.foxit.sdk.PDFException |
Get encrypt data of Foxit DRM encryption. More... | |
PDFDictionary | getEncryptDict () throws com.foxit.sdk.PDFException |
Get the encrypt dictionary. More... | |
int | getEncryptionType () throws com.foxit.sdk.PDFException |
Get the encryption type. More... | |
String | getEndpoint () throws com.foxit.sdk.PDFException |
Get the URL of ConnectedPDF Web services if current PDF is a connected PDF. More... | |
java.math.BigInteger | getFileSize () throws com.foxit.sdk.PDFException |
Get file size. More... | |
int | getFileVersion () throws com.foxit.sdk.PDFException |
Get PDF file version stored in PDF header section. More... | |
int | getFirstAvailPageIndex () throws com.foxit.sdk.PDFException |
Get the page index of the fist available page. More... | |
Font | getFont (int index) throws com.foxit.sdk.PDFException |
Get a font by index. More... | |
int | getFontCount () throws com.foxit.sdk.PDFException |
Count all the PDF fonts used in current PDF document. More... | |
String | getHeader () throws com.foxit.sdk.PDFException |
Get PDF header identifying the version of the PDF specification to which the file conforms. More... | |
PDFObject | getIndirectObject (int object_number) throws com.foxit.sdk.PDFException |
Get an indirect object by indirect object number. More... | |
PDFDictionary | getInfo () throws com.foxit.sdk.PDFException |
Get the information dictionary. More... | |
Action | getOpenAction () throws com.foxit.sdk.PDFException |
Get the action to be performed when the document is opened. More... | |
PDFPage | getPage (int index) throws com.foxit.sdk.PDFException |
Get a PDF page by index. More... | |
PageBasicInfo | getPageBasicInfo (int index) throws com.foxit.sdk.PDFException |
Get the basic information of a page specified by index. More... | |
int | getPageCount () throws com.foxit.sdk.PDFException |
Get the count of pages. More... | |
PDFDictionary | getPagesDict () throws com.foxit.sdk.PDFException |
Get the dictionary of "Pages". More... | |
int | getPasswordType () throws com.foxit.sdk.PDFException |
Get the type of current used password. More... | |
PayLoadData | getPayLoadData () throws com.foxit.sdk.PDFException |
Get payload data if current document's wrapper type is e_WrapperPDFV2. More... | |
ReadingBookmark | getReadingBookmark (int index) throws com.foxit.sdk.PDFException |
Get a reading bookmark by index. More... | |
int | getReadingBookmarkCount () throws com.foxit.sdk.PDFException |
Get the count of reading bookmarks. More... | |
RMSEncryptData | getRMSEncryptData () throws com.foxit.sdk.PDFException |
Get encrypt data of RMS encryption. More... | |
Bookmark | getRootBookmark () throws com.foxit.sdk.PDFException |
Get bookmark root node. More... | |
SecurityHandler | getSecurityHandler () throws com.foxit.sdk.PDFException |
Get current PDF security handler of current document. More... | |
Signature | getSignature (int index) throws com.foxit.sdk.PDFException |
Get a signature by index. More... | |
int | getSignatureCount () throws com.foxit.sdk.PDFException |
Get the count of signature. More... | |
StdEncryptData | getStdEncryptData () throws com.foxit.sdk.PDFException |
Get encrypt data of standard encryption (known as password encryption). More... | |
PDFDictionary | getTrailer () throws com.foxit.sdk.PDFException |
Get the trailer dictionary. More... | |
String | getUserPassword (byte[] owner_password) throws com.foxit.sdk.PDFException |
Get the user password based on owner password. More... | |
int | getUserPermissions () throws com.foxit.sdk.PDFException |
Get user access permissions. More... | |
WrapperData | getWrapperData () throws com.foxit.sdk.PDFException |
Get wrapper data if current document's wrapper type is e_WrapperFoxit. More... | |
int | getWrapperOffset () throws com.foxit.sdk.PDFException |
Get wrapper offset if current document's wrapper type is e_WrapperFoxit. More... | |
int | getWrapperType () throws com.foxit.sdk.PDFException |
Get Wrapper type. More... | |
boolean | hasForm () throws com.foxit.sdk.PDFException |
Check whether current PDF document has interactive form (also known as AcroForm). More... | |
boolean | importFromFDF (FDFDoc fdf_doc, int types, Range page_range) throws com.foxit.sdk.PDFException |
Import form fields and annotations from a FDF/XFDF document. More... | |
PDFPage | insertPage (int index, float width, float height) throws com.foxit.sdk.PDFException |
Insert a new blank PDF page to document, by index. More... | |
PDFPage | insertPage (int index, int size) throws com.foxit.sdk.PDFException |
Insert a new blank PDF page to document, by index. More... | |
ReadingBookmark | insertReadingBookmark (int reading_bookmark_index, String title, int dest_page_index) throws com.foxit.sdk.PDFException |
Insert a reading bookmark to current PDF document. More... | |
boolean | isCDRM () throws com.foxit.sdk.PDFException |
Check whether the loaded document is a ConnectedPDF DRM document or not. More... | |
boolean | isCPDF () throws com.foxit.sdk.PDFException |
Check whether the loaded document is a ConnectedPDF document or not. More... | |
boolean | isEmpty () |
Check whether current object is empty or not. More... | |
boolean | isEncrypted () throws com.foxit.sdk.PDFException |
Check whether current document is an encrypted file or not. More... | |
boolean | isLinearized () throws com.foxit.sdk.PDFException |
Check if current PDF document is a linearized file. More... | |
boolean | isPortfolio () throws com.foxit.sdk.PDFException |
Check whether current PDF document is a portfolio file or not. More... | |
boolean | isTaggedPDF () throws com.foxit.sdk.PDFException |
Check if current PDF document is a Tagged PDF file. More... | |
boolean | isWrapper () throws com.foxit.sdk.PDFException |
Check whether current document is a wrapper file or not. More... | |
boolean | isXFA () throws com.foxit.sdk.PDFException |
Check whether current PDF document is an XFA document. More... | |
int | load (byte[] password) throws com.foxit.sdk.PDFException |
Load current document content by using a specified password. More... | |
int | loadW (String password) throws com.foxit.sdk.PDFException |
Load current document content by using a specified password. More... | |
boolean | movePagesTo (Range page_range, int dest_index) throws com.foxit.sdk.PDFException |
Move one or more pages (specified by index) to a new index position. More... | |
boolean | movePageTo (PDFPage page, int dest_index) throws com.foxit.sdk.PDFException |
Move a specified page to a new index position. More... | |
boolean | removeBookmark (Bookmark bookmark) throws com.foxit.sdk.PDFException |
Remove a specified bookmark. More... | |
boolean | removeOpenAction () throws com.foxit.sdk.PDFException |
Remove the action to be performed when the document is opened. More... | |
boolean | removePage (int index) throws com.foxit.sdk.PDFException |
Remove a PDF page by page index. More... | |
boolean | removePage (PDFPage page) throws com.foxit.sdk.PDFException |
Remove a specified PDF page. More... | |
boolean | removeReadingBookmark (ReadingBookmark reading_bookmark) throws com.foxit.sdk.PDFException |
Remove a reading bookmark from current PDF document. More... | |
boolean | removeSecurity () throws com.foxit.sdk.PDFException |
Remove the security handler from current document, so that the later saved document will be unencrypted. More... | |
void | removeSignature (Signature signature) throws com.foxit.sdk.PDFException |
Remove a signature. More... | |
boolean | saveAs (String file_path, int save_flags) throws com.foxit.sdk.PDFException |
Save current PDF document as another PDF file. More... | |
boolean | saveAsWrapperFile (String file_path, WrapperData wrapper_data, int user_permissions, String owner_password) throws com.foxit.sdk.PDFException |
Save current PDF document as a wrapper file. More... | |
void | setDisplayMode (int display_mode) throws com.foxit.sdk.PDFException |
Set the display mode. More... | |
void | setFileVersion (int version) throws com.foxit.sdk.PDFException |
Set the PDF file version which will be stored in PDF header section of the saved PDF file. More... | |
boolean | setOpenAction (Action action) throws com.foxit.sdk.PDFException |
Set the action to be performed when the document is opened. More... | |
boolean | setSecurityHandler (SecurityHandler handler) throws com.foxit.sdk.PDFException |
Set a PDF security handler for encryption, such as standard encryption(password), certificate encryption, and so on. More... | |
Progressive | startGetPayloadFile (FileWriterCallback payload_file, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to get payload file. More... | |
Progressive | startImportPages (int dest_index, PDFDoc src_doc, int flags, String layer_name, Range page_range, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to import pages from another PDF document (via PDF document object). More... | |
Progressive | startImportPagesFromFilePath (int dest_index, String src_file_path, byte[] password, int flags, String layer_name, Range page_range, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to import pages from another PDF document (via file path). More... | |
Progressive | startLoad (byte[] password, boolean is_cache_stream, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to loading current document content by using a specified password. More... | |
Progressive | startLoadW (String password, boolean is_cache_stream, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to loading current document content by using a specified password. More... | |
Progressive | startSaveAs (String file_path, int save_flags, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to save current PDF document as another PDF file. More... | |
Progressive | startSaveAs (FileWriterCallback file, int save_flags, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to save current PDF document as another PDF file. More... | |
Progressive | startSaveAsPayloadFile (String file_path, String payload_file_path, String crypto_filter, String description, float version, int save_flags, PauseCallback pause) throws com.foxit.sdk.PDFException |
Start to save current PDF document as a wrapper document with a payload document (defined in PDF 2.0). More... | |
Static Public Attributes | |
static final int | e_Annots = 0x0002 |
Annotations are to imported from or exported to FDF/XFDF document. | |
static final int | e_DisplayFullScreen = 3 |
When document is opened, full-screen mode, with no menu bar, window controls, or any other windows are visible. | |
static final int | e_DisplayUseAttachment = 5 |
When document is opened, attachment panels are visible. | |
static final int | e_DisplayUseNone = 0 |
When document is opened, neither document outlines nor thumbnail images are visible. | |
static final int | e_DisplayUseOC = 4 |
When document is opened, optional content group panels are visible. | |
static final int | e_DisplayUseOutlines = 1 |
When document is opened, document outlines (bookmarks) are visible. | |
static final int | e_DisplayUseThumbs = 2 |
When document is opened, thumbnail images are visible. | |
static final int | e_EncryptCDRM = 6 |
Encryption type: Foxit connected PDF DRM encryption. | |
static final int | e_EncryptCertificate = 2 |
Encryption type: digital certificate encryption. | |
static final int | e_EncryptCustom = 4 |
Encryption type: customized encryption. | |
static final int | e_EncryptFoxitDRM = 3 |
Encryption type: Foxit DRM encryption. | |
static final int | e_EncryptNone = 0 |
No encryption pattern. | |
static final int | e_EncryptPassword = 1 |
Encryption type: password, which is the standard encryption. | |
static final int | e_EncryptRMS = 5 |
Encryption type: Microsoft RMS encryption. | |
static final int | e_EncryptUnknown = -1 |
Unknown encryption type. | |
static final int | e_Forms = 0x0001 |
Form fields are to imported from or exported to FDF/XFDF document. | |
static final int | e_ImportFlagNormal = 0 |
Import pages normally. | |
static final int | e_ImportFlagShareStream = 0x0002 |
Import pages without cloning stream objects into memory. More... | |
static final int | e_ImportFlagWithLayers = 0x0001 |
Import pages with layers. | |
static final int | e_NoLinks = 0x0004 |
Annotations (except link annotations) are to imported from or exported to FDF/XFDF document. | |
static final int | e_PermAnnotForm = 0x0020 |
Operate text annotations and fill in interactive form fields. (Bit 6 in permission value) More... | |
static final int | e_PermAssemble = 0x0400 |
Assemble PDF document. (Bit 11 in permission value) More... | |
static final int | e_PermExtract = 0x0010 |
Extract PDF contents. (Bit 5 in permission value) More... | |
static final int | e_PermExtractAccess = 0x0200 |
Disabilities support. (Bit 10 in permission value) More... | |
static final int | e_PermFillForm = 0x0100 |
Fill PDF form. (Bit 9 in permission value) More... | |
static final int | e_PermModify = 0x0008 |
Modify PDF contents. (Bit 4 in permission value) More... | |
static final int | e_PermPrint = 0x0004 |
Print PDF document with normal mode. (Bit 3 in permission value) More... | |
static final int | e_PermPrintHigh = 0x0800 |
Print PDF document with higher qualities. (Bit 12 in permission value) More... | |
static final int | e_PwdInvalid = 0 |
The password is invalid. | |
static final int | e_PwdNoPassword = 1 |
No password is used in PDF document. | |
static final int | e_PwdOwner = 3 |
An owner password is used in PDF document. | |
static final int | e_PwdUser = 2 |
A user password is used in PDF document. | |
static final int | e_SaveFlagIncremental = 0x0001 |
Save document incrementally. More... | |
static final int | e_SaveFlagLinearized = 0x1000 |
Save document as a linearized file. More... | |
static final int | e_SaveFlagNoOriginal = 0x0002 |
Save document without original data or unchanged objects. More... | |
static final int | e_SaveFlagNormal = 0 |
Save document normally, without using any special flag. This can only be used alone. | |
static final int | e_SaveFlagXRefStream = 0x0008 |
Save document by using XRef stream. More... | |
static final int | e_WrapperFoxit = 1 |
Foxit wrapper document. | |
static final int | e_WrapperNone = 0 |
Normal document. | |
static final int | e_WrapperPDFV2 = 2 |
PDF 2.0 wrapper document. | |
A PDF document object can be constructed with an existing PDF file from file path, memory buffer, a custom implemented ReaderCallback object and an input file stream. And then call function pdf::PDFDoc::startLoad or pdf::PDFDoc::startLoad to load document content. This class offers functions to retrieve different part of a PDF document. For example:
To retrieve pages, please use functions pdf::PDFDoc::getPageCount and pdf::PDFDoc::getPage.
To retrieve bookmark, such as function pdf::PDFDoc::getRootBookmark, pdf::PDFDoc::createRootBookmark, etc.
To retrieve some document's dictionaries (in low-level), such as functions pdf::PDFDoc::getCatalog, pdf::PDFDoc::getTrailer, etc.
To retrieve reading bookmark, such as functions pdf::PDFDoc::getReadingBookmarkCount, pdf::PDFDoc::getReadingBookmark, etc.
To check if a PDF document has interactive form, please use function pdf::PDFDoc::hasForm.
This class also offers functions for features, such as saving current document as another PDF file, importing pages from another PDF file, setting security handler in order to save encrypted PDF file, and so on.
This class object can also be used to construct objects of other classes in order to access specified information in PDF document:
To access form, please construct a interform::Form object with PDF document object.
To access additional actions, please construct an actions::AdditionalAction object with PDF document object.
To access viewer preferences information, please construct a DocViewerPrefs object with PDF document object.
To access metadata information, please construct a Metadata object with PDF document object.
To manage page labels information, please construct a PageLabels object with PDF document object.
To search among a PDF file, please construct a TextSearch object with PDF document object.
To access layers, please construct a LayerTree object with PDF document object. And to render layers, please constructor a LayerContext object with PDF document object.
To construct a new FileSpec object.
To manage associated files, please construct an AssociatedFiles object with PDF document object.
To access name tree, please construct a objects::PDFNameTree object with PDF document object. Specially, for EmbeddedFiles name tree, an Attachments object can be constructed with PDF document object, for convenient use.
To do redaction, please construct a addon::Redaction object with PDF document object.
com.foxit.sdk.pdf.PDFDoc.PDFDoc | ( | ) | throws com.foxit.sdk.PDFException |
Constructor.
This constructor is to construct a new PDF document (without any data). The file version value would be 17 (as PDF version 1.7) by default.
com.foxit.sdk.pdf.PDFDoc.PDFDoc | ( | String | path | ) | throws com.foxit.sdk.PDFException |
Constructor, from an existing PDF file path.
After constructing such a PDF document object, please ensure the document object has been loaded before using most functions in class pdf::PDFDoc.
path | A full path of an existing PDF file. It should not be an empty string. |
com.foxit.sdk.pdf.PDFDoc.PDFDoc | ( | byte [] | buffer | ) | throws com.foxit.sdk.PDFException |
Constructor, from a memory buffer.
After constructing such a PDF document object, please ensure the document object has been loaded before using most functions in class pdf::PDFDoc.
buffer | A memory buffer, containing the serialized document. The PDF document data should be fully loaded in this memory buffer. It should not be null. |
com.foxit.sdk.pdf.PDFDoc.PDFDoc | ( | FileReaderCallback | file_read, |
boolean | is_async | ||
) | throws com.foxit.sdk.PDFException |
Constructor, with a file read callback object.
After constructing such a PDF document object, please ensure the document object has been loaded before using most functions in class pdf::PDFDoc.
file_read | A ReaderCallback object which is implemented by user to load a PDF document. It should not be null. If the input callback object is a AsyncReaderCallback, and is_async is true that means the PDF document will be loaded by asynchronous method; otherwise, the document will be loaded in common way. |
is_async | Whether the input ReaderCallback object is for asynchronously loading or not. |
int com.foxit.sdk.pdf.PDFDoc.addIndirectObject | ( | PDFObject | pdf_object | ) | throws com.foxit.sdk.PDFException |
Add a PDF object to current PDF document, to be an indirect object.
If input PDF object is a direct object (whose indirect object number is 0), this functions will change it to be an indirect object and add to PDF document. Then return the new indirect object number.
If input PDF object is already an indirect object (whose indirect object number is above 0), this function will not add it into document again. The return value will be its own indirect object number.
pdf_object | A PDFObject object. It should not be null. |
int com.foxit.sdk.pdf.PDFDoc.checkPassword | ( | byte [] | password | ) | throws com.foxit.sdk.PDFException |
Check the type of a specified password.
This function can be used to check the type of any password string, including the password string used for loading document content.
password | A password string to be detected. |
int com.foxit.sdk.pdf.PDFDoc.checkPassword | ( | String | password | ) | throws com.foxit.sdk.PDFException |
(Only supported in PDF 2.0) Check the type of a specified unicode password.
This function can be used to check the type of any password string, including the password string used for loading document content.
password | A unicode password string to be detected. |
void com.foxit.sdk.pdf.PDFDoc.clearRenderCache | ( | ) | throws com.foxit.sdk.PDFException |
Clear the cache used during rendering, to reduce the memory usage.
Bookmark com.foxit.sdk.pdf.PDFDoc.createRootBookmark | ( | ) | throws com.foxit.sdk.PDFException |
Create new bookmark root node.
If current PDF document already has the bookmark root node, this function will remove the old bookmark tree and create a new root node instead.
void com.foxit.sdk.pdf.PDFDoc.deleteIndirectObject | ( | int | object_number | ) | throws com.foxit.sdk.PDFException |
Delete an indirect object by indirect object number.
object_number | The indirect object number. It should be above 0. |
boolean com.foxit.sdk.pdf.PDFDoc.doJSOpenAction | ( | ) | throws com.foxit.sdk.PDFException |
Perform JavaScript actions when the document is opened.
boolean com.foxit.sdk.pdf.PDFDoc.exportAnnotToFDF | ( | Annot | pdf_annot, |
FDFDoc | fdf_doc | ||
) | throws com.foxit.sdk.PDFException |
Export specified annotation to a FDF/XFDF document.
pdf_annot | A valid PDF annotation object to be exported to the FDF/XFDF document. |
fdf_doc | A valid FDF/XFDF document object, to which the specified annotation will be exported. |
boolean com.foxit.sdk.pdf.PDFDoc.exportToFDF | ( | FDFDoc | fdf_doc, |
int | types, | ||
Range | page_range | ||
) | throws com.foxit.sdk.PDFException |
Export form fields and annotations to a FDF/XFDF document.
fdf_doc | A valid FDF/XFDF document object, to which form fields and annotations will be exported. |
types | Used to decide which kind of data will be exported. Please refer to values starting from e_Forms and this can be one or a combination of these values. |
page_range | A Range object that specifies some pages. Data (in specified types) in these pages will be exported to FDF/XFDF document. If this Range object is constructed by default constructor and not set any value, that means all the data (in specified types) of current document will be exported to FDF/XFDF document. |
PDFDictionary com.foxit.sdk.pdf.PDFDoc.getCatalog | ( | ) | throws com.foxit.sdk.PDFException |
Get the catalog dictionary.
CertificateEncryptData com.foxit.sdk.pdf.PDFDoc.getCertificateEncryptData | ( | ) | throws com.foxit.sdk.PDFException |
Get encrypt data of certificate encryption.
This function is useful when current document is encrypted by certificate.
CustomEncryptData com.foxit.sdk.pdf.PDFDoc.getCustomEncryptData | ( | ) | throws com.foxit.sdk.PDFException |
Get encrypt data of custom encryption.
This function is useful when current document is encrypted by custom.
int com.foxit.sdk.pdf.PDFDoc.getDisplayMode | ( | ) | throws com.foxit.sdk.PDFException |
Get the display mode.
Display mode specifies how the document should be displayed when opened.
String com.foxit.sdk.pdf.PDFDoc.getDocURI | ( | ) | throws com.foxit.sdk.PDFException |
Get the URI of connected PDF if current PDF is a connected PDF.
DRMEncryptData com.foxit.sdk.pdf.PDFDoc.getDRMEncryptData | ( | ) | throws com.foxit.sdk.PDFException |
Get encrypt data of Foxit DRM encryption.
This function is useful when current document is encrypted by Foxit DRM.
PDFDictionary com.foxit.sdk.pdf.PDFDoc.getEncryptDict | ( | ) | throws com.foxit.sdk.PDFException |
Get the encrypt dictionary.
int com.foxit.sdk.pdf.PDFDoc.getEncryptionType | ( | ) | throws com.foxit.sdk.PDFException |
Get the encryption type.
String com.foxit.sdk.pdf.PDFDoc.getEndpoint | ( | ) | throws com.foxit.sdk.PDFException |
Get the URL of ConnectedPDF Web services if current PDF is a connected PDF.
java.math.BigInteger com.foxit.sdk.pdf.PDFDoc.getFileSize | ( | ) | throws com.foxit.sdk.PDFException |
Get file size.
int com.foxit.sdk.pdf.PDFDoc.getFileVersion | ( | ) | throws com.foxit.sdk.PDFException |
Get PDF file version stored in PDF header section.
int com.foxit.sdk.pdf.PDFDoc.getFirstAvailPageIndex | ( | ) | throws com.foxit.sdk.PDFException |
Get the page index of the fist available page.
This is useful for a linearized PDF document because in a linearized PDF document the first available page may not be the first page.
This function can be used only when document is loaded successfully.
Font com.foxit.sdk.pdf.PDFDoc.getFont | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Get a font by index.
index | The index of PDF font. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getFontCount. |
int com.foxit.sdk.pdf.PDFDoc.getFontCount | ( | ) | throws com.foxit.sdk.PDFException |
Count all the PDF fonts used in current PDF document.
This function will enumerate all the font resources used for pages, annotations, and interactive form.
String com.foxit.sdk.pdf.PDFDoc.getHeader | ( | ) | throws com.foxit.sdk.PDFException |
Get PDF header identifying the version of the PDF specification to which the file conforms.
PDFObject com.foxit.sdk.pdf.PDFDoc.getIndirectObject | ( | int | object_number | ) | throws com.foxit.sdk.PDFException |
Get an indirect object by indirect object number.
object_number | The indirect object number. It should be above 0. |
PDFDictionary com.foxit.sdk.pdf.PDFDoc.getInfo | ( | ) | throws com.foxit.sdk.PDFException |
Get the information dictionary.
Document's information dictionary contains metadata for the document.
Action com.foxit.sdk.pdf.PDFDoc.getOpenAction | ( | ) | throws com.foxit.sdk.PDFException |
Get the action to be performed when the document is opened.
PDFPage com.foxit.sdk.pdf.PDFDoc.getPage | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Get a PDF page by index.
If current PDF document object is constructed with a AsyncReaderCallback which means to do asynchronous loading, this function may throw exception e_ErrDataNotReady. In this case, user should prepare data for specified range informed by callback function common::file::AsyncReaderCallback::addDownloadHint and then call this function again.
index | The page index. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getPageCount. |
PageBasicInfo com.foxit.sdk.pdf.PDFDoc.getPageBasicInfo | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Get the basic information of a page specified by index.
This function can quickly get the basic information of a PDF page without getting that PDF page object. If current PDF document object is constructed with a AsyncReaderCallback which means to do asynchronous loading, this function may throw exception e_ErrDataNotReady. In this case, user should prepare data for specified range informed by callback function common::file::AsyncReaderCallback::addDownloadHint and then call this function again.
index | The page index. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getPageCount. |
int com.foxit.sdk.pdf.PDFDoc.getPageCount | ( | ) | throws com.foxit.sdk.PDFException |
Get the count of pages.
PDFDictionary com.foxit.sdk.pdf.PDFDoc.getPagesDict | ( | ) | throws com.foxit.sdk.PDFException |
Get the dictionary of "Pages".
int com.foxit.sdk.pdf.PDFDoc.getPasswordType | ( | ) | throws com.foxit.sdk.PDFException |
Get the type of current used password.
This function is useful after loading a PDF document, in order to get the type of the password which was used in the loading process.
If current document is a new one (not loading from existed PDF file), this function will return e_PwdNoPassword.
If current document is constructed from an existing file but has not been loaded yet, this function will return e_PwdInvalid.
PayLoadData com.foxit.sdk.pdf.PDFDoc.getPayLoadData | ( | ) | throws com.foxit.sdk.PDFException |
Get payload data if current document's wrapper type is e_WrapperPDFV2.
ReadingBookmark com.foxit.sdk.pdf.PDFDoc.getReadingBookmark | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Get a reading bookmark by index.
index | The index of reading bookmarks. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getReadingBookmarkCount. |
int com.foxit.sdk.pdf.PDFDoc.getReadingBookmarkCount | ( | ) | throws com.foxit.sdk.PDFException |
Get the count of reading bookmarks.
RMSEncryptData com.foxit.sdk.pdf.PDFDoc.getRMSEncryptData | ( | ) | throws com.foxit.sdk.PDFException |
Get encrypt data of RMS encryption.
This function is useful when current document is encrypted by RMS.
Bookmark com.foxit.sdk.pdf.PDFDoc.getRootBookmark | ( | ) | throws com.foxit.sdk.PDFException |
Get bookmark root node.
SecurityHandler com.foxit.sdk.pdf.PDFDoc.getSecurityHandler | ( | ) | throws com.foxit.sdk.PDFException |
Get current PDF security handler of current document.
Signature com.foxit.sdk.pdf.PDFDoc.getSignature | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Get a signature by index.
index | The index of signature. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getSignatureCount. |
int com.foxit.sdk.pdf.PDFDoc.getSignatureCount | ( | ) | throws com.foxit.sdk.PDFException |
Get the count of signature.
StdEncryptData com.foxit.sdk.pdf.PDFDoc.getStdEncryptData | ( | ) | throws com.foxit.sdk.PDFException |
Get encrypt data of standard encryption (known as password encryption).
This function is useful when current document is encrypted by password.
PDFDictionary com.foxit.sdk.pdf.PDFDoc.getTrailer | ( | ) | throws com.foxit.sdk.PDFException |
Get the trailer dictionary.
String com.foxit.sdk.pdf.PDFDoc.getUserPassword | ( | byte [] | owner_password | ) | throws com.foxit.sdk.PDFException |
Get the user password based on owner password.
This function is useful when current document is encrypted by password.
owner_password | Owner password string. |
int com.foxit.sdk.pdf.PDFDoc.getUserPermissions | ( | ) | throws com.foxit.sdk.PDFException |
Get user access permissions.
WrapperData com.foxit.sdk.pdf.PDFDoc.getWrapperData | ( | ) | throws com.foxit.sdk.PDFException |
Get wrapper data if current document's wrapper type is e_WrapperFoxit.
int com.foxit.sdk.pdf.PDFDoc.getWrapperOffset | ( | ) | throws com.foxit.sdk.PDFException |
Get wrapper offset if current document's wrapper type is e_WrapperFoxit.
int com.foxit.sdk.pdf.PDFDoc.getWrapperType | ( | ) | throws com.foxit.sdk.PDFException |
Get Wrapper type.
boolean com.foxit.sdk.pdf.PDFDoc.hasForm | ( | ) | throws com.foxit.sdk.PDFException |
Check whether current PDF document has interactive form (also known as AcroForm).
If current PDF document object is constructed with a AsyncReaderCallback which means to do asynchronous loading, this function may throw exception e_ErrDataNotReady. In this case, user should prepare data for specified range informed by callback function common::file::AsyncReaderCallback::addDownloadHint and then call this function again.
boolean com.foxit.sdk.pdf.PDFDoc.importFromFDF | ( | FDFDoc | fdf_doc, |
int | types, | ||
Range | page_range | ||
) | throws com.foxit.sdk.PDFException |
Import form fields and annotations from a FDF/XFDF document.
fdf_doc | A valid FDF/XFDF document object, from which form fields and annotations will be imported. |
types | Used to decide which kind of data will be imported. Please refer to values starting from e_Forms and this can be one or a combination of these values. |
page_range | A Range object that specifies some pages. Data (in specified types) from FDF/XFDF document will be imported to these specified pages. range for importing. If this Range object is constructed by default constructor and not set any value, that means data (in specified types) from FDF/XFDF document will be imported to related PDF pages whose index have been defined in FDF/XFDF document. |
PDFPage com.foxit.sdk.pdf.PDFDoc.insertPage | ( | int | index, |
float | width, | ||
float | height | ||
) | throws com.foxit.sdk.PDFException |
Insert a new blank PDF page to document, by index.
index | The page index for new page. If parameter index is less than 0, the new page will be inserted to the first. If parameter index is equal to or larger than current page count, the new page will be inserted to the end. |
width | Width of new page (unit is 1/72 inch). |
height | Height of new page (unit is 1/72 inch). |
PDFPage com.foxit.sdk.pdf.PDFDoc.insertPage | ( | int | index, |
int | size | ||
) | throws com.foxit.sdk.PDFException |
Insert a new blank PDF page to document, by index.
index | The page index for new page. If parameter index is less than 0, the new page will be inserted to the first. If parameter index is equal to or larger than current page count, the new page will be inserted to the end. |
size | Size type of new page. Please refer to values starting from e_SizeLetter and this should be one of these values. |
ReadingBookmark com.foxit.sdk.pdf.PDFDoc.insertReadingBookmark | ( | int | reading_bookmark_index, |
String | title, | ||
int | dest_page_index | ||
) | throws com.foxit.sdk.PDFException |
Insert a reading bookmark to current PDF document.
reading_bookmark_index | A reading bookmark index. If reading_bookmark_index is less than 0, the new reading bookmark will be inserted to the first. If reading_bookmark_index is equal to or larger than the count of reading bookmarks, the new reading bookmark will be inserted to the end. |
title | Title string for new reading bookmark and should not an empty string. |
dest_page_index | The index of destination page. |
boolean com.foxit.sdk.pdf.PDFDoc.isCDRM | ( | ) | throws com.foxit.sdk.PDFException |
Check whether the loaded document is a ConnectedPDF DRM document or not.
boolean com.foxit.sdk.pdf.PDFDoc.isCPDF | ( | ) | throws com.foxit.sdk.PDFException |
Check whether the loaded document is a ConnectedPDF document or not.
boolean com.foxit.sdk.pdf.PDFDoc.isEmpty | ( | ) |
Check whether current object is empty or not.
When the current object is empty, that means current object is useless.
boolean com.foxit.sdk.pdf.PDFDoc.isEncrypted | ( | ) | throws com.foxit.sdk.PDFException |
Check whether current document is an encrypted file or not.
boolean com.foxit.sdk.pdf.PDFDoc.isLinearized | ( | ) | throws com.foxit.sdk.PDFException |
Check if current PDF document is a linearized file.
If current document object is constructed with a AsyncReaderCallback object, this function can be used before or after the document is loaded successfully. Specially, if this function is called before document is loaded successfully, application should ensure the first 1024 bytes of the PDF file is available; otherwise, this function will call the callback function common::file::AsyncReaderCallback::addDownloadHint to notify application the range of data which should be downloaded by application then, and then this function will throw exception e_ErrDataNotReady.
If current document object is constructed from other methods or with a common ReaderCallback object, this function can only be used after the document is loaded successfully; otherwise, exception e_ErrUnknownState will be thrown.
boolean com.foxit.sdk.pdf.PDFDoc.isPortfolio | ( | ) | throws com.foxit.sdk.PDFException |
Check whether current PDF document is a portfolio file or not.
boolean com.foxit.sdk.pdf.PDFDoc.isTaggedPDF | ( | ) | throws com.foxit.sdk.PDFException |
Check if current PDF document is a Tagged PDF file.
boolean com.foxit.sdk.pdf.PDFDoc.isWrapper | ( | ) | throws com.foxit.sdk.PDFException |
Check whether current document is a wrapper file or not.
boolean com.foxit.sdk.pdf.PDFDoc.isXFA | ( | ) | throws com.foxit.sdk.PDFException |
Check whether current PDF document is an XFA document.
Currently, Foxit PDF SDK does not fully support XFA document. When loading an XFA document, Foxit PDF SDK may only load the XFA wrapper level, and cannot have access to the real XFA content. Foxit PDF SDK does not support to insert/import/remove/move pages in an XFA document yet.
int com.foxit.sdk.pdf.PDFDoc.load | ( | byte [] | password | ) | throws com.foxit.sdk.PDFException |
Load current document content by using a specified password.
If current PDF document object is constructed with a AsyncReaderCallback which means to do asynchronous loading, this function may return e_ErrDataNotReady. In this case, user should prepare data for specified range informed by callback function common::file::AsyncReaderCallback::addDownloadHint and then call this function again.
password | The password string, used to load current document content. The password can be either user password or owner password. If current document is not encrypted by password, just pass an empty string. |
int com.foxit.sdk.pdf.PDFDoc.loadW | ( | String | password | ) | throws com.foxit.sdk.PDFException |
Load current document content by using a specified password.
If current PDF document object is constructed with a AsyncReaderCallback which means to do asynchronous loading, this function may return e_ErrDataNotReady. In this case, user should prepare data for specified range informed by callback function common::file::AsyncReaderCallback::addDownloadHint and then call this function again.
password | The password string, used to load current document content. The password can be either user password or owner password. If current document is not encrypted by password, just pass an empty string. |
boolean com.foxit.sdk.pdf.PDFDoc.movePagesTo | ( | Range | page_range, |
int | dest_index | ||
) | throws com.foxit.sdk.PDFException |
Move one or more pages (specified by index) to a new index position.
If move only one page, this function just has the same feature as function pdf::PDFDoc::movePageTo.
If move more than one page, these page will keep the order defined in parameter page_range and be moved to the destination index position as a whole.
After this function is successful, indexes of moved pages will be changed and indexes of the rest pages may be affected as well.
page_range | A Range object which should at least contain one valid range. All the related pages will keep the order (specified by this range) and be moved as a whole. If there exist duplicated indexes in the range, only the last occurrence will be useful. |
dest_index | Index of the destination position, based on current page array. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getPageCount. |
boolean com.foxit.sdk.pdf.PDFDoc.movePageTo | ( | PDFPage | page, |
int | dest_index | ||
) | throws com.foxit.sdk.PDFException |
Move a specified page to a new index position.
If the specified page is successfully moved to the new index position, page index of all the pages between the new index and old index of the specified page will be changed as well.
page | A PDF page to be moved. It should be in current PDF document. |
dest_index | Index of the destination position in page array. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getPageCount. If parameter dest_index is just the same as the page index of parameter page, no change will be done and this function will return true directly. |
boolean com.foxit.sdk.pdf.PDFDoc.removeBookmark | ( | Bookmark | bookmark | ) | throws com.foxit.sdk.PDFException |
Remove a specified bookmark.
bookmark | The valid bookmark that would be deleted. |
boolean com.foxit.sdk.pdf.PDFDoc.removeOpenAction | ( | ) | throws com.foxit.sdk.PDFException |
Remove the action to be performed when the document is opened.
boolean com.foxit.sdk.pdf.PDFDoc.removePage | ( | int | index | ) | throws com.foxit.sdk.PDFException |
Remove a PDF page by page index.
index | The page index. Valid range: from 0 to (count-1). count is returned by function pdf::PDFDoc::getPageCount. |
boolean com.foxit.sdk.pdf.PDFDoc.removePage | ( | PDFPage | page | ) | throws com.foxit.sdk.PDFException |
Remove a specified PDF page.
Once the specified PDF page is removed successfully, the page object cannot be used any more.
page | A PDFPage object that represents the PDF page to be removed. The page should be in current PDF document. |
boolean com.foxit.sdk.pdf.PDFDoc.removeReadingBookmark | ( | ReadingBookmark | reading_bookmark | ) | throws com.foxit.sdk.PDFException |
Remove a reading bookmark from current PDF document.
reading_bookmark | A valid reading bookmark to be removed. |
boolean com.foxit.sdk.pdf.PDFDoc.removeSecurity | ( | ) | throws com.foxit.sdk.PDFException |
Remove the security handler from current document, so that the later saved document will be unencrypted.
void com.foxit.sdk.pdf.PDFDoc.removeSignature | ( | Signature | signature | ) | throws com.foxit.sdk.PDFException |
Remove a signature.
signature | A valid signature to be removed. |
boolean com.foxit.sdk.pdf.PDFDoc.saveAs | ( | String | file_path, |
int | save_flags | ||
) | throws com.foxit.sdk.PDFException |
Save current PDF document as another PDF file.
If current document is loaded from an existing PDF file and a different file version has been set by function pdf::PDFDoc::setFileVersion before saving, Foxit PDF SDK will ignore e_SaveFlagIncremental in parameter save_flags and use the file version in saved PDF file.
file_path | A full path for the new saved PDF file. It should not be an empty string. |
save_flags | Document saving flags. Please refer to values starting from e_SaveFlagNormal and this can be one or combination of these values. |
boolean com.foxit.sdk.pdf.PDFDoc.saveAsWrapperFile | ( | String | file_path, |
WrapperData | wrapper_data, | ||
int | user_permissions, | ||
String | owner_password | ||
) | throws com.foxit.sdk.PDFException |
Save current PDF document as a wrapper file.
PDF wrapper is an extended standard, and it helps to hint some information to viewers.
PDF wrapper consists of
wrapper type: it is an identity string,
wrapper offset: it tells the end of original data,
wrapper template: it is the content of wrapper document.
This function uses the current size of file which is specified by file_path to set wrapper offset.
file_path | A full path of a PDF file. Current PDF document will be saved into this PDF file as a wrapper file. |
wrapper_data | Wrapper data. If this is null, no wrapper data is used. |
user_permissions | User permissions for the wrapper document. Pass 0xFFFFFFFC if no special permissions is needed. Please refer to values starting from e_PermPrint and this should be one or combination of these values. Default value: 0xFFFFFFFC. |
owner_password | Owner password. If this is an empty string, parameter user_permissions will be ignored. |
void com.foxit.sdk.pdf.PDFDoc.setDisplayMode | ( | int | display_mode | ) | throws com.foxit.sdk.PDFException |
Set the display mode.
Display mode specifies how the document should be displayed when opened.
display_mode | Display mode value. Please refer to values starting from e_DisplayUseNone and this should be one of these values. |
void com.foxit.sdk.pdf.PDFDoc.setFileVersion | ( | int | version | ) | throws com.foxit.sdk.PDFException |
Set the PDF file version which will be stored in PDF header section of the saved PDF file.
The new file version will not affect on current document directly, but will be used in the saved PDF file in function pdf::PDFDoc::saveAs or pdf::PDFDoc::startSaveAs. This function does not check whether the PDF content matches the specified version.
version | An integer that specifies the file version, for example value 14 means version "1.4", value 15 means "1.5", and etc. This value should be from 10 to 17 or 20 and be equal or greater than current version of current PDF file. |
boolean com.foxit.sdk.pdf.PDFDoc.setOpenAction | ( | Action | action | ) | throws com.foxit.sdk.PDFException |
Set the action to be performed when the document is opened.
action | A valid action to be set. Currently only support following types as the new action: actions::e_TypeGoto, actions::e_TypeURI, actions::e_TypeJavaScript, actions::e_TypeNamed, actions::e_TypeSubmitForm, actions::e_TypeResetForm, actions::e_TypeHide, actions::e_TypeImportData. |
boolean com.foxit.sdk.pdf.PDFDoc.setSecurityHandler | ( | SecurityHandler | handler | ) | throws com.foxit.sdk.PDFException |
Set a PDF security handler for encryption, such as standard encryption(password), certificate encryption, and so on.
handler | A PDF SecurityHandler object. |
Progressive com.foxit.sdk.pdf.PDFDoc.startGetPayloadFile | ( | FileWriterCallback | payload_file, |
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to get payload file.
It may take a long time to getting payload document, so this function uses a progressive process to do this.
payload_file | A WriterCallback callback object. User should implement the callback function in this callback object in order that this callback object can be used to save payload file. |
pause | Pause callback object which decides if the parsing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startImportPages | ( | int | dest_index, |
PDFDoc | src_doc, | ||
int | flags, | ||
String | layer_name, | ||
Range | page_range, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to import pages from another PDF document (via PDF document object).
It may take a long time to importing pages, so Foxit PDF SDK uses a progressive process to do this.
Signed signatures in the pages of source PDF document will not be imported into current PDF document.
Currently, if either current PDF document or the source PDF document contains XFA, not support to do the importing.
dest_index | A page index in current PDF document. This is used to specify where the imported pages will be inserted: If parameter dest_index is less than 0, the imported pages will be inserted to the first. If parameter dest_index is equal to or larger than current page count, the imported pages will be inserted to the end. |
src_doc | A PDF document object which is the source PDF document. Pages in this document will be imported to current PDF document. Please keep this source PDF document object valid until current document will not be saved any more or is closed. |
flags | Options for importing pages. Please refer to values starting from e_ImportFlagNormal and this can be one or a combination of these macros. |
layer_name | The name of non-selectable label or the prefix name of the non-selectable label to be shown in layer panel of application. If parameter flags contains e_ImportFlagWithLayers, this should not be empty and should be a valid string. If parameter flags does not contain e_ImportFlagWithLayers, this string will be ignored. If all the pages of source PDF document is to be imported to current document, all layers from source document will be grouped under a non-selectable label, and this string will be directly used as the label. If only part of pages of source PDF document is to be imported to current document, layers in the same page will be grouped under a single non-selectable label, and this string will be used as the prefix name of the label. The label will be like "layerName_Page_X". |
page_range | A Range object to specify which pages is to be inserted. If this Range object is constructed by default constructor and not set any value, all pages in the source document will be imported. |
pause | Pause object which decides if the importing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startImportPagesFromFilePath | ( | int | dest_index, |
String | src_file_path, | ||
byte [] | password, | ||
int | flags, | ||
String | layer_name, | ||
Range | page_range, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to import pages from another PDF document (via file path).
It may take a long time to importing pages, so Foxit PDF SDK uses a progressive process to do this.
Signed signatures in the pages of source PDF document will not be imported into current PDF document.
Currently, Foxit PDF SDK does not support to do the importing if either current PDF document or the source PDF document contains XFA.
dest_index | A page index in current PDF document. This is used to specify where the imported pages will be inserted. If parameter dest_index is less than 0, the imported pages will be inserted to the first. If parameter dest_index is equal to or larger than current page count, the imported pages will be inserted to the end. |
src_file_path | A full path of an existing PDF file as the source PDF document Some pages will be imported from this PDF file to current PDF document. |
password | A password string used to load source PDF document content. The password can be either user password or owner password. If source PDF document is not encrypted by password, just pass an empty string. |
flags | Options for importing pages. Please refer to values starting from e_ImportFlagNormal and this can be one or a combination of these values. |
layer_name | The name of non-selectable label or the prefix name of the non-selectable label to be shown in layer panel of application. If parameter flags contains e_ImportFlagWithLayers, this should not be empty and should be a valid string. If parameter flags does not contain e_ImportFlagWithLayers, this string will be ignored. If all the pages of source PDF document is to be imported to current document, all layers from source document will be grouped under a non-selectable label, and this string will be directly used as the label. If only part of pages of source PDF document is to be imported to current document, layers in the same page will be grouped under a single non-selectable label, and this string will be used as the prefix name of the label. The label will be like "layerName_Page_X". |
page_range | A range object to specify which pages is to be imported. If this Range object is constructed by default constructor and not set any value, all pages in the source document will be imported. |
pause | Pause object which decides if the importing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startLoad | ( | byte [] | password, |
boolean | is_cache_stream, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to loading current document content by using a specified password.
It may take a long time to loading document content, so this function uses a progressive process to do this.
When using this function, parameter is_cache_stream can be used to decide whether to load stream content into memory or not:
Loading stream content into memory will improve performance for frequent access, however, it will also consume a lot of memory space.
Not to load stream content into memory, that means to leave stream content on file system, and read them when needed. This may reduce the performance a little bit, but greatly reduce the memory consumption, especially when the file is big.
password | A password string, used to load current document content. The password can be either user password or owner password. If current document is not encrypted by password, just pass an empty string. |
is_cache_stream | true means to load stream content into memory, and false means not to load stream content into memory and just leave stream content on file system and read them when needed. Please refer to "Details" part about the difference between these two modes. |
pause | Pause object which decides if the importing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startLoadW | ( | String | password, |
boolean | is_cache_stream, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to loading current document content by using a specified password.
It may take a long time to loading document content, so this function uses a progressive process to do this.
When using this function, parameter is_cache_stream can be used to decide whether to load stream content into memory or not:
Loading stream content into memory will improve performance for frequent access, however, it will also consume a lot of memory space.
Not to load stream content into memory, that means to leave stream content on file system, and read them when needed. This may reduce the performance a little bit, but greatly reduce the memory consumption, especially when the file is big.
password | A password string, used to load current document content. The password can be either user password or owner password. If current document is not encrypted by password, just pass an empty string. |
is_cache_stream | true means to load stream content into memory, and false means not to load stream content into memory and just leave stream content on file system and read them when needed. Please refer to "Details" part about the difference between these two modes. |
pause | Pause object which decides if the importing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startSaveAs | ( | String | file_path, |
int | save_flags, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to save current PDF document as another PDF file.
It may take a long time to saving PDF document, so this function uses a progressive process to do this.
If current document is loaded from an existing PDF file and a different file version has been set by function pdf::PDFDoc::setFileVersion before saving, Foxit PDF SDK will ignore e_SaveFlagIncremental in parameter save_flags and use the file version in saved PDF file.
file_path | A full path for the new saved PDF file. It should not be an empty string. |
save_flags | Document saving flags. Please refer to values starting from e_SaveFlagNormal and this can be one or combination of these values. |
pause | Pause callback object which decides if the parsing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startSaveAs | ( | FileWriterCallback | file, |
int | save_flags, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to save current PDF document as another PDF file.
It may take a long time to saving PDF document, so this function uses a progressive process to do this.
If current document is loaded from an existing PDF file and a different file version has been set by function pdf::PDFDoc::setFileVersion before saving, Foxit PDF SDK will ignore e_SaveFlagIncremental in parameter save_flags and use the file version in saved PDF file.
file | A WriterCallback object which is implemented by user to save a PDF document. |
save_flags | Document saving flags. Please refer to values starting from e_SaveFlagNormal and this can be one or combination of these values. |
pause | Pause callback object which decides if the parsing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
Progressive com.foxit.sdk.pdf.PDFDoc.startSaveAsPayloadFile | ( | String | file_path, |
String | payload_file_path, | ||
String | crypto_filter, | ||
String | description, | ||
float | version, | ||
int | save_flags, | ||
PauseCallback | pause | ||
) | throws com.foxit.sdk.PDFException |
Start to save current PDF document as a wrapper document with a payload document (defined in PDF 2.0).
It may take a long time to saving PDF document, so this function uses a progressive process to do this.
If current document is loaded from an existing PDF file and a different file version has been set by function pdf::PDFDoc::setFileVersion before saving, Foxit PDF SDK will ignore e_SaveFlagIncremental in parameter save_flags and use the file version in saved PDF file.
file_path | A full path for the new saved PDF file. It should not be an empty string. |
payload_file_path | A full path of a PDF document which will be used as payload document. It should not be an empty string. |
crypto_filter | The name of the cryptographic filter used to encrypt the encrypted payload document. |
description | Description for wrapper file to show applications or confront users prompt information. |
version | The version number of the cryptographic filter used to encrypt the encrypted payload referenced by this dictionary. |
save_flags | Document saving flags. Please refer to values starting from e_SaveFlagNormal and this can be one or combination of these values. |
pause | Pause callback object which decides if the parsing process needs to be paused. This can be null which means not to pause during the parsing process. If this is not null, it should be a valid pause object implemented by user. |
|
static |
Import pages without cloning stream objects into memory.
This flags is only useful when the source PDF document has not been encrypted. If this flag is used for importing pages, it will reduce memory overhead.
|
static |
Operate text annotations and fill in interactive form fields. (Bit 6 in permission value)
If value e_PermModify is also set, user can create or modify interactive form fields (including signature fields).
|
static |
Assemble PDF document. (Bit 11 in permission value)
If this value is set, it enables to assemble the document (Insert, rotate, or delete pages and create bookmarks or thumbnail images), regardless if value e_PermModify is set or not.
|
static |
Extract PDF contents. (Bit 5 in permission value)
If this value is set, user can copy or otherwise extract text and graphics from the document by operations other than that controlled by value e_PermExtractAccess.
|
static |
Disabilities support. (Bit 10 in permission value)
If this value is set, user can extract text and graphics in support of accessibility to users with disabilities or for other purposes.
|
static |
Fill PDF form. (Bit 9 in permission value)
If this value is set, user can fill in interactive form fields (including signature fields), even if value e_PermAnnotForm is not used.
|
static |
Modify PDF contents. (Bit 4 in permission value)
If this value is set, user can modify contents of PDF document by operations other than those controlled by values e_PermAnnotForm, e_PermFillForm and e_PermAssemble.
|
static |
Print PDF document with normal mode. (Bit 3 in permission value)
If user wants to print a higher quality level of PDF document, please set current value with value e_PermPrintHigh together.
|
static |
Print PDF document with higher qualities. (Bit 12 in permission value)
If this value is not set (and value e_PermPrint is set), printing is limited to a low-level representation of the appearance, possibly of degraded quality.
|
static |
Save document incrementally.
This can be used alone or be combined with other saving flags except e_SaveFlagNormal. Especially, if this is combined with e_SaveFlagNoOriginal, only the increment data will be saved.
|
static |
Save document as a linearized file.
This should be used alone and cannot be used with other saving flags. This can only be used for function pdf::PDFDoc::saveAs or pdf::PDFDoc::startSaveAs.
|
static |
Save document without original data or unchanged objects.
This can be used alone or be combined with other saving flags except e_SaveFlagNormal. Especially, if this is combined with e_SaveFlagIncremental, only the increment data will be saved.
|
static |
Save document by using XRef stream.
This can be used alone or be combined with other saving flags except e_SaveFlagNormal.