Python で 3D プレゼンテーションを作成

概要

通常、3D PowerPoint プレゼンテーションはどのように作成しますか？Microsoft PowerPoint では、3D モデルの追加、シェイプへの 3D 効果の適用、3D テキストの作成、3D グラフィックの挿入、3D アニメーションの構築が可能です。

3D 効果を作成するとインパクトが大きく、標準的なスライドを 3D プレゼンテーションに変換する最も簡単な方法の一つです。Aspose.Slides 20.9 以降、新しい クロスプラットフォーム 3D エンジン が追加されました。このエンジンにより、3D 効果を持つシェイプやテキストをエクスポートおよびラスター化できます。以前のバージョンでは、3D 効果を持つシェイプは平坦に描画されていましたが、現在は 本格的な 3D で描画可能です。また、Aspose.Slides API を使用して 3D 効果を持つシェイプを作成することもできます。

Aspose.Slides API でシェイプを PowerPoint 3D シェイプにするには、Shape.three_d_format プロパティを使用します。このプロパティは ThreeDFormat クラスのメンバーを公開します。

bevel_bottom と bevel_top：ベベルを設定し、ベベルタイプ（例：Angle、Circle、SoftRound）を選択し、ベベルの高さと幅を定義します。
camera：オブジェクトの周りをカメラが移動するようにシミュレートします。カメラの回転、ズーム、その他のプロパティを調整することで、PowerPoint の 3D モデルのようにシェイプを操作できます。
contour_color と contour_width：輪郭プロパティを設定し、シェイプを 3D PowerPoint オブジェクトのように見せます。
depth、extrusion_color、extrusion_height：深さを設定または押し出すことでシェイプを立体化します。
light_rig：3D シェイプに照明効果を作成します。カメラと同様に、光の回転を 3D シェイプに対して設定し、光のタイプを選択できます。
material：マテリアルを選択して 3D シェイプをよりリアルにします。事前定義されたマテリアルには Metal、Plastic、Powder、Matte などがあります。

すべての 3D 機能はシェイプとテキストの両方に適用できます。以下のセクションでは、これらのプロパティへのアクセス方法とステップバイステップでの使用例を示します。

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
    shape.text_frame.text = "3D"
    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64

    shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
    shape.three_d_format.camera.set_rotation(20, 30, 40)
    shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
    shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    shape.three_d_format.material = slides.MaterialPresetType.FLAT
    shape.three_d_format.extrusion_height = 100
    shape.three_d_format.extrusion_color.color = drawing.Color.blue

    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("sample_3d.png")

    presentation.save("sandbox_3d.pptx", slides.export.SaveFormat.PPTX)

レンダリングされたサムネイルは次のようになります。

todo:image_alt_text

3D 回転

PowerPoint の 3D シェイプを三次元空間で回転させ、インタラクティブ性を追加できます。PowerPoint で 3D シェイプを回転させるには、次のメニューを使用します。

todo:image_alt_text

Aspose.Slides API では、シェイプの 3D 回転は camera プロパティで制御します。

shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
shape.three_d_format.camera.set_rotation(20, 30, 40)
# ... 他の 3D シーン パラメータを設定

with slide.get_image(image_scale, image_scale) as thumbnail:
    thumbnail.save("sample_3d.png")

3D 深さと押し出し

シェイプに第3の次元を加えて本格的な 3D にするには、ThreeDFormat.extrusion_height と ThreeDFormat.extrusion_color プロパティを使用します。

shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 200, 200)
shape.three_d_format.camera.set_rotation(20, 30, 40)
shape.three_d_format.extrusion_height = 100
shape.three_d_format.extrusion_color.color = drawing.Color.purple
# ... 他の 3D シーン パラメータを設定

with slide.get_image(image_scale, image_scale) as thumbnail:
    thumbnail.save("sample_3d.png")

PowerPoint では通常、Depth メニューを使用して 3D シェイプの深さを設定します。

todo:image_alt_text

3D グラデーション

