An instance of the JawsMako PDF input class. More...
#include <pdfinput.h>
Classes | |
class | CPdfFontInfo |
Information about a font in a PDF file, obtained by scanning the PDF font structures. More... | |
class | CPdfScannedInk |
Basic information about an ink used in a PDF file, obtained by scanning the PDF page tree. More... | |
Public Member Functions | |
virtual void | setPassword (const U8String &password)=0 |
Set the password that should be used when attempting to open PDF files. For password encrypted PDF, this is the user or owner password. For PDF files encrypted with public key cryptography, this is the password to be used to extract the private key from the PKCS12/PFX container. The default is no password. More... | |
virtual void | setPkcs12 (const IRAInputStreamPtr &pkcs12)=0 |
Set the stream containing the PKCS12/PFX data containing the private key used to decrypt the PDF when public key encryption is used. More... | |
virtual void | setFailOnFontFallback (bool failOnFontFallback)=0 |
Set whether or not to fail when a font cannot be found and PDF input needs to use a fallback font or create and emulated font. More... | |
virtual void | setDefaultRenderingIntent (eRenderingIntent intent)=0 |
Override the default rendering intent in the PDF. More... | |
virtual CPdfFontInfoVect | scanPdfForFonts (const U8String &pathToFile, const IProgressMonitorPtr &progressMonitor, bool domFont=false)=0 |
Quickly scan the PDF file at the given UTF-8 path for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also. More... | |
virtual CPdfFontInfoVect | scanPdfForFonts (const String &pathToFile, const IProgressMonitorPtr &progressMonitor, bool domFont=false)=0 |
Quickly scan the PDF file at the given wide-character Unicode path for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also. More... | |
virtual CPdfFontInfoVect | scanPdfForFonts (const IInputStreamPtr &pdfStream, const IProgressMonitorPtr &progressMonitor, bool domFont=false)=0 |
Quickly scan the PDF file in the given stream for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also. More... | |
virtual CPdfScannedInkVect | scanPdfForInks (const U8String &pathToFile, const IProgressMonitorPtr &progressMonitor, uint32 startPageIndex=0, uint32 endPageIndex=0)=0 |
Quickly scan the PDF file at the given UTF-8 path and find any mentions of inks in color spaces. More... | |
virtual CPdfScannedInkVect | scanPdfForInks (const String &pathToFile, const IProgressMonitorPtr &progressMonitor, uint32 startPageIndex=0, uint32 endPageIndex=0)=0 |
Quickly scan the PDF file at the given wide character path and find any mentions of inks in color spaces. More... | |
virtual CPdfScannedInkVect | scanPdfForInks (const IInputStreamPtr &pdfStream, const IProgressMonitorPtr &progressMonitor, uint32 startPageIndex=0, uint32 endPageIndex=0)=0 |
Quickly scan the given PDF stream and find any mentions of inks in color spaces. More... | |
virtual uint32 | getNumIncrementalSaves (const U8String &pathToFile)=0 |
Find the number of incremental saves in the given PDF stream. More... | |
virtual uint32 | getNumIncrementalSaves (const String &pathToFile)=0 |
Find the number of incremental saves in the given PDF stream. More... | |
virtual uint32 | getNumIncrementalSaves (const IInputStreamPtr &pdfStream)=0 |
Find the number of incremental saves in the given PDF stream. More... | |
virtual IDocumentAssemblyPtr | openIncremental (const U8String &pathToFile, uint32 incrementalIndex)=0 |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents. More... | |
virtual IDocumentAssemblyPtr | openIncremental (const String &pathToFile, uint32 incrementalIndex)=0 |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents. More... | |
virtual IDocumentAssemblyPtr | openIncremental (const IInputStreamPtr &pdfStream, uint32 incrementalIndex)=0 |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents. More... | |
virtual CIRAInputStreamVect | getIncrementalSaves (const U8String &pathToFile)=0 |
Find the number of incremental saves in the given PDF stream, returning a vector of streams. More... | |
virtual CIRAInputStreamVect | getIncrementalSaves (const String &pathToFile)=0 |
Find the number of incremental saves in the given PDF stream, returning a vector of streams. More... | |
virtual CIRAInputStreamVect | getIncrementalSaves (const IInputStreamPtr &pdfStream)=0 |
Find the number of incremental saves in the given PDF stream, returning a vector of streams. More... | |
Public Member Functions inherited from JawsMako::IInput | |
virtual IDocumentAssemblyPtr | open (const U8String &pathToFile)=0 |
Open a file on disk, returning the IDocumentAssembly representing the contents. More... | |
virtual IDocumentAssemblyPtr | open (const String &pathToFile)=0 |
Open a file on disk, returning the IDocumentAssembly representing the contents. Takes a wide character string. More... | |
virtual IDocumentAssemblyPtr | open (const IInputStreamPtr &inputStream)=0 |
Open a stream, returning the IDocumentAssembly representing the contents. More... | |
virtual void | setSequentialMode (bool sequential)=0 |
Set/unset sequential mode on this input. More... | |
virtual void | setParameter (const U8String ¶m, const U8String &value)=0 |
Apply a key value pair output parameter with a string value. The parameter name is case insensitive. Please refer to the supplied documentation for the details of the available parameters and their ranges. More... | |
Public Member Functions inherited from IRCObject | |
virtual void | addRef () const =0 |
Increases the reference count of the actual object pointed to. This would take place during an assignment or copying. | |
virtual bool | decRef () const =0 |
Decreases the reference count of the actual object pointed to. When the reference count falls to Zero, it deletes the actual object pointed to. More... | |
virtual int32 | getRefCount () const =0 |
Retrieve the current reference count of the actual object pointed to. More... | |
Static Public Member Functions | |
static JAWSMAKO_API IPDFInputPtr | create (const IJawsMakoPtr &jawsMako, const IProgressMonitorPtr &progressMonitor=IProgressMonitorPtr()) |
Create an input for reading source documents in PDF format. More... | |
Static Public Member Functions inherited from JawsMako::IInput | |
static JAWSMAKO_API IInputPtr | create (const IJawsMakoPtr &jawsMako, eFileFormat format, const IProgressMonitorPtr &progressMonitor=IProgressMonitorPtr()) |
Create an input for reading source documents in the given format. The following formats are currently supported: More... | |
Additional Inherited Members | |
Protected Member Functions inherited from IRCObject | |
virtual | ~IRCObject () |
Virtual destructor. | |
An instance of the JawsMako PDF input class.
|
static |
Create an input for reading source documents in PDF format.
jawsMako | The IJawsMako object |
progressMonitor | A smart pointer to an IProgressMonitor object which can be NULL if no such object was passed in. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream, returning a vector of streams.
pdfStream | The input PDF stream. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream, returning a vector of streams.
pathToFile | The path to the input file. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream, returning a vector of streams.
pathToFile | The path to the input file. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream.
pdfStream | The input PDF stream. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream.
pathToFile | The path to the input file. |
|
pure virtual |
Find the number of incremental saves in the given PDF stream.
pathToFile | The path to the input file. |
|
pure virtual |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents.
pdfStream | The input PDF stream. |
incrementalUpdateIndex | The incremental update to load, with valid values being in the range 0 to getNumIncrementalSaves(). |
|
pure virtual |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents.
pathToFile | The path to the input file. |
incrementalUpdateIndex | The incremental update to load, with valid values being in the range 0 to getNumIncrementalSaves(). |
|
pure virtual |
Open an incremental PDF stream, returning the IDocumentAssembly representing the contents.
pathToFile | The path to the input file. |
incrementalUpdateIndex | The incremental update to load, with valid values being in the range 0 to getNumIncrementalSaves(). |
|
pure virtual |
Quickly scan the PDF file in the given stream for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also.
You can pass in an optional callback function to receive progress information. From this function, execution may be aborted by throwing an abort exception using throwEDLError(EDL_ERR_ABORTED) which will propagate back to the caller.
When the optional domFont parameter is set to true, scanPdfFonts() will generate a IDOMFont from any found PDF font object.
Note: Even if a font is embedded, a given PDF consumer may decide not to use it and instead use a substitute, for example if the font is invalid or broken.
|
pure virtual |
Quickly scan the PDF file at the given wide-character Unicode path for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also.
You can pass in an optional callback function to receive progress information. From this function, execution may be aborted by throwing an abort exception using throwEDLError(EDL_ERR_ABORTED) which will propagate back to the caller.
When the optional domFont parameter is set to true, scanPdfFonts() will generate a IDOMFont from any found PDF font object.
Note: Even if a font is embedded, a given PDF consumer may decide not to use it and instead use a substitute, for example if the font is invalid or broken.
|
pure virtual |
Quickly scan the PDF file at the given UTF-8 path for fonts. Does not attempt to validate the fonts, nor use them in any way. Instead, the PDF page tree is scanned and the PDF font objects interrogated. Annotations are scanned also.
You can pass in an optional callback function to receive progress information. From this function, execution may be aborted by throwing an abort exception using throwEDLError(EDL_ERR_ABORTED) which will propagate back to the caller.
When the optional domFont parameter is set to true, scanPdfFonts() will generate a IDOMFont from any found PDF font object.
Note: Even if a font is embedded, a given PDF consumer may decide not to use it and instead use a substitute, for example if the font is invalid or broken.
|
pure virtual |
Quickly scan the given PDF stream and find any mentions of inks in color spaces.
pdfStream | The input PDF stream to scan. |
progressMonitor | A smart pointer to an IProgressMonitor object which can be NULL if no such object was passed in. |
startPageIndex | Optional index of the first page to scan. Pages are numbered starting with page 0, which is the default value. |
endPageIndex | Optional index of the end page. This is the index after the last page, where the number of pages to scan is equal to (endPageIndex - startPageIndex). Setting this parameter to 0 indicates that the function should scan up to and including the final page. |
|
pure virtual |
Quickly scan the PDF file at the given wide character path and find any mentions of inks in color spaces.
pathToFile | The path to the input file to scan. |
progressMonitor | A smart pointer to an IProgressMonitor object which can be NULL if no such object was passed in. |
startPageIndex | Optional index of the first page to scan. Pages are numbered starting with page 0, which is the default value. |
endPageIndex | Optional index of the end page. This is the index after the last page, where the number of pages to scan is equal to (endPageIndex - startPageIndex). Setting this parameter to 0 indicates that the function should scan up to and including the final page. |
|
pure virtual |
Quickly scan the PDF file at the given UTF-8 path and find any mentions of inks in color spaces.
pathToFile | The path to the input file to scan. |
progressMonitor | A smart pointer to an IProgressMonitor object which can be NULL if no such object was passed in. |
startPageIndex | Optional index of the first page to scan. Pages are numbered starting with page 0, which is the default value. |
endPageIndex | Optional index of the end page. This is the index after the last page, where the number of pages to scan is equal to (endPageIndex - startPageIndex). Setting this parameter to 0 indicates that the function should scan up to and including the final page. |
|
pure virtual |
Override the default rendering intent in the PDF.
The default is RelativeColorimetric, as per the PDF specification.
|
pure virtual |
Set whether or not to fail when a font cannot be found and PDF input needs to use a fallback font or create and emulated font.
If false, font substitution and/or font emulation for missing fonts is allowed, which is sensible behaviour for general use cases. If a font is found to be invalid, a font may be sought on the users system or substituted.
If true, PDF input will fail and an exception thrown if a font requires the use of a fallback font or an emulated font, or if a damaged font is found and needs to be substituted.
The default is false.
|
pure virtual |
Set the password that should be used when attempting to open PDF files. For password encrypted PDF, this is the user or owner password. For PDF files encrypted with public key cryptography, this is the password to be used to extract the private key from the PKCS12/PFX container. The default is no password.
password | The password to use. Assumed to be UTF8. |
|
pure virtual |
Set the stream containing the PKCS12/PFX data containing the private key used to decrypt the PDF when public key encryption is used.
Note: Public Key Encryption is only supported on Linux and Windows (non-UWP) platforms at this time.
pkcs12 | A random access stream pointing to a pkcs12/pfx file for the user that is authorised as a recipient for this PDF. |