Python を使用したプレゼンテーションの 3D 効果作成

概要

Aspose.Slides for Python via .NET は、シェイプやテキストに対して PowerPoint 形式の 3D 書式設定を作成、編集、保持、およびレンダリングできます。この記事では、回転、押し出し、ベベル、照明、素材、グラデーションまたは画像塗りつぶし、そして 3D テキストなどの 3D 効果について説明します。

この記事は PowerPoint のシェイプとテキストに対する 3D 書式設定効果についてです。単独の 3D モデルファイルの挿入や編集については扱いません。スライドを画像、PDF、または HTML にエクスポートすると、Aspose.Slides はそれらの 3D 効果をエクスポートされた 2D 出力にレンダリングします。

3D 書式概念

シェイプに 3D 書式を適用するには、Shape.three_d_format プロパティを使用します。このプロパティは ThreeDFormat を公開し、シェイプの 3D シーンを制御します。

テキストの場合は、TextFrameFormat.three_d_format プロパティを使用します。これはシェイプ本体ではなくテキストフレームに 3D 書式を適用します。

最も重要なプロパティは次のとおりです:

プロパティ	制御内容	使用する場面
camera	視点、プリセットカメラタイプ、回転、ズーム、遠近感。	3D 空間でオブジェクトを回転させたり、PowerPoint の 3D 回転プリセットに合わせたりする場合。
light_rig	ライトプリセット、方向、ライトの回転。	3D 表面のハイライトや影の見え方を変更する場合。
material	フラット、マット、プラスチック、金属などの表面素材。	同じ形状を平坦、柔らかい、光沢のある、または金属的に見せたい場合。
extrusion_height	前面から後方へシェイプがどれだけ伸びるか。	平面のシェイプを視覚的に厚みのある 3D オブジェクトに変える場合。
extrusion_color	押し出された側面の色。	奥行きを見せたり、側面の色を前面の塗りつぶしと合わせたりする場合。
depth	PowerPoint の 3D 書式で使用される追加の奥行き。	シェイプやテキストの奥行きを微調整する場合、特にベベルや素材設定と組み合わせるとき。
bevel_top と bevel_bottom	前面と背面のエッジを持ち上げたり丸めたりする。	鋭利な平面の代わりに、柔らかく成形されたエッジを加えたい場合。
contour_color と contour_width	3D オブジェクトの輪郭線。	レンダリング結果でオブジェクトの境界を強調したい場合。

3D シェイプの作成

シェイプが説得力のある 3D に見えるようになるには、通常次の 4 種類の設定が必要です:

カメラ設定 – デフォルトの正面ビューでは押し出しが隠れることがあるため。
ライト設定 – 照明が面や側面を読みやすくするため。
素材設定 – 表面が光の当たり方に影響を与えるため。
押し出しまたは奥行き設定 – 平面シェイプに厚みを持たせるため。

以下の例は長方形を作成し、前面にテキストを追加し、3D 書式を適用し、プレゼンテーションを PPTX として保存し、スライドを PNG 画像としてレンダリングします。

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.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = drawing.Color.cornflower_blue

    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("shape_3d.png")

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

レンダリングされたスライド画像は、長方形が厚みのある 3D ブロックとして表示されます:

前面に白い 3D テキストがある青い 3D 長方形のレンダリング結果

カメラでシェイプを回転する

PowerPoint では、3D 回転は「3-D 回転」ペインから設定します。X、Y、Z の回転値はカメラ API を介して設定する回転に対応しています。

X、Y、Z 回転値が強調表示された PowerPoint の 3-D 回転ペイン

Aspose.Slides では、ThreeDFormat.camera を使用してカメラタイプと回転を設定します:

shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
shape.three_d_format.camera.set_rotation(20, 30, 40)

ビューアがオブジェクトを見る方向を変更したいときにカメラを使用します。スライド上の 2D シェイプのジオメトリは変更せず、PowerPoint および Aspose.Slides がレンダリング時に使用する 3D 視点を変更します。

押し出しと奥行きを追加する

押し出しはシェイプの前面の背後に拡張することで厚みを持たせます。PowerPoint では、奥行きコントロールがこの可視厚さを設定し、色コントロールが側面の色を設定します。

PowerPoint の奥行きコントロールが押し出しの色と押し出し高さプロパティに対応している様子

厚さには ThreeDFormat.extrusion_height を、側面の色には ThreeDFormat.extrusion_color を設定します:

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

PowerPoint の奥行き値を直接操作したい場合や、奥行きをベベル、素材、テキスト効果と組み合わせたい場合は ThreeDFormat.depth を使用します。多くのシェイプシナリオでは、可視的な押し出しを直接示す ThreeDFormat.extrusion_height の方が分かりやすい設定です。

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.material = slides.MaterialPresetType.FLAT
    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("gradient_3d.png")

