Créer des effets 3D dans les présentations sur Android

Vue d’ensemble

Aspose.Slides for Android via Java peut créer, modifier, conserver et rendre une mise en forme 3D de type PowerPoint pour les formes et le texte. Cet article traite des effets 3D tels que la rotation, l’extrusion, les chanfreins, l’éclairage, le matériau, les remplissages dégradés ou image, et le texte 3D.

Cet article porte sur les effets de mise en forme 3D appliqués aux formes et au texte PowerPoint. Il ne traite pas de l’insertion ou de la modification de fichiers de modèle 3D autonomes. Lorsque vous exportez une diapositive vers une image, un PDF ou du HTML, Aspose.Slides rend ces effets 3D dans la sortie 2D exportée.

Concepts de mise en forme 3D

Utilisez la méthode IShape.getThreeDFormat pour appliquer une mise en forme 3D à une forme. La méthode renvoie IThreeDFormat, qui contrôle la scène 3D pour cette forme.

Pour le texte, utilisez la méthode ITextFrameFormat.getThreeDFormat . Celle‑ci applique la mise en forme 3D au cadre de texte plutôt qu’au corps de la forme.

Les membres d’API les plus importants sont :

Membre API	Ce qu’il contrôle	Quand l’utiliser
getCamera	Point de vue, type de caméra prédéfini, rotation, zoom et perspective.	Faire pivoter l’objet dans l’espace 3D ou correspondre à un préréglage de rotation 3D de PowerPoint.
getLightRig	Préréglage d’éclairage, direction et rotation de la lumière.	Modifier l’apparence des reflets et des ombres sur la surface 3D.
getMaterial et setMaterial	Matériau de surface, tel que plat, mat, plastique ou métal.	Faire paraître la même géométrie plus plate, plus douce, brillante ou métallique.
getExtrusionHeight et setExtrusionHeight	Distance à laquelle la forme s’étend en arrière depuis sa face avant.	Transformer une forme plate en un objet 3D visiblement épais.
getExtrusionColor	Couleur des côtés extrudés.	Rendre la profondeur visible ou harmoniser la couleur du côté avec le remplissage de face.
getDepth et setDepth	Profondeur 3D supplémentaire utilisée par la mise en forme 3D de PowerPoint.	Ajuster finement la profondeur des formes ou du texte, notamment avec les paramètres de chanfrein et de matériau.
getBevelTop et getBevelBottom	Bords relevés ou arrondis sur les faces avant et arrière.	Ajouter un bord adouci ou moulé au lieu d’une face plate et tranchante.
getContourColor, getContourWidth, et setContourWidth	Contour autour de l’objet 3D.	Mettre en évidence les limites de l’objet dans la sortie rendue.

Créer une forme 3D

Une forme doit généralement disposer de quatre types de réglages avant d’apparaître réellement en 3D :

Réglages de la caméra, car la vue frontale par défaut peut masquer l’extrusion.
Réglages de la lumière, car l’éclairage rend les faces et les côtés lisibles.
Réglages du matériau, car la surface influence le rendu de la lumière.
Réglages d’extrusion ou de profondeur, car une forme plate a besoin d’épaisseur.

L’exemple suivant crée un rectangle, ajoute du texte sur sa face avant, applique une mise en forme 3D, enregistre la présentation au format PPTX et rend la diapositive en image PNG.

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();
}

L’image de la diapositive rendue montre le rectangle comme un bloc 3D épais :

Rectangle 3D bleu rendu avec texte 3D blanc sur la face avant

Faire pivoter une forme avec la caméra

Dans PowerPoint, la rotation 3D est configurée depuis le volet Rotation 3‑D. Les valeurs de rotation X, Y et Z correspondent à la rotation que vous définissez via l’API de la caméra.

Volet Rotation 3D de PowerPoint avec les valeurs de rotation X, Y et Z mises en évidence

Dans Aspose.Slides, définissez le type de caméra et la rotation via IThreeDFormat.getCamera :

shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront);
shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);

Utilisez la caméra lorsque vous devez modifier la façon dont le spectateur voit l’objet. Cela ne modifie pas la géométrie 2D de la forme sur la diapositive. Cela change le point de vue 3D utilisé par PowerPoint et par Aspose.Slides lors du rendu.

Ajouter une extrusion et une profondeur

L’extrusion donne à une forme un aspect épais en l’étendant derrière la face avant. Dans PowerPoint, le contrôle de profondeur définit cette épaisseur visible, et le contrôle de couleur définit la couleur des faces latérales.

Contrôles de profondeur de PowerPoint associés aux propriétés de couleur d’extrusion et de hauteur d’extrusion

Définissez IThreeDFormat.setExtrusionHeight pour l’épaisseur et IThreeDFormat.getExtrusionColor pour la couleur des côtés :

shape.getThreeDFormat().getCamera().setRotation(20, 30, 40);
shape.getThreeDFormat().setExtrusionHeight(100);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(128, 0, 128));

Utilisez IThreeDFormat.setDepth lorsque vous devez travailler directement avec la valeur de profondeur de PowerPoint ou combiner profondeur avec chanfrein, matériau et effets de texte. Dans de nombreux scénarios de forme, setExtrusionHeight est le réglage le plus clair car il exprime directement l’extrusion visible.

Utiliser des remplissages en dégradé ou image avec des effets 3D

La mise en forme 3D est indépendante du remplissage de la forme. Vous pouvez appliquer une couleur unie, un dégradé, un motif ou un remplissage image à la face avant tout en conservant les mêmes réglages de caméra, lumière, matériau et extrusion.

