Créer des présentations 3D en .NET

Vue d’ensemble

Comment créez-vous habituellement une présentation PowerPoint 3D ?
Microsoft PowerPoint permet de créer des présentations 3D selon lesquelles nous pouvons ajouter des modèles 3D, appliquer des effets 3D sur les formes, créer du texte 3D, télécharger des graphiques 3D dans la présentation, créer des animations 3D PowerPoint.

Créer des effets 3D a un fort impact sur l’amélioration de votre présentation en une présentation 3D, et peut être la mise en œuvre la plus simple d’une présentation 3D.
Depuis la version 20.9 d’Aspose.Slides, un nouveau moteur 3D multiplateforme a été ajouté. Le nouveau moteur 3D permet d’exporter et de rasteriser les formes et le texte avec des effets 3D. Dans les versions précédentes, les formes Slides avec des effets 3D appliqués étaient rendues à plat. Mais maintenant il est possible de rendre les formes avec un 3D complet.
De plus, il est maintenant possible de créer des formes avec des effets 3D via l’API publique Slides.

Dans l’API Aspose.Slides, pour faire d’une forme une forme PowerPoint 3D, utilisez la propriété IShape.ThreeDFormat, qui hérite des fonctionnalités de l’interface IThreeDFormat :

BevelBottom et BevelTop : définir le chanfrein de la forme, préciser le type de chanfrein (par ex. Angle, Cercle, SoftRound), définir la hauteur et la largeur du chanfrein.
Camera : est utilisé pour imiter les mouvements de caméra autour de l’objet. En d’autres termes, en réglant la rotation, le zoom et d’autres propriétés de la caméra, vous pouvez manipuler vos formes comme avec le modèle 3D dans PowerPoint.
ContourColor et ContourWidth : définir les propriétés de contour pour que la forme ressemble à une forme 3D PowerPoint.
Depth, ExtrusionColor et ExtrusionHeight : sont utilisés pour rendre la forme tridimensionnelle, c’est‑à‑dire convertir une forme 2D en une forme 3D, en définissant sa profondeur ou en la extrudant.
LightRig : peut créer un effet de lumière sur une forme 3D. Le principe de cette propriété est proche de celui de Camera, vous pouvez régler la rotation de la lumière par rapport à la forme 3D et choisir le type de lumière.
Material : définir le type de matériau de la forme 3D peut ajouter un effet plus vivant. La propriété fournit un ensemble de matériaux prédéfinis, tels que : Metal, Plastique, Poudre, Mat, etc.

Toutes les fonctionnalités 3D peuvent être appliquées aux formes et au texte. Voyons comment accéder aux propriétés mentionnées ci‑dessus et les examiner en détail, étape par étape :

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
    shape.TextFrame.Text = "3D";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;

    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.Material = MaterialPresetType.Flat;
    shape.ThreeDFormat.ExtrusionHeight = 100;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.Blue;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("sample_3d.png");
    }

    presentation.Save("sandbox_3d.pptx", SaveFormat.Pptx);
}

La miniature rendue ressemble à ceci :

todo:image_alt_text

Rotation 3D

Il est possible de faire pivoter les formes PowerPoint 3D dans le plan 3D, ce qui apporte plus d’interactivité. Pour faire pivoter une forme 3D dans PowerPoint, vous utilisez généralement le menu suivant :

todo:image_alt_text

Dans l’API Aspose.Slides, la rotation des formes 3D peut être gérée à l’aide de la propriété IThreeDFormat.Camera :

IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
// ... définir les autres paramètres de la scène 3D

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

Profondeur et extrusion 3D

Pour ajouter la troisième dimension à votre forme et en faire une forme 3D, utilisez les propriétés IThreeDFormat.ExtrusionHeight et IThreeDFormat.ExtrusionColor.Color :

IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 200, 200);
shape.ThreeDFormat.Camera.SetRotation(20, 30, 40);
shape.ThreeDFormat.ExtrusionHeight = 100;
shape.ThreeDFormat.ExtrusionColor.Color = Color.Purple;
// ... définir les autres paramètres de la scène 3D

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

En général, vous utilisez le menu Profondeur dans PowerPoint pour définir la profondeur d’une forme 3D PowerPoint :

todo:image_alt_text

Dégradé 3D