レンダリング結果は前面のグラデーションを保持し、押し出しは別個に描画されます:

青からオレンジへのグラデーション塗りとオレンジの押し出しを持つ 3D 長方形のレンダリング結果

画像塗りつぶしを使用する場合は、プレゼンテーションに画像を追加し、シェイプの塗りつぶしに割り当てます:

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

image = presentation.images.add_image(image_data)

shape.fill_format.fill_type = slides.FillType.PICTURE
shape.fill_format.picture_fill_format.picture.image = image
shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

shape.three_d_format.camera.set_rotation(10, 20, 30)
shape.three_d_format.extrusion_height = 150
shape.three_d_format.extrusion_color.color = drawing.Color.dark_orange

画像は前面にレンダリングされ、押し出しは 3D 側面として描画されます:

前面に写真塗りつぶし、側面にオレンジの押し出しを持つ 3D 長方形のレンダリング結果

テキストに 3D 書式を適用する

シェイプの 3D 書式はシェイプ本体に影響します。テキストの 3D 書式はテキストフレームに影響します。文字自体に押し出し、素材、照明、カメラ設定が必要な WordArt のような効果に便利です。

次の例はパターン塗りつぶしのテキストを作成し、WordArt 変形を適用し、TextFrameFormat の 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.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
    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("text_3d.png")

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

テキストは曲線状に押し出された 3D 文字としてレンダリングされます:

アーチ状の WordArt 変形、オレンジのパターン塗り、暗い押し出しを持つ 3D テキストのレンダリング結果

エクスポートとレンダリングの動作

Aspose.Slides は PPTX などの PowerPoint フォーマットに保存するときに 3D 書式を保持します。固定レイアウト形式にレンダリングまたはエクスポートする場合、3D シーンはラスタライズされ、2D の結果として出力に描画されます。これはスライドを PNG にレンダリングする場合、PDF にエクスポートする場合、HTML にエクスポートする場合、またはビデオ変換用のフレームを生成する場合に適用されます。

留意点:

エクスポートされた画像や PDF はインタラクティブではありません。エクスポート後にビューアがオブジェクトを回転させることはできません。
最終的な外観はカメラ、ライトリグ、素材、押し出し、塗りつぶし、スライドの拡大縮小の組み合わせに依存します。
継承された設定やテーマベースの書式値を確認する必要がある場合は、effective shape properties を参照してください。
一部の出力形式は編集可能な PowerPoint 3D 書式を保存できません。そのような形式では、視覚的結果がレンダリングされ、編集可能な 3D 設定としては保持されません。

FAQ

Aspose.Slides はインタラクティブな 3D プレゼンテーションを作成できますか？

Aspose.Slides はシェイプとテキストの PowerPoint 3D 効果を作成およびレンダリングしますが、エクスポートされた画像、PDF、HTML ページをビューアが回転できるインタラクティブな 3D シーンにすることはできません。PPTX では、フォーマットがサポートしている限り、3D 書式は PowerPoint で編集可能なまま保持されます。

3D モデルと 3D 効果の違いは何ですか？

3D モデルはプレゼンテーションに挿入される別個の 3D オブジェクトです。3D 効果は、回転、押し出し、ベベル、照明、素材などの通常の PowerPoint シェイプまたはテキストに適用される書式です。この記事では 3D 効果について扱います。

見える 3D シェイプに必要な設定は何ですか？

最低限、カメラの回転と押し出しまたは奥行きを設定します。実務では、ハイライトと影をはっきりさせるためにライトリグと素材も設定するのが一般的です。

シェイプとテキストの両方に 3D 効果を適用できますか？

はい。シェイプ本体には Shape.three_d_format を、テキストには TextFrameFormat.three_d_format を使用します。

画像、PDF、HTML、ビデオフレームにエクスポートするときに 3D 効果は表示されますか？

はい。Aspose.Slides はスライド画像、PDF 出力、HTML 出力、ビデオ変換用フレームを生成する際に 3D 効果をレンダリングします。エクスポートされた出力にはレンダリングされた外観が含まれ、編集可能な 3D オブジェクトは含まれません。

継承やテーマ設定が適用された後の最終的な 3D 値を取得できますか？

はい。最終的なカメラ、ライトリグ、ベベル、その他の 3D 値を取得するには、Shape Effective Properties で説明されている有効書式 API を使用してください。

Python でアニメーションを使用して PowerPoint プレゼンテーションを強化する PythonでプレゼンテーションのVBAプロジェクトを管理する