THPDFPage.ShowImageMatrix Method
Platziert ein registriertes Bild-XObject über eine exakte Sechs-Parameter-Matrix im aktuellen PDF-User-Space
Deklaration
procedure ShowImageMatrix(ImageIndex: Integer; A, B, C, D, E, F: Single);
void __fastcall ShowImageMatrix(int ImageIndex, float A, float B, float C, float D, float E, float F);
Unit
HPDFDoc
Parameter
| Name | Zweck |
|---|---|
ImageIndex | Index, der von einer AddImage-, AddImageWithMask- oder AddImageWithSMask-API zurückgegeben wird |
A, B, C, D | Lineare Komponenten, die das Einheitsquadrat des Bilds skalieren, drehen, spiegeln oder scheren |
E, F | Translationskomponenten im aktuellen PDF-User-Space |
Verhalten
- Registriert das ausgewählte Bild einmal in den XObject-Ressourcen der aktuellen Seite und verwendet für wiederholte Platzierungen einen vorhandenen Alias wieder
- Schreibt eine isolierte
q,cm,Do,Q-Sequenz, sodass die Matrix nicht in späteren Seiteninhalt ausläuft - Mappt das Einheitsquadrat des Bild-XObjects direkt über
[A B C D E F] - Wendet keine Dokument-Maßeinheiten-Konvertierung, Y-Koordinaten-Projektion, Seitenverhältnis-Anpassung oder automatische Rotation an
- Weist einen ungültigen Bildindex und jede nicht-endliche Matrixkomponente ab
Beispiel
ImageIndex := Document.AddImage(Bitmap, icFlate);
Document.CurrentPage.ShowImageMatrix(
ImageIndex,
120, 0,
0, 80,
36, 540);