3D and Visual Effects

Arbeiten mit 3D‑Effekten und visuellen Effekten — Aspose.Slides FOSS für .NET

Aspose.Slides FOSS for .NET bietet zwei separate Effekt‑Systeme, die für jede Form zugänglich sind:

EffectFormat (shape.EffectFormat): 2D‑Visuelle Effekte: Schatten, Leuchten, weiche Kante, Unschärfe, Spiegelung
ThreeDFormat (shape.ThreeDFormat): 3D‑Aussehen: Fase, Kameraprojektion, Licht‑Rig, Material, Extrusionstiefe

Beide bleiben über Speicher‑/Ladezyklen hinweg erhalten.

Visuelle Effekte (EffectFormat)

Äußerer Schlagschatten

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 120);
shape.AddTextFrame("Shadowed Text");

var ef = shape.EffectFormat;
ef.EnableOuterShadowEffect();
ef.OuterShadowEffect.BlurRadius = 10;      // softness in points
ef.OuterShadowEffect.Direction = 315;       // angle: 315 = upper-left cast
ef.OuterShadowEffect.Distance = 8;          // offset in points
ef.OuterShadowEffect.ShadowColor.Color = Color.FromArgb(128, 0, 0, 0);  // semi-transparent black

prs.Save("shadow.pptx", SaveFormat.Pptx);

Gemeinsame Direction Werte: 0 = rechts, 45 = unten-rechts, 90 = unten, 270 = oben, 315 = oben-links.

Leuchteffekt

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Ellipse, 150, 100, 200, 200);

var ef = shape.EffectFormat;
ef.EnableGlowEffect();
ef.GlowEffect.Radius = 15;
ef.GlowEffect.Color.Color = Color.Gold;

prs.Save("glow.pptx", SaveFormat.Pptx);

Weiche Kante (Verwischter Rand)

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 350, 180);

var ef = shape.EffectFormat;
ef.EnableSoftEdgeEffect();
ef.SoftEdgeEffect.Radius = 12;   // feather radius in points

prs.Save("soft-edge.pptx", SaveFormat.Pptx);

Unschärfe

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 350, 180);

shape.EffectFormat.SetBlurEffect(8, true);

prs.Save("blur.pptx", SaveFormat.Pptx);

Überprüfen und Entfernen von Effekten

using Aspose.Slides.Foss;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);
var ef = shape.EffectFormat;

ef.EnableOuterShadowEffect();
ef.EnableGlowEffect();
Console.WriteLine($"Has effects: {!ef.IsNoEffects}");  // True

ef.DisableOuterShadowEffect();
ef.DisableGlowEffect();
Console.WriteLine($"Has effects: {!ef.IsNoEffects}");  // False

3D-Formatierung (ThreeDFormat)

Bevel Effect

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 250, 120);
shape.AddTextFrame("3D Button");

var tdf = shape.ThreeDFormat;
tdf.BevelTop.BevelType = BevelPresetType.Circle;
tdf.BevelTop.Width = 12;
tdf.BevelTop.Height = 6;

prs.Save("bevel.pptx", SaveFormat.Pptx);

BevelPresetType Werte: Circle, RelaxedInset, CoolSlant, Divot, Riblet, HardEdge, Slope, Convex

Kamera‑Voreinstellung

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 250, 120);
var tdf = shape.ThreeDFormat;
tdf.BevelTop.BevelType = BevelPresetType.Circle;
tdf.BevelTop.Width = 10;
tdf.Camera.CameraType = CameraPresetType.PerspectiveAbove;
prs.Save("camera.pptx", SaveFormat.Pptx);

Licht‑Rig und Material

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 250, 120);
shape.AddTextFrame("Metal Button");

var tdf = shape.ThreeDFormat;
tdf.BevelTop.BevelType = BevelPresetType.Circle;
tdf.BevelTop.Width = 10;
tdf.BevelTop.Height = 5;
tdf.Camera.CameraType = CameraPresetType.PerspectiveAbove;
tdf.LightRig.LightType = LightRigPresetType.Balanced;
tdf.LightRig.Direction = LightingDirection.Top;
tdf.Material = MaterialPresetType.Metal;
tdf.Depth = 20;

prs.Save("3d-metal.pptx", SaveFormat.Pptx);

MaterialPresetType-Werte: Standard, Warm, Cool, Plastic, Metal, Matte, WireFrame

Kombinieren von 2D- und 3D-Effekten

Sie können sowohl EffectFormat als auch ThreeDFormat auf dieselbe Form anwenden:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.RoundCornerRectangle, 150, 150, 300, 120);
shape.AddTextFrame("Premium Card");

// Solid fill
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 30, 80, 180);

// 3D bevel
var tdf = shape.ThreeDFormat;
tdf.BevelTop.BevelType = BevelPresetType.Circle;
tdf.BevelTop.Width = 8;
tdf.Camera.CameraType = CameraPresetType.PerspectiveAbove;
tdf.Material = MaterialPresetType.Plastic;

// Drop shadow
var ef = shape.EffectFormat;
ef.EnableOuterShadowEffect();
ef.OuterShadowEffect.BlurRadius = 12;
ef.OuterShadowEffect.Direction = 270;
ef.OuterShadowEffect.Distance = 6;
ef.OuterShadowEffect.ShadowColor.Color = Color.FromArgb(80, 0, 0, 0);

prs.Save("premium-card.pptx", SaveFormat.Pptx);