기술 문서

Delphi의 하이픈네기와 균형 잡힌 텍스트 열

독일어 제품 시트를 148포인트 열 셋에 흘려 넣으면 두 가지가 동시에 틀어진다. Rechnungsprüfungsausschuss 같은 단어 앞 줄은 3분의 1이 빈 채로 끝날 수 있다. 26글자 합성어 앞의 공백이 유일한 끊김 자리였기 때문이다. 그리고 마지막 페이지에서는 남은 텍스트가 한 열을 채우고 두 번째 열의 일부를 채운 뒤 세 번째 열을 비워 둔다. 공백만 알고 남은 것을 세지 않는 줄바꿈기가 정확히 그런 페이지를 만든다

해법은 두 절반으로 이뤄진다. 텍스트 언어의 규칙으로 단어 안쪽을 끊는 것, 그리고 아직 놓아야 할 줄 수로 마지막 열들의 크기를 정하는 것. 두 절반 모두, 판단에 쓰이는 줄 수가 그려질 그 끊김들, 하이픈까지 포함해서, 480포인트 영역이 아니라 148포인트 열 폭에서 나올 때만 동작한다

PDF Library for Delphi의 하이픈 세 단 텍스트 흐름

PDF Library for Delphi는 한 단락을 텍스트 흐름으로 다룬다. NewTextFlow가 핸들을 돌려주고, SetTextFlowLanguage와 SetTextFlowHyphenation이 단어가 끊길 수 있는 자리를 제어하며, DrawTextFlowColumns는 남은 텍스트 중 들어가는 만큼 1개에서 64개의 등폭 열에 붓고 흐름을 앞으로 민다. 열 폭은 영역 폭에서 거터를 빼고 열 수로 나눈 것이므로, 세 열과 18포인트 거터를 둔 480포인트 영역은 열마다 (480 − 2 × 18) / 3 = 148포인트를 준다

이 호출은 그린 줄의 총수를 반환한다. 0은 아무것도 들어가지 못했다는 뜻이고 그 경우 흐름은 제자리에 머물러 텍스트가 잃어버리지 않는다. 함정은 호출이 계속 0을 반환하는 동안 NewPage를 계속 부르는 페이지 루프다. 영역이 한 줄보다 짧거나 최소 줄 수 설정이 주어진 공간에서 만족될 수 없을 때 일어난다. 아래 루프는 빙글거리는 대신 0을 오류로 취급한다

var
  Lib: TPDFlib;
  FontID, Flow, Drawn: Integer;
begin
  Lib := TPDFlib.Create;
  try
    Lib.SetDocumentLanguage('de-DE');      // NewTextFlow 전에, 아래 참조
    FontID := Lib.AddTrueTypeFont('Georgia', 1);
    Lib.SetTextSize(10.5);

    Flow := Lib.NewTextFlow(ArticleBody);
    try
      Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);
      Lib.SetTextFlowMinLines(Flow, 2);   // 열 바닥에 홀로 남는 줄 없음

      repeat
        // 왼쪽 66, 위 72, 480 x 620pt 영역, 3열, 18pt 거터, 균형
        Drawn := Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
        if Lib.TextFlowFinished(Flow) = 1 then
          Break;
        if Drawn = 0 then
          raise Exception.Create('Column region cannot take the next lines');
        Lib.NewPage;
        Lib.SelectFont(FontID);
        Lib.SetTextSize(10.5);            // NewPage는 폰트를 12pt로 되돌려 온다
      until False;
    finally
      Lib.ReleaseTextFlow(Flow);
    end;

    Lib.SaveToFile('newsletter.pdf');
  finally
    Lib.Free;
  end;
end;

좌표는 원점을 무엇으로 설정했든 페이지의 왼쪽 위 구석에서 잰다. 열 호출이 줄을 Top에서 아래로 깔기 때문이다. 기본 왼쪽 정렬에서는 모든 줄이 자기 열의 왼쪽 가장자리에서 시작하므로 나쁜 끊김의 여유가 삐뚤빼뚤한 오른쪽 가장자리로 드러나고, 양쪽 정렬에서는 같은 여유가 강으로 변한다

PDF Library for Delphi의 하이픈 처리 유무에 따른 양쪽 정렬 좁은 열 비교: 하이픈 처리를 켜면 긴 단어가 끊기고 공백의 강이 사라진다
언어 인식 하이픈 처리는 끊김을 단어 안쪽에 두므로 양쪽 정렬의 여유가 강으로 고이지 않는다

