Cómo cargar presentaciones en C++

Aspose.Slides FOSS for C++ le permite abrir cualquier archivo .pptx, inspeccionar su contenido y guardarlo de nuevo en PPTX o extraer datos de él. Esta guía cubre la apertura de un archivo, la iteración de diapositivas, la lectura del texto de formas y el proceso de guardado de ida y vuelta.

Guía paso a paso

Paso 1: Compilar y enlazar la biblioteca

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 .

Paso 2: Abrir una presentación existente

Pase la ruta del archivo al constructor Presentation. El destructor se encarga de la limpieza.

#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;
}

Las partes XML desconocidas en el archivo fuente se conservan literalmente: la biblioteca nunca elimina contenido que aún no comprende.

Paso 3: Inspeccionar diapositivas

Iterar sobre todas las diapositivas e imprimir el recuento de sus formas:

#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;
}

Paso 4: Leer texto de forma

Iterar sobre las formas y leer el texto de las formas que tengan un 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;
}

Paso 5: Leer propiedades del documento

Acceder a las propiedades principales del documento desde 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;
}

Paso 6: Guardado de ida y vuelta

Después de inspeccionar o modificar la presentación, guárdala de nuevo en PPTX:

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

Guardar en una ruta diferente crea un nuevo archivo. Guardar en la misma ruta sobrescribe el original.

Problemas comunes y soluciones

Archivo no encontrado o no se puede abrir

Verifique que la ruta al archivo .pptx sea correcta en relación con el directorio de trabajo. Use std::filesystem::path para una construcción de ruta robusta:

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

Excepción: formato de archivo no compatible

La biblioteca admite .pptx (Office Open XML) únicamente. Los archivos heredados .ppt (PowerPoint binario 97-2003) no son compatibles.

Shape no tiene text_frame

Algunas formas (Connectors, PictureFrames, GroupShapes) no tienen un marco de texto. Proteja con shape.has_text_frame() antes de acceder al texto.

Preguntas frecuentes

¿La carga conserva todo el contenido original?

Sí. Las partes XML desconocidas se conservan literalmente al guardar en una ronda completa. La biblioteca solo serializa las partes del modelo de documento que entiende y pasa cualquier XML que no reconoce.

¿Puedo cargar un PPTX protegido con contraseña?

Las presentaciones protegidas con contraseña (cifradas) no son compatibles en esta edición.

¿Puedo extraer imágenes incrustadas?

Acceda a la colección de imágenes: prs.images() devuelve el ImageCollection. Cada imagen tiene los métodos width(), height() y binary_data() para leer los datos de imagen sin procesar.

¿Se admite la carga desde un búfer en memoria?

Cargar desde un std::vector<uint8_t> o std::istream no está expuesto en la API actual. Escriba los bytes en un archivo temporal primero, luego pase la ruta al constructor Presentation.