Class PdfConverterOptions

Namespace

Slidize

Assembly

Slidize.Plugins.dll

Provides options that control how a presentation is converted to PDF format.

public sealed class PdfConverterOptions : ConverterOptions

Inheritance

object

ConverterOptions

PdfConverterOptions

Inherited Members

ConverterOptions.SlidesViewOptions

ConverterOptions.DefaultRegularFont

object.GetType()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Examples

The following example shows how to convert PowerPoint document to PDF/A-1b format in Notes/Comments view with embedded fonts and OLE data.

[C#]
PdfConverterOptions options = new()
{
    ComplianceLevel = PdfComplianceLevel.PdfA1b,
    EmbedFullFonts = true,
    IncludeOleData = true,
    SlidesViewOptions = new NotesCommentsViewOptions
    {
        NotesPosition = NotesPositions.BottomTruncated,
        CommentsPosition = CommentsPositions.Right
    }
};
PresentationToPdfConverter.Process("pres.pptx", "pres.pdf", options);

Constructors

PdfConverterOptions()

Initializes a new instance of the PdfConverterOptions class.

public PdfConverterOptions()

Properties

BestImagesCompressionRatio

Indicates if the most effective compression (instead of the default one) for each image must be selected automatically. If set to bool.true, for every image in presentation the most appropriate compression algorithm will be chosen, what will lead to the smaller size of the resulting PDF document. Best image compression ratio selection is computationally expensive and takes an additional amount of RAM, and this option is bool.false by default.

public bool BestImagesCompressionRatio { get; set; }

Property Value

bool

Remarks

Default value is false.

ComplianceLevel

Desired conformance level for generated PDF document. Read/write PdfComplianceLevel.

public PdfComplianceLevel ComplianceLevel { get; set; }

Property Value

PdfComplianceLevel

Remarks

Default value is Pdf17.

EmbedFullFonts

Determines if all characters of font should be embedded or only used subset. Read/write bool.

public bool EmbedFullFonts { get; set; }

Property Value

bool

Remarks

Default value is false.

EmbedTrueTypeFontsForASCII

Determines if Aspose.Slides will embed common fonts for ASCII (33..127 code range) text. Fonts for character codes greater than 127 are always embedded. Common fonts list includes PDF's base 14 fonts and additional user specified fonts. Read/write bool.

public bool EmbedTrueTypeFontsForASCII { get; set; }

Property Value

bool

Remarks

Default value is true.

IncludeOleData

True to convert all OLE data from the presentation to embedded files in the resulting PDF. Read/write bool.

public bool IncludeOleData { get; set; }

Property Value

bool

Remarks

Default is false.

JpegQuality

Returns or sets a value determining the quality of the JPEG images inside PDF document. Read/write byte.

public byte JpegQuality { get; set; }

Property Value

byte

Remarks

Has effect only when a document contains JPEG images.

Use this property to get or set the quality of the images inside a document when saving in PDF format. The value may vary from 0 to 100 where 0 means worst quality but maximum compression and 100 means best quality but minimum compression.

The default value is 100.

Password

Setting user password to protect the PDF document. Read/write string.

public string Password { get; set; }

Property Value

string

RasterizeUnsupportedFontStyles

Indicates whether text should be rasterized as a bitmap and saved to PDF when the font does not support bold styling. This approach can enhance the quality of text in the resulting PDF for certain fonts. Read/write bool.

public bool RasterizeUnsupportedFontStyles { get; set; }

Property Value

bool

Remarks

Default value is false.

SaveMetafilesAsPng

True to convert all metafiles used in a presentation to the PNG images. Read/write bool.

public bool SaveMetafilesAsPng { get; set; }

Property Value

bool

Remarks

Default is true. Pdf document can contain vector graphics and raster images. If SaveMetafilesAsPng is set to true then source Metafile image is converted to Png format and saved to Pdf as a raster image. If SaveMetafilesAsPng is set to false then source Metafile is converted to Pdf vector graphics. Each approach has advantages and disadvantages. For example, if Metafile is converted to PNG, then some quality loss is possible during resulting document scaling. If Metafile is converted to Pdf vector graphics, then performance issues in Pdf viewing tool are possible.

ShowHiddenSlides

Specifies whether the generated document should include hidden slides or not. Default value is false.

public bool ShowHiddenSlides { get; set; }

Property Value

bool

SufficientResolution

Returns or sets a value determining resolution of images inside PDF document.

Property affects on file size, time of export and image quality.

The default value is 96.

Effect of this parameter depends on few factors. Algorithm tries to get best output image size according to the property value, source image size and image frame size. Using of similar property values may give the same result. Recommended to use step 16 or 32 to get visible effect. Read/write float.

public float SufficientResolution { get; set; }

Property Value

float

UseFlatTextCompression

Specifies compression type to be used for all textual content in the document. Default value is true.

public bool UseFlatTextCompression { get; set; }

Property Value

bool