Java에서 검색 가능한 텍스트 레이어가 포함된 Word를 PNG로 변환

이 포괄적인 가이드에서는 GroupDocs.Viewer for Java를 사용하여 숨겨진 선택 가능한 텍스트 레이어를 유지하면서 Word를 PNG로 변환하는 방법을 배웁니다. 동일한 기술은 PDF에도 적용되어 고해상도 이미지 미리보기를 제공하며 완전히 검색 가능하므로 빠른 렌더링이 필요하면서도 검색 가능성을 포기할 수 없는 웹 포털, CMS 시스템 및 아카이브 솔루션에 적합합니다.

GroupDocs.Viewer for Java를 사용한 텍스트 레이어가 있는 문서 이미지 렌더링

GroupDocs.Viewer for Java를 사용한 텍스트 레이어가 있는 문서 이미지 렌더링

빠른 답변

  • convert Word to PNG가 의미하는 바는 무엇인가요? 각 페이지마다 래스터 PNG를 생성하고 보이지 않는 텍스트 오버레이를 삽입하여 내용이 검색 가능하도록 합니다.
  • 텍스트 레이어를 추가하는 이유는? 오버레이는 OCR 없이도 브라우저와 검색 엔진이 텍스트를 색인하도록 하여 접근성과 SEO를 향상시킵니다.
  • 어떤 라이브러리가 이를 처리합니까? GroupDocs.Viewer for Java는 이미지 렌더링과 텍스트 추출을 모두 지원합니다.
  • 라이선스가 필요합니까? 개발에는 무료 체험판으로 충분하며, 프로덕션 배포에는 유료 라이선스가 필요합니다.
  • PDF에도 같은 코드를 사용할 수 있나요? 예—뷰어를 PDF에 지정하고 동일한 텍스트 오버레이 옵션을 활성화하면 됩니다.

텍스트 레이어가 있는 Word를 PNG로 변환이란?

텍스트 레이어가 있는 Word를 PNG로 변환은 각 DOCX 페이지를 PNG 이미지로 렌더링하고 검색 가능하도록 보이지 않는 텍스트 오버레이를 삽입합니다.
이 프로세스는 Word 문서를 고해상도 이미지 집합으로 변환하면서 원본 텍스트를 화면 판독기와 검색 크롤러가 접근할 수 있게 유지합니다. 결과는 정적인 그림처럼 보이지만, 픽셀 뒤에 숨겨진 레이어에 텍스트가 존재하므로 복사·붙여넣기 또는 검색이 가능합니다.

이 작업에 GroupDocs.Viewer를 사용하는 이유

GroupDocs.Viewer는 픽셀 단위로 완벽한 PNG 출력 및 자동으로 검색 가능한 텍스트 오버레이를 추가하여 별도의 OCR 단계가 필요 없게 합니다. 렌더링 엔진은 스트리밍 방식으로 문서를 처리하므로 수백 페이지 파일도 전체 파일을 메모리에 로드하지 않고 처리할 수 있습니다. 이 라이브러리는 DOCX, PDF, PPTX, XLSX 및 일반 이미지 형식을 포함한 70개 이상의 입력 및 출력 형식을 지원하여 다양한 문서 파이프라인을 위한 원스톱 솔루션을 제공합니다.

  • 고품질 PNG 출력은 원본 레이아웃을 픽셀 단위로 그대로 복제합니다.
  • 자동 텍스트 오버레이 추출은 직접 OCR을 구현할 필요를 없애줍니다.
  • 간단한 API—몇 줄의 Java 코드만으로 전체 워크플로를 처리합니다.
  • 광범위한 형식 지원—같은 접근 방식이 PDF, PPTX 및 기타 많은 형식에서도 작동합니다.
  • 향상된 문서 선명도는 벡터 그래픽과 폰트를 보존하는 무손실 렌더링 엔진 덕분입니다.

사전 요구 사항

  • Java Development Kit (JDK) 8 이상이 설치 및 구성되어 있어야 합니다.
  • Maven을 사용한 의존성 관리.
  • Java 파일 처리 및 Maven 프로젝트 구조에 대한 기본 지식.

GroupDocs.Viewer for Java 설정

설치 정보

Maven 프로젝트에 GroupDocs.Viewer를 추가하려면 pom.xml에 저장소와 의존성을 삽입하십시오:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득

무료 체험판은 GroupDocs.Viewer를 다운로드 페이지에서 다운로드하여 시작하십시오. 프로덕션 사용을 위해서는 라이선스를 구매하거나 임시 라이선스 페이지에서 임시 키를 얻으십시오.

기본 초기화 및 설정

Viewer 클래스는 문서를 로드하고 지정된 보기 옵션에 따라 렌더링하는 핵심 구성 요소입니다. Maven 동기화가 완료되면 Viewer 인스턴스를 생성할 수 있으며, 이 객체가 렌더링 프로세스를 담당합니다.

