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());
}

Presentation::Save(System::String, Export::SaveFormat, System::SharedPtr<System::Web::HttpResponse>, bool) method

Sends the presentation to the client browser. This method is absent in ClientProfile versions of Aspose.Slide.

void Aspose::Slides::Presentation::Save(System::String fname, Export::SaveFormat format, System::SharedPtr<System::Web::HttpResponse> response, bool showInline) override

Arguments

Parameter	Type	Description
fname	System::String	The name for the presentation that will appear at the client browser. The name should not contain path.
format	Export::SaveFormat	Format of the exported data.
response	System::SharedPtr<System::Web::HttpResponse>	Response object where to save the document.
showInline	bool	True to show an option to open the presentation inside the browser.

Deprecated

The method will be removed after release of version 24.7.

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

Sends the presentation to the client browser. This method is absent in ClientProfile versions of Aspose.Slide.

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

Arguments

Parameter	Type	Description
fname	System::String	The name for the presentation that will appear at the client browser. The name should not contain path.
format	Export::SaveFormat	Format of the exported data.
options	System::SharedPtr<Export::ISaveOptions>	Additional format options.
response	System::SharedPtr<System::Web::HttpResponse>	Response object where to save the document.
showInline	bool	True to show an option to open the presentation inside the browser.

Deprecated

The method will be removed after release of version 24.7.

See Also

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