Aspose::Pdf::PdfFormatConversionOptions class
PdfFormatConversionOptions class
represents set of options for convert PDF document
class PdfFormatConversionOptions : public System::Object
Enums
| Enum | Description |
|---|---|
| PuaProcessingStrategy | Some PDF documents have special unicode symbols, which are belonged to Private Use Area (PUA), see description at https://en.wikipedia.org/wiki/Private_Use_Areas. This symbols cause an PDF/A compliant errors like “Text is mapped to Unicode Private Use Area but no ActualText entry is present”. This enumeration declares a strategies which can be used to handle PUA symbols. |
| RemoveFontsStrategy | Some documens have large size after converison into PDF/A format. To reduce file size for these documents it’s necessary to define a strategy of fonts removing. This enumeration declares a strategies which can be used to optimize fonts usage. Every strategy from this enumeration has sense only when flag OptimizeFileSize is set. |
| SegmentAlignStrategy | Describes strategies used to align document text segments. Now only strategy to restore segments to original bounds is supported. In future another strategies could be added. |
Methods
| Method | Description |
|---|---|
| get_AlignText() const | This flag controls text alignment in converted document. By default document conversion doesn’t affect text alignment and leave text as is. But in some cases font substitution causes text overlapping or extra spaces in converted document. When this flag is set special alignment operations will be performed. This flag should be set only for documents which have problems with overlapped text or extra text spaces cause using of this flag decrease performance and in some cases could corrupt text content. |
| get_ConvertSoftMaskAction() const | Action for images with soft mask. |
| static get_Default() | Gets PdfFormatConversionOptions object with default parameters. |
| get_ErrorAction() const | Action for objects that can not be converted. |
| get_ExcludeFontsStrategy() const | Strategy(ies) to exclude superfluous fonts and reduce document file size. This parameter has sense only when flag OptimizeFileSize is set to true. By default combination of strategies SubsetFonts and RemoveDuplicatedFonts is used. |
| get_FontEmbeddingOptions() const | Options for cases when it’s not possible to embed some fonts into PDF document. |
| get_Format() const | PDF format. |
| get_IccProfileFileName() const | Gets the filename of icc profile name. In case of null the default icc profile used. |
| get_IsAsyncImageStreamsConversionMode() const | Gets/sets run of image streams in async mode. |
| get_IsLowMemoryMode() const | Is low memory conversion mode enabled. |
| get_IsTransferInfo() const | Gets whether to pass data from Info to Metadata when converted to PDF 2.0. True by default. |
| get_LogFileName() const | Path to file where comments will be stored. |
| get_LogStream() const | Stream where comments will be stored. |
| get_NonSpecificationCases() const | Holds flags to control PDF/A conversion process for cases when source document doesn’t correspond to PDF/A specification. |
| get_NotAccessibleFonts() | This property is out-property. It holds all the fonts(font names) which were not found on computer at last PDF/A conversion. |
| get_OptimizeFileSize() const | Gets a flag which enables/disables special conversion mode to get PDF/A document with reduced file size. Now this flag impacts on optimization of fonts used in PDF document, possibly, in future, this flag also will be used to switch on optimization for another data structures, such as graphic. |
Set of this flag and mode could significantly reduce file size but at the same time it could significantly decrease performance of conversion. | | get_PuaTextProcessingStrategy() const | Strategy to process symbols from unicode Private Use Area (PUA). | | get_SymbolicFontEncodingStrategy() const | Strategy to copy encoding data for symbolic fonts if symbolic TrueType font has more than one encoding subtable. | | get_TransparencyAction() const | Action for image masked objects. | | get_UnicodeProcessingRules() const | Rules to solve problems with unicode mapping. Can be null. | | PdfFormatConversionOptions(System::String, PdfFormat, ConvertErrorAction) | Constructor. | | PdfFormatConversionOptions(System::String, PdfFormat) | Constructor. | | PdfFormatConversionOptions(PdfFormat) | Constructor. | | PdfFormatConversionOptions(PdfFormat, ConvertErrorAction) | Constructor. | | PdfFormatConversionOptions(System::String, PdfFormat, ConvertErrorAction, ConvertTransparencyAction) | Constructor. | | PdfFormatConversionOptions(System::SharedPtr<System::IO::Stream>, PdfFormat, ConvertErrorAction) | Constructor. | | set_AlignText(bool) | This flag controls text alignment in converted document. By default document conversion doesn’t affect text alignment and leave text as is. But in some cases font substitution causes text overlapping or extra spaces in converted document. When this flag is set special alignment operations will be performed. This flag should be set only for documents which have problems with overlapped text or extra text spaces cause using of this flag decrease performance and in some cases could corrupt text content. | | set_ConvertSoftMaskAction(Aspose::Pdf::ConvertSoftMaskAction) | Action for images with soft mask. | | set_ErrorAction(ConvertErrorAction) | Action for objects that can not be converted. | | set_ExcludeFontsStrategy(PdfFormatConversionOptions::RemoveFontsStrategy) | Strategy(ies) to exclude superfluous fonts and reduce document file size. This parameter has sense only when flag OptimizeFileSize is set to true. By default combination of strategies SubsetFonts and RemoveDuplicatedFonts is used. | | set_Format(PdfFormat) | PDF format. | | set_IccProfileFileName(System::String) | Sets the filename of icc profile name. In case of null the default icc profile used. | | set_IsAsyncImageStreamsConversionMode(bool) | Gets/sets run of image streams in async mode. | | set_IsLowMemoryMode(bool) | Is low memory conversion mode enabled. | | set_IsTransferInfo(bool) | Sets whether to pass data from Info to Metadata when converted to PDF 2.0. True by default. | | set_LogFileName(System::String) | Path to file where comments will be stored. | | set_LogStream(System::SharedPtr<System::IO::Stream>) | Stream where comments will be stored. | | set_OptimizeFileSize(bool) | Sets a flag which enables/disables special conversion mode to get PDF/A document with reduced file size. Now this flag impacts on optimization of fonts used in PDF document, possibly, in future, this flag also will be used to switch on optimization for another data structures, such as graphic.
Set of this flag and mode could significantly reduce file size but at the same time it could significantly decrease performance of conversion. | | set_PuaTextProcessingStrategy(PdfFormatConversionOptions::PuaProcessingStrategy) | Strategy to process symbols from unicode Private Use Area (PUA). | | set_SymbolicFontEncodingStrategy(System::SharedPtr<PdfASymbolicFontEncodingStrategy>) | Strategy to copy encoding data for symbolic fonts if symbolic TrueType font has more than one encoding subtable. | | set_TransparencyAction(ConvertTransparencyAction) | Action for image masked objects. | | set_UnicodeProcessingRules(System::SharedPtr<PdfAOptionClasses::ToUnicodeProcessingRules>) | Rules to solve problems with unicode mapping. Can be null. |
See Also
- Class Object
- Namespace Aspose::Pdf
- Library Aspose.PDF for C++