하이픈 처리 언어는 어디서 오는가?

새 흐름은 문서 카탈로그의 /Lang 항목에서, NewTextFlow가 도는 순간 언어를 가져온다. 화면 낭독기와 검색 인덱서가 읽는 것과 같은 값이므로, 접근성 PDF 자동 태깅의 태그 출력처럼 이미 자기 언어를 선언하는 문서는 하이픈 처리를 공짜로 얻는다. 다만 타이밍이 중요하다. 흐름이 존재한 뒤에 SetDocumentLanguage를 부르면 그 흐름은 영영 그것을 보지 못한다. 첫 예제가 정확히 그 이유로 언어를 먼저 설정한다

태그가 지원 언어를 가리키면 자동 하이픈 처리가 스스로 켜진다. 규칙은 영어, 독일어, 네덜란드어, 프랑스어, 스페인어, 이탈리아어, 포르투갈어, 러시아어, 터키어, 덴마크어, 스웨덴어, 핀란드어, 폴란드어, 체코어, 헝가리어를 다룬다. 지역 서브태그는 탐색 전에 떼어 내므로 de-CH, de-AT, de 모두 독일어로 하이픈 처리된다. 규칙이 다루지 않는 태그, 예컨대 ja는 받아들여지고 그 흐름에서는 자동 끊김이 그저 꺼진다

세 반환 값이 무슨 일이 있었는지 알려 주며, 사용자 데이터에서 언어를 받는 코드라면 검사할 가치가 있다:

  • SetTextFlowLanguage는 기형 태그에만 0을 반환한다. 다루지 않는 언어의 잘 구성된 태그는 1을 반환하고 자동 하이픈 처리는 꺼진 채로 둔다
  • SetTextFlowHyphenation을 Enable = 1로 부르면 흐름의 언어에 규칙이 없을 때 0을 반환한다. 언어 없는 끊김 지점을 낼 수는 없다는 뜻이다
  • GetTextFlowHyphenation은 자동 끊김이 지금 켜져 있는지 보고하며, 레이아웃이 이상해 보일 때 로그로 남길 값이 바로 이것이다

여기서도 순서가 중요하다. SetTextFlowLanguage는 켜짐/꺼짐 상태를 새 언어에서 다시 계산하므로, SetTextFlowHyphenation(Flow, 0, …) 뒤에 부르면 지원 언어에서는 하이픈 처리가 다시 켜진다. 언어를 먼저, 하이픈 옵션을 그다음에

MinPrefix와 MinSuffix는 사내 문체 설정이다

활성화 플래그 뒤의 두 정수는 끊김 앞의 줄에 남아 있어야 하는 최소 글자 수와 끊김 뒤 다음 줄로 가야 하는 최소 글자 수다. 둘 다 1부터 16을 받는다. 언어만으로 하이픈 처리가 켜질 때는 둘 다 2이고, 단어는 최소 MinPrefix + MinSuffix + 1글자를 가질 때만 끊김 후보가 된다

이와 이는 거의 모든 문서에서 우리가 바꾸고 싶은 설정이다. 끊김 기회는 더 많이 만들지만 줄 끝의 두 글자 조각은 오타처럼 읽히고, 독일어나 네덜란드어에서는 독자가 나중에 다시 붙여야 하는 두 글자 접두사 같은 것을 떼어 낸다. 삼과 삼은 삐뚤한 줄을 몇 개 더 내주는 대신 조판으로 보인다. 글자가 큰 타입에서는 모든 조각이 도드라지므로 최소값을 더 올리고, 빡빡한 행폭이 깔끔한 행폭을 이긴다고 판단한 진짜 좁은 열에서만 둘로 내려라

어떤 단어가 끊길 수 있고 URL은 어떻게 되는가

줄은 공백과 탭에서 끊기고 줄바꿈은 새 줄을 강제한다. 단어 안쪽에서 자동 하이픈 처리는 전부 글자로만 이뤄진 단어(Latin, 악센트가 붙은 Latin Extended 범위 포함, 그리고 Cyrillic)만 본다. 앞뒤 구두점은 따로 뗀다. 규칙은 모음의 보수적 조합과 합법 자음군, 흔한 접사의 조합이라 사전식 하이픈 처리기보다 끊김 지점을 적게 놓는다. 숫자나 내부 구두점을 가진 단어, 예컨대 ISO-32000이나 v2Beta, 그리고 128글자를 넘는 단어는 자동 지점을 받지 않는다

