PDFium Delphi Component Docs

GetImageObjectRenderedBitmap metode

Komponen: TPdf  ·  Unit: PDFium
Mengrender satu page object gambar secara tersendiri dan mengembalikan piksel hasil dekode sebagai bitmap milik pemanggil

Syntax

function GetImageObjectRenderedBitmap(Index: Integer): TBitmap;

IndexInteger. Indeks page object gambar berbasis nol, dalam rentang 0 .. ObjectCount - 1. Objek dengan tipe lain memunculkan EPdfError (Image object required)
ResultTBitmap. Bitmap yang baru dibuat, dimiliki pemanggil dan wajib dibebaskan, atau nil ketika panggilan native tidak menghasilkan bitmap

Description

Mengrender hanya objek gambar itu melalui renderer native (FPDFImageObj_GetRenderedBitmap) dengan matriks, color space, dan mask terkininya diterapkan — hasilnya menampilkan gambar sebagaimana ditampilkan oleh halaman, termasuk soft mask, stencil key, dan konversi warna, yang tidak dimiliki sampel mentah yang tersedia melalui Image

Render lock dipegang selama panggilan native, sehingga aman terhadap rendering konkuren pada komponen yang sama. Bitmap native dikonversi dan dihancurkan sebelum kembali; TBitmap yang dihasilkan menjadi milik pemanggil

Panggilan mengharuskan halaman saat ini aktif, objek pada Index bertipe otImage (periksa ObjectType), dan build PDFium yang mengekspor entry point render per gambar; jika tidak, EPdfError dimunculkan (Rendered image object bitmaps are not available)

Hasil nil bukanlah kondisi abort: ketika panggilan native tidak menghasilkan bitmap, pemanggil dapat beralih memotong render halaman penuh dengan batas dari ObjectBounds

Remarks

Example

var
  Bmp: TBitmap;
begin
  if Pdf1.ObjectType[7] = otImage then
  begin
    Bmp := Pdf1.GetImageObjectRenderedBitmap(7);
    if Bmp <> nil then
      try
        Image1.Picture.Bitmap.Assign(Bmp);
        // use Bmp for export, comparison or recognition
      finally
        Bmp.Free;
      end;
  end;
end;

See Also

GetTextObjectRenderedBitmap, ObjectBitmap, ObjectType, ObjectBounds, ImageInfo