グラデーションは PowerPoint 3D シェイプの塗りつぶしに使用できます。ここでは、グラデーション塗りつぶしを持つシェイプを作成し、3D 効果を適用します。

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
    shape.text_frame.text = "3D Gradient"
    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 64

    shape.fill_format.fill_type = slides.FillType.GRADIENT
    shape.fill_format.gradient_format.gradient_stops.add(0, drawing.Color.blue)
    shape.fill_format.gradient_format.gradient_stops.add(100, drawing.Color.orange)
   
    shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
    shape.three_d_format.camera.set_rotation(10, 20, 30)
    shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.FLAT
    shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    shape.three_d_format.extrusion_height = 150
    shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange
   
    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("sample_3d.png")

結果は次のとおりです。

todo:image_alt_text

グラデーション塗りつぶしに加えて、画像でシェイプを塗りつぶすこともできます。

with open("image.png", "rb") as image_file:
    image_data = image_file.read()

    shape.fill_format.fill_type = slides.FillType.PICTURE
    shape.fill_format.picture_fill_format.picture.image = presentation.images.add_image(image_data)
    shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH
    # ... 3D の設定: shape.three_d_format.camera, shape.three_d_format.light_rig, shape.three_d_format.Extrusion* プロパティ

    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("sample_3d.png")

その様子は次のとおりです。

todo:image_alt_text

3D テキスト (WordArt)

Aspose.Slides はテキストにも 3D 効果を適用できます。3D テキストを作成するには、WordArt の変形効果を使用します。

import aspose.pydrawing as drawing
import aspose.slides as slides

image_scale = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 150, 250, 250)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
    shape.text_frame.text = "3D text"
   
    portion = shape.text_frame.paragraphs[0].portions[0]
    portion.portion_format.fill_format.fill_type = slides.FillType.PATTERN
    portion.portion_format.fill_format.pattern_format.fore_color.color = drawing.Color.dark_orange
    portion.portion_format.fill_format.pattern_format.back_color.color = drawing.Color.white
    portion.portion_format.fill_format.pattern_format.pattern_style = slides.PatternStyle.LARGE_GRID
   
    shape.text_frame.paragraphs[0].paragraph_format.default_portion_format.font_height = 128
   
    text_frame_format = shape.text_frame.text_frame_format
    # "Arch Up" WordArt変形効果を設定
    text_frame_format.transform = slides.TextShapeType.ARCH_UP

    text_frame_format.three_d_format.extrusion_height = 3.5
    text_frame_format.three_d_format.depth = 3
    text_frame_format.three_d_format.material = slides.MaterialPresetType.PLASTIC
    text_frame_format.three_d_format.light_rig.direction = slides.LightingDirection.TOP
    text_frame_format.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
    text_frame_format.three_d_format.light_rig.set_rotation(0, 0, 40)
    text_frame_format.three_d_format.camera.camera_type = slides.CameraPresetType.PERSPECTIVE_CONTRASTING_RIGHT_FACING
   
    with slide.get_image(image_scale, image_scale) as thumbnail:
        thumbnail.save("text3d.png")

    presentation.save("text3d.pptx", slides.export.SaveFormat.PPTX)

結果は次のとおりです。

todo:image_alt_text

FAQ

プレゼンテーションを画像/PDF/HTML にエクスポートするとき、3D 効果は保持されますか？

はい。Slides の 3D エンジンは、サポートされている形式へのエクスポート時に 3D 効果をレンダリングします（images、PDF、HTML など）。

テーマや継承などを考慮した「実効」(最終) の 3D パラメータ値を取得できますか？

はい。Slides は実効値の読み取り用 API を提供しており、3D の照明やベベルなどの最終設定を確認できます。

プレゼンテーションを動画に変換するとき、3D 効果は機能しますか？

はい。動画用フレーム生成時にも、3D 効果はエクスポート画像と同様にレンダリングされます。

Python でプレゼンテーションの表示プロパティを取得および更新する Python でプレゼンテーションの VBA プロジェクトを管理する