소프트 하이픈(U+00AD)이 수동 재정의다. 단어가 하나라도 갖고 있으면 그 자리들이 유일한 끊김 지점이 된다. 그 단어에는 자동 규칙을 건너뛰고, 자동 하이픈 처리가 꺼져 있거나 언어에 규칙이 없어도 소프트 하이픈은 동작한다. 브랜드명과 제품 코드, 규칙이 엉망으로 자르는 용어에 써라. 다음 예제에서 Rechnungs와 prüfungs가 합성어가 끊길 수 있는 단 둘의 자리다

var
  Flow: Integer;
  Body, Rest: WideString;
begin
  // U+00AD가 이 합성어가 끊길 수 있는 유일한 자리를 표시한다
  Body := 'Die Pr' + #$00FC + 'fung erfolgt durch den Rechnungs' + #$00AD +
    'pr' + #$00FC + 'fungs' + #$00AD + 'ausschuss der Gesellschaft';
  Flow := Lib.NewTextFlow(Body);
  try
    if Lib.SetTextFlowLanguage(Flow, CustomerLanguageTag) = 0 then
      raise Exception.Create('Malformed language tag: ' + CustomerLanguageTag);
    if Lib.SetTextFlowHyphenation(Flow, 1, 3, 3) = 0 then
      LogWarning('No hyphenation rules; only soft hyphens will break words');
      // LogWarning은 여러분의 로깅 루틴이다

    Lib.DrawTextFlow(Flow, 72, 72, 148, 240);

    // 들어가지 못한 것은 넘겨진 그대로 돌아온다.
    // 소프트 하이픈도 포함해서
    Rest := Lib.GetTextFlowRemaining(Flow);
  finally
    Lib.ReleaseTextFlow(Flow);
  end;
end;

하이픈 마이너스는 실제로 택해진 끊김에만 그려진다. 버려진 소프트 하이픈은 측정과 그리기 양쪽에서 보이지 않고, 끊김은 원본 텍스트 기준으로 기록된다. GetTextFlowRemaining이 소프트 하이픈을 그대로 돌려주는 이유다. 순진한 설계는 알아볼 수 있는 방식으로 이것을 틀린다. 후보를 시험하는 동안 하이픈을 문자열에 써 넣고, 끊김이 나중에 옮겨가면 떠돌이 하이픈이 줄 한가운데 남는다

어느 줄에도 전혀 들어가지 않는 토큰, 곧 합법적 끊김이 없는 긴 URL이나 등록 번호는 들어가는 가장 긴 접두부에서, 하이픈을 더하지 않고 잘린다. 잘림은 서러게이트 쌍의 두 절반 사이나 결합 기호 앞에 놓이지 않으므로 이모지나 악센트 글자가 줄을 가르는 일은 없다

Balance=1이 마지막 페이지에서 바꾸는 것

Balance 인수가 문제 되는 것은 남은 것이 전부 영역 안에 들어갈 때뿐이다. 그 경우 DrawTextFlowColumns는 남은 줄 수를 열 수로 나눠 올림하고 그것을 모든 열의 높이로 쓴다. 세 열에 남은 22줄은 8, 8, 6으로 나온다. 나머지가 들어가지 않으면 모든 열이 전체 높이를 유지해 페이지가 최대한 실어 나르고 나머지는 다음 페이지로 이어진다

최소 줄 수 설정은 균형 높이를 끌어올릴 수 있다. SetTextFlowMinLines(Flow, 3)에서 줄이 넷 남았다면 균형 높이 2는 최소 아래이므로 열은 순서대로 채워진다. 첫 열에 셋, 두 번째에 하나, 셋째는 빈 채로. 단락 맨 끝의 짧은 꼬리는 갈 곳이 없으므로 언제나 놓인다. 다음 열의 맨 위에서도 최소 두 줄을 함께 붙잡아 두려면 SetTextFlowPaginationLines가 고아·과부 최소값을 한 번의 호출로 받는다

PDF Library for Delphi의 Balance 매개변수 다이어그램: 앞선 열 영역은 가득 유지하면서 마지막 영역은 모든 열에서 같은 줄 수로 줄인다
균형 맞추기는 단락의 끝에서만 적용되며 그 자리에서 모든 열을 같은 줄 수로 다듬는다