Word를 PNG로 변환하는 단계별 가이드

단계 1: 출력 디렉터리 정의

먼저, 뷰어에 생성된 PNG 파일을 저장할 위치를 알려야 합니다. 아래 코드는 YOUR_OUTPUT_DIRECTORY라는 폴더를 생성(또는 재사용)합니다.

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

팁: 폴더를 자동으로 생성하려면 Files.createDirectories(outputDirectory);를 사용하십시오.

단계 2: 보기 옵션 구성

PngViewOptions는 각 페이지를 PNG로 렌더링하는 방식을 설정하고 텍스트 추출을 활성화할 수 있습니다. setExtractText(true)를 호출하면 GroupDocs.Viewer가 모든 이미지에 보이지 않는 텍스트 레이어를 삽입하도록 지시합니다.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");
PngViewOptions viewOptions = new PngViewOptions(pageFilePathFormat);
viewOptions.setExtractText(true);  // Enable extracting text over the image

단계 3: 문서 렌더링

viewer.view(viewOptions) 호출은 원본 DOCX를 열고 PNG 페이지를 생성합니다. try‑with‑resources 블록은 Viewer 인스턴스를 적절히 닫아 모든 네이티브 리소스를 해제함을 보장합니다.

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    viewer.view(viewOptions);  // Perform rendering operation
}

프로세스가 완료되면 Word 문서의 각 페이지가 보이지 않는 텍스트 레이어가 포함된 고해상도 PNG로 나타나며, 인덱싱 및 검색이 가능합니다.

이것이 중요한 이유

검색 가능한 텍스트 레이어를 삽입하면 가벼운 이미지 미리보기를 제공 및 전체 텍스트 검색 가능성을 유지할 수 있습니다. 이는 특히 다음과 같은 경우에 유용합니다:

  1. 웹 포털은 SEO를 희생하지 않고 빠른 썸네일 미리보기가 필요합니다.
  2. 콘텐츠 관리 시스템은 아카이브 스냅샷을 저장하지만 여전히 텍스트 인덱싱이 필요합니다.
  3. 문서 아카이빙은 저장 비용이 문제이지만 검색 가능성은 높게 유지되어야 합니다.

일반적인 문제 및 해결책

  • 파일을 찾을 수 없음: SAMPLE_DOCX 경로를 다시 확인하십시오. 절대 경로를 사용하는 것이 안전합니다.
  • 권한 문제: Java 프로세스가 YOUR_OUTPUT_DIRECTORY에 쓸 수 있는지 확인하십시오.
  • 버전 불일치: pom.xml에 지정된 버전이 다운로드한 라이브러리와 일치하는지 확인하십시오.
  • 텍스트 레이어 누락: viewOptions.setExtractText(true)가 설정되어 있고 출력 폴더에 쓰기 권한이 있는지 확인하십시오.

실용적인 적용 사례

  1. 웹 포털: 사용자가 원본 파일을 다운로드하지 않고도 검색할 수 있는 문서 미리보기를 표시합니다.
  2. 콘텐츠 관리 시스템: 아카이브 목적을 위해 검색 가능한 이미지 스냅샷을 저장합니다.
  3. 문서 아카이빙: 가벼운 이미지 버전을 유지하면서 전체 텍스트 검색을 가능하게 합니다.

성능 고려 사항

  • Viewer 객체를 즉시 해제하십시오(try‑with‑resources 예시와 같이).
  • 품질을 위해 PNG를 선택하고, 대역폭이 문제라면 JPEG로 전환하십시오.
  • 동일한 문서가 반복 요청될 때 렌더링된 페이지를 캐시하십시오.

자주 묻는 질문

Q: 대용량 문서는 어떻게 처리하나요?
A: 페이지를 점진적으로 렌더링하고 배치 처리 후 각 Viewer 인스턴스를 해제하여 메모리 사용량을 낮게 유지합니다.

Q: 동일한 방법으로 PDF를 렌더링할 수 있나요?
A: 예, GroupDocs.Viewer는 PDF를 지원하며 동일한 setExtractText(true) 플래그가 검색 가능한 PDF 이미지를 생성합니다.

Q: 출력에 텍스트 레이어가 보이지 않으면 어떻게 하나요?
A: viewOptions.setExtractText(true)가 설정되어 있고 출력 폴더에 쓰기 권한이 있는지 확인하십시오.

Q: 다른 이미지 형식도 지원하나요?
A: PNG 외에도 뷰 옵션 클래스를 교체하여 JpgViewOptions 또는 BmpViewOptions를 사용할 수 있습니다.

Q: 자세한 API 문서는 어디서 찾을 수 있나요?
A: 공식 문서에서 포괄적인 예제와 구성 세부 정보를 제공합니다.

리소스

마지막 업데이트: 2026-08-30
테스트 환경: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs

관련 튜토리얼