ImagePixelFormat enumeration

Specifies the pixel format for the generated images of document pages.

public enum ImagePixelFormat


Format16BppRgb555016 bits per pixel, RGB.
Format16BppRgb565116 bits per pixel, RGB.
Format16BppArgb1555216 bits per pixel, ARGB.
Format24BppRgb324 bits per pixel, RGB.
Format32BppRgb432 bits per pixel, RGB.
Format32BppArgb532 bits per pixel, ARGB.
Format32BppPArgb632 bits per pixel, ARGB, premultiplied alpha.
Format48BppRgb748 bits per pixel, RGB.
Format64BppArgb864 bits per pixel, ARGB.
Format64BppPArgb964 bits per pixel, ARGB, premultiplied alpha.
Format1bppIndexed101 bit per pixel, Indexed.


Shows how to select a bit-per-pixel rate with which to render a document to an image.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ParagraphFormat.Style = doc.Styles["Heading 1"];
builder.Writeln("Hello world!");
builder.InsertImage(ImageDir + "Logo.jpg");

// When we save the document as an image, we can pass a SaveOptions object to
// select a pixel format for the image that the saving operation will generate.
// Various bit per pixel rates will affect the quality and file size of the generated image.
ImageSaveOptions imageSaveOptions = new ImageSaveOptions(SaveFormat.Png);
imageSaveOptions.PixelFormat = imagePixelFormat;

// We can clone ImageSaveOptions instances.
Assert.AreNotEqual(imageSaveOptions, imageSaveOptions.Clone());

doc.Save(ArtifactsDir + "ImageSaveOptions.PixelFormat.png", imageSaveOptions);

See Also