이어지는 글이라면 매번 1을 넘겨라. 단락 중간에서는 아무것도 바꾸지 않는다. 어차피 열은 가득하다. 0을 넘기겠다는 것은 열 영역이 폼 같은 레이아웃의 고정 상자일 때뿐이다. 43줄 열에 52줄 나머지는 18, 18, 16이 아니라 43, 9, 0으로 떨어져야 하는 자리다

레이아웃 자체가 단락의 길이에 의존한다면 그리기 전에 측정하라. MeasureTextFlow는 흐름을 옮기지 않고 주어진 폭에서 흐름의 나머지가 필요한 줄 수를 반환하며, 같은 끊김, 하이픈 포함, 을 쓴다

var
  Flow, Needed, LinesPerColumn: Integer;
  LinePitch: Double;
begin
  Flow := Lib.NewTextFlow(ArticleBody);
  try
    Lib.SetTextFlowLanguage(Flow, 'fr');
    Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);

    Lib.SelectFont(FontID);
    Lib.SetTextSize(10.5);
    // 열 호출이 쓰는 줄 피치: 선택된 텍스트 높이의 1.2배
    LinePitch := Lib.GetTextHeight * 1.2;
    LinesPerColumn := Trunc(620 / LinePitch);

    Needed := Lib.MeasureTextFlow(Flow, (480 - 2 * 18) / 3);
    if Needed > 3 * LinesPerColumn then
      UseTwoPageSpread      // 여러분의 레이아웃 선택
    else
      UseSinglePage;        // Balance=1이 열을 고르게 만든다

    Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
    if Lib.TextFlowFinished(Flow) <> 1 then
      CarryOver(Lib.GetTextFlowRemaining(Flow));   // 이것도 여러분의 것
  finally
    Lib.ReleaseTextFlow(Flow);
  end;
end;

상자에서 상자로 폰트와 크기를 똑같이 유지하기

DrawTextFlow, DrawTextFlowColumns, MeasureTextFlow는 모두 호출되는 순간 선택된 폰트와 크기로 줄을 끊는다. 같은 흐름의 두 상자 사이에서 하나라도 바꾸면 두 번째 상자는 첫 번째가 측정한 것과 다르게 끊는다. 줄 피치도 따라 움직인다. 선택된 텍스트 높이의 1.2배이기 때문이다. GetTextHeight가 여러분 서체에 대해 12포인트를 보고한다면 피치는 14.4포인트이고 620포인트 열은 43줄을 담는다

여기에 걸려 넘어지기 쉬운 길이 새 페이지다. NewPage는 현재 폰트를 다시 선택하되 12포인트로 하고, SelectFont도 마찬가지다. 1페이지에서 10.5포인트로 맞춘 흐름은 루프가 SetTextSize를 다시 부르지 않는 한 2페이지부터 12포인트로 돈다. 더 넓은 단어, 더 높은 피치, 열당 더 적은 줄, 그리고 더는 맞지 않는 1페이지의 MeasureTextFlow 결과. 증상이 간헐적으로 보이는 이유는 1페이지가 언제나 옳기 때문이다. 모든 NewPage 뒤에 폰트를, 그다음 크기를, 그 순서대로 다시 선택하라. 첫 예제가 그렇게 하는 이유다

PDF Library for Delphi 경고 다이어그램: 상자 사이 폰트 변경 뒤 줄바꿈이 표류하는 모습과, 새 페이지마다 폰트를 다시 선택하는 안정적인 루프의 대비
세 흐름 메서드 모두 현재 선택된 폰트로 줄을 끊으므로 서체는 페이지를 넘어 그대로 살아남아야 한다

문자 체계를 섞는 단락도 측정과 그리기에서 같은 선택 폰트 경로를 거치므로, CJK와 이모지 텍스트의 자동 폰트 폴백이 고른 대체 서체가 둘 사이에 틈을 열지 않는다. 흐름이 헤더와 푸터, 데이터 기반 블록과 페이지를 나눠 쓰는 리포트 레이아웃에서는 데이터셋 리포트 엔진의 순서가 그대로 이어진다. 먼저 측정하고, 고정 엘리먼트를 놓고, 남은 영역을 흐름에 넘긴다

여기서 다룬 텍스트 흐름 호출들, 생성과 측정부터 되감기와 해제까지는 Delphi, C++Builder, Lazarus용 PDF Library for Delphi의 일부다. 함수 레퍼런스와 다운로드는 PDF Library for Delphi 제품 페이지에 있다