Bitmap 속성

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

현재 page의 지정한 image object raster 데이터를 담은 새로 디코딩한 VCL TBitmap을 반환합니다. 호출할 때마다 bitmap이 새로 할당되며, 호출자가 이를 소유하고 Free를 호출할 책임이 있습니다

Bitmap는 현재 page의 n번째 raster image pixel 데이터를 담은 TBitmap을 반환합니다. PDFium은 기반 stream(JPEG, JPEG2000, CCITT, JBIG2, FlateDecode pixel data)을 디코딩하고, PDFiumPas는 source가 soft mask를 제공하는 경우 alpha가 보존된 32-bit ARGB surface로 그 결과를 VCL TBitmap으로 변환합니다

호출할 때마다 새 bitmap이 할당되며 캐시하지 않습니다. 그래서 worker thread에서 호출해도 안전하지만, 호출자는 반환된 object를 항상 해제해야 하며 보통 try .. finally 블록 안에서 처리합니다

이미지의 page 내 transformation matrix와 bounding rectangle도 필요하면 대신 Image[Index]를 사용하세요. 이쪽은 같은 TBitmap에 위치 메타데이터를 묶은 record를 반환합니다. 모양을 구분하지 않는 자매 항목 ObjectBitmap[ObjectIndex]는 전체 page-object 배열(text, path, image 혼합)을 인덱싱하며, 대상 object가 이미지일 때 같은 bitmap을 반환합니다

• 작은 이미지가 수천 개 들어 있는 PDF라면 배치로 순회하고 bitmap을 즉시 해제해 peak memory를 줄이세요
• 반환된 bitmap에는 DPI 힌트가 들어 있지 않습니다. page의 nominal output size로 인쇄해야 한다면 source resolution에 맞춰 크기를 잡으세요
• bitmap을 원래 page 내 위치에 다시 놓으려면 Image에서 제공하는 page coordinate transform을 사용하세요
• Index가 범위를 벗어나거나 문서가 활성 상태가 아니면 nil을 반환합니다

BitmapCount, Image, ImageCount, ObjectBitmap