Java를 사용한 프레젠테이션에서 그림 프레임 관리

이 페이지의 내용

Aspose.Slides for Java를 사용하여 프레젠테이션에서 그림 프레임을 만들고, 서식 지정하고, 연결하고, 자르고, 추출하고, 압축합니다.

개요

그림 프레임은 이미지를 표시하는 슬라이드 도형입니다. Aspose.Slides에서는 이미지 리소스와 이를 표시하는 도형이 별개의 객체입니다: Presentation은 IImageCollection을 통해 삽입된 이미지 리소스를 소유하고, IPictureFrame은 이미지의 위치, 크기, 선 서식, 회전, 자르기, 그림 효과 및 기타 프레임 수준 설정을 제어합니다.

같은 이미지를 여러 번 표시할 때 이 분리가 유용합니다. 이미지를 프레젠테이션에 한 번 추가하고 반환된 IPPImage를 보관한 뒤, 그림 프레임을 만들 때 해당 이미지 리소스를 사용합니다.

그림 프레임은 PNG 또는 JPEG와 같은 래스터 이미지와 SVG와 같은 벡터 이미지를 포함할 수 있습니다. 또한 프레젠테이션에 이미지 바이트를 저장하는 대신 링크된 이미지를 참조할 수도 있습니다. 선택은 휴대성, 파일 크기, 추출 및 내보내기 동작에 영향을 미치므로 서식 지정이나 최적화를 적용하기 전에 이미지 저장 방식을 결정하는 것이 좋습니다.

삽입된 이미지 추가 및 서식 지정

삽입된 이미지의 경우 이미지 데이터를 프레젠테이션에 추가하고 IShapeCollection.addPictureFrame을 사용하여 그림 프레임을 생성합니다. 이미지는 프레젠테이션 패키지의 일부가 되므로 프레젠테이션을 다른 컴퓨터로 이동해도 자체 포함된 상태를 유지합니다.

다음 예제는 JPEG 이미지를 추가하고, 이미지의 기본 크기로 프레임을 만든 뒤, 선 서식과 회전을 적용합니다:

import com.aspose.slides.*;
import java.awt.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.jpg");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    pictureFrame.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    pictureFrame.getLineFormat().setWidth(3);
    pictureFrame.setRotation(15);

    presentation.save("picture-frame.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

그림 프레임은 표시된 기하학을 제어합니다; 프레임 크기를 변경해도 삽입된 이미지 리소스에 저장된 원본 픽셀 크기는 변하지 않습니다. 이 구분은 나중에 이미지를 자르거나 압축할 때 중요해집니다.

상대 스케일 사용

IPictureFrame은 setRelativeScaleWidth 및 setRelativeScaleHeight을 통해 프레임에 대한 상대 너비와 높이 스케일을 제공한다. 값 1.0은 원본 그림 크기의 100%에 해당합니다. 상대 스케일은 워크플로에서 최종 크기를 직접 계산하지 않고 원본 이미지 크기와의 비율을 유지해야 할 때 유용합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.jpg");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, image);
    pictureFrame.setRelativeScaleWidth(1.35f);
    pictureFrame.setRelativeScaleHeight(0.8f);

    presentation.save("relative-scale.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

상대 스케일은 프레임의 스케일 설정을 변경하지만, 삽입된 이미지를 재샘플링하거나 압축하지는 않습니다.

삽입 이미지와 연결 이미지

삽입된 그림은 이미지 데이터를 프레젠테이션 내부에 저장하므로 휴대성과 예측 가능한 렌더링 측면에서 가장 안전한 선택입니다. 연결된 그림은 ISlidesPicture.setLinkPathLong 메서드를 사용해 외부 위치를 저장하므로 이미지 데이터를 동일한 방식으로 삽입하지 않습니다.

연결된 이미지는 PPTX에 저장되는 이미지 데이터 양을 줄일 수 있지만 외부 종속성을 도입합니다. 연결 파일은 프레젠테이션을 열거나 렌더링하는 애플리케이션에서 계속 접근 가능해야 합니다. 경로가 변경되거나 파일이 이동되거나 리소스를 사용할 수 없게 되면 연결된 그림이 예상대로 표시되지 않을 수 있습니다. 이메일로 전송하거나 보관하거나 격리된 환경에서 렌더링해야 하는 프레젠테이션의 경우, 삽입된 이미지가 보통 더 신뢰됩니다.

연결 이미지 추가

다음 예제는 그림 프레임을 만들고 로컬 이미지 파일을 가리키도록 설정합니다. 이 예제는 이미지 연결만 다루며, 비디오 연결은 별도의 미디어 워크플로이며 의도적으로 혼합되지 않았습니다.

import com.aspose.slides.*;
import java.io.File;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 320, 180, null);
    File linkedImageFile = new File("linked-image.jpg");
    String linkPath = linkedImageFile.getAbsolutePath();
    pictureFrame.getPictureFormat().getPicture().setLinkPathLong(linkPath);

    presentation.save("linked-image.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

외부 파일 관리를 의도적으로 할 경우에만 링크를 사용하십시오. 압축을 대신하는 용도로 사용하면 안 됩니다: 깨진 이미지 종속성을 가진 작은 PPTX는 일반적으로 자체 포함된 큰 프레젠테이션보다 덜 유용합니다.

그림 프레임에서 이미지 추출

기존 프레젠테이션에서 이미지를 추출하기 전에 해당 도형이 실제로 IPictureFrame인지, 삽입된 이미지를 포함하고 있는지 확인하십시오. 연결된 그림 프레임은 같은 방식으로 추출할 수 있는 이미지 바이트를 포함하지 않을 수 있습니다.

래스터 이미지 추출

최신 이미지 API는 IImage을 직접 사용하며 이전 Java 이미지 래퍼가 필요하지 않습니다. 다음 예제는 슬라이드에서 첫 번째 삽입된 래스터 그림을 찾아 PNG로 저장합니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IPictureFrame)) {
            continue;
        }

        IPictureFrame pictureFrame = (IPictureFrame) shape;
        IPPImage embeddedImage = pictureFrame.getPictureFormat().getPicture().getImage();
        if (embeddedImage == null || embeddedImage.getSvgImage() != null) {
            continue;
        }

        IImage rasterImage = embeddedImage.getImage();
        try {
            rasterImage.save("extracted-image.png", ImageFormat.Png);
        } finally {
            rasterImage.dispose();
        }
        break;
    }
} finally {
    presentation.dispose();
}

