rc = pmatrix:TransformRectangle(rect)
rect mithilfe der Matrix
und berechnet dann den Begrenzungsrahmen des transformierten
Rechtecks. Der Parameter rect muss eine Tabelle sein, in der
die Felder x, y, width und height initialisiert sind. In
der Rückgabetabelle werden diese Felder ebenfalls initialisiert.
Diese Funktion ist beispielsweise nützlich, wenn Sie ein gedrehtes Pango-Layout in einen Bildpuffer zeichnen wollen und wissen möchten, wie groß das Bild sein soll und wie stark Sie das Layout beim Rendern verschieben müssen.
Wenn Sie ein Rechteck in Pixel haben, verwenden Sie pmatrix:TransformPixelRectangle().
Wenn Sie das Rechteck in Pango-Einheiten haben und es in einen transformierten Pixel-Begrenzungsrahmen konvertieren möchten, ist es genauer, es zuerst zu transformieren (mit dieser Funktion) und das Ergebnis an pango.ExtentsToPixels(), das erste Argument, für ein abgerundetes Rechteck zu übergeben. Es gibt jedoch triftige Gründe, die dafür sprechen, erst in Pixel zu konvertieren und dann zu transformieren, beispielsweise wenn die transformierten Koordinaten in Pango-Einheiten überlaufen (z.B. bei einer großen Matrix-Translation).