Java에서 PDF에 도형 추가 단계

1. Maven 저장소 및 종속성 추가 - Conholdate Maven 저장소와 conholdate-total 종속성을 pom.xml에 포함합니다. 이렇게 하면 PdfDocument 및 ShapeFactory와 같은 SDK 클래스들을 사용할 수 있습니다.

   <repositories>
       <repository>
           <id>conholdate-repo</id>
           <name>Conholdate Maven Repository</name>
           <url>https://repository.conholdate.com/repo/</url>
       </repository>
   </repositories>
   

2. PDF 문서 로드 - PdfDocument 인스턴스를 생성하고 대상 PDF 파일을 엽니다. 이 클래스는 API 참조에 문서화되어 있습니다.

PdfDocument pdf = new PdfDocument();
pdf.open("input.pdf");

3. 도형 객체 만들기 - ShapeFactory를 사용하여 사각형, 타원 또는 선을 인스턴스화합니다. 위치, 크기 및 시각적 속성을 설정합니다.

// Rectangle
Shape rect = ShapeFactory.createRectangle(100, 150, 200, 100);
rect.setFillColor(Color.BLUE);
rect.setStrokeColor(Color.BLACK);
rect.setLineWidth(2);

// Ellipse
   Shape ellipse = ShapeFactory.createEllipse(350, 150, 150, 100);
   ellipse.setFillColor(Color.GREEN);
   ellipse.setStrokeColor(Color.DARK_GRAY);
   ellipse.setLineWidth(1.5f);

// Line
   Shape line = ShapeFactory.createLine(100, 300, 500, 300);
   line.setStrokeColor(Color.RED);
   line.setLineWidth(3);

4. 페이지에 도형 추가 - 문서에서 원하는 페이지를 가져와 각 도형을 해당 페이지의 그래픽 컬렉션에 추가합니다.

Page page = pdf.getPages().get_Item(0); // first page
page.getGraphics().addShape(rect);
page.getGraphics().addShape(ellipse);
page.getGraphics().addShape(line);

5. 업데이트된 PDF 저장 - 모든 도형이 추가된 후, 문서를 새 파일에 저장합니다.

   pdf.save("output.pdf");
   pdf.close();
   

Java에서 PDF에 도형 추가 - 전체 코드 예제

다음 예제는 모든 단계를 하나의 실행 가능한 프로그램으로 결합합니다.

import com.conholdate.total.pdf.*;
import com.conholdate.total.pdf.shapes.*;
import java.awt.Color;

public class AddShapesDemo { public static void main(String[] args) throws Exception { // PDF 문서 초기화 PdfDocument pdf = new PdfDocument(); pdf.open(“input.pdf”);

// Create rectangle Shape rectangle = ShapeFactory.createRectangle(100, 150, 200, 100); rectangle.setFillColor(Color.BLUE); rectangle.setStrokeColor(Color.BLACK); rectangle.setLineWidth(2);

// Create ellipse Shape ellipse = ShapeFactory.createEllipse(350, 150, 150, 100); ellipse.setFillColor(Color.GREEN); ellipse.setStrokeColor(Color.DARK_GRAY); ellipse.setLineWidth(1.5f);

// 선 만들기 Shape line = ShapeFactory.createLine(100, 300, 500, 300); line.setStrokeColor(Color.RED); line.setLineWidth(3);

// 첫 페이지에 도형 추가
Page page = pdf.getPages().get_Item(0);
page.getGraphics().addShape(rectangle);
page.getGraphics().addShape(ellipse);
page.getGraphics().addShape(line);

// 결과 저장
pdf.save("output.pdf");
pdf.close();
}
}

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로(input.pdf, output.pdf)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

Installation and Setup in Java

Conholdate.Total for Java를 사용하려면 공식 사이트에서 최신 릴리스를 다운로드하고 앞에서 보여준 Maven 의존성을 추가합니다. SDK는 Java 8+ 런타임에서 작동하며 추가 네이티브 라이브러리가 필요하지 않습니다.

• 다운로드 URL: Conholdate.Total for Java Release
• 문서: 자세한 사용 방법은 공식 문서에서 확인할 수 있습니다.
• 라이선스: 임시 라이선스 페이지에서 임시 라이선스를 얻거나, 가격 페이지에서 전체 가격을 확인하십시오.

주요 기능 및 개요

Conholdate.Total를 사용하여 Java에서 PDF에 도형 추가

