[]
        
(Showing Draft Content)

GrapeCity.Documents.Pdf.ImageOptions.ImageFormat

ImageOptions.ImageFormat Enum

Defines formats that can be used to encode images in a PDF.

Namespace: GrapeCity.Documents.Pdf
Assembly: DS.Documents.Pdf.dll
Syntax
public enum ImageOptions.ImageFormat
Public Enum ImageOptions.ImageFormat

Fields

Name Description
Auto

Select the optimal format automatically based on the particular image and document options (recommended).

The following rules are used:

  • If the image is a JPEG or a JPEG2000, the image data is written as is without any additional processing.
  • If the image contains transparency, Raw is used.
  • If CompressionLevel is NoCompression, Jpeg is used.
  • Otherwise the format is selected that provides the minimal data size for the image.
Jpeg

Use JPEG to encode images.

Note that when using this format, any transparency that may be present in an original image will be lost, as JPEG does not support transparency.

Raw

Do not encode image data.

When using this format, the CompressionLevel affects the final PDF size, and in combination with Optimal it may produce better compression than JPEG for certain types of images (e.g. screenshots of mostly text screens).