Le dégradé peut être utilisé pour remplir la couleur d’une forme 3D PowerPoint. Créons une forme avec un remplissage en dégradé et appliquons‑lui un effet 3D :

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.TextFrame.Text = "3D Gradient";
    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 64;

    shape.FillFormat.FillType = FillType.Gradient;
    shape.FillFormat.GradientFormat.GradientStops.Add(0, Color.Blue);
    shape.FillFormat.GradientFormat.GradientStops.Add(100, Color.Orange);
    
    shape.ThreeDFormat.Camera.CameraType = CameraPresetType.OrthographicFront;
    shape.ThreeDFormat.Camera.SetRotation(10, 20, 30);
    shape.ThreeDFormat.LightRig.LightType = LightRigPresetType.Flat;
    shape.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    shape.ThreeDFormat.ExtrusionHeight = 150;
    shape.ThreeDFormat.ExtrusionColor.Color = Color.DarkOrange;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("sample_3d.png");
    }
}

Et voici le résultat :

todo:image_alt_text

En plus d’un remplissage dégradé, il est possible de remplir les formes avec une image :

byte[] imageData = File.ReadAllBytes("image.jpg");
IPPImage image = presentation.Images.AddImage(imageData);

shape.FillFormat.FillType = FillType.Picture;
shape.FillFormat.PictureFillFormat.Picture.Image = image;
shape.FillFormat.PictureFillFormat.PictureFillMode = PictureFillMode.Stretch;
// ... configurer la 3D : shape.ThreeDFormat.Camera, shape.ThreeDFormat.LightRig, propriétés shape.ThreeDFormat.Extrusion* 

using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
{
    thumbnail.Save("sample_3d.png");
}

C’est ainsi que cela apparaît :

todo:image_alt_text

Texte 3D (WordArt)

Aspose.Slides permet également d’appliquer la 3D au texte. Pour créer un texte 3D, il est possible d’utiliser l’effet de transformation WordArt :

const float imageScale = 2;

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 150, 250, 250);
    shape.FillFormat.FillType = FillType.NoFill;
    shape.LineFormat.FillFormat.FillType = FillType.NoFill;
    shape.TextFrame.Text = "3D Text";

    Portion portion = (Portion)shape.TextFrame.Paragraphs[0].Portions[0];
    portion.PortionFormat.FillFormat.FillType = FillType.Pattern;
    portion.PortionFormat.FillFormat.PatternFormat.ForeColor.Color = Color.DarkOrange;
    portion.PortionFormat.FillFormat.PatternFormat.BackColor.Color = Color.White;
    portion.PortionFormat.FillFormat.PatternFormat.PatternStyle = PatternStyle.LargeGrid;

    shape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 128;

    ITextFrameFormat textFrameFormat = shape.TextFrame.TextFrameFormat;
    // définir l'effet de transformation WordArt "Arch Up"
    textFrameFormat.Transform = TextShapeType.ArchUp;

    textFrameFormat.ThreeDFormat.ExtrusionHeight = 3.5f;
    textFrameFormat.ThreeDFormat.Depth = 3;
    textFrameFormat.ThreeDFormat.Material = MaterialPresetType.Plastic;
    textFrameFormat.ThreeDFormat.LightRig.Direction = LightingDirection.Top;
    textFrameFormat.ThreeDFormat.LightRig.LightType = LightRigPresetType.Balanced;
    textFrameFormat.ThreeDFormat.LightRig.SetRotation(0, 0, 40);

    textFrameFormat.ThreeDFormat.Camera.CameraType = CameraPresetType.PerspectiveContrastingRightFacing;

    using (IImage thumbnail = slide.GetImage(imageScale, imageScale))
    {
        thumbnail.Save("text3d.png");
    }

    presentation.Save("text3d.pptx", SaveFormat.Pptx);
}

Voici le résultat :

todo:image_alt_text

FAQ

Les effets 3D seront‑ils conservés lors de l’exportation d’une présentation vers des images/PDF/HTML ?
Oui. Le moteur 3D de Slides rend les effets 3D lors de l’exportation vers les formats pris en charge (images, PDF, HTML, etc.).

Puis‑je récupérer les valeurs « effectives » (finales) des paramètres 3D qui tiennent compte des thèmes, de l’héritage, etc. ?
Oui. Slides propose des API pour lire les valeurs effectives (y compris pour la 3D — éclairage, chanfreins, etc.) afin que vous puissiez voir les paramètres finaux appliqués.

Les effets 3D fonctionnent‑ils lors de la conversion d’une présentation en vidéo ?
Oui. Lors de la génération des images pour la vidéo, les effets 3D sont rendus de la même manière que pour les images exportées.

Améliorer les présentations PowerPoint avec des animations en .NET Prise en charge .NET 6