Conholdate.Total for Java은 PDF 콘텐츠를 생성하고 편집하기 위한 통합 API를 제공합니다. 도형 그리기 기능은 벡터 그래픽을 사용하여 추가된 요소가 어떤 확대 수준에서도 선명하게 유지됩니다. 기본 도형(사각형, 타원, 선)뿐만 아니라 복잡한 경로도 그릴 수 있습니다.

Conholdate.Total이 이 작업에 중요한 기능

• Cross‑platform compatibility: Windows, Linux 및 macOS 서버에서 작동합니다.
• High‑performance rendering: 도형은 네이티브 PDF 콘텐츠를 생성하는 동일한 엔진으로 렌더링되어 래스터화를 방지합니다.
• Full control over appearance: 채우기 색상, 스트로크 색상, 선 두께, 불투명도 및 blend 모드를 설정합니다.
• Layered graphics: 도형을 특정 레이어 또는 그룹에 추가하여 이후 조작을 쉽게 합니다.

최적 렌더링을 위한 도형 속성 구성

도형을 추가할 때 원하는 시각적 결과를 얻기 위해 다음 속성을 고려하십시오:

• Position and Size: 절대 좌표(포인트) 또는 페이지 크기에 대한 비율(퍼센트)을 사용합니다.
• Colors: SDK는 java.awt.Color 객체를 허용합니다. 투명도를 위해서는 new Color(r, g, b, alpha)를 사용하십시오.
• Line Width: 포인트 단위로 측정되며, 값 1은 1/72 인치에 해당합니다.
• Opacity and Blend Mode: setOpacity(float) 및 setBlendMode(BlendMode)로 조정합니다.
• Rotation and Skew: 고급 레이아웃을 위해 setRotation(double) 또는 setSkew(double, double)를 사용하여 변환을 적용합니다.

고급 속성 설정 예시:

ellipse.setOpacity(0.7f);
ellipse.setBlendMode(BlendMode.MULTIPLY);
ellipse.setRotation(45);

PDF에 도형을 추가할 때 성능 고려 사항

많은 벡터 객체를 추가하면 처리 시간과 메모리 사용량이 증가할 수 있습니다. 다음 지침을 따르세요:

• Batch Drawing: 페이지에 추가하기 전에 관련된 도형들을 하나의 그래픽 컨테이너로 그룹화합니다.
• Reuse Objects: 여러 페이지에 동일한 도형이 필요할 경우, 새 인스턴스를 만들지 말고 기존 도형을 복제합니다.
• Avoid Over‑Scaling: 비용이 많이 드는 래스터 변환을 방지하기 위해 최종 표시 크기로 도형을 정의합니다.
• Dispose Resources: 네이티브 리소스를 해제하기 위해 PdfDocument를 즉시 닫습니다.

Conclusion

Conholdate.Total for Java은 Java 개발자에게 PDF 문서에 도형을 추가하는 간단한 방법을 제공하여 풍부하고 인터랙티브한 보고서와 인보이스를 만들 수 있게 합니다. 이 가이드의 단계, 구성 팁 및 성능 지침을 따라 하면 PDF 워크플로에 벡터 그래픽을 자신 있게 통합할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보하는 것을 기억하세요; 평가용 임시 라이선스를 사용할 수 있으며 전체 가격 정보는 가격 페이지에 나와 있습니다.

FAQ

PDF에서 도형에 사용자 정의 글꼴을 추가하려면 어떻게 해야 하나요?
TrueType 글꼴을 pdf.getFonts().addFont("MyFont.ttf") 로 임베드한 다음 setFont(myFont) 를 사용하여 도형에 할당할 수 있습니다. SDK는 해당 글꼴이 최종 PDF에 포함되도록 보장합니다.

기존 PDF에 기존 내용을 잃지 않고 도형을 삽입할 수 있나요?
예. PdfDocument.open()으로 PDF를 열면 모든 기존 페이지와 객체가 보존됩니다. 페이지의 그래픽 컬렉션에 도형을 추가하면 페이지가 보강될 뿐이며 기존 내용을 덮어쓰지 않습니다.

도형을 추가한 후 어떤 파일 형식으로 내보낼 수 있나요?
Conholdate.Total for Java는 PDF, PDF/A, PDF/X로 저장하는 것을 지원하며, 또한 PNG, JPEG, BMP와 같은 이미지 형식으로도 저장할 수 있습니다. 필요에 따라 pdf.save("output.pdf") 또는 pdf.save("output.png", ImageSaveOptions.Png)를 사용하십시오.