Vytvoření miniatur tvarů prezentace v JavaScriptu

O čem je tato stránka

Vytvořte vysoce kvalitní miniatury tvarů z PowerPoint snímků pomocí JavaScriptu a Aspose.Slides pro Node.js – snadno vytvořte a exportujte miniatury prezentací.

Úvod

Aspose.Slides se používá k vytváření prezentačních souborů, kde je každá stránka snímkem. Tyto snímky lze zobrazit otevřením prezentačních souborů v aplikaci Microsoft PowerPoint. Ale někdy mohou vývojáři potřebovat zobrazit obrázky tvarů samostatně v prohlížeči obrázků. V takových případech vám Aspose.Slides pomáhá generovat miniatury obrázků tvarů na snímcích. Jak tuto funkci použít, je popsáno v tomto článku.
Tento článek vysvětluje, jak generovat miniatury snímků různými způsoby:

Generování miniatury tvaru uvnitř snímku.
Generování miniatury tvaru pro tvar snímku s uživatelem definovanými rozměry.
Generování miniatury tvaru v mezích vzhledu tvaru.

Generování miniatur tvarů ze snímků

Chcete‑li vygenerovat miniaturu tvaru z libovolného snímku pomocí Aspose.Slides pro Node.js přes Java, postupujte takto:

Vytvořte instanci třídy Prezentace.
Získejte odkaz na libovolný snímek pomocí jeho ID nebo indexu.
Získejte miniaturu tvaru odkazovaného snímku ve výchozím měřítku.
Uložte miniaturu do vámi preferovaného formátu obrázku.

Tento ukázkový kód vám ukazuje, jak vygenerovat miniaturu tvaru ze snímku:

