Save()

Presentation::Save(System::String, Export::SaveFormat) method

Saves all slides of a presentation to a file with the specified format.

void Aspose::Slides::Presentation::Save(System::String fname, Export::SaveFormat format) override

Arguments

Parameter	Type	Description
fname	System::String	Path to the created file.
format	Export::SaveFormat	Format of the exported data.

Presentation::Save(System::SharedPtr<System::IO::Stream>, Export::SaveFormat) method

Saves all slides of a presentation to a stream in the specified format.

void Aspose::Slides::Presentation::Save(System::SharedPtr<System::IO::Stream> stream, Export::SaveFormat format) override

Arguments

Parameter	Type	Description
stream	System::SharedPtr<System::IO::Stream>	Output stream.
format	Export::SaveFormat	Format of the exported data.

Presentation::Save(System::String, Export::SaveFormat, System::SharedPtr<Export::ISaveOptions>) method

Saves all slides of a presentation to a file with the specified format and with additional options.

void Aspose::Slides::Presentation::Save(System::String fname, Export::SaveFormat format, System::SharedPtr<Export::ISaveOptions> options) override

Arguments

Parameter	Type	Description
fname	System::String	Path to the created file.
format	Export::SaveFormat	Format of the exported data.
options	System::SharedPtr<Export::ISaveOptions>	Additional format options.

Remarks

The following example shows how to convert PowerPoint to HTML using C++.

// Instantiates a presentation object that represents a presentation file e.g. PPT, PPTX, ODP etc.
auto presentation = System::MakeObject<Presentation>(u"Convert_HTML.pptx");

System::SharedPtr<HtmlOptions> htmlOpt = System::MakeObject<HtmlOptions>();
System::SharedPtr<NotesCommentsLayoutingOptions> options = System::MakeObject<NotesCommentsLayoutingOptions>();
options->set_NotesPosition(NotesPositions::BottomFull);
htmlOpt->set_SlidesLayoutOptions(options);
htmlOpt->set_HtmlFormatter(HtmlFormatter::CreateDocumentFormatter(u"", false));

// Saves the presentation to HTML
presentation->Save(u"ConvertWholePresentationToHTML_out.html", SaveFormat::Html, htmlOpt);

The following example shows how to convert PowerPoint to responsive HTML using C++.

// Instantiates a Presentation object that represents a presentation file
auto presentation = System::MakeObject<Presentation>(u"Convert_HTML.pptx");

System::SharedPtr<ResponsiveHtmlController> controller = System::MakeObject<ResponsiveHtmlController>();
System::SharedPtr<HtmlOptions> htmlOptions = System::MakeObject<HtmlOptions>();
htmlOptions->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(controller));

// Saves the presentation to HTML
presentation->Save(u"ConvertPresentationToResponsiveHTML_out.html", SaveFormat::Html, htmlOptions);

The following example shows how to convert PowerPoint to HTML with notes using C++.

auto pres = System::MakeObject<Presentation>(u"Presentation.pptx");

auto opt = System::MakeObject<HtmlOptions>();
System::SharedPtr<NotesCommentsLayoutingOptions> options = System::MakeObject<NotesCommentsLayoutingOptions>();
options->set_NotesPosition(NotesPositions::BottomFull);
opt->set_SlidesLayoutOptions(options);

// Saves notes pages
pres->Save(u"Output.html", SaveFormat::Html, opt);

The following example shows how to convert PowerPoint to HTML with original fonts using C++.

auto pres = System::MakeObject<Presentation>(u"input.pptx");

// Excludes default presentation fonts
System::ArrayPtr<System::String> fontNameExcludeList = System::MakeArray<System::String>({u"Calibri", u"Arial"});
auto embedFontsController = System::MakeObject<EmbedAllFontsHtmlController>(fontNameExcludeList);
auto htmlOptionsEmbed = System::MakeObject<HtmlOptions>();
htmlOptionsEmbed->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(embedFontsController));
pres->Save(u"input-PFDinDisplayPro-Regular-installed.html", SaveFormat::Html, htmlOptionsEmbed);

The following example shows how to convert PowerPoint to HTML with high-quality images at 150 DPI using C++.

