Extract Images from DOCX with C# using IronWord

IronWord 로 시작하기

워드 문서에서 이미지를 추출하는 방법은 무엇인가요?

IronWord 사용하면 Word 문서에서 이미지를 추출하는 것이 간단합니다. 파일 embedded_images.docx는 3개의 다른 페이지에 5개의 이미지를 포함하는 예제 파일로 사용됩니다. 아래 코드 스니펫은 ExtractImages() 메서드를 사용한 이미지 추출 프로세스의 핵심 워크플로를 정의합니다.

문서 처리 라이브러리를 사용할 때는 애플리케이션이 사용 약관을 준수하는지 확인하기 위해 라이선스 요구 사항을 이해하는 것이 필수적입니다. IronWord 다른 Iron 제품과 유사한 라이선스 체계를 따르며, 포괄적인 지원 옵션과 함께 영구 라이선스를 제공합니다. 실제 운영 환경에 배포하려면 워터마크나 제한 사항을 제거하기 위해 라이선스 키를 적용해야 합니다.

:path=/static-assets/word/content-code-examples/how-to/extract-images-properties.cs

using System;
using IronWord;
using IronSoftware.Drawing;

// Load an existing Word document
WordDocument doc = new WordDocument("embedded_images.docx");

// Extract all images from the document
var images = doc.ExtractImages();

// Iterate through extracted images
int count = 0;
foreach (var image in images)
{
    // Save each image to disk
    string fileName = $"extracted-image-{count}.png";
    ((AnyBitmap)image.Image).SaveAs(fileName);

    Console.WriteLine($"Extracted image {count}:");
    Console.WriteLine($"Width: {image.Width}");
    Console.WriteLine($"Height: {image.Height}");
    Console.WriteLine($"Saved as: {fileName}");

    count++;
}

Console.WriteLine($"Total images extracted: {count}");

ExtractImages 메서드는 각 이미지 데이터와 메타데이터를 포함한 전체 이미지 데이터를 포함하는 이미지 객체의 열거 가능한 컬렉션을 반환합니다. 이미지를 저장하려면 ((AnyBitmap)image.Image).SaveAs()를 사용하여 SaveAs 메서드에 액세스할 수 있도록 Image 속성을 AnyBitmap로 캐스트해야 합니다. 이 작업은 네임스페이스 선언에 using IronSoftware.Drawing;를 추가해야 합니다.

이러한 접근 방식을 통해 유연한 처리 워크플로우를 구현할 수 있습니다. 위에서 보여준 것처럼 이미지를 디스크에 저장하거나, 다른 형식으로 변환하거나, 클라우드 스토리지 서비스로 직접 스트리밍할 수 있습니다. 이 메서드는 JPEG, PNG, BMP, GIF를 포함하여 Word 문서에 일반적으로 포함된 다양한 이미지 형식을 처리합니다.

샘플 문서는 어떤 모습인가요?

어떤 결과가 나올 것으로 예상해야 할까요?

추출된 이미지는 원본 형식(예: .jpg, .png 또는 기타 형식)을 유지하며 적절한 파일 확장자로 저장할 수 있습니다. 문서의 모든 이미지를 순회하거나 필요에 따라 특정 섹션을 대상으로 이미지를 선택할 수 있습니다.

고급 이미지 추출 시나리오

IronWord는 기본적인 이미지 추출 기능을 넘어, 개발자들이 실제 애플리케이션에서 자주 접하는 여러 고급 이미지 처리 시나리오를 지원합니다.

여러 문서 일괄 처리 : 대규모 문서 모음을 처리할 때 병렬 처리를 통해 여러 Word 파일에서 이미지를 동시에 추출할 수 있습니다. 이러한 접근 방식은 문서 보관소 또는 콘텐츠 마이그레이션 프로젝트의 처리 시간을 크게 단축합니다.

이미지 형식 변환 : 추출된 이미지 객체는 형식 간 변환을 지원합니다. 워드 문서에서 JPEG 이미지를 추출하여 웹 최적화를 위해 PNG로 저장하거나, 최신 브라우저와의 호환성을 위해 WebP로 변환할 수 있습니다.

메타데이터 보존 : 추출된 각 이미지는 크기, 해상도, 색심도 등 중요한 메타데이터를 유지합니다. 이 정보는 이미지 최적화 파이프라인을 구현하거나 애플리케이션 전반에 걸쳐 품질 표준을 유지할 때 유용합니다.

지속적인 지원과 정기적인 업데이트가 필요한 Enterprise 애플리케이션의 경우, 새로운 기능에 대한 지속적인 접근과 우선 지원을 제공하는 라이선스 연장을 고려해 보십시오. 프로젝트 범위가 확장될 경우, 업그레이드 옵션을 통해 추가 개발자 또는 배포 위치로 원활하게 확장할 수 있습니다.

문서 워크플로와의 통합

이미지 추출은 종종 더 큰 문서 처리 워크플로의 일부를 구성합니다. 다음과 같은 일반적인 통합 패턴을 고려해 보세요.

콘텐츠 관리 시스템 : 문서 업로드 중 이미지를 추출하여 미리보기 이미지를 생성하거나, 이미지 갤러리를 구축하거나, 미디어 라이브러리를 채울 수 있습니다. 추출된 이미지는 검색 기능을 위해 색인화하거나 문서 메타데이터로 태그를 지정할 수 있습니다.

문서 변환 파이프라인 : 워드 문서를 다른 형식으로 변환할 때, 추출된 이미지는 최적의 품질을 위해 별도로 처리할 수 있습니다. 이러한 분리를 통해 형식별 최적화가 가능해집니다. 예를 들어 웹 출력과 인쇄 출력에 서로 다른 압축 설정을 적용할 수 있습니다.

품질 보증 워크플로우 : 자동 추출 기능을 통해 내장된 이미지를 체계적으로 검토하여 브랜드 가이드라인, 해상도 요구 사항 또는 파일 크기 제한을 준수하는지 확인할 수 있습니다. 게시하기 전에 해상도가 낮은 이미지나 잘못된 형식이 포함된 문서를 표시할 수 있습니다.

문서 처리 기능의 최신 기능 및 개선 사항을 확인하려면 제품 변경 로그를 정기적으로 확인하십시오. 새로운 릴리스에는 종종 성능 향상 및 확장된 형식 지원이 포함되어 이미지 추출 워크플로에 도움이 될 수 있습니다.

성능 고려 사항

이미지 수가 많거나 고해상도 이미지가 포함된 문서를 작업할 때는 다음과 같은 성능 최적화 전략을 고려하십시오.

메모리 관리 : 모든 이미지를 동시에 메모리에 로드하는 대신 이미지를 일괄 처리합니다. 이러한 접근 방식은 대용량 문서나 고해상도 이미지를 처리할 때 메모리 부족 현상을 방지합니다.

비동기 처리 : 특히 추출된 이미지를 디스크나 네트워크 저장소에 저장할 때 I/O 작업에 async/await 패턴을 구현하십시오. 이렇게 하면 장시간 추출 작업 중에도 애플리케이션의 응답성을 유지할 수 있습니다.

선택적 추출 : 특정 이미지만 필요한 경우, 불필요한 콘텐츠 처리를 방지하기 위해 이미지 속성이나 문서 구조를 기반으로 필터를 구현하는 것을 고려해 보세요.

견고한 API 설계 덕분에 다양한 문서 유형과 이미지 형식에서 일관된 동작을 보장하므로 .NET 애플리케이션에 안정적인 이미지 추출 기능을 손쉽게 구축할 수 있습니다.