우리는 GroupDocs.Comparison for .NET v26.10의 출시를 기쁘게 발표합니다. 이 버전은 2026년 10월부터 사용할 수 있습니다. 이번 릴리스에서는 OCR 기반 이미지 비교—픽셀 데이터가 아니라 인식된 텍스트를 기준으로 이미지를 비교—를 도입했으며, 스프레드시트 비교에 대한 주요 수정 및 향상 기능을 포함합니다. 여기에는 성능 개선 및 행 높이, 숫자 셀 유형, 삭제된 행에 대한 올바른 처리 등이 포함됩니다. 추가 개선 사항은 PDF, Word, TXT 및 HTML 비교 결과에 걸쳐 있습니다.

이번 릴리스의 새로운 기능

  • COMPARISONNET-4844 | 기능 | 인식된 텍스트(OCR)로 이미지 비교
  • COMPARISONNET-4944 | 기능 | 스프레드시트 비교를 위한 StyleSettings에서 HighlightColor 지원
  • COMPARISONNET-4945 | 🔧 수정 | 동일한 파일이라도 XLSX 비교에 몇 분이 걸리는 문제 수정
  • COMPARISONNET-4940 | 🔧 수정 | 삭제된 한 행이 XLSX 비교에서 이후 모든 행을 변경된 것으로 표시하는 문제 수정
  • COMPARISONNET-4946 | 🔧 수정 | 고정 15pt 높이를 강제하는 대신 자동 높이 행을 유지
  • COMPARISONNET-4947 | 🔧 수정 | 스프레드시트 비교 결과에서 숫자 셀 유형을 유지
  • COMPARISONNET-4943 | 향상 | Excel 비교에서 짧은 텍스트 문자열을 완전히 교체하는 것을 방지
  • COMPARISONNET-4931 | 향상 | PDF 비교에서 교체된 텍스트를 삭제된 후 삽입된 것으로 표시
  • COMPARISONNET-4927 | 향상 | TXT 비교 출력에서 삭제 및 삽입된 구성 요소의 순서를 정규화
  • COMPARISONNET-4935 | 향상 | HTML 미리보기 생성에서 임시 경로 사용을 제거
  • COMPARISONNET-4936 | 🔧 수정 | HTML 파일 렌더링 시 PreviewOptions에서 PageNumbers 속성이 무시되는 문제 수정
  • COMPARISONNET-4926 | 🔧 수정 | 표가 포함된 Word 문서를 비교할 때 문서 비교가 충돌하는 문제 수정
  • COMPARISONNET-4923 | 🔧 수정 | 텍스트 비교의 HTML 결과에서 줄 바꿈이 사라지는 문제 수정
  • COMPARISONNET-4917 | 향상 | 내부 개선 사항 집합

공개 API 변경 사항

새로운 OcrOptions 클래스가 GroupDocs.Comparison.Options 네임스페이스에 추가되었으며, 새로운 CompareOptions.Ocr 속성을 통해 노출됩니다.

멤버 유형 설명
Enabled bool true이면 인식된 텍스트를 비교하고, false이면 이미지를 픽셀로 비교합니다. 기본값은 false입니다.
DisplayMode OcrDisplayMode OcrDisplayMode에 따라 비교 결과가 배치됩니다. 기본값은 OcrDisplayMode.SideBySide입니다.
Language OcrLanguage 문서가 작성된 언어 또는 스크립트입니다. 기본값은 OcrLanguage.Latin입니다.
DisableResourceDownloads bool true이면 필요한 인식 모델이 로컬에 없을 때 실패하고, false이면 다운로드합니다. 기본값은 false입니다.
ResourcesPath string 인식 모델이 들어 있는 폴더이며, null이면 기본 위치를 사용합니다.

새로운 OcrDisplayMode 열거형은 인식된 텍스트를 비교한 결과가 어떻게 배치되는지를 제어합니다:

값 설명
SideBySide 기본 모드입니다. 원본 레이아웃을 유지하면서 소스와 대상이 나란히 표시된 이미지를 생성하고, 서로 다른 부분을 표시합니다.
Text 두 문서의 인식된 텍스트를 일반 텍스트로 표시하는 이미지를 생성하며, 삭제 및 삽입된 단어를 강조합니다. 원본 문서의 레이아웃(글꼴, 표, 열, 이미지)은 재현되지 않습니다.

새로운 기능

인식된 텍스트(OCR)로 이미지 비교

GroupDocs.Comparison은 이제 이미지에 인식된 텍스트를 기준으로 이미지를 비교할 수 있습니다. 이전에는 두 이미지를 픽셀 단위로 비교했으며, 몇 픽셀만 이동하거나 품질이 달라 재저장된 스캔, 다른 스캐너로 만든 경우 전체에 차이가 있다고 보고되었습니다. OCR 비교를 활성화하면 두 이미지에서 먼저 텍스트를 인식한 뒤 텍스트로 비교하므로, 결과에 실제 변경된 문구가 표시됩니다.

이를 통해 스캔된 계약서, 스크린샷, 사진으로 촬영한 문서 및 기타 이미지 전용 파일을 의미 있게 비교할 수 있습니다.

Note: OCR 비교는 .NET Framework에서는 사용할 수 없습니다.

스프레드시트 비교를 위한 StyleSettings에서 HighlightColor 지원

StyleSettings의 HighlightColor 속성이 이제 스프레드시트를 비교할 때 적용되어, 변경된 셀을 표시하는 배경색을 다른 형식과 동일하게 사용자 지정할 수 있습니다.

코드 예제

OCR 기반 비교를 나란히 배치하도록 활성화하려면:

using (Comparer comparer = new Comparer("source.png"))
{
    var options = new CompareOptions
    {
        Ocr = new OcrOptions
        {
            Enabled = true,
            DisplayMode = OcrDisplayMode.SideBySide
        },
        GenerateSummaryPage = false
    };

    comparer.Add("target.png");
    var result = comparer.Compare("result.png", options);
}

일반 텍스트 결과를 얻고 로컬 폴더의 Cyrillic 언어 모델을 사용하려면:

using (Comparer comparer = new Comparer("source.png"))
{
    var options = new CompareOptions
    {
        Ocr = new OcrOptions
        {
            Enabled = true,
            DisplayMode = OcrDisplayMode.Text,
            Language = OcrLanguage.Cyrillic,
            ResourcesPath = @"C:\ocr-models",
            DisableResourceDownloads = true
        },
        GenerateSummaryPage = false
    };

    comparer.Add("target.png");
    comparer.Compare("result.png", options);
}

스프레드시트 비교에서 강조 색상을 사용자 지정하려면:

using (Comparer comparer = new Comparer("source.xlsx"))
{
    comparer.Add("target.xlsx");

    var options = new CompareOptions
    {
        InsertedItemStyle = new StyleSettings { HighlightColor = Color.LightGreen },
        DeletedItemStyle  = new StyleSettings { HighlightColor = Color.LightPink }
    };

    comparer.Compare("result.xlsx", options);
}

업데이트 받는 방법

NuGet

NuGet을 통해 최신 GroupDocs.Comparison 패키지로 업그레이드하세요:
GroupDocs.Comparison 26.10.0

.NET CLI를 사용하여 설치:

dotnet add package GroupDocs.Comparison --version 26.10.0

직접 다운로드

GroupDocs.Comparison for .NET 26.10 Release Notes 페이지에서 어셈블리를 다운로드하세요.

리소스