Jak načíst prezentace v C++

Aspose.Slides FOSS for C++ vám umožňuje otevřít libovolný soubor .pptx, prozkoumat jeho obsah a buď jej uložit zpět do PPTX, nebo z něj extrahovat data. Tento průvodce pokrývá otevření souboru, procházení snímků, čtení textu tvarů a zpětné uložení.

Průvodce krok za krokem

Krok 1: Sestavit a propojit knihovnu

git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .

Krok 2: Otevřít existující prezentaci

Předávejte cestu k souboru do konstruktoru Presentation. Destruktor provádí úklid.

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("input.pptx");
    std::cout << "Slide count: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

Neznámé části XML ve zdrojovém souboru jsou zachovány doslovně: knihovna nikdy neodstraňuje obsah, který ještě nerozumí.

Krok 3: Prohlédněte snímky

Iterujte přes všechny snímky a vytiskněte počet jejich tvarů:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        std::cout << "Slide " << i << ": "
                  << slide.shapes().size() << " shapes\n";
    }
    return 0;
}

Krok 4: Přečíst text tvaru

Iterujte přes tvary a načtěte text z tvarů, které mají TextFrame:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        for (size_t j = 0; j < slide.shapes().size(); ++j) {
            auto& shape = slide.shapes()[j];
            if (shape.has_text_frame()) {
                auto text = shape.text_frame()->text();
                if (!text.empty()) {
                    std::cout << "  Shape text: " << text << "\n";
                }
            }
        }
    }
    return 0;
}

Krok 5: Načíst vlastnosti dokumentu

Přístup k základním vlastnostem dokumentu z prs.document_properties():

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    auto& props = prs.document_properties();
    std::cout << "Title:   " << props.title() << "\n";
    std::cout << "Author:  " << props.author() << "\n";
    std::cout << "Subject: " << props.subject() << "\n";
    return 0;
}

Krok 6: Uložení v obou směrech

Po prohlédnutí nebo úpravě prezentace ji uložte zpět do PPTX:

prs.save("output.pptx", asf::SaveFormat::PPTX);

Ukládání do jiné cesty vytvoří nový soubor. Ukládání do stejné cesty přepíše původní.

Časté problémy a opravy

Soubor nebyl nalezen nebo jej nelze otevřít

Zkontrolujte, že cesta k souboru .pptx je správná vzhledem k pracovnímu adresáři. Použijte std::filesystem::path pro robustní konstrukci cesty:

#include <filesystem>
auto path = std::filesystem::path(__FILE__).parent_path() / "assets" / "deck.pptx";
asf::Presentation prs(path.string());

Výjimka: Formát souboru není podporován

Knihovna podporuje pouze .pptx (Office Open XML). Starší soubory .ppt (binární PowerPoint 97‑2003) nejsou podporovány.

Shape nemá text_frame

Některé tvary (Connectors, PictureFrames, GroupShapes) nemají textový rámeček. Před přístupem k textu použijte ochranu shape.has_text_frame().

Často kladené otázky

Zachovává načítání veškerý původní obsah?

Ano. Neznámé části XML jsou při ukládání v režimu round‑trip zachovány doslovně. Knihovna serializuje pouze části modelu dokumentu, které rozumí, a předává jakékoli XML, které nepozná.

Mohu načíst PPTX chráněný heslem?

Prezentace chráněné heslem (šifrované) nejsou v této edici podporovány.

Mohu extrahovat vložené obrázky?

Přístup ke kolekci obrázků: prs.images() vrací ImageCollection. Každý obrázek má metodu width(), height() a binary_data() pro čtení surových dat obrázku.

Je načítání z paměťového bufferu podporováno?

Načítání z std::vector<uint8_t> nebo std::istream není v současném API zpřístupněno. Nejprve zapište bajty do dočasného souboru a poté předávejte cestu do konstruktoru Presentation.