우리는 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 페이지에서 어셈블리를 다운로드하세요.