IImage.save을 통해 저장하면 추출된 이미지를 원하는 출력 형식으로 변환합니다. 프레젠테이션에 저장된 인코딩된 바이트가 필요하면 이미지 리소스의 바이너리 데이터를 사용하십시오.

SVG 이미지 추출

SVG 그림의 경우 IPPImage이 ISvgImage 객체를 노출합니다. 이를 통해 SVG 데이터를 직접 가져올 수 있어 먼저 그림을 래스터화할 필요가 없습니다.

import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.IOException;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    for (IShape shape : slide.getShapes()) {
        if (!(shape instanceof IPictureFrame)) {
            continue;
        }

        IPictureFrame pictureFrame = (IPictureFrame) shape;
        IPPImage embeddedImage = pictureFrame.getPictureFormat().getPicture().getImage();
        ISvgImage svgImage = embeddedImage != null ? embeddedImage.getSvgImage() : null;
        if (svgImage == null) {
            continue;
        }

        byte[] svgData = svgImage.getSvgData();
        FileOutputStream outputStream = new FileOutputStream("extracted-image.svg");
        try {
            outputStream.write(svgData);
        } finally {
            outputStream.close();
        }
        break;
    }
} finally {
    presentation.dispose();
}

SVG 내용을 SVG 그대로 유지하면 프레젠테이션 내에 벡터 소스를 보존할 수 있습니다. PNG 또는 JPEG와 같은 래스터 내보내기는 해당 벡터 내용을 픽셀로 렌더링합니다. PDF 또는 SVG 슬라이드 내보내기도 렌더링 작업이므로, 내보낸 그래픽을 원본 삽입된 SVG의 바이트 단위 복사본으로 취급해서는 안 됩니다; 원본 벡터 리소스가 필요할 때는 삽입된 ISvgImage.getSvgData 데이터를 사용하십시오.

이미지 자르기

자르기는 프레임 내부에서 이미지의 어느 부분이 보일지를 변경합니다. IPictureFillFormat의 자르기 값은 원본 이미지 차원의 백분율입니다. 자르기는 처음에 숨겨진 픽셀을 삽입된 이미지에서 삭제하지 않고, 보이는 영역만 변경합니다.

