PDFium Delphi Component Docs

เมธอด RenderPageWithMatrix

Component: TPdf  ·  Unit: PDFium
เรนเดอร์หน้าปัจจุบันผ่าน transformation matrix ใด ๆ พร้อมกรอบสี่เหลี่ยม clip

Syntax

function RenderPageWithMatrix(Width, Height: Integer; const Matrix: FS_MATRIX; const Clip: TPdfRectangle; Options: TRenderOptions = []; Color: TColor = clWhite): TBitmap;

Width, HeightInteger ขนาดของ bitmap ปลายทางเป็นพิกเซล
MatrixFS_MATRIX transformation ที่นำไปใช้กับหน้าก่อนแรสเตอร์ ตามลำดับเมทริกซ์ของ PDF (a, b, c, d, e, f)
ClipTPdfRectangle กรอบสี่เหลี่ยม clip เป็นพิกเซลปลายทาง เนื้อหาที่อยู่นอกกรอบจะไม่ถูกวาด
OptionsTRenderOptions เซ็ตของแฟล็ก TRenderOption ที่ควบคุมคุณภาพและพฤติกรรมของการเรนเดอร์
ColorTColor สีพื้นหลังที่เติมก่อนการเรนเดอร์ ค่าเริ่มต้นคือ clWhite
ResultTBitmap bitmap ที่สร้างขึ้นใหม่ซึ่งผู้เรียกเป็นเจ้าของและต้องปล่อยเอง

 

procedure RenderPageWithMatrix(Bitmap: TBitmap; Width, Height: Integer; const Matrix: FS_MATRIX; const Clip: TPdfRectangle; Options: TRenderOptions = []; Color: TColor = clWhite);

BitmapTBitmap bitmap ที่มีอยู่แล้วสำหรับเรนเดอร์ลงไป ผู้เรียกเป็นผู้สร้างและปล่อยเอง
Width, HeightInteger ขนาดของพื้นที่ปลายทางเป็นพิกเซล
MatrixFS_MATRIX transformation ที่นำไปใช้กับหน้า
ClipTPdfRectangle กรอบสี่เหลี่ยม clip เป็นพิกเซลปลายทาง
OptionsTRenderOptions แฟล็กของการเรนเดอร์
ColorTColor สีพื้นหลังที่เติมก่อนการเรนเดอร์

Description

ในจุดที่ RenderPage ให้กรอบสี่เหลี่ยมและการหมุนหนึ่งในสี่ขั้น เมธอดนี้เปิดเผย transformation ทั้งหมดที่ PDFium ใช้เรนเดอร์ ไม่ว่าจะเป็นการย่อขยายระดับใดก็ได้ มุมหมุนใดก็ได้ การเฉือน การกลับด้าน หรือการผสมกันของทั้งหมดนี้

กรอบสี่เหลี่ยม clip ถูกนำไปใช้ในพื้นที่ปลายทาง จึงเป็นวิธีที่เป็นธรรมชาติในการวาดพื้นที่ที่เสียหายเพียงส่วนเดียวของมุมมองแบบซูม โดยไม่ต้องเรนเดอร์ทั้งหน้าใหม่

เมทริกซ์จับคู่หน่วยหน้าของ PDF เข้ากับพิกเซลปลายทาง การเรนเดอร์แบบพอดีความกว้างโดยไม่หมุนคือ (Width / PageWidth, 0, 0, Height / PageHeight, 0, 0) การกลับด้านจะทำให้ a หรือ d เป็นค่าลบและเลื่อนค่า translation ที่สอดคล้องกัน

See Also

RenderPage, RenderTile, RenderPageBanded, TransformPageContent