Aspose::Words::Saving::ImagePixelFormat enum

ImagePixelFormat enum

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

enum class ImagePixelFormat

Values

NameValueDescription
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.

Examples

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

auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

builder->get_ParagraphFormat()->set_Style(doc->get_Styles()->idx_get(u"Heading 1"));
builder->Writeln(u"Hello world!");
builder->InsertImage(ImageDir + u"Logo.jpg");

ASSERT_LT(20000, MakeObject<System::IO::FileInfo>(ImageDir + u"Logo.jpg")->get_Length());

// 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.
auto imageSaveOptions = MakeObject<ImageSaveOptions>(SaveFormat::Png);
imageSaveOptions->set_PixelFormat(imagePixelFormat);

// We can clone ImageSaveOptions instances.
ASPOSE_ASSERT_NE(imageSaveOptions, imageSaveOptions->Clone());

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

See Also