다음 예제는 그림 프레임을 안전하게 찾고 자르기 값을 적용합니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        pictureFrame.getPictureFormat().setCropLeft(23.6f);
        pictureFrame.getPictureFormat().setCropRight(21.5f);
        pictureFrame.getPictureFormat().setCropTop(3f);
        pictureFrame.getPictureFormat().setCropBottom(31f);
        presentation.save("cropped-image.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

숨겨진 이미지 데이터가 여전히 존재하므로, 원본 픽셀을 손실하지 않고 나중에 자르기 값을 변경할 수 있습니다. 파일 크기가 더 중요하고 되돌릴 필요가 없을 경우, 다음 섹션에서 설명하는 대로 자른 영역을 물리적으로 제거할 수 있습니다.

잘라낸 이미지 데이터 삭제

IPictureFillFormat.deletePictureCroppedAreas는 현재 자르기 사각형 외부의 이미지 데이터를 제거하고 결과 이미지 리소스를 반환합니다. 이는 파일 크기를 줄일 수 있지만 파괴적인 최적화이며, 프레젠테이션을 저장한 후에는 삭제된 픽셀을 다시 복원할 수 없습니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation("cropped-image.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IPPImage croppedImage = pictureFrame.getPictureFormat().deletePictureCroppedAreas();
        if (croppedImage != null) {
            presentation.save("cropped-data-removed.pptx", SaveFormat.Pptx);
        }
    }
} finally {
    presentation.dispose();
}

이 메서드는 프레젠테이션에 새로운 이미지 리소스를 추가할 수 있습니다. 원본 이미지가 다른 그림 프레임에서도 사용 중이라면 해당 프레임은 기존 리소스를 계속 필요로 하므로, 잘라낸 영역을 삭제해도 전체 이미지 수가 반드시 감소하는 것은 아닙니다. WMF 또는 EMF 콘텐츠를 이 메서드로 자르면 결과가 PNG로 래스터화됩니다.

래스터 이미지 압축

IPictureFillFormat.compressImage은 그림이 표시되는 크기에 비례하여 래스터 이미지 해상도를 낮춥니다. 같은 작업에서 잘라낸 영역을 제거할 수도 있습니다. 메서드는 이미지가 크기 조정 또는 잘라내기된 경우 true를, 변경이 필요하지 않은 경우 false를 반환합니다.