// Instancujte třídu Presentation, která představuje soubor prezentace
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
    // Vytvořte obrázek v plném měřítku
    var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
    // Uložte obrázek na disk ve formátu PNG
    try {
        slideImage.save("output.png", aspose.slides.ImageFormat.Png);
    } finally {
        if (slideImage != null) {
            slideImage.dispose();
        }
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Generování miniatur tvarů s uživatelem definovaným měřítkovým faktorem

Chcete‑li vygenerovat miniaturu tvaru snímku pomocí Aspose.Slides pro Node.js přes Java, postupujte takto:

Vytvořte instanci třídy Prezentace.
Získejte odkaz na libovolný snímek pomocí jeho ID nebo indexu.
Získejte miniaturu tvaru odkazovaného snímku s uživatelem definovanými rozměry.
Uložte miniaturu do vámi preferovaného formátu obrázku.

Tento ukázkový kód vám ukazuje, jak vygenerovat miniaturu tvaru na základě definovaného měřítkového faktoru:

// Instancujte třídu Presentation, která představuje soubor prezentace
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
    // Vytvořte obrázek v plném měřítku
    var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(aspose.slides.ShapeThumbnailBounds.Shape, 1, 1);
    // Uložte obrázek na disk ve formátu PNG
    try {
        slideImage.save("output.png", aspose.slides.ImageFormat.Png);
    } finally {
        if (slideImage != null) {
            slideImage.dispose();
        }
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Generování miniatury tvaru v mezích

Tato metoda vytváření miniatur tvarů umožňuje vývojářům generovat miniaturu v mezích vzhledu tvaru. Bere v úvahu všechny efekty tvaru. Vygenerovaná miniatura tvaru je omezena mezemi snímku. Chcete‑li vygenerovat miniaturu tvaru snímku v mezích jeho vzhledu, postupujte takto:

Vytvořte instanci třídy Prezentace.
Získejte odkaz na libovolný snímek pomocí jeho ID nebo indexu.
Získejte miniaturu odkazovaného snímku s mezemi tvaru jako vzhledem.
Uložte miniaturu do vámi preferovaného formátu obrázku.

Tento ukázkový kód je založen na výše uvedených krocích:

// Instancujte třídu Presentation, která představuje soubor prezentace
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
    // Vytvořte obrázek v plném měřítku
    var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(aspose.slides.ShapeThumbnailBounds.Appearance, 1, 1);
    // Uložte obrázek na disk ve formátu PNG
    try {
        slideImage.save("output.png", aspose.slides.ImageFormat.Png);
    } finally {
        if (slideImage != null) {
            slideImage.dispose();
        }
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Získání skutečných vizuálních mezí tvaru

Vlastnosti rámce Tvaru — jeho metody getX(), getY(), getWidth() a getHeight() — popisují obdélník uložený v modelu prezentace. Obsah, který je skutečně vykreslen, může přesahovat tento rámec nebo zabírat jiný osově zarovnaný obdélník. Rotace, obrysy, šipky, rozvržení a přetékaný text, generovaná geometrie SmartArt a další efekty vykreslování mohou změnit zabranou oblast.
Použijte Shape.getVisualBounds k výpočtu této zabrané oblasti bez vytváření obrázku. Metoda vrací objekt Rectangle2D.Float ve souřadnicích snímku. Vrácený obdélník není oříznut na snímek, takže jeho souřadnice mohou být záporné, pokud obsah přesahuje počátek snímku.

Následující příklad získává a porovnává rám a vizuální meze:

const presentation = new aspose.slides.Presentation("example.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const shape = slide.getShapes().get_Item(0);

    const visualBounds = shape.getVisualBounds();

    const frameBounds = {
        x: shape.getX(),
        y: shape.getY(),
        width: shape.getWidth(),
        height: shape.getHeight()
    };
    const visualBoundsValues = {
        x: visualBounds.getX(),
        y: visualBounds.getY(),
        width: visualBounds.getWidth(),
        height: visualBounds.getHeight()
    };

    console.log(
        `Frame bounds (x, y, width, height): ${frameBounds.x}, ${frameBounds.y}, ${frameBounds.width}, ${frameBounds.height}`
    );
    console.log(
        `Visual bounds (x, y, width, height): ${visualBoundsValues.x}, ${visualBoundsValues.y}, ${visualBoundsValues.width}, ${visualBoundsValues.height}`
    );
} finally {
    presentation.dispose();
}

Stejný obdélník lze použít k zarovnání blízkých tvarů na jeho levý, pravý, horní nebo spodní okraj; vyhradit dostatek místa ve vytvořeném rozvržení; nebo detekovat obsah mimo povolenou oblast. Vizuální meze jsou zvláště užitečné pro SmartArt, textová pole, šipky, obrázky, otočené tvary a skupinové tvary, kde uložený rámec nemusí představovat celý vykreslený výsledek.
Při potřebě souřadnic pro rozvržení nebo validaci a bez potřeby bitmapy použijte Shape.getVisualBounds. Když potřebujete tvar vykreslit, použijte Shape.getImage. S ShapeThumbnailBounds, ShapeThumbnailBounds.Shape určuje velikost obrázku podle mezí tvaru, včetně nastavení obrysu, zatímco ShapeThumbnailBounds.Appearance určuje velikost podle vzhledu tvaru a omezuje výsledek na meze snímku. Naopak Shape.getVisualBounds vrací pouze vypočítaný obdélník a neorezuje jej na snímek.

FAQ

Jaké formáty obrázků lze použít při ukládání miniatur tvarů?
PNG, JPEG, BMP, GIF, TIFF, a další. Tvary lze také exportovat jako vektorové SVG uložení obsahu tvaru jako SVG.

Jaký je rozdíl mezi mezemi Shape a Appearance při vykreslování miniatury?
Shape používá geometrii tvaru; Appearance bere v úvahu vizuální efekty (stíny, záře apod.).

Co se stane, pokud je tvar označen jako skrytý? Bude se stále vykreslovat jako miniatura?
Skrytý tvar zůstává součástí modelu a může být vykreslen; příznak skrytí ovlivňuje zobrazení v prezentaci, ale nebrání v generování obrázku tvaru.

Jsou podporovány skupinové tvary, grafy, SmartArt a další složité objekty?
Ano. Jakýkoli objekt reprezentovaný jako Shape (včetně GroupShape, Chart, a SmartArt) lze uložit jako miniaturu nebo jako SVG.

Ovlivňují systémově nainstalované fonty kvalitu miniatur textových tvarů?
Ano. Měli byste poskytnout požadované fonty (nebo nastavit substituce fontů), aby nedošlo k nechtěným náhradám a přetečení textu.

Použití animací tvarů v prezentacích pomocí JavaScriptu Správa ActiveX ovládacích prvků v prezentacích pomocí JavaScriptu