Miniaturen van presentatiesvormen maken in JavaScript
Inleiding
Aspose.Slides wordt gebruikt om presentatiedocumenten te maken waarbij elke pagina een dia is. Deze dia’s kunnen worden bekeken door de presentatiebestanden te openen met Microsoft PowerPoint. Soms moeten ontwikkelaars echter de afbeeldingen van de vormen apart bekijken in een afbeeldingsviewer. In zulke gevallen helpt Aspose.Slides u bij het genereren van miniatuurafbeeldingen van de dia‑vormen. Hoe u deze functie gebruikt, wordt in dit artikel beschreven.
Dit artikel legt uit hoe u dia‑miniaturen op verschillende manieren kunt genereren:
- Een vormminiatuur binnen een dia genereren.
- Een vormminiatuur voor een dia‑vorm met gebruikersgedefinieerde afmetingen genereren.
- Een vormminiatuur binnen de grenzen van de weergave van een vorm genereren.
Vormminiaturen genereren vanuit dia’s
Om een vormminiatuur van een willekeurige dia te genereren met Aspose.Slides voor Node.js via Java, doet u het volgende:
- Maak een instantie van de Presentatie‑klasse aan.
- Verkrijg de referentie van een willekeurige dia met behulp van de ID of index.
- Haal de vormminiatuurafbeelding op van de referentie‑dia op met de standaard schaal.
- Sla de miniatuurafbeelding op in het door u gewenste afbeeldingsformaat.
// Instantieer een Presentation-klasse die het presentatie-bestand vertegenwoordigt
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
// Maak een afbeelding op volledige schaal
var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
// Sla de afbeelding op schijf op in PNG-formaat
try {
slideImage.save("output.png", aspose.slides.ImageFormat.Png);
} finally {
if (slideImage != null) {
slideImage.dispose();
}
}
} finally {
if (pres != null) {
pres.dispose();
}
}
Vormminiaturen genereren met door de gebruiker gedefinieerde schaalfactor
Om de vormminiatuur van een dia te genereren met Aspose.Slides voor Node.js via Java, doet u het volgende:
- Maak een instantie van de Presentatie‑klasse aan.
- Verkrijg de referentie van een willekeurige dia met behulp van de ID of index.
- Haal de vormminiatuurafbeelding op van de referentie‑dia met door de gebruiker gedefinieerde afmetingen.
- Sla de miniatuurafbeelding op in het door u gewenste afbeeldingsformaat.
// Instantieer een Presentation-klasse die het presentatiebestand vertegenwoordigt
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
// Maak een afbeelding op volledige schaal
var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(aspose.slides.ShapeThumbnailBounds.Shape, 1, 1);
// Sla de afbeelding op schijf in PNG-formaat
try {
slideImage.save("output.png", aspose.slides.ImageFormat.Png);
} finally {
if (slideImage != null) {
slideImage.dispose();
}
}
} finally {
if (pres != null) {
pres.dispose();
}
}
Vormminiatuur genereren binnen de grenzen
Deze methode om miniaturen van vormen te maken stelt ontwikkelaars in staat om een miniatuur te genereren binnen de grenzen van de weergave van een vorm. Hierbij worden alle vorm‑effecten meegewogen. De gegenereerde vormminiatuur wordt beperkt door de dia‑grenzen. Om een miniatuur van een dia‑vorm binnen de grenzen van zijn weergave te genereren, doet u het volgende:
- Maak een instantie van de Presentatie‑klasse aan.
- Verkrijg de referentie van een willekeurige dia met behulp van de ID of index.
- Haal de miniatuurafbeelding van de referentie‑dia op met de vormgrenzen als weergave.
- Sla de miniatuurafbeelding op in het door u gewenste afbeeldingsformaat.
// Instantieer een Presentation-klasse die het presentatiebestand vertegenwoordigt
var pres = new aspose.slides.Presentation("Thumbnail.pptx");
try {
// Maak een afbeelding op volledige schaal
var slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(aspose.slides.ShapeThumbnailBounds.Appearance, 1, 1);
// Sla de afbeelding op schijf in PNG-formaat
try {
slideImage.save("output.png", aspose.slides.ImageFormat.Png);
} finally {
if (slideImage != null) {
slideImage.dispose();
}
}
} finally {
if (pres != null) {
pres.dispose();
}
}
De werkelijke visuele grenzen van een vorm ophalen
De frame‑eigenschappen van een Vorm—de getX(), getY(), getWidth() en getHeight()‑methoden—gebruiken het rechthoekige gebied dat in het presentatiemodel is opgeslagen. De inhoud die daadwerkelijk wordt gerenderd kan buiten dat frame uitsteken of een ander rechthoekig gebied innemen. Rotatie, omtreklijnen, pijlpuntjes, tekstlayout en -overloop, gegenereerde SmartArt‑geometrie en andere rendereffecten kunnen allemaal het bezette gebied wijzigen.
Gebruik Shape.getVisualBounds om dat bezette gebied te berekenen zonder een afbeelding te maken. De methode retourneert een Rectangle2D.Float‑object in dia‑coördinaten. Het geretourneerde rechthoek wordt niet bijgesneden op de dia, zodat de coördinaten negatief kunnen zijn wanneer de inhoud buiten de oorsprong van de dia reikt.
Het volgende voorbeeld haalt de frame‑ en visuele grenzen op en vergelijkt ze:
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();
}
Hetzelfde rechthoek kan worden gebruikt om naburige vormen uit te lijnen aan de linker-, rechter-, boven‑ of onderkant; om voldoende ruimte te reserveren in een gegenereerde lay-out; of om inhoud buiten een toegestane regio te detecteren. Visuele grenzen zijn vooral nuttig voor SmartArt, tekstvakken, pijlen, afbeeldingen, gedraaid vormen en groep‑vormen, waar het opgeslagen frame mogelijk niet het volledige gerenderde resultaat weergeeft.
Gebruik Shape.getVisualBounds wanneer u coördinaten nodig heeft voor lay‑out of validatie en geen bitmap nodig heeft. Gebruik Shape.getImage wanneer u de vorm moet renderen. Met ShapeThumbnailBounds, bepaalt ShapeThumbnailBounds.Shape de afbeelding op basis van de vormgrenzen, inclusief omtrekinstellingen, terwijl ShapeThumbnailBounds.Appearance de afbeelding baseert op de weergave van de vorm en het resultaat beperkt tot de dia‑grenzen. Daarentegen retourneert Shape.getVisualBounds alleen het berekende rechthoek en snijdt het niet bij de dia.
FAQ
Welke afbeeldingformaten kunnen worden gebruikt bij het opslaan van vormminiaturen?
PNG, JPEG, BMP, GIF, TIFF, en andere. Vormen kunnen ook geëxporteerd worden als vector‑SVG door de inhoud van de vorm op te slaan als SVG.
Wat is het verschil tussen Shape‑ en Appearance‑grenzen bij het renderen van een miniatuur?
Shape gebruikt de geometrie van de vorm; Appearance houdt rekening met visuele effecten (schaduwen, gloed, enz.).
Wat gebeurt er als een vorm als verborgen is gemarkeerd? Wordt er toch een miniatuur gerenderd?
Een verborgen vorm blijft deel van het model en kan gerenderd worden; de verborgen‑vlag beïnvloedt alleen de weergave in de diavoorstelling maar verhindert niet dat de afbeelding van de vorm wordt gegenereerd.
Worden groeperende vormen, grafieken, SmartArt en andere complexe objecten ondersteund?
Ja. Elk object dat wordt weergegeven als Vorm (inclusief GroupShape, Chart, en SmartArt) kan worden opgeslagen als een miniatuur of als SVG.
Beïnvloeden systeem‑geïnstalleerde lettertypen de kwaliteit van miniaturen voor tekstvormen?
Ja. U moet de benodigde lettertypen leveren (of lettertype‑substituties configureren) om ongewenste fallback‑opties en tekst‑herindeling te voorkomen.