3D-effecten maken in presentaties op Android
Overzicht
Aspose.Slides voor Android via Java kan 3D‑opmaak in PowerPoint‑stijl voor vormen en tekst maken, bewerken, behouden en renderen. Dit artikel behandelt 3D‑effecten zoals rotatie, extrusie, schuine randen, belichting, materiaal, verloop‑ of afbeeldingsvullingen en 3D‑tekst.
Opmerking
Dit artikel gaat over 3D‑opmaak‑effecten op PowerPoint‑vormen en -tekst. Het gaat niet over het invoegen of bewerken van losse 3D‑modellen. Wanneer je een dia exporteert naar een afbeelding, PDF of HTML, rendert Aspose.Slides die 3D‑effecten in de geëxporteerde 2D‑output.3D‑opmaakconcepten
Gebruik de IShape.getThreeDFormat‑methode om 3D‑opmaak op een vorm toe te passen. De methode retourneert IThreeDFormat, die de 3D‑scene voor die vorm regelt.
Voor tekst gebruik je de ITextFrameFormat.getThreeDFormat‑methode. Deze past 3D‑opmaak toe op het tekstframe in plaats van op het vormlichaam.
De belangrijkste API‑leden zijn:
| API‑lid | Wat het regelt | Wanneer te gebruiken |
|---|---|---|
| getCamera | Viewpoint, vooraf ingestelde cameratype, rotatie, zoom en perspectief. | Roteer het object in 3D‑ruimte of pas een PowerPoint‑3D‑rotatie‑preset toe. |
| getLightRig | Vooraf ingestelde verlichting, richting en rotatie van het licht. | Wijzig hoe hooglichten en schaduwen op het 3D‑oppervlak verschijnen. |
| getMaterial en setMaterial | Materiaal van het oppervlak, zoals vlak, mat, kunststof of metaal. | Laat dezelfde geometrie er platter, zachter, glanzender of metallisch uitzien. |
| getExtrusionHeight en setExtrusionHeight | Hoe ver de vorm naar achteren uitstekt vanaf de voorzijde. | Zet een platte vorm om in een duidelijk dik 3D‑object. |
| getExtrusionColor | Kleur van de geëxtrudeerde zijkanten. | Maak diepte zichtbaar of stem de kleur van de zijkanten af op de voorvulling. |
| getDepth en setDepth | Extra 3D‑diepte die wordt gebruikt door PowerPoint‑3D‑opmaak. | Fijn afstemmen van diepte voor vormen of tekst, vooral in combinatie met schuine randen‑ en materiaalinstellingen. |
| getBevelTop en getBevelBottom | Verhoogde of afgeronde randen op de voor‑ en achtervlakken. | Voeg een verzachte of gevormde rand toe in plaats van een scherpe vlakke rand. |
| getContourColor en getContourWidth en setContourWidth | Omtrek rond het 3D‑object. | Benadruk de objectgrens in de gerenderde output. |
Een 3D‑vorm maken
- Camera‑instellingen, omdat de standaard vooraanzicht de extrusie kan verbergen.
- Licht‑instellingen, omdat belichting de vlakken en zijkanten leesbaar maakt.
- Materiaal‑instellingen, omdat het oppervlak bepaalt hoe licht wordt weergegeven.
- Extrusie‑ of diepte‑instellingen, omdat een platte vorm dikte nodig heeft.
Het onderstaande voorbeeld maakt een rechthoek, voegt tekst toe aan de voorzijde en past 3D‑opmaak toe. De camerarotatiewaarden staan in graden, en de extrusie‑hoogte is 100 punten. Het voorbeeld rendert de dia naar een PNG‑afbeelding op twee keer de standaardafmetingen en slaat de presentatie op als PPTX.
import com.aspose.slides.*;
import android.graphics.Color;
final float imageScale = 2;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.getTextFrame().setText("3D");
shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(64);
shape.getFillFormat().setFillType(FillType.Solid);
shape.getFillFormat().getSolidFillColor().setColor(Color.rgb(100, 149, 237));
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
shape.getThreeDFormat().setExtrusionHeight(100);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.BLUE);
IImage thumbnail = slide.getImage(imageScale, imageScale);
try {
thumbnail.save("shape_3d.png", ImageFormat.Png);
} finally {
thumbnail.dispose();
}
presentation.save("shape_3d.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}

Een vorm draaien met de camera
In PowerPoint wordt 3D‑rotatie geconfigureerd via het paneel 3‑D‑rotatie. De X‑, Y‑ en Z‑rotatiewaarden komen overeen met de rotatie die je via de camera‑API instelt.

In Aspose.Slides krijg je toegang tot de camera via IThreeDFormat.getCamera. Dit voorbeeld maakt een rechthoek, selecteert een orthografisch frontaanzicht en stelt de X‑, Y‑ en Z‑rotaties in op respectievelijk 20, 30 en 40 graden. Het configureert de vorm in het geheugen zonder een bestand op te slaan:
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
} finally {
presentation.dispose();
}
Gebruik de camera wanneer je de manier wilt wijzigen waarop de kijker het object ziet. Het wijzigt niet de 2D‑vormgeometrie op de dia. Het verandert het 3D‑viewpoint dat PowerPoint en Aspose.Slides gebruiken bij het renderen.
Camera‑oriëntatie kopiëren van een sjabloonvorm
Om de oriëntatie van een sjabloonvorm te evenaren, lees je de camera‑preset met getCameraType en de rotatiehoeken met getRotation. Het voorbeeld opent template.pptx en kopieert de camera‑oriëntatie van de eerste vorm op de eerste dia naar de tweede vorm. Beide vormen hebben al 3D‑belichting, en de tweede vorm heeft geen expliciete camera‑rotatie.
De hoeken staan in graden. Index 0 is breedtegraad, index 1 is lengtegraad, en index 2 is omwenteling. Geef ze in die volgorde door aan setRotation. Als de bron null retourneert, heeft deze geen expliciete rotatie, dus laat de hoeken van de tweede vorm onaangedaan. Een expliciete rotatie van (0, 0, 0) levert drie nullen op en moet worden gekopieerd.
import com.aspose.slides.*;
Presentation presentation = new Presentation("template.pptx");
try {
IShapeCollection shapes = presentation.getSlides().get_Item(0).getShapes();
ICamera sourceCamera = shapes.get_Item(0).getThreeDFormat().getCamera();
ICamera destinationCamera = shapes.get_Item(1).getThreeDFormat().getCamera();
destinationCamera.setCameraType(sourceCamera.getCameraType());
float[] angles = sourceCamera.getRotation();
if (angles != null) {
destinationCamera.setRotation(angles[0], angles[1], angles[2]);
}
presentation.save("camera-copy.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Wanneer je camera-copy.pptx in PowerPoint heropent, heeft de pijl aan de rechterkant dezelfde camera‑preset en rotatie als de rechthoek aan de linkerkant. Beide vormen gebruiken dezelfde belichting en extrusiediepte.

Extrusie en diepte toevoegen
Extrusie laat een vorm dikker lijken door deze achter de voorzijde uit te breiden. In PowerPoint bepaalt de diepte‑instelling deze zichtbare dikte, en de kleuren‑instelling bepaalt de kleur van de zijkanten.

Gebruik IThreeDFormat.setExtrusionHeight om de dikte in te stellen en IThreeDFormat.getExtrusionColor om de kleur van de zijkanten op te halen. Dit voorbeeld geeft een rechthoek een extrusie van 100 punten met paarse zijkanten en draait de camera om de dikte te onthullen. Het configureert de vorm in het geheugen zonder een bestand op te slaan:
import com.aspose.slides.*;
import android.graphics.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
int extrusionColor = Color.rgb(128, 0, 128);
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
shape.getThreeDFormat().setExtrusionHeight(100);
shape.getThreeDFormat().getExtrusionColor().setColor(extrusionColor);
} finally {
presentation.dispose();
}
De IThreeDFormat.setDepth‑methode stelt de diepte van een 3D‑vorm in. De setExtrusionHeight‑methode regelt de hoogte van het extrusie‑effect, zoals in dit voorbeeld wordt getoond.
Verlopen‑ of afbeeldingsvullingen gebruiken met 3D‑effecten
3D‑opmaak staat los van de vormvulling. Je kunt een effen kleur, verloop, patroon of afbeeldingsvulling op de voorzijde toepassen en toch dezelfde camera‑, licht‑, materiaal‑ en extrusie‑instellingen gebruiken.
Dit voorbeeld past een blauw‑naar‑oranje verloop toe op de voorzijde en een donkeroranje kleur op de 150‑punten extrusie. De verloopstops bij 0 en 100 markeren het begin en einde van het verloop. De camerarotatiewaarden staan in graden. De dia wordt gerenderd naar een PNG‑afbeelding op twee keer de standaardafmetingen:
import com.aspose.slides.*;
import android.graphics.Color;
final float imageScale = 2;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
shape.getTextFrame().setText("3D Gradient");
shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(64);
shape.getFillFormat().setFillType(FillType.Gradient);
shape.getFillFormat().getGradientFormat().getGradientStops().add(0, Color.BLUE);
shape.getFillFormat().getGradientFormat().getGradientStops().add(100, Color.rgb(255, 165, 0));
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(10, 20, 30);
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
int extrusionColor = Color.rgb(255, 140, 0);
shape.getThreeDFormat().setExtrusionHeight(150);
shape.getThreeDFormat().getExtrusionColor().setColor(extrusionColor);
IImage thumbnail = slide.getImage(imageScale, imageScale);
try {
thumbnail.save("gradient_3d.png", ImageFormat.Png);
} finally {
thumbnail.dispose();
}
} finally {
presentation.dispose();
}