auto pres = System::MakeObject<Presentation>(u"InputDoc.pptx");

auto htmlOpts = System::MakeObject<HtmlOptions>();
htmlOpts->set_PicturesCompression(PicturesCompression::Dpi150);

pres->Save(u"OutputDoc-dpi150.html", SaveFormat::Html, htmlOpts);

The following example shows how to convert PowerPoint to HTML with full quality images using C++.

auto pres = System::MakeObject<Presentation>(u"InputDoc.pptx");

auto htmlOpts = System::MakeObject<HtmlOptions>();
htmlOpts->set_DeletePicturesCroppedAreas(false);

pres->Save(u"Outputdoc-noCrop.html", SaveFormat::Html, htmlOpts);

The following example shows how to convert Slide to HTML using C++.

The following example shows how to save CSS and Images when exporting To HTML using C++.

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

auto htmlController = System::MakeObject<CustomHeaderAndFontsController>(u"styles.css");
auto options = System::MakeObject<HtmlOptions>();
options->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(htmlController));
pres->Save(u"pres.html", SaveFormat::Html, options);

class CustomHeaderAndFontsController : public EmbedAllFontsHtmlController
{
public:
    CustomHeaderAndFontsController(System::String cssFileName);
    void WriteDocumentStart(System::SharedPtr<IHtmlGenerator> generator, System::SharedPtr<IPresentation> presentation) override;
    void WriteAllFonts(System::SharedPtr<IHtmlGenerator> generator, System::SharedPtr<IPresentation> presentation) override;

private:
    static const System::String ms_header;
    System::String m_cssFileName;
};

const System::String CustomHeaderAndFontsController::ms_header = System::String(u"<!DOCTYPE html>\n") +
                                                                 u"<html>\n" + u"<head>\n" +
                                                                 u"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\">\n" +
                                                                 u"<meta http-equiv=\"X-UA-Compatible\" content=\"IE=9\">\n" +
                                                                 u"<link rel=\"stylesheet\" type=\"text/css\" href=\"{0}\">\n" +
                                                                 u"</head>";

CustomHeaderAndFontsController::CustomHeaderAndFontsController(System::String cssFileName) : m_cssFileName(cssFileName)
{}

void CustomHeaderAndFontsController::WriteDocumentStart(System::SharedPtr<IHtmlGenerator> generator, System::SharedPtr<IPresentation> presentation)
{
    generator->AddHtml(System::String::Format(ms_header, m_cssFileName));
    WriteAllFonts(generator, presentation);
}

void CustomHeaderAndFontsController::WriteAllFonts(System::SharedPtr<IHtmlGenerator> generator, System::SharedPtr<IPresentation> presentation)
{
    generator->AddHtml(u"<!-- Embedded fonts -->");
    EmbedAllFontsHtmlController::WriteAllFonts(generator, presentation);
}

The following example shows how to link all fonts when converting Presentation to HTML using C++.

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

// Excludes default presentation fonts
System::ArrayPtr<System::String> fontNameExcludeList = System::MakeArray<System::String>({u"Calibri", u"Arial"});
auto linkcont = System::MakeObject<LinkAllFontsHtmlController>(fontNameExcludeList, u"C:\\Windows\\Fonts\\");
auto htmlOptionsEmbed = System::MakeObject<HtmlOptions>();
htmlOptionsEmbed->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(linkcont));
pres->Save(u"pres.html", SaveFormat::Html, htmlOptionsEmbed);

The following example shows how to LinkAllFontsHtmlController is implemented using C++.

class LinkAllFontsHtmlController : public EmbedAllFontsHtmlController
{
public:
    LinkAllFontsHtmlController(System::ArrayPtr<System::String> fontNameExcludeList, System::String basePath);
    void WriteFont(System::SharedPtr<IHtmlGenerator> generator,
                   System::SharedPtr<IFontData> originalFont,
                   System::SharedPtr<IFontData> substitutedFont,
                   System::String fontStyle,
                   System::String fontWeight,
                   System::ArrayPtr<uint8_t> fontData) override;

private:
    System::String m_basePath;
};

