ObjectTransparent 속성

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

page object가 PDF transparency에 참여하는지 나타냅니다 — 불투명하지 않은 fill/stroke alpha나 non-Normal blend mode를 사용하면 simple painter's-algorithm rendering 대신 compositing이 필요합니다

PDF 1.4 introduced the Transparency Imaging Model (PDF 32000-1 § 11), which lets any page object specify a graphics-state alpha (ca/CA) and a blend mode (BM in the ExtGState dictionary). ObjectTransparent returns True if PDFium detected either of these on the object at Index, meaning the renderer cannot simply overpaint and must allocate an isolated compositing buffer for the object.

이것은 전체 current page에 transparent content가 있는지 보고하는 Transparent의 object별 대응입니다. page의 비용이 큰 부분만 flatten하거나, transparency를 이해하지 못하는 print-shop pipeline용으로 들어오는 PDF를 점검하거나, 대부분의 object가 완전히 opaque일 때 compositing을 건너뛰어 custom rendering을 빠르게 하고 싶을 때 사용하세요

결과는 insertion 시점의 object 자체 graphics state를 반영합니다. object를 삽입한 뒤 state를 바꾸면 ObjectTransparent와 실제 appearance가 어긋날 수 있습니다

object (for example through native FPDFPageObj_SetFillColor with a non-255 alpha) only changes the reported value after UpdatePage and ReloadPage have rebuilt the cached page.

• Image objects whose source data contains an alpha channel (soft mask / SMask) also report True.
• 객체가 투명한 이웃 뒤에 일부 가려져 있어도 False를 반환할 수 있습니다 — 이 속성은 객체 자체를 설명할 뿐, 형제와 어떻게 합성되는지는 설명하지 않습니다
• Wraps PDFium's FPDFPageObj_HasTransparency and is intentionally cheap to call inside loops over ObjectCount.
• The reported value is independent of PageRotation, page scaling, or the current rendering DPI.

ObjectCount, ObjectType, ObjectBounds, Transparent