3D Presentation

Overview

Since Aspose.Slides 20.9 its possible to create and modify PowerPoint 3D models. This can be achieved by bringing 2D shapes a set of 3D effects. By creating a camera view on the shape, you may rotate it by the axis. Create an extrusion or depth on the shape, which will transform the shape from a 2d shape to a 3D model. Setting the light effect on the 3D shape or changing the materials can make it look more alive. Changing the colors of 3D models to a 3D gradient, modifying shapes contour, adding a bevel make 3D model more volume. All the 3D effects can be applied on both PowerPoint 3D models and texts.

Let us observe the first example of creating 3D models, which includes all the abovementioned features:

{
    using namespace Aspose::Slides;

    auto pres = System::MakeObject<Presentation>();
    auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 200.0f, 200.0f);
    shape->get_TextFrame()->set_Text(u"3D");
    shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f);

    shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront);
    shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
    shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::ThreePt);
    shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
    shape->get_ThreeDFormat()->set_Material(MaterialPresetType::Matte);
    shape->get_ThreeDFormat()->set_ExtrusionHeight(100);
    shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(System::Drawing::Color::get_Blue());

    pres->get_Slides()->idx_get(0)->GetThumbnail(2.0f, 2.0f)->Save(u"sample_3d.png");
    pres->Save(u"sandbox_3d.pptx", Export::SaveFormat::Pptx);
}

The resulting PowerPoint 3D model:

3D Rotation

In PowerPoint shape rotation is available via:

To rotate PowerPoint 3D models, it is necessary to create a camera view on the shape. This is done with IThreeDFormat.get_Camera() method. The rotation method is called from the camera class as if you would be rotating the camera. In fact, when you rotate the camera relatively to the shape, you rotate the shape on the 3D plane.

{
    using namespace Aspose::Slides;
 
    auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 200.0f, 200.0f);
    shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
    // ... set other 3D scene parameters
    pres->get_Slides()->idx_get(0)->GetThumbnail(2, 2)->Save(u"sample_3d.png");
}

3D Depth and Extrusion

To add depth and extrusion for a PowerPoint 3D model use IThreeDFormat.set_ExtrusionHeight() method. For modifying extrusion color use IThreeDFormat.get_ExtrusionColor() method:

{
    using namespace Aspose::Slides;
 
    auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 200.0f, 200.0f);
    shape->get_ThreeDFormat()->get_Camera()->SetRotation(20.0f, 30.0f, 40.0f);
    shape->get_ThreeDFormat()->set_ExtrusionHeight(100.0);
    shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(System::Drawing::Color::get_Purple());
    // ... set other 3D scene parameters
    pres->get_Slides()->idx_get(0)->GetThumbnail(2, 2)->Save(u"sample_3d.png");
}

Depth menu in PowerPoint:

3D Gradient

Drawing a 3D gradient on PowerPoint 3D model can be done via Shape.get_FillFormat().get_GradientFormat() method:

{
    using namespace Aspose::Slides;

    auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f);
    shape->get_TextFrame()->set_Text(u"3D Gradient");
    shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(64.0f);

    shape->get_FillFormat()->set_FillType(FillType::Gradient);
    shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(0, System::Drawing::Color::get_Blue());
    shape->get_FillFormat()->get_GradientFormat()->get_GradientStops()->Add(100.0f, System::Drawing::Color::get_Orange());

    shape->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::OrthographicFront);
    shape->get_ThreeDFormat()->get_Camera()->SetRotation(10.0f, 20.0f, 30.0f);
    shape->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Flat);
    shape->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
    shape->get_ThreeDFormat()->set_ExtrusionHeight(150.0);
    shape->get_ThreeDFormat()->get_ExtrusionColor()->set_Color(System::Drawing::Color::get_DarkOrange());

    pres->get_Slides()->idx_get(0)->GetThumbnail(2, 2)->Save(u"sample_3d.png");
}

3D model with 3D gradient:

To create image gradient use Shape.get_FillFormat().get_PictureFillFormat() method:

{
    using namespace Aspose::Slides;

    shape->get_FillFormat()->set_FillType(FillType::Picture);
    shape->get_FillFormat()->get_PictureFillFormat()->get_Picture()->set_Image(pres->get_Images()->AddImage(System::IO::File::ReadAllBytes(u"image.jpg")));
    shape->get_FillFormat()->get_PictureFillFormat()->set_PictureFillMode(PictureFillMode::Stretch);
    // .. setup 3D: Camera, LightRig, Extrusion
    pres->get_Slides()->idx_get(0)->GetThumbnail(2, 2)->Save(u"sample_3d.png");
}
    

3d model with image gradient:

3D Text (WordArt)

To apply rotation, extrusion, light, gradient on text and make it a 3D text(WordArt), you need to access IAutoShape.get_TextFrame().get_TextFrameFormat().get_ThreeDFormat() method:

{
    using namespace Aspose::Slides;
    using namespace Aspose::Slides::Export;

    auto shape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 150.0f, 250.0f, 250.0f);

    shape->get_FillFormat()->set_FillType(FillType::NoFill);
    shape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::NoFill);
    shape->get_TextFrame()->set_Text(u"3D Text");

    auto portion = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0);
    portion->get_PortionFormat()->get_FillFormat()->set_FillType(FillType::Pattern);
    portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_ForeColor()->set_Color(System::Drawing::Color::get_DarkOrange());
    portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->get_BackColor()->set_Color(System::Drawing::Color::get_White());
    portion->get_PortionFormat()->get_FillFormat()->get_PatternFormat()->set_PatternStyle(PatternStyle::LargeGrid);

    shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(128.0f);

    auto textFrame = shape->get_TextFrame();
    // setup "Arch Up" WordArt transform effect
    textFrame->get_TextFrameFormat()->set_Transform(TextShapeType::ArchUp);

    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->set_ExtrusionHeight(3.5);
    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->set_Depth(3.0);
    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->set_Material(MaterialPresetType::Plastic);
    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->get_LightRig()->set_Direction(LightingDirection::Top);
    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->get_LightRig()->set_LightType(LightRigPresetType::Balanced);
    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->get_LightRig()->SetRotation(0.0f, 0.0f, 40.0f);

    textFrame->get_TextFrameFormat()->get_ThreeDFormat()->get_Camera()->set_CameraType(CameraPresetType::PerspectiveContrastingRightFacing);

    pres->get_Slides()->idx_get(0)->GetThumbnail(2, 2)->Save(u"text3d.png");
    pres->Save(u"text3d.pptx", SaveFormat::Pptx);
}

An example of 3D text (WordArt):

Not Supported - Coming Soon

The following PowerPoint 3D features are not supported yet:

• Bevel
• Material
• Contour
• Lighting

We continue to improve our 3D Engine, and these features are the subject of further implementation.