LinkAllFontsHtmlController::LinkAllFontsHtmlController(System::ArrayPtr<System::String> fontNameExcludeList, System::String basePath)
    : EmbedAllFontsHtmlController(fontNameExcludeList), m_basePath(basePath)
{}

void LinkAllFontsHtmlController::WriteFont(System::SharedPtr<IHtmlGenerator> generator,
                                           System::SharedPtr<IFontData> originalFont,
                                           System::SharedPtr<IFontData> substitutedFont,
                                           System::String fontStyle,
                                           System::String fontWeight,
                                           System::ArrayPtr<uint8_t> fontData)
{
    try
    {
        System::String fontName = substitutedFont == nullptr ? originalFont->get_FontName() : substitutedFont->get_FontName();
        System::String path = fontName + u".woff";

        // Some path sanitize may be needed
        System::IO::File::WriteAllBytes(System::IO::Path::Combine(m_basePath, path), fontData);
        generator->AddHtml(u"<style>");
        generator->AddHtml(u"@font-face { ");
        generator->AddHtml(System::String(u"font-family: '") + fontName + u"'; ");
        generator->AddHtml(System::String(u"src: url('") + path + u"')");
        generator->AddHtml(u" }");
        generator->AddHtml(u"</style>");
    }
    catch (System::Exception& ex)
    {
        System::Console::WriteLine(ex->get_Message());
    }
}

The following example shows how to convert PowerPoint to responsive HTML using C++.

auto presentation = System::MakeObject<Presentation>(u"SomePresentation.pptx");

auto saveOptions = System::MakeObject<HtmlOptions>();
saveOptions->set_SvgResponsiveLayout(true);
presentation->Save(u"SomePresentation-out.html", SaveFormat::Html, saveOptions);

The following example shows how to export Media files to HTML using C++.

// Loads a presentation
auto pres = System::MakeObject<Presentation>();

System::String path = u"C:/out/";
const System::String fileName = u"ExportMediaFiles_out.html";
const System::String baseUri = u"http://www.example.com/";
auto fileStream = System::MakeObject<System::IO::FileStream>(u"my_video.avi", System::IO::FileMode::Open, System::IO::FileAccess::Read);

auto video = pres->get_Videos()->AddVideo(fileStream, LoadingStreamBehavior::ReadStreamAndRelease);
auto slide = pres->get_Slides()->idx_get(0);
slide->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 100.0f, 100.0f, video);
auto controller = System::MakeObject<VideoPlayerHtmlController>(path, fileName, baseUri);

// Sets HTML options
System::SharedPtr<HtmlOptions> htmlOptions = System::MakeObject<HtmlOptions>(controller);
System::SharedPtr<SVGOptions> svgOptions = System::MakeObject<SVGOptions>(controller);
htmlOptions->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(controller));
htmlOptions->set_SlideImageFormat(SlideImageFormat::Svg(svgOptions));

// Saves the file
pres->Save(System::IO::Path::Combine(path, fileName), SaveFormat::Html, htmlOptions);

Presentation::Save(System::SharedPtr<System::IO::Stream>, Export::SaveFormat, System::SharedPtr<Export::ISaveOptions>) method

Saves all slides of a presentation to a stream in the specified format and with additional options.

void Aspose::Slides::Presentation::Save(System::SharedPtr<System::IO::Stream> stream, Export::SaveFormat format, System::SharedPtr<Export::ISaveOptions> options) override

Arguments

Parameter	Type	Description
stream	System::SharedPtr<System::IO::Stream>	Output stream.
format	Export::SaveFormat	Format of the exported data.
options	System::SharedPtr<Export::ISaveOptions>	Additional format options.

Presentation::Save(System::SharedPtr<Export::Xaml::IXamlOptions>) method

Saves all slides of a presentation to a set of files representing XAML markup.

void Aspose::Slides::Presentation::Save(System::SharedPtr<Export::Xaml::IXamlOptions> options) override

Arguments

Parameter	Type	Description
options	System::SharedPtr<Export::Xaml::IXamlOptions>	The XAML format options.

Remarks

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

SharedPtr<IXamlOptions> options = System::MakeObject<XamlOptions>();
options->set_ExportHiddenSlides(true);

pres->Save(options);

Presentation::Save(System::String, System::ArrayPtr<int32_t>, Export::SaveFormat) method

