FONT 레코드 여덟 개를 지닌 BIFF8 워크북에 폰트 필드가 8인 XF 레코드가 들어 있습니다. 0부터 세면 테이블 끝의 한 칸 뒤인데도 Excel은 불만 없이 그 셀을 여덟 번째 폰트로 렌더링합니다. 그 값은 합법입니다. [MS-XLS] §2.5.129는 처음 네 FONT 레코드를 0부터 3까지 매기고 4를 통째로 건너뛴 뒤, 이후의 모든 레코드를 1 기반 위치로 매깁니다
그래서 다섯 번째 FONT 레코드가 ifnt 5이고, 잘 만들어진 파일은 자기 FONT 레코드 개수보다 큰 값을 필요로 하지 않습니다. 이 규칙은 스펙의 오타처럼 읽히는데, 바로 그래서 사람들이 "고친" 적이 있는 것이고, 셀 서식, 공유 문자열 rich text, 주석 run이 전부 같은 FontIndex 타입을 나르므로 경로마다 읽기가 달라지면 어떤 폰트는 바르게, 어떤 폰트는 한 레코드 어긋나게 묶입니다. BIFF8 XLUnicodeString cch와 fHigh 디코딩의 길이와 인코딩 기벽과 같은 계열입니다. 파일은 멀쩡하고 파일에 대한 읽기가 틀렸을 뿐입니다
[MS-XLS] §2.5.129가 말하는 것, 그리고 실제 파일로 검사하는 방법
[MS-XLS] §2.5.129는 FontIndex를 구멍이 뚫린 레코드 위치로 정의합니다. 4 미만은 zero-based, 4 초과는 one-based이고 값 4는 MUST NOT, 즉 쓰면 안 됩니다. XF 레코드가 이것으로 폰트를 가리키고, rich 공유 문자열의 FormatRun 항목이 이것을 쓰며, §2.5.272가 묘사하는 TXO 서식 run도 마찬가지입니다
스펙 말을 그대로 믿을 필요는 없습니다. Excel이 직접 저장한 .xls를 BIFF 레코드 뷰어로 덤프하고, FONT 레코드(레코드 타입 $0031)를 센 뒤, 모든 XF 레코드($00E0) 앞부분의 폰트 필드를 훑으세요. 최댓값은 레코드 개수 안에 머물고 목록에는 4가 없습니다. 4가 나오거나 FONT 개수를 넘는 값이 나오면 그 파일은 Excel이 아닌 무언가가 쓴 것이므로 폰트 번호 매기기를 자세히 볼 가치가 있습니다. 진단 도구나 테스트라면 매핑 전체가 두 함수에 들어갑니다
// 자작 헬퍼, 어느 라이브러리에도 속하지 않음
// [MS-XLS] 2.5.129 FontIndex: 0..3은 zero-based, > 4는 one-based, 4는 invalid
function FontIndexToRecordNo(Ifnt: Word): Integer; // 1 기반 FONT 레코드
begin
if Ifnt < 4 then
Result := Ifnt + 1
else if Ifnt > 4 then
Result := Ifnt
else
Result := -1; // 4는 나와서는 안 된다
end;
function RecordNoToFontIndex(RecordNo: Integer): Word;
begin
if RecordNo <= 4 then
Result := RecordNo - 1
else
Result := RecordNo;
end;
HotXLS가 XF 레코드와 rich text run의 폰트에 번호를 매기는 방법
HotXLS는 모든 BIFF8 폰트 참조를 스펙 번호로 읽고 씁니다. 저장 시 폰트 테이블은 실제로 참조되는 폰트로 압축되고, 살아남은 각 폰트의 위치가 FontIndex가 됩니다. 위치 1~4는 0~3으로 쓰이고 위치 5 이상은 그대로 나갑니다. 로드는 이를 되돌려, 5 이상의 값은 메모리에서 폰트를 찾으려고 하나 내려오고 5 미만은 제자리입니다. 같은 변환이 XF 레코드, 공유 문자열 테이블의 rich text run, 주석과 텍스트 상자 run, 클래식 차트 레코드 안의 폰트 참조에 적용됩니다
애플리케이션 코드에서 보이는 부분은 TXLSComment와 TXLSTextBox의 TextRuns입니다. TextRuns.FontIndex[I]는 읽은 그대로, 4를 건너뛴 파일 번호를 돌려줍니다. run 인덱스는 1 기반이고 CharIndex[I]는 run I가 시작하는 문자 오프셋입니다. zero-based 테이블 슬롯 대신 파일 번호를 노출하는 편이 여기서는 나은 기본값입니다. API가 보고하는 것이 레코드 덤프가 보여주는 것과 일치하니까요. 대가는 그 값을 테이블 위치로 다루기 전에 위의 헬퍼를 한 번 부르는 것입니다
var
Book: IXLSWorkbook;
Note: TXLSComment;
I: Integer;
Ifnt: Word;
begin
Book := TXLSWorkbook.Create;
if Book.Open('review-notes.xls') <> 1 then
raise Exception.Create('Cannot open review-notes.xls');
Note := Book.Sheets[1].Range['C2', 'C2'].Comment;
if Note <> nil then
for I := 1 to Note.TextRuns.Count do
begin
Ifnt := Note.TextRuns.FontIndex[I]; // 파일 번호, 4 건너뜀
// 자작 정신 검사: 4라면 파일이 2.5.129를 깨는 것이다
if Ifnt = 4 then
raise Exception.CreateFmt('Run %d uses invalid ifnt 4', [I]);
Writeln(Format('run %d at char %d: ifnt %d = FONT record #%d',
[I, Note.TextRuns.CharIndex[I], Ifnt, FontIndexToRecordNo(Ifnt)]));
end;
end;
저장 뒤에는 run에 저장된 번호가 읽거나 설정한 번호와 다를 수 있습니다. 저장이 run을 압축된 폰트 테이블과 함께 재번호 매기므로, 번호는 바뀌지만 그것이 가리키는 폰트는 바뀌지 않습니다
zero-based "수정"이 모든 커스텀 폰트를 한 칸 밀어 낸 이유는?
함정은 대개 그럴듯해 보이는 버그 보고서에서 시작합니다. 누군가 FONT 레코드 여덟 개짜리 워크북을 덤프하고, 폰트 8을 가리키는 XF를 보고, 작성기가 범위 밖 인덱스를 만들었다고 결론 내린 뒤, 작성기와 리더를 모두 순수 zero-based 산술로 바꿉니다. 왕복 테스트는 여전히 통과합니다. 고쳐진 작성기와 고쳐진 리더가 서로 합의하니까요. Excel은 합의하지 않습니다. 그렇게 쓰인 파일은 첫 커스텀 폰트를 ifnt 4로 저장하고 Excel은 그것을 기본 폰트로 해석하며, 이후의 모든 커스텀 폰트는 한 레코드 앞에 착지합니다. Excel이 쓴 파일을 읽는 쪽은 반대로 어긋나 각 폰트를 한 레코드 늦게 묶습니다
출하 전에 잘못된 읽기를 폭로하는 신호 둘. 하나는 ifnt < FontCount를 단언하는 테스트입니다. 경계 검사처럼 보이지만 실제로는 그 잘못된 읽기를 요구사항으로 적어 두는 것입니다. 쓰인 모든 ifnt를 스펙 공식으로 FONT 레코드 이름에 역매핑하는 테스트는 첫 실행에서 그 밀림을 잡습니다
다른 신호는 스스로와 어긋나는 코드입니다. 완전한 BIFF8 리더와 라이터는 여러 곳에서 skip-4 규칙을 적용합니다. XF 출력, XF 입력, 공유 문자열 run 리매핑, 주석 run, 차트 폰트 레코드가 그 대상입니다. 변경이 그중 일부를 zero-based로 옮기고 나머지를 내버려 두면, 손대지 않은 지점들이 증거가 됩니다. 따라서 그 지점들을 의심하기 전에 변경을 의심하세요. 부분 변경은 오래 숨을 수 있습니다. rich text에 쓰이는 폰트는 보통 어떤 셀 서식도 참조하고 있기 때문입니다
주석 폰트 run이 두 번째 저장에서만 깨지는 이유는?
주석과 텍스트 상자 run은 작성자 습관 둘이 만나면 한 번의 저장은 버티고 다음 저장에서 깨질 수 있습니다. 첫 습관은 비대칭 가지치기입니다. 처음 N-1개 FONT 레코드는 무조건 제자리에 두고, 어떤 XF도 참조하지 않을 때 마지막 하나만 버립니다. 둘째 습관은 TXO 서식 run([MS-XLS] §2.4.329)을 번호를 다시 매기지 않고 바이트 그대로 되쓰는 것입니다. 각 습관은 혼자서는 단일 저장 테스트를 통과합니다. 함께면 한 세대를 기다리는 폰트 손실을 준비합니다
이유는 Excel이 쓰는 것 안에 있습니다. Excel이 만든 .xls 파일은 흔히 참조되지 않는 꼬리 폰트로 끝나고, 중국어 로캘 시스템에서는 9 pt DengXian입니다. 첫 저장에서 주석 run만이 쓰는 폰트는 따라서 마지막이 아니었고 눈에 보이는 변화는 없습니다. 하지만 그 첫 저장이 꼬리 폰트를 버리면서 주석 전용 폰트를 마지막 자리로 승격시킵니다. 두 번째 저장은 XF 참조가 없는 마지막 폰트를 발견하고 버립니다. run의 ifnt는 이제 테이블 끝을 넘어 가리키고 Excel은 기본 폰트로 폴백합니다. 그 사이 워크북이 폰트를 하나 얻었다면 run은 새내기에게 묶입니다. 열고, 주석 달고, 다시 저장하는 일이 반복되는 노트, 그러니까 주석과 하이퍼링크 검토 워크플로 만들기의 그런 파일에서 이것이 가장 먼저 나타납니다
HotXLS는 주석과 텍스트 상자 run을 공유 문자열 run과 똑같이 다룹니다. 폰트 테이블을 압축하기 전에 모든 워크시트의 모든 run이 skip-4 FontIndex에서 테이블 슬롯으로 변환되고 참조로 세어집니다. run만이 쓰는 폰트가 살아남는 이유입니다. 나가는 길에는 run이 XF 레코드를 재번호 매기는 그 슬롯-저장 인덱스 테이블을 통과합니다. 폰트를 실지 않는 마지막 TxOLastRun 항목은 읽은 그대로 쓰입니다. 그 재번호 매기기 때문에 저장 전후의 FontIndex 값 비교는 아무것도 말해주지 않습니다. 그것들이 해석되는 폰트 이름을 비교하세요
복사, 행 삽입, 워크북을 넘나드는 run
클래식 엔진에서 Range.Copy, CopyRange, Sheets.AddCopy와 Range.Insert, Range.Delete 뒤의 셀 이동이 모두 하나의 셀 복사 경로를 거치고, shift는 지우기가 뒤따르는 복사일 뿐입니다. 주석 텍스트와 작성자만 나르던 복사라면 행 하나를 삽입했을 뿐인데도 run 두 개짜리 노트가 폰트 하나짜리 노트로 변합니다. 사용자는 주석을 전혀 만지지 않았는데도요
HotXLS는 텍스트와 함께 각 run의 시작 오프셋과 폰트를 복사합니다. 한 워크북 안에서는 FontIndex가 그대로 재사용됩니다. 워크북을 넘을 때는 폰트가 값으로 이동합니다. skip-4 번호를 슬롯으로 변환하고, 대상 폰트 테이블에서 속성으로 폰트를 맞추거나 추가한 뒤, 결과 슬롯을 파일 번호로 되돌립니다. 공유 문자열의 rich text도 Sheets.AddCopy가 시트를 다른 워크북으로 복사할 때 같은 변환을 거치므로, 두 종류의 run이 갈라질 수 없습니다. 폰트 테이블 쪽은 워크북 간 복사와 수식 리바인딩이 다루는 수식 쪽과 같은 by-value 방식을 따릅니다
이것을 테스트로 쓸 때 알아 둘 엣지 케이스 둘:
- 원본과 대상이 같은 주석으로 해석되는 제자리 붙여넣기는 run을 유지합니다. 읽히기 전에 지워지는 것은 아무것도 없습니다
Sheets.AddCopy는 저장된 셀 레코드가 없는 셀에 붙은 주석도 복사합니다. 저장된 셀만 도는 루프는 이것을 놓칩니다
XLSX 엔진에서는 복사가 주석 run을 값으로 클론하고, 주석 부분은 rFont, strike, u, vertAlign으로 읽고 쓰입니다. run의 폰트 이름, 취소선, 밑줄, 위첨자/아래첨자 설정이 저장과 다시 열기를 살아나 온전히 돌아옵니다
재번호 매기기를 버티는 회귀 테스트
이 글의 모든 함정은 메모리 상 테스트를 통과합니다. zero-based 잘못된 읽기는 맞춤 작성기와 리더 속에 살고, 주석 폰트 손실은 저장 두 번이 필요하며, XLSX에서 사라진 주석 run은 다시 열어야 보입니다. 그래서 테스트는 디스크에서 다시 열고, 최소 두 세대의 저장을 돌리고, raw 폰트 번호 대신 run 구조를 검사해야 합니다. Excel이 직접 저장한 워크북에서 시작하세요. C2에 run 두 개짜리 주석이 있고 둘째 run이 파일의 그 무엇도 참조하지 않는 폰트를 쓰는 구성입니다. 두 번째 저장이 아니었으면 버렸을 폰트가 바로 그것입니다
procedure CheckNoteAcrossTwoSaves(const SrcFile, Out1, Out2: string);
var
Book: IXLSWorkbook;
Note: TXLSComment;
RunCount: Integer;
SecondRunAt: Word;
begin
// Assert 호출은 자작 테스트 검사다
Book := TXLSWorkbook.Create;
Assert(Book.Open(SrcFile) = 1); // Excel이 저장한 파일, C2에는 run 두 개
Note := Book.Sheets[1].Range['C2', 'C2'].Comment;
Assert(Note <> nil);
RunCount := Note.TextRuns.Count;
SecondRunAt := Note.TextRuns.CharIndex[2];
Book.Sheets[1].Range['C2', 'C2'].Copy(Book.Sheets[1].Range['E5', 'E5']);
Book.Sheets[1].Range['C1', 'C1'].Insert(xlShiftDown); // C2는 C3로 이동
Assert(Book.SaveAs(Out1) = 1);
Book := TXLSWorkbook.Create; // 두 번째 세대
Assert(Book.Open(Out1) = 1);
Assert(Book.SaveAs(Out2) = 1);
Book := TXLSWorkbook.Create; // 다시 열기, 메모리는 절대 믿지 않는다
Assert(Book.Open(Out2) = 1);
Note := Book.Sheets[1].Range['C3', 'C3'].Comment;
Assert((Note <> nil) and (Note.TextRuns.Count = RunCount));
Assert(Note.TextRuns.CharIndex[2] = SecondRunAt);
Assert(Note.TextRuns.FontIndex[2] <> 4);
Note := Book.Sheets[1].Range['E5', 'E5'].Comment;
Assert((Note <> nil) and (Note.TextRuns.Count = RunCount));
end;
run 개수와 시작 오프셋은 뭉개진 노트를 잡습니다. 폰트 자체는 테스트 밖의 한 단계가 더 필요합니다. Out2를 레코드 뷰어로 열고 각 run의 ifnt를 FontIndexToRecordNo에 통과시킨 뒤, 착지한 FONT 레코드가 소스 파일과 같은 폰트 이름을 지녔는지 확인하세요. Excel에서는 잃어버린 폰트가 C3 노트 둘째 run의 기본 서체로 드러납니다
클래식 XLS는 여전히 많은 Delphi와 C++Builder 프로젝트에 등장하고, BIFF8 파일 안의 모든 폰트 소비자가 §2.5.129에 합의해야 출력이 Excel에서 올바로 열립니다. Delphi 스프레드시트 컴포넌트인 HotXLS는 셀 서식, 공유 문자열, 주석, 텍스트 상자, 차트 전반에 skip-4 번호 매기기를 적용하고, 저장마다 run을 재번호 매기며, 워크북 사이에서 값으로 옮기고, Excel이나 OLE automation 없이 XLS와 XLSX를 모두 읽고 씁니다