CharacterGenerated 속성

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.

지정한 인덱스의 character가 page content stream에 직접 그려진 것이 아니라 PDFium이 text extraction 중 합성한 것일 때 True를 반환합니다. 합성 character는 ligature 확장, soft hyphenation, 단어/줄 경계 휴리스틱에 대해 생성되며, search와 select-all 결과가 자연스럽게 읽히도록 해줍니다

CharacterGenerated는 지정한 인덱스의 character가 원본 content stream에 있던 것이 아니라 PDFium 내부에서 생성된 것일 때 True를 반환합니다. 대표적인 예는 ligature 분해(fi ligature glyph를 f + i로 나눔), 시각적으로 분리된 인접 text run 사이에 PDFium이 넣는 trailing space, 각 시각적 line 끝에 삽입되는 line-break character입니다

생성된 character는 page content stream에 별도 그리기가 없으므로 bounding box를 이웃 glyph에서 유도합니다. pixel-accurate hit-testing이 필요하면 주의해서 다루세요; 해당 CharacterRectangle은 너비나 높이가 0인 영역으로 접힐 수 있습니다

정확한 verbatim extraction(디지털 서명, text의 hash, page content stream과의 ASCII 일치 비교) 같은 작업에서는 먼저 생성된 character를 걸러내세요. 일반적인 text search와 clipboard copy에서는 이 flag가 순전히 정보용입니다. PDFium은 사용자가 기대하는 대로 이미 character를 삽입해 둡니다

• 이 flag는 CharacterMapError와 독립적입니다. 생성된 character도 여전히 유효한 Unicode 값을 가질 수 있습니다
• CharacterIsHyphen가 보고하는 soft hyphen도 보통 생성된 character입니다
• run 사이에 붙는 trailing space가 가장 흔한 True 사례입니다. 생성된 character가 항상 보이지 않는 glyph라고 가정하지 마세요
• 생성된 character도 CharacterCount에 포함됩니다

Character, CharacterIsHyphen, CharacterMapError, CharacterRectangle, Text