Saves specified slides of a presentation to a file with the specified format with page number keeping.

void Aspose::Slides::Presentation::Save(System::String fname, System::ArrayPtr<int32_t> slides, Export::SaveFormat format) override

Arguments

Parameter	Type	Description
fname	System::String	Path to the created file.
slides	System::ArrayPtr<int32_t>	Array with slide positions, starting from 1.
format	Export::SaveFormat	Format of the exported data.

Presentation::Save(System::String, System::ArrayPtr<int32_t>, Export::SaveFormat, System::SharedPtr<Export::ISaveOptions>) method

Saves specified slides of a presentation to a file with the specified format with page number keeping.

void Aspose::Slides::Presentation::Save(System::String fname, System::ArrayPtr<int32_t> slides, Export::SaveFormat format, System::SharedPtr<Export::ISaveOptions> options) override

Arguments

Parameter	Type	Description
fname	System::String	Path to the created file.
slides	System::ArrayPtr<int32_t>	Array with slide positions, starting from 1.
format	Export::SaveFormat	Format of the exported data.
options	System::SharedPtr<Export::ISaveOptions>	Additional format options.

Presentation::Save(System::SharedPtr<System::IO::Stream>, System::ArrayPtr<int32_t>, Export::SaveFormat) method

Saves specified slides of a presentation to a stream in the specified format with page number keeping.

void Aspose::Slides::Presentation::Save(System::SharedPtr<System::IO::Stream> stream, System::ArrayPtr<int32_t> slides, Export::SaveFormat format) override

Arguments

Parameter	Type	Description
stream	System::SharedPtr<System::IO::Stream>	Output stream.
slides	System::ArrayPtr<int32_t>	Array with slide positions, starting from 1.
format	Export::SaveFormat	Format of the exported data.

Presentation::Save(System::SharedPtr<System::IO::Stream>, System::ArrayPtr<int32_t>, Export::SaveFormat, System::SharedPtr<Export::ISaveOptions>) method

Saves specified slides of a presentation to a stream in the specified format with page number keeping.

void Aspose::Slides::Presentation::Save(System::SharedPtr<System::IO::Stream> stream, System::ArrayPtr<int32_t> slides, Export::SaveFormat format, System::SharedPtr<Export::ISaveOptions> options) override

Arguments

Parameter	Type	Description
stream	System::SharedPtr<System::IO::Stream>	Output stream.
slides	System::ArrayPtr<int32_t>	Array with slide positions, starting from 1.
format	Export::SaveFormat	Format of the exported data.
options	System::SharedPtr<Export::ISaveOptions>	Additional format options.

Remarks

The following example shows how to convert PowerPoint to PNG.

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

for (int32_t index = 0; index < pres->get_Slides()->get_Count(); index++)
{
    auto slide = pres->get_Slides()->idx_get(index);
    slide->GetThumbnail()->Save(System::String::Format(u"slide_{0}.png", index),
                                System::Drawing::Imaging::ImageFormat::get_Png());
}

The following example shows how to convert PowerPoint to PNG with custom dimensions.

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

float scaleX = 2.0f, scaleY = 2.0f;
for (int32_t index = 0; index < pres->get_Slides()->get_Count(); index++)
{
    auto slide = pres->get_Slides()->idx_get(index);
    slide->GetThumbnail(scaleX, scaleY)->Save(System::String::Format(u"slide_{0}.png", index),
                                              System::Drawing::Imaging::ImageFormat::get_Png());
}

The following example shows how to convert PowerPoint to PNG with custom size.

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

System::Drawing::Size size(960, 720);
for (int32_t index = 0; index < pres->get_Slides()->get_Count(); index++)
{
    auto slide = pres->get_Slides()->idx_get(index);
    slide->GetThumbnail(size)->Save(System::String::Format(u"slide_{0}.png", index),
                                    System::Drawing::Imaging::ImageFormat::get_Png());
}

See Also

• Enum SaveFormat
• Typedef SharedPtr
• Typedef ArrayPtr
• Class String
• Class Presentation
• Class Stream
• Class ISaveOptions
• Class IXamlOptions
• Namespace Aspose::Slides
• Library Aspose.Slides