Om in plaats daarvan een afbeeldingsvulling te gebruiken, voeg je de afbeelding toe aan de presentatie en wijs je deze toe aan de vormvulling. Dit voorbeeld vereist een bestaand bestand met de naam “image.jpg” in de werkmap. Het rekent de afbeelding uit om de rechthoek te vullen, past een extrusie van 150 punten toe en zet de camerarotatie in graden. Het configureert de vorm in het geheugen zonder een bestand op te slaan of te renderen:
import com.aspose.slides.*;
import android.graphics.Color;
import java.io.FileInputStream;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
IPPImage image;
try (FileInputStream imageStream = new FileInputStream("image.jpg")) {
image = presentation.getImages().addImage(imageStream);
}
shape.getFillFormat().setFillType(FillType.Picture);
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(image);
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);
int extrusionColor = Color.rgb(255, 140, 0);
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(10, 20, 30);
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
shape.getThreeDFormat().setExtrusionHeight(150);
shape.getThreeDFormat().getExtrusionColor().setColor(extrusionColor);
} finally {
presentation.dispose();
}

3D‑opmaak toepassen op tekst
3D‑opmaak van een vorm heeft invloed op het vormlichaam. 3D‑opmaak van tekst heeft invloed op het tekstframe. Dit is nuttig voor WordArt‑achtige effecten waarbij de letters zelf extrusie, materiaal, belichting en camera‑instellingen nodig hebben.
Het volgende voorbeeld maakt tekst met een oranje‑en‑wit rasterpatroon, past een omhoog gebogen boog toe en configureert 3D‑instellingen via ITextFrameFormat.getThreeDFormat. De extrusie‑hoogte en diepte staan in punten, en de licht‑rotatie in graden. De vormvulling en omtrek zijn verborgen zodat alleen de tekst zichtbaar is. Het voorbeeld rendert een PNG‑afbeelding op twee keer de standaarddia‑afmetingen en slaat de presentatie op als PPTX:
import com.aspose.slides.*;
import android.graphics.Color;
final float imageScale = 2;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
shape.getTextFrame().setText("3D Text");
IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
portion.getPortionFormat().getFillFormat().setFillType(FillType.Pattern);
int patternColor = Color.rgb(255, 140, 0);
portion.getPortionFormat().getFillFormat().getPatternFormat().getForeColor().setColor(patternColor);
portion.getPortionFormat().getFillFormat().getPatternFormat().getBackColor().setColor(Color.WHITE);
portion.getPortionFormat().getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.LargeGrid);
shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(128);
ITextFrameFormat textFrameFormat = shape.getTextFrame().getTextFrameFormat();
textFrameFormat.setTransform(TextShapeType.ArchUp);
textFrameFormat.getThreeDFormat().setExtrusionHeight(3.5f);
textFrameFormat.getThreeDFormat().setDepth(3);
textFrameFormat.getThreeDFormat().setMaterial(MaterialPresetType.Plastic);
textFrameFormat.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
textFrameFormat.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced);
textFrameFormat.getThreeDFormat().getLightRig().setRotation(0, 0, 40);
textFrameFormat.getThreeDFormat().getCamera().setCameraType(CameraPresetType.PerspectiveContrastingRightFacing);
IImage thumbnail = slide.getImage(imageScale, imageScale);
try {
thumbnail.save("text_3d.png", ImageFormat.Png);
} finally {
thumbnail.dispose();
}
presentation.save("text_3d.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}

Tekst plat houden op een 3D‑vorm
Om tekst leesbaar te houden terwijl je de 3D‑uitstraling van een vorm behoudt, roep je ITextFrameFormat.setKeepTextFlat aan via ITextFrame.getTextFrameFormat. Wanneer de waarde true is, blijft de tekst buiten de 3D‑scene. Wanneer deze false is, neemt de tekst deel aan de scene en volgt hij de 3D‑oriëntatie.
Deze instelling verwijdert de 3D‑opmaak van de vorm niet: de camera, belichting, materiaal en extrusie blijven geconfigureerd via IShape.getThreeDFormat. Het is ook anders dan gewone rotatie. IShape.setRotation roteert de vorm in het dia‑vlak, terwijl ITextFrameFormat.setRotationAngle de aangepaste rotatie van de tekst binnen de omhullende regelt. Tekst buiten de 3D‑scene houden zet geen van die hoeken terug.
Het volgende zelfstandige voorbeeld maakt een blauwe rechthoek met tekst en kloont deze naast het origineel. Beide vormen hebben dezelfde 3D‑opmaak; alleen de teksteigenschap verschilt: false links en true rechts. De camera‑hoeken staan in graden, en de extrusie‑hoogte is 40 punten. Het voorbeeld slaat de presentatie op als PPTX en rendert de vergelijkingsdia naar PNG op twee keer de standaardafmetingen.
import com.aspose.slides.*;
import android.graphics.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 70, 160, 240, 140);
shape.getTextFrame().setText("Readable text");
shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(28);
shape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().setAlignment(TextAlignment.Center);
shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Center);
shape.getFillFormat().setFillType(FillType.Solid);
shape.getFillFormat().getSolidFillColor().setColor(Color.rgb(100, 149, 237));
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(30, 30, 0);
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Flat);
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top);
shape.getThreeDFormat().setMaterial(MaterialPresetType.Flat);
shape.getThreeDFormat().setExtrusionHeight(40);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(65, 105, 225));
shape.getTextFrame().getTextFrameFormat().setKeepTextFlat(false);
IAutoShape flatTextShape = (IAutoShape) slide.getShapes().addClone(shape, 400, 160);
flatTextShape.getTextFrame().getTextFrameFormat().setKeepTextFlat(true);
presentation.save("keep_text_flat.pptx", SaveFormat.Pptx);
IImage image = slide.getImage(2, 2);
try {
image.save("keep_text_flat.png", ImageFormat.Png);
} finally {
image.dispose();
}
} finally {
presentation.dispose();
}
Links volgt de tekst de 3D‑oriëntatie. Rechts blijft de tekst plat en beter leesbaar. Beide rechthoeken behouden dezelfde zichtbare extrusie en 3D‑oriëntatie.

Export‑ en rendergedrag
Aspose.Slides behoudt 3D‑opmaak bij het opslaan naar PowerPoint‑formaten zoals PPTX. Bij het renderen of exporteren naar vaste‑layoutformaten wordt de 3D‑scene gerasterd of in de output getekend als een 2D‑resultaat. Dit geldt wanneer je dia’s rendert naar PNG, exporteert naar PDF, exporteert naar HTML, of frames genereert voor video‑conversie.
- Geëxporteerde afbeeldingen en PDF’s zijn niet interactief. Het object kan na export niet door de kijker worden gedraaid.
- Het uiteindelijke uiterlijk hangt af van de combinatie van camera, licht‑setup, materiaal, extrusie, vulling en dia‑schaling.
- Als je erfde of themagebaseerde opmaakwaarden wilt inspecteren, lees dan de effectieve vormeigenschappen.
- Sommige uitvoerformaten kunnen geen bewerkbare PowerPoint‑3D‑opmaak opslaan. In die formaten wordt het visuele resultaat gerenderd in plaats van bewaard als bewerkbare 3D‑instellingen.
FAQ
Kan Aspose.Slides interactieve 3D‑presentaties creëren?
Aspose.Slides maakt en rendert PowerPoint‑3D‑effecten voor vormen en tekst. Het maakt van geëxporteerde afbeeldingen, PDF‑s of HTML‑pagina’s geen interactieve 3D‑scènes die een kijker kan roteren. In PPTX blijft de 3D‑opmaak bewerkbaar in PowerPoint waarvoor het formaat ondersteuning biedt.
Wat is het verschil tussen een 3D‑model en een 3D‑effect?
Een 3D‑model is een apart 3D‑object dat in een presentatie wordt ingevoegd. Een 3D‑effect is opmaak die wordt toegepast op een gewone PowerPoint‑vorm of -tekst, zoals rotatie, extrusie, schuine rand, belichting en materiaal. Dit artikel behandelt 3D‑effecten.
Welke instellingen zijn vereist voor een zichtbare 3D‑vorm?
Minimaal moet je een camera‑rotatie instellen en ofwel extrusie of diepte. In de praktijk stel je ook een licht‑setup en materiaal in zodat de gerenderde vlakken duidelijke highlights en schaduwen krijgen.
Kan ik 3D‑effecten toepassen op zowel vormen als tekst?
Ja. Gebruik IShape.getThreeDFormat voor het vormlichaam en ITextFrameFormat.getThreeDFormat voor tekst.
Zullen 3D‑effecten verschijnen bij export naar afbeeldingen, PDF, HTML of videoframes?
Ja. Aspose.Slides rendert 3D‑effecten bij het produceren van dia‑afbeeldingen, PDF‑output, HTML‑output en frames die worden gebruikt voor video‑conversie. De geëxporteerde output bevat het gerenderde uiterlijk, niet een bewerkbaar 3D‑object.
Kan ik de uiteindelijke 3D‑waarden lezen nadat overerving en thema‑instellingen zijn toegepast?
Ja. Gebruik de effectieve opmaak‑API’s beschreven in Shape Effective Properties om de uiteindelijke camera‑, licht‑setup-, schuine‑rand‑ en gerelateerde 3D‑waarden te lezen.