표준 목표 해상도가 충분할 때는 미리 정의된 PicturesCompression 값을 사용하십시오:

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        boolean compressed = pictureFrame.getPictureFormat().compressImage(true, PicturesCompression.Dpi150);
        System.out.println(compressed ? "The image was compressed." : "No compression was necessary.");
        presentation.save("compressed-image.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

특정 목표가 필요할 경우 미리 정의된 값 대신 양의 DPI 값을 직접 전달할 수 있습니다.

압축은 래스터 이미지에만 적용됩니다. SVG 및 메타파일 내용은 이 래스터 압축 워크플로로 줄어들지 않습니다. 또한 낮은 해상도와 삭제된 잘라낸 영역은 최적화된 프레젠테이션에서 복구할 수 없음을 기억하십시오. 전체적으로 가장 낮은 DPI를 적용하기보다는 이미지가 실제로 표시되거나 내보내질 가장 큰 크기를 기준으로 목표 해상도를 선택하십시오.

이미지 변형 효과 관리

밝기, 대비, 색상 변환, 블러, 알파 효과, 순서 체인, 검사, 제거 및 라운드 트립 검증을 포괄하는 전체 워크플로는 Image Transform Effects를 참조하십시오.

그림 프레임 기하학 잠금

IPictureFrameLock 설정은 그림 프레임에 대해 어떤 편집 작업이 비활성화되는지를 제어합니다. 예를 들어, setAspectRatioLocked은 크기를 조정할 때 도형 비율을 유지합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.jpg");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 100, image.getWidth(), image.getHeight(), image);
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);

    presentation.save("locked-picture-frame.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

잠금은 그림 프레임 도형에만 적용되며, 원본 이미지를 재샘플링하거나 영구적으로 같은 비율로 변경하도록 강제하지는 않습니다.

StretchOffset 값 조정

그림 채우기 모드가 stretch인 경우, IPictureFillFormat의 stretch‑offset 값은 그림 프레임 경계 상자에 대한 채우기 사각형을 정의합니다. 양의 백분율은 가장자리에서 내부로 inset을 만들고, 음의 백분율은 외부로 outset을 만듭니다.

이는 자르기와 다릅니다. 자르기 값은 원본 이미지 중 어느 부분이 보이는지를 선택하고, stretch offset은 보이는 그림 채우기가 늘어나는 사각형을 변경합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 10, 10, 400, 300, image);
    pictureFrame.getPictureFormat().setPictureFillMode(PictureFillMode.Stretch);
    pictureFrame.getPictureFormat().setStretchOffsetLeft(12f);
    pictureFrame.getPictureFormat().setStretchOffsetRight(12f);
    pictureFrame.getPictureFormat().setStretchOffsetTop(8f);
    pictureFrame.getPictureFormat().setStretchOffsetBottom(8f);

    presentation.save("stretch-offsets.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

채우기 위치를 지정할 때 stretch offset을 사용하십시오. 이미지 가장자리 숨기기가 목표라면 자르기 속성을 사용하십시오.

스토리지, 파일 크기 및 내보내기 고려 사항

이미지 스토리지와 그림 프레임 서식을 별도로 처리하면 주요 트레이드오프를 더 쉽게 관리할 수 있습니다:

삽입된 이미지는 프레젠테이션을 자체 포함하게 만들며, 공유 및 서버‑사이드 렌더링에 가장 신뢰할 수 있습니다. 하지만 큰 래스터 이미지는 PPTX 크기와 메모리 사용량을 증가시킵니다.
연결된 이미지는 패키지를 작게 유지할 수 있지만, 프레젠테이션은 지정된 경로나 위치에 외부 파일이 계속 존재해야 합니다.
자르기는 처음에 비파괴적입니다. 숨겨진 픽셀은 잘라낸 영역을 명시적으로 삭제하거나 압축 중에 제거하기 전까지는 삽입된 상태로 남아 있습니다.
압축은 과도한 래스터 이미지의 파일 크기를 크게 줄일 수 있지만, 원본 해상도를 포기하게 됩니다. 슬라이드에서 실제 표시될 크기를 파악한 후 적용해야 합니다.
SVG 이미지는 벡터 보존이 중요할 때 SVG 형태로 유지해야 합니다. 벡터 리소스 자체가 필요할 경우 삽입된 SVG를 직접 추출하십시오. 래스터 슬라이드 내보내기는 항상 렌더링된 슬라이드를 픽셀로 변환합니다.
반복 이미지는 가능한 경우 기존 [IPPImage] 리소스를 재사용하고, 동일한 파일을 프레젠테이션 워크플로에 반복 로드하지 않도록 하십시오.

대규모 프레젠테이션에서는 이미지 최적화를 선택적으로 수행하는 것이 일반적으로 가장 효과적입니다: 로고와 다이어그램은 벡터 콘텐츠로 유지하고, 사진은 실제 표시 크기에 따라 압축하고, 나중에 편집이 필요하지 않을 경우에만 잘라낸 픽셀을 제거하며, 의존성 관리가 배포 설계에 포함되지 않는 한 외부 링크는 피하십시오.

FAQ

그림 프레임과 이미지 리소스의 차이점은 무엇인가요?

[IPPImage]는 프레젠테이션과 연결된 이미지 리소스를 나타냅니다. [IPictureFrame]은 슬라이드에 삽입된 이미지와 프레임 수준의 기하학 및 서식(크기, 회전, 자르기 값, 효과, 잠금 등)을 저장하는 도형입니다.

이미지를 삽입할까요, 링크할까요?

프레젠테이션을 휴대 가능하게 하거나 보관·외부 리소스 없이 렌더링해야 하는 경우 이미지를 삽입하십시오. 이미지 파일을 PPTX 외부에 두는 것이 의도적이며 외부 위치를 안정적으로 유지할 수 있는 경우에만 이미지를 링크하십시오.

자르기가 PPTX 파일 크기를 감소시키나요?

그 자체로는 감소시키지 않습니다. 일반적인 자르기 설정은 원본 이미지의 일부를 숨기지만 기본 픽셀은 유지합니다. 픽셀을 영구적으로 삭제하려면 [IPictureFillFormat.deletePictureCroppedAreas] 또는 잘라낸 영역을 제거하는 이미지 압축을 사용하십시오.

압축 후 이미지 품질을 복구할 수 있나요?

아니요. 압축은 저장된 래스터 해상도를 낮추고, 잘라낸 영역을 제거하면 이미지 데이터가 사라집니다. 나중에 고해상도 편집이 필요할 경우 원본 이미지를 프레젠테이션 외부에 보관하십시오.

SVG 이미지는 어떻게 다루어야 하나요?

벡터 정확도가 중요할 때 SVG 콘텐츠를 SVG 그대로 유지하십시오. 삽입된 [ISvgImage]를 직접 추출할 수 있습니다. PNG 또는 JPEG와 같은 래스터 형식으로 슬라이드를 렌더링하면 SVG가 해당 슬라이드 이미지의 픽셀로 변환됩니다.

기존 슬라이드를 읽을 때 안전하지 않은 캐스트를 피하려면 어떻게 해야 하나요?

도형 유형을 확인한 후 그림 프레임 전용 멤버를 사용하십시오. [IPictureFrame]에 대한 instanceof 검사는 잘못된 캐스트를 방지하고 그림 프레임이 없는 슬라이드를 올바르게 처리할 수 있게 해줍니다.

Java로 프레젠테이션에서 이미지 변환 효과 관리