Aspose.Slides FOSS
Java
개발자 가이드
3D and Visual Effects

3D 효과 및 시각 효과 작업 — Aspose.Slides FOSS for Java

Aspose.Slides FOSS for Java는 모든 도형에서 액세스할 수 있는 두 개의 별도 효과 시스템을 제공합니다:

  • EffectFormat (shape.getEffectFormat()): 2D 시각 효과: 그림자, 글로우, 부드러운 가장자리, 블러, 반사
  • ThreeDFormat (shape.getThreeDFormat()): 3D 외관: 베벨, 카메라 투영, 라이트 릭, 재질, 압출 깊이

두 경우 모두 저장/재로드 사이클에서 지속됩니다.

시각 효과 (EffectFormat)

외부 그림자 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.drawing.Color;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 100, 100, 300, 120);
    shape.addTextFrame("Shadowed Text");

    var ef = shape.getEffectFormat();
    ef.enableOuterShadowEffect();
    ef.getOuterShadowEffect().setBlurRadius(10);      // softness in points
    ef.getOuterShadowEffect().setDirection(315);       // angle: 315 = upper-left cast
    ef.getOuterShadowEffect().setDistance(8);          // offset in points
    ef.getOuterShadowEffect().getShadowColor().setColor(Color.fromArgb(128, 0, 0, 0));  // semi-transparent black

    prs.save("shadow.pptx", SaveFormat.PPTX);
}

공통 direction 값: 0 = 오른쪽, 45 = 오른쪽 아래, 90 = 아래, 270 = 위, 315 = 왼쪽 위.

글로우 효과 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.drawing.Color;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.ELLIPSE, 150, 100, 200, 200);

    var ef = shape.getEffectFormat();
    ef.enableGlowEffect();
    ef.getGlowEffect().setRadius(15);
    ef.getGlowEffect().getColor().setColor(Color.fromArgb(255, 255, 215, 0));  // gold

    prs.save("glow.pptx", SaveFormat.PPTX);
}

소프트 엣지 (페더링 테두리) 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 100, 100, 350, 180);

    var ef = shape.getEffectFormat();
    ef.enableSoftEdgeEffect();
    ef.getSoftEdgeEffect().setRadius(12);   // feather radius in points

    prs.save("soft-edge.pptx", SaveFormat.PPTX);
}

블러 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 100, 100, 350, 180);

    shape.getEffectFormat().setBlurEffect(8, true);

    prs.save("blur.pptx", SaveFormat.PPTX);
}

효과 확인 및 제거 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 100, 100, 200, 100);
    var ef = shape.getEffectFormat();

    ef.enableOuterShadowEffect();
    ef.enableGlowEffect();
    System.out.println("Has effects: " + !ef.isNoEffects());  // true

    ef.disableOuterShadowEffect();
    ef.disableGlowEffect();
    System.out.println("Has effects: " + !ef.isNoEffects());  // false
}

3D 서식 (ThreeDFormat)

베벨 효과 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.BevelPresetType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 150, 150, 250, 120);
    shape.addTextFrame("3D Button");

    var tdf = shape.getThreeDFormat();
    tdf.getBevelTop().setBevelType(BevelPresetType.CIRCLE);
    tdf.getBevelTop().setWidth(12);
    tdf.getBevelTop().setHeight(6);

    prs.save("bevel.pptx", SaveFormat.PPTX);
}

BevelPresetType 값: CIRCLE, RELAXED_INSET, COOL_SLANT, DIVOT, RIBLET, HARD_EDGE, SLOPE, CONVEX

카메라 프리셋 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.BevelPresetType;
import org.aspose.slides.foss.CameraPresetType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 150, 150, 250, 120);
    var tdf = shape.getThreeDFormat();
    tdf.getBevelTop().setBevelType(BevelPresetType.CIRCLE);
    tdf.getBevelTop().setWidth(10);
    tdf.getCamera().setCameraType(CameraPresetType.PERSPECTIVE_ABOVE);
    prs.save("camera.pptx", SaveFormat.PPTX);
}

라이트 리그 및 재질 

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.BevelPresetType;
import org.aspose.slides.foss.CameraPresetType;
import org.aspose.slides.foss.LightRigPresetType;
import org.aspose.slides.foss.LightingDirection;
import org.aspose.slides.foss.MaterialPresetType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.RECTANGLE, 150, 150, 250, 120);
    shape.addTextFrame("Metal Button");

    var tdf = shape.getThreeDFormat();
    tdf.getBevelTop().setBevelType(BevelPresetType.CIRCLE);
    tdf.getBevelTop().setWidth(10);
    tdf.getBevelTop().setHeight(5);
    tdf.getCamera().setCameraType(CameraPresetType.PERSPECTIVE_ABOVE);
    tdf.getLightRig().setLightType(LightRigPresetType.BALANCED);
    tdf.getLightRig().setDirection(LightingDirection.TOP);
    tdf.setMaterial(MaterialPresetType.METAL);
    tdf.setDepth(20);

    prs.save("3d-metal.pptx", SaveFormat.PPTX);
}

MaterialPresetType 값: MATTE, WARM_MATTE, PLASTIC, METAL, FLAT, SOFT_EDGE, CLEAR

2D 및 3D 효과 결합

같은 도형에 getEffectFormat()와 getThreeDFormat()를 모두 적용할 수 있습니다:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.BevelPresetType;
import org.aspose.slides.foss.CameraPresetType;
import org.aspose.slides.foss.MaterialPresetType;
import org.aspose.slides.foss.drawing.Color;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    var shape = prs.getSlides().get(0).getShapes().addAutoShape(ShapeType.ROUND_CORNER_RECTANGLE, 150, 150, 300, 120);
    shape.addTextFrame("Premium Card");

    // Solid fill
    shape.getFillFormat().setFillType(FillType.SOLID);
    shape.getFillFormat().getSolidFillColor().setColor(Color.fromArgb(255, 30, 80, 180));

    // 3D bevel
    var tdf = shape.getThreeDFormat();
    tdf.getBevelTop().setBevelType(BevelPresetType.CIRCLE);
    tdf.getBevelTop().setWidth(8);
    tdf.getCamera().setCameraType(CameraPresetType.PERSPECTIVE_ABOVE);
    tdf.setMaterial(MaterialPresetType.PLASTIC);

    // Drop shadow
    var ef = shape.getEffectFormat();
    ef.enableOuterShadowEffect();
    ef.getOuterShadowEffect().setBlurRadius(12);
    ef.getOuterShadowEffect().setDirection(270);
    ef.getOuterShadowEffect().setDistance(6);
    ef.getOuterShadowEffect().getShadowColor().setColor(Color.fromArgb(80, 0, 0, 0));

    prs.save("premium-card.pptx", SaveFormat.PPTX);
}

참고

 한국어