Bezeichnung
page:Concat -- verknüpft Matrizen
Übersicht
status = page:Concat(a, b, c, d, x, y)
Beschreibung
page:Concat() verknüpft die aktuelle Transformationsmatrix der Seite mit der angegebenen Matrix.

Wenn Sie beispielsweise das Koordinatensystem der Seite um 45 Grad drehen möchten, verwenden Sie page:Concat() wie folgt:

 
Local rad1 = 45 / 180 * #PI
page:Concat(Cos(rad1),Sin(rad1),-Sin(rad1),Cos(rad1),220,350)

Um das Koordinatensystem der Seite auf 300 dpi zu ändern, verwenden Sie page:Concat() wie folgt:

 
page:Concat(72.0 / 300.0, 0, 0, 72.0 / 300.0, 0, 0)

Rufen Sie page:GSave() vor page:Concat() auf. Dann kann die Änderung durch page:Concat() durch Aufruf von page:GRestore() wiederhergestellt werden.

 
; speichert die aktuellen Grafikzustände
page:GSave(page)

; verknüpft die Transformationsmatrix
page:Concat(72.0 / 300.0, 0, 0, 72.0 / 300.0, 0, 0)

; zeigt den Text bei den verschobenen Koordinaten an
page:BeginText()
page:MoveTextPos(50, 100)
page:ShowText("Text on the translated coordinates")
page:EndText(page)

; stellt die Grafikzustände wieder her
page:GRestore()

Eine Anwendung kann page:GSave() aufrufen, wenn sich der Grafikmodus der Seite in #HPDF_GMODE_PAGE_DESCRIPTION befindet.

Liefert #HPDF_OK bei Erfolg. Andernfalls wird ein Fehlercode zurückgegeben und der Fehler-Handler wird aufgerufen.

Eingaben
a
Skalierung der x-Koordinate (Grössenveränderung)
b
Rotation der x-Koordinate (Drehung)
c
Rotation der y-Koordinate (Drehung)
d
Skalierung der y-Koordinate (Grössenveränderung)
x
Translation der x-Koordinate (Verschiebung)
y
Translation der y-Koordinate (Verschiebung)
Rückgabewerte
status
Statusinformation

Navigation zeigen