[java] Java Apache FOP로 생성된 PDF의 품질 및 해상도 조정 방법

23 Nov 2023

java

Apache FOP는 Java로 작성된 오픈 소스 XSL-FO(Extensible Stylesheet Language Formatting Objects) 프로세서입니다. 이는 XML 기반의 문서를 가지고 PDF, PostScript, AFP, PCL 등 다양한 형식의 출력물로 변환할 수 있도록 지원합니다.

Apache FOP로 생성된 PDF의 품질과 해상도는 출력 결과의 세부 사항을 조정하여 제어할 수 있습니다. PDF의 품질은 이미지의 해상도 및 압축 수준 등에 영향을 받으며, 해상도는 출력물의 선명도와 세부 사항을 결정합니다.

이제 Java Apache FOP로 생성된 PDF의 품질과 해상도를 조정하는 방법에 대해 알아보겠습니다.

1. 이미지 해상도 조정

Apache FOP에서 생성된 PDF의 이미지 해상도는 기본적으로 72dpi입니다. 이는 보통 화면 출력용으로 적합한 해상도이지만, 인쇄용으로 사용되는 경우에는 더 높은 해상도가 필요할 수 있습니다.

이를 위해 FOP 설정 파일인 “fop.xconf”에서 Image 사용 전략을 변경할 수 있습니다. 다음 코드를 fop.xconf 파일에 추가하여 해상도를 조정할 수 있습니다:

<renderers>
  <renderer mime="application/pdf">
    <fonts>
      <!-- Define your fonts here -->
    </fonts>
    <image-resolution>300</image-resolution>
  </renderer>
</renderers>

위 예시에서 image-resolution 엘리먼트의 값을 300으로 변경하였습니다. 이는 이미지의 해상도를 300dpi로 설정하는 것입니다. 원하는 해상도로 값을 조정하여 적용할 수 있습니다.

2. 이미지 압축 수준 조정

Apache FOP에서 생성된 PDF의 이미지 압축 수준 역시 품질에 영향을 미칩니다. 이미지의 압축 수준을 높일 경우 파일 크기는 줄어들지만, 이미지의 품질은 손상될 수 있습니다. 반대로 압축 수준을 낮출 경우 파일 크기는 증가하지만 이미지의 품질은 향상될 수 있습니다.

FOP 설정 파일인 “fop.xconf”에서 이미지 압축 수준을 조정할 수 있습니다. 다음 코드를 fop.xconf 파일에 추가하여 압축 수준을 조정할 수 있습니다:

<renderers>
  <renderer mime="application/pdf">
    <fonts>
      <!-- Define your fonts here -->
    </fonts>
    <image-compression>JPEG</image-compression>
    <pdf-version>1.4</pdf-version>
  </renderer>
</renderers>

위 예시에서 image-compression 엘리먼트의 값을 JPEG로 설정하였습니다. JPEG 이미지 형식은 압축률을 조절할 수 있으며, 다른 이미지 형식(BMP, PNG 등)을 사용할 수도 있습니다. 또한, pdf-version 엘리먼트를 추가하여 생성된 PDF의 버전을 지정할 수도 있습니다.

3. 폰트 및 텍스트 처리

PDF의 품질과 해상도 조정은 이미지뿐만 아니라 텍스트에도 영향을 미칩니다. 폰트의 크기와 스타일, 그림자 효과 등을 조정하여 출력물의 품질을 향상시킬 수 있습니다.

폰트 및 텍스트 처리를 위해 FOP 설정 파일인 “fop.xconf”에서 Fonts 구성을 추가하거나 수정할 수 있습니다. 다음 코드를 fop.xconf 파일에 추가하여 폰트 및 텍스트 처리를 조정할 수 있습니다:

<renderers>
  <renderer mime="application/pdf">
    <fonts>
      <font metrics-url="Arial.xml" kerning="yes" embed-url="fonts/Arial.ttf">
        <font-triplet name="Arial" style="normal" weight="normal" />
      </font>
      <!-- Define your other fonts here -->
    </fonts>
    <!-- Other renderer settings -->
  </renderer>
</renderers>

위 예시에서는 Arial 폰트를 사용하도록 설정한 것입니다. Fonts 구성을 추가하여 원하는 폰트를 지정하고, font-triplet 엘리먼트에 폰트 이름, 스타일 및 두께 등을 설정할 수 있습니다. 폰트 파일도 지정할 수 있으며, metrics-url과 embed-url 엘리먼트를 사용하여 URL이나 파일 경로를 설정할 수 있습니다.

마무리

Java Apache FOP를 사용하여 생성된 PDF의 품질과 해상도 조정은 이미지 해상도, 이미지 압축 수준, 폰트 및 텍스트 처리 등 다양한 요소에 의해 결정됩니다. 위의 방법들을 조합하여 원하는 출력물의 품질과 해상도를 얻을 수 있으니, 필요에 따라 적절한 설정을 적용해 보시기 바랍니다.

자세한 정보와 더 많은 설정 옵션은 Apache FOP 공식 문서를 참조하시면 도움이 될 것입니다.

참고 자료:

Apache FOP 공식 문서: https://xmlgraphics.apache.org/fop/
XSL-FO(Extensible Stylesheet Language Formatting Objects): https://www.w3.org/TR/xslfo20/