Cet exemple applique un remplissage dégradé à la forme et une couleur d’extrusion plus sombre aux côtés :

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);
    shape.getThreeDFormat().setExtrusionHeight(150);
    shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(255, 140, 0));

    IImage thumbnail = slide.getImage(imageScale, imageScale);
    try {
        thumbnail.save("gradient_3d.png", ImageFormat.Png);
    } finally {
        thumbnail.dispose();
    }
} finally {
    presentation.dispose();
}

Le rendu conserve le dégradé sur la face avant et rend séparément l’extrusion :

Rectangle 3D rendu avec un remplissage en dégradé du bleu à l’orange et une extrusion orange

Pour utiliser un remplissage image à la place, ajoutez l’image à la présentation et affectez‑la au remplissage de la forme :

IPPImage image;
try (FileInputStream imageStream = new FileInputStream("image.png")) {
    image = presentation.getImages().addImage(imageStream);
}

shape.getFillFormat().setFillType(FillType.Picture);
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(image);
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

shape.getThreeDFormat().getCamera().setRotation(10, 20, 30);
shape.getThreeDFormat().setExtrusionHeight(150);
shape.getThreeDFormat().getExtrusionColor().setColor(Color.rgb(255, 140, 0));

L’image est rendue sur la face avant, tandis que l’extrusion est rendue comme surface latérale 3D :

Rectangle 3D rendu avec un remplissage photo sur la face avant et une extrusion orange

Appliquer la mise en forme 3D au texte

La mise en forme 3D d’une forme affecte le corps de la forme. La mise en forme 3D du texte affecte le cadre de texte. Cela est utile pour des effets de type WordArt où les lettres elles‑mêmes nécessitent extrusion, matériau, éclairage et réglages de caméra.

L’exemple suivant crée du texte avec un remplissage en motif, applique une transformation WordArt et configure les paramètres 3D sur ITextFrameFormat :

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);
    portion.getPortionFormat().getFillFormat().getPatternFormat().getForeColor().setColor(Color.rgb(255, 140, 0));
    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.5);
    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();
}

Le texte est rendu comme une lettrine 3D courbée et extrudée :

Texte 3D rendu avec une transformation WordArt en arc, remplissage motif orange et extrusion sombre

Comportement d’exportation et de rendu

Aspose.Slides conserve la mise en forme 3D lors de l’enregistrement aux formats PowerPoint tels que PPTX. Lors du rendu ou de l’exportation vers des formats à mise en page fixe, la scène 3D est rasterisée ou dessinée dans la sortie sous forme de résultat 2D. Cela s’applique lorsque vous rendez des diapositives en PNG, exportez en PDF, exportez en HTML, ou générez des images pour la conversion vidéo.

Gardez ces points à l’esprit :

Les images et les PDF exportés ne sont pas interactifs. L’objet ne peut pas être pivoté par le spectateur après l’exportation.
L’apparence finale dépend de la combinaison de la caméra, du rig lumineux, du matériau, de l’extrusion, du remplissage et du redimensionnement de la diapositive.
Si vous devez inspecter les valeurs de mise en forme héritées ou basées sur le thème, lisez les propriétés de forme effectives.
Certains formats de sortie ne peuvent pas stocker la mise en forme 3D PowerPoint éditable. Dans ces formats, le résultat visuel est rendu plutôt que préservé comme paramètres 3D éditables.

FAQ

Aspose.Slides peut‑il créer des présentations 3D interactives ?

Aspose.Slides crée et rend les effets 3D PowerPoint pour les formes et le texte. Il ne rend pas les images, PDF ou pages HTML exportés interactifs ; le spectateur ne peut pas faire pivoter la scène 3D. Dans les fichiers PPTX, la mise en forme 3D reste éditable dans PowerPoint lorsque le format le prend en charge.

Quelle est la différence entre un modèle 3D et un effet 3D ?

Un modèle 3D est un objet 3D distinct inséré dans une présentation. Un effet 3D est une mise en forme appliquée à une forme ou un texte PowerPoint ordinaire, comme la rotation, l’extrusion, le chanfrein, l’éclairage et le matériau. Cet article traite des effets 3D.

Quels réglages sont nécessaires pour qu’une forme 3D soit visible ?

Au minimum, définissez une rotation de caméra et soit l’extrusion, soit la profondeur. En pratique, il faut également définir un rig lumineux et un matériau afin que les faces rendues présentent des reflets et des ombres clairs.

Puis‑je appliquer des effets 3D à la fois aux formes et au texte ?

Oui. Utilisez IShape.getThreeDFormat pour le corps de la forme et ITextFrameFormat.getThreeDFormat pour le texte.

Les effets 3D apparaissent‑ils lors de l’exportation vers des images, PDF, HTML ou des images vidéo ?

Oui. Aspose.Slides rend les effets 3D lors de la génération d’images de diapositives, de sorties PDF, HTML et des images utilisées pour la conversion vidéo. La sortie exportée contient l’apparence rendue, pas un objet 3D éditable.

Puis‑je lire les valeurs 3D finales après l’application de l’héritage et des paramètres de thème ?

Oui. Utilisez les API de mise en forme effective décrites dans Propriétés de forme effectives pour lire les valeurs finales de caméra, de rig lumineux, de chanfrein et les valeurs 3D associées.

Améliorer les présentations PowerPoint avec des animations sur Android Améliorer le traitement d'images avec l'API Moderne