Matrix-Klasse
Summary: Replaces the GDI+ Matrix.
Module: aspose.imaging
Full Name: aspose.imaging.Matrix
Constructors
| Name | Beschreibung |
|---|---|
| Matrix() | Initialisiert eine neue Instanz der Matrix-Klasse als Einheitsmatrix. |
| Matrix(m11, m12, m21, m22, m31, m32) | Initialisiert eine neue Instanz der Matrix Klasse. |
| Matrix(origin) | Erstellt eine Kopie der Matrix Klasse. |
| Matrix(rect, plgpts) | Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist. |
| Matrix(rect, plgpts) | Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist. |
Properties
| Name | Type | Access | Beschreibung |
|---|---|---|---|
| TYPE_FLIP [statisch] | int | r | This flag bit indicates that the transform defined by this object performs a mirror image flip about some axis which changes the normally right handed coordinate system into a left handed system in addition to the conversions indicated by other flag bits. A right handed coordinate system is one where the positive X axis rotates counterclockwise to overlay the positive Y axis similar to the direction that the fingers on your right hand curl when you stare end on at your thumb. A left handed coordinate system is one where the positive X axis rotates clockwise to overlay the positive Y axis similar to the direction that the fingers on your left hand curl. There is no mathematical way to determine the angle of the original flipping or mirroring transformation since all angles of flip are identical given an appropriate adjusting rotation. NOTE: TypeFlip was added after GENERAL_TRANSFORM was in public circulation and the flag bits could no longer be conveniently renumbered without introducing binary incompatibility in outside code. |
| TYPE_GENERAL_ROTATION [static] | int | r | This flag bit indicates that the transform defined by this object performs a rotation by an arbitrary angle in addition to the conversions indicated by other flag bits. A rotation changes the angles of vectors by the same amount regardless of the original direction of the vector and without changing the length of the vector. This flag bit is mutually exclusive with the |
| TYPE_GENERAL_SCALE [static] | int | r | A general scale multiplies the length of vectors by different amounts in the x and y directions without changing the angle between perpendicular vectors. This flag bit is mutually exclusive with the TypeUniformScale flag. |
| TYPE_GENERAL_TRANSFORM [static] | int | r | This constant indicates that the transform defined by this object performs an arbitrary conversion of the input coordinates. If this transform can be classified by any of the above constants, the type will either be the constant TypeIdentity or a combination of the appropriate flag bits for the various coordinate conversions that this transform performs. |
| TYPE_IDENTITY [static] | int | r | An identity transform is one in which the output coordinates are always the same as the input coordinates. If this transform is anything other than the identity transform, the type will either be the constant GENERAL_TRANSFORM or a combination of the appropriate flag bits for the various coordinate conversions that this transform performs. |
| TYPE_MASK_ROTATION [static] | int | r | This constant is a bit mask for any of the rotation flag bits. |
| TYPE_MASK_SCALE [static] | int | r | This constant is a bit mask for any of the scale flag bits. |
| TYPE_QUADRANT_ROTATION [static] | int | r | This flag bit indicates that the transform defined by this object performs a quadrant rotation by some multiple of 90 degrees in addition to the conversions indicated by other flag bits. A rotation changes the angles of vectors by the same amount regardless of the original direction of the vector and without changing the length of the vector. This flag bit is mutually exclusive with the TypeGeneralRotation flag. |
| TYPE_TRANSLATION [static] | int | r | A translation moves the coordinates by a constant amount in x and y without changing the length or angle of vectors. |
| TYPE_UNIFORM_SCALE [static] | int | r | A uniform scale multiplies the length of vectors by the same amount in both the x and y directions without changing the angle between vectors. This flag bit is mutually exclusive with the TypeGeneralScale flag. |
| elements | float[] | r | Gets an array of floating-point values that represents the elements of this Matrix. |
| m11 | float | r | Gets the matrix element at first row first column. Represents scale along X axis. |
| m12 | float | r | Gets the matrix element at first row second column. Represents shear along Y axis. |
| m21 | float | r | Liefert das Matrix-Element in der zweiten Zeile, ersten Spalte. Stellt eine Scherung entlang der X-Achse dar. |
| m22 | float | r | Liefert das Matrix-Element in der zweiten Zeile, zweiten Spalte. Stellt eine Skalierung entlang der Y-Achse dar. |
| m31 | float | r | Liefert das Matrix-Element in der dritten Zeile, ersten Spalte. Stellt eine Translation entlang der X-Achse dar. |
| m32 | float | r | Liefert das Matrix-Element in der dritten Zeile, ersten Spalte. Stellt eine Translation entlang der Y-Achse dar. |
Methods
| Name | Beschreibung |
|---|---|
| create_with_rect(rect, plgpts) | Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist. |
| create_with_rect_f(rect, plgpts) | Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist. |
| get_elements() | Liefert eine Kopie der Matrix-Elemente. |
| multiply(t_tx) | Multipliziert diese Matrix mit der im Matrix-Parameter angegebenen Matrix unter Verwendung der (default) Prepend‑Reihenfolge. |
| multiply(t_tx, order) | Multipliziert diese Matrix mit der im Matrix-Parameter angegebenen Matrix und in der im Order-Parameter angegebenen Reihenfolge. |
| reset() | Setzt diese Matrix zurück, sodass sie die Elemente der Einheitsmatrix enthält. |
| rotate(angle) | Wendet eine im Winkelparameter angegebene Drehung im Uhrzeigersinn um den Ursprung (null x‑ und y‑Koordinaten) für diese Matrix in der Standard‑(Prepend)‑Reihenfolge an. |
| rotate(angle, order) | Wendet eine im Winkelparameter angegebene Drehung im Uhrzeigersinn um den Ursprung (null x‑ und y‑Koordinaten) für diese Matrix in der angegebenen Reihenfolge an. |
| rotate_at(angle, point) | Wendet eine Drehung im Uhrzeigersinn um den angegebenen Punkt auf diese Matrix in der Standard‑(Prepend)‑Reihenfolge an. |
| rotate_at(angle, point, order) | Wendet eine Drehung im Uhrzeigersinn um den angegebenen Punkt auf diese Matrix in der angegebenen Reihenfolge an. |
| scale(scale_x, scale_y, order) | Wendet den angegebenen Skalierungsvektor (scaleX und scaleY) auf diese Matrix unter Verwendung der angegebenen Reihenfolge an. |
| scale(sx, sy) | Wendet den angegebenen Skalierungsvektor (scaleX und scaleY) auf diese Matrix unter Verwendung der (default) Prepend‑Reihenfolge an. |
| transform_points(points) | Wendet die von dieser Matrix dargestellte geometrische Transformation auf ein angegebenes Punktarray an. |
| translate(offset_x, offset_y, order) | Wendet den angegebenen Translationsvektor auf diese Matrix in der angegebenen Reihenfolge an. |
| translate(tx, ty) | Wendet den angegebenen Translationsvektor auf diese Matrix unter Verwendung der (default) Prepend‑Reihenfolge an. |
Constructor: Matrix()
Matrix()
Initialisiert eine neue Instanz der Matrix-Klasse als Einheitsmatrix.
Constructor: Matrix(m11, m12, m21, m22, m31, m32)
Matrix(m11, m12, m21, m22, m31, m32)
Initialisiert eine neue Instanz der Matrix Klasse.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| m11 | float | m00 M11 Skalierung X |
| m12 | float | m10 M12 Scherung Y |
| m21 | float | m01 M21 Scherung X |
| m22 | float | m11 M22 Skalierung Y |
| m31 | float | m02 M31 Translation X |
| m32 | float | m12 M32 Verschiebe Y |
Constructor: Matrix(origin)
Matrix(origin)
Erstellt eine Kopie der Matrix Klasse.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| origin | Matrix | Eine Basismatrix zum Kopieren |
Constructor: Matrix(rect, plgpts)
Matrix(rect, plgpts)
Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| rect | RectangleF | Eine RectangleF Struktur, die das zu transformierende Rechteck darstellt. |
| plgpts | PointF[] | Ein Array von drei PointF Strukturen, das die Punkte eines Parallelogramms darstellt, zu dem die obere linke, obere rechte und untere linke Ecke des Rechtecks transformiert werden sollen. Die untere rechte Ecke des Parallelogramms wird durch die ersten drei Ecken impliziert. |
Constructor: Matrix(rect, plgpts)
Matrix(rect, plgpts)
Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| rect | Rectangle | Eine RectangleF Struktur, die das zu transformierende Rechteck darstellt. |
| plgpts | Point[] | Ein Array von drei PointF Strukturen, das die Punkte eines Parallelogramms darstellt, zu dem die obere linke, obere rechte und untere linke Ecke des Rechtecks transformiert werden sollen. Die untere rechte Ecke des Parallelogramms wird durch die ersten drei Ecken impliziert. |
Method: create_with_rect(rect, plgpts) [static]
create_with_rect(rect, plgpts)
Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| rect | Rectangle | Eine RectangleF Struktur, die das zu transformierende Rechteck darstellt. |
| plgpts | Point[] | Ein Array von drei PointF Strukturen, das die Punkte eines Parallelogramms darstellt, zu dem die obere linke, obere rechte und untere linke Ecke des Rechtecks transformiert werden sollen. Die untere rechte Ecke des Parallelogramms wird durch die ersten drei Ecken impliziert. |
Returns
| Typ | Beschreibung |
|---|---|
| Matrix |
Method: create_with_rect_f(rect, plgpts) [static]
create_with_rect_f(rect, plgpts)
Initialisiert eine neue Instanz der Matrix Klasse mit der geometrischen Transformation, die durch das angegebene Rechteck und das Punkte-Array definiert ist.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| rect | RectangleF | Eine RectangleF Struktur, die das zu transformierende Rechteck darstellt. |
| plgpts | PointF[] | Ein Array von drei PointF Strukturen, das die Punkte eines Parallelogramms darstellt, zu dem die obere linke, obere rechte und untere linke Ecke des Rechtecks transformiert werden sollen. Die untere rechte Ecke des Parallelogramms wird durch die ersten drei Ecken impliziert. |
Returns
| Typ | Beschreibung |
|---|---|
| Matrix |
Method: get_elements()
get_elements()
Liefert eine Kopie der Matrix-Elemente.
Returns
| Typ | Beschreibung |
|---|---|
| float[] | Eine Kopie der Matrixelemente. |
Method: multiply(t_tx)
multiply(t_tx)
Multipliziert diese Matrix mit der im Matrix-Parameter angegebenen Matrix unter Verwendung der (default) Prepend‑Reihenfolge.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| t_tx | Matrix | Die Matrix, mit der multipliziert wird. |
Method: multiply(t_tx, order)
multiply(t_tx, order)
Multipliziert diese Matrix mit der im Matrix-Parameter angegebenen Matrix und in der im Order-Parameter angegebenen Reihenfolge.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| t_tx | Matrix | Der tx. Der tx. Der tx. |
| order | MatrixOrder | Die Reihenfolge. Die Reihenfolge. Die Reihenfolge. |
Method: rotate(angle)
rotate(angle)
Wendet eine im Winkelparameter angegebene Drehung im Uhrzeigersinn um den Ursprung (null x‑ und y‑Koordinaten) für diese Matrix in der Standard‑(Prepend)‑Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| angle | float | Der Rotationswinkel. |
Method: rotate(angle, order)
rotate(angle, order)
Wendet eine im Winkelparameter angegebene Drehung im Uhrzeigersinn um den Ursprung (null x‑ und y‑Koordinaten) für diese Matrix in der angegebenen Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| angle | float | Der Rotationswinkel. |
| order | MatrixOrder | Die Matrixreihenfolge. |
Method: rotate_at(angle, point)
rotate_at(angle, point)
Wendet eine Drehung im Uhrzeigersinn um den angegebenen Punkt auf diese Matrix in der Standard‑(Prepend)‑Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| angle | float | Der Winkel. |
| point | PointF | Der Punkt. |
Method: rotate_at(angle, point, order)
rotate_at(angle, point, order)
Wendet eine Drehung im Uhrzeigersinn um den angegebenen Punkt auf diese Matrix in der angegebenen Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| angle | float | Der Winkel. |
| point | PointF | Der Punkt. |
| order | MatrixOrder | Die Reihenfolge. |
Method: scale(scale_x, scale_y, order)
scale(scale_x, scale_y, order)
Wendet den angegebenen Skalierungsvektor (scaleX und scaleY) auf diese Matrix unter Verwendung der angegebenen Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| scale_x | float | Die Skalierung X. |
| scale_y | float | Die Skalierung Y. |
| order | MatrixOrder | Die Reihenfolge. |
Method: scale(sx, sy)
scale(sx, sy)
Wendet den angegebenen Skalierungsvektor (scaleX und scaleY) auf diese Matrix unter Verwendung der (default) Prepend‑Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| sx | float | Der sx. Der sx. Der sx. |
| sy | float | Der sy. Der sy. Der sy. |
Method: transform_points(points)
transform_points(points)
Wendet die von dieser Matrix dargestellte geometrische Transformation auf ein angegebenes Punktarray an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| points | PointF[] | Die Punkte. |
Method: translate(offset_x, offset_y, order)
translate(offset_x, offset_y, order)
Wendet den angegebenen Translationsvektor auf diese Matrix in der angegebenen Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| offset_x | float | Der Versatz X. |
| offset_y | float | Der Versatz Y. |
| order | MatrixOrder | Die Reihenfolge. |
Method: translate(tx, ty)
translate(tx, ty)
Wendet den angegebenen Translationsvektor auf diese Matrix unter Verwendung der (default) Prepend‑Reihenfolge an.
Parameters:
| Parameter | Typ | Beschreibung |
|---|---|---|
| tx | float | Der tx. Der tx. Der tx. |
| ty | float | Der ty. Der ty. Der ty. |