Classe Matrix
Summary: Replaces the GDI+ Matrix.
Module: aspose.imaging
Full Name: aspose.imaging.Matrix
Constructors
| Name | Descrizione |
|---|---|
| Matrix() | Inizializza una nuova istanza della classe Matrix come matrice identità. |
| Matrix(m11, m12, m21, m22, m31, m32) | Inizializza una nuova istanza della classe Matrix. |
| Matrix(origin) | Crea una copia della classe Matrix. |
| Matrix(rect, plgpts) | Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti. |
| Matrix(rect, plgpts) | Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti. |
Properties
| Name | Type | Access | Descrizione |
|---|---|---|---|
| TYPE_FLIP [static] | int | r | Questo bit di flag indica che la trasformazione definita da questo oggetto esegue un capovolgimento a immagine speculare attorno a qualche asse che trasforma il normale sistema di coordinate destro in un sistema sinistro oltre alle conversioni indicate da altri bit di flag. Un sistema di coordinate destro è quello in cui l’asse X positivo ruota in senso antiorario per sovrapporsi all’asse Y positivo simile alla direzione in cui le dita della tua mano destra si avvolgono quando guardi di profilo il tuo pollice. Un sistema di coordinate sinistro è quello in cui l’asse X positivo ruota in senso orario per sovrapporsi all’asse Y positivo simile alla direzione in cui le dita della tua mano sinistra si avvolgono. Non esiste un modo matematico per determinare l’angolo della trasformazione originale di capovolgimento o specchiatura poiché tutti gli angoli di capovolgimento sono identici dato un’adeguata rotazione di aggiustamento. NOTA: TypeFlip è stato aggiunto dopo che GENERAL_TRANSFORM era in pubblico circolazione e i bit di flag non potevano più essere comodamente rinumerati senza introdurre incompatibilità binarie nel codice esterno. |
| TYPE_GENERAL_ROTATION [static] | int | r | Questo bit di flag indica che la trasformazione definita da questo oggetto esegue una rotazione di un angolo arbitrario oltre alle conversioni indicate da altri bit di flag. Una rotazione modifica gli angoli dei vettori della stessa quantità indipendentemente dalla direzione originale del vettore e senza alterare la lunghezza del vettore. Questo bit di flag è mutuamente esclusivo con il |
| TYPE_GENERAL_SCALE [static] | int | r | Una scala generale moltiplica la lunghezza dei vettori di valori diversi nelle direzioni x e y senza modificare l’angolo tra vettori perpendicolari. Questo bit di flag è mutuamente esclusivo con il flag TypeUniformScale. |
| TYPE_GENERAL_TRANSFORM [static] | int | r | Questa costante indica che la trasformazione definita da questo oggetto esegue una conversione arbitraria delle coordinate di input. Se questa trasformazione può essere classificata da una delle costanti sopra, il tipo sarà oppure la costante TypeIdentity o una combinazione dei bit di flag appropriati per le varie conversioni di coordinate che questa trasformazione esegue. |
| TYPE_IDENTITY [static] | int | r | Una trasformazione identità è quella in cui le coordinate di output sono sempre le stesse delle coordinate di input. Se questa trasformazione è diversa dalla trasformazione identità, il tipo sarà oppure la costante GENERAL_TRANSFORM o una combinazione dei bit di flag appropriati per le varie conversioni di coordinate che questa trasformazione esegue. |
| TYPE_MASK_ROTATION [static] | int | r | Questa costante è una maschera di bit per qualsiasi dei bit di flag di rotazione. |
| TYPE_MASK_SCALE [static] | int | r | Questa costante è una maschera di bit per qualsiasi dei bit di flag di scala. |
| TYPE_QUADRANT_ROTATION [static] | int | r | Questo bit di flag indica che la trasformazione definita da questo oggetto esegue una rotazione di quadrante di un multiplo di 90 gradi in aggiunta alle conversioni indicate da altri bit di flag. Una rotazione modifica gli angoli dei vettori della stessa quantità indipendentemente dalla direzione originale del vettore e senza alterare la lunghezza del vettore. Questo bit di flag è mutuamente esclusivo con il flag TypeGeneralRotation. |
| TYPE_TRANSLATION [static] | int | r | Una traslazione sposta le coordinate di una quantità costante in x e y senza modificare la lunghezza o l’angolo dei vettori. |
| TYPE_UNIFORM_SCALE [static] | int | r | Una scala uniforme moltiplica la lunghezza dei vettori della stessa quantità sia nelle direzioni x che y senza modificare l’angolo tra vettori. Questo bit di flag è mutuamente esclusivo con il flag TypeGeneralScale. |
| elements | float[] | r | Ottiene un array di valori a virgola mobile che rappresenta gli elementi di questo Matrix. |
| m11 | float | r | Ottiene l’elemento della matrice alla prima riga prima colonna. Rappresenta la scala lungo l’asse X. |
| m12 | float | r | Ottiene l’elemento della matrice alla prima riga seconda colonna. Rappresenta lo shear lungo l’asse Y. |
| m21 | float | r | Ottiene l’elemento della matrice nella seconda riga prima colonna. Rappresenta un taglio lungo l’asse X. |
| m22 | float | r | Ottiene l’elemento della matrice nella seconda riga seconda colonna. Rappresenta una scalatura lungo l’asse Y. |
| m31 | float | r | Ottiene l’elemento della matrice nella terza riga prima colonna. Rappresenta una traslazione lungo l’asse X. |
| m32 | float | r | Ottiene l’elemento della matrice nella terza riga prima colonna. Rappresenta una traslazione lungo l’asse Y. |
Methods
| Name | Descrizione |
|---|---|
| create_with_rect(rect, plgpts) | Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti. |
| create_with_rect_f(rect, plgpts) | Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti. |
| get_elements() | Ottiene una copia degli elementi della matrice. |
| multiply(t_tx) | Moltiplica questa Matrix per la matrice specificata nel parametro matrix usando l’ordine Prepend (predefinito). |
| multiply(t_tx, order) | Moltiplica questa Matrix per la matrice specificata nel parametro matrix, nell’ordine specificato nel parametro order. |
| reset() | Reimposta questa Matrix affinché contenga gli elementi della matrice identità. |
| rotate(angle) | Applica una rotazione in senso orario di un valore specificato nel parametro angle, attorno all’origine (coordinate x e y pari a zero) per questa Matrix nell’ordine predefinito (Prepend). |
| rotate(angle, order) | Applica una rotazione in senso orario di un valore specificato nel parametro angle, attorno all’origine (coordinate x e y pari a zero) per questa Matrix nell’ordine specificato. |
| rotate_at(angle, point) | Applica una rotazione in senso orario attorno al punto specificato a questa Matrix nell’ordine predefinito (Prepend). |
| rotate_at(angle, point, order) | Applica una rotazione in senso orario attorno al punto specificato a questa Matrix nell’ordine specificato. |
| scale(scale_x, scale_y, order) | Applica il vettore di scala specificato (scaleX e scaleY) a questa Matrix usando l’ordine specificato. |
| scale(sx, sy) | Applica il vettore di scala specificato (scaleX e scaleY) a questa Matrix usando l’ordine Prepend (predefinito). |
| transform_points(points) | Applica la trasformazione geometrica rappresentata da questa Matrix a un array di punti specificato. |
| translate(offset_x, offset_y, order) | Applica il vettore di traslazione specificato a questa Matrix nell’ordine specificato. |
| translate(tx, ty) | Applica il vettore di traslazione specificato a questa Matrix usando l’ordine Prepend (predefinito). |
Constructor: Matrix()
Matrix()
Inizializza una nuova istanza della classe Matrix come matrice identità.
Constructor: Matrix(m11, m12, m21, m22, m31, m32)
Matrix(m11, m12, m21, m22, m31, m32)
Inizializza una nuova istanza della classe Matrix.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| m11 | float | m00 M11 Scala X |
| m12 | float | m10 M12 Taglio Y |
| m21 | float | m01 M21 Taglio X |
| m22 | float | m11 M22 Scala Y |
| m31 | float | m02 M31 Trasla X |
| m32 | float | m12 M32 Trasla Y |
Constructor: Matrix(origin)
Matrix(origin)
Crea una copia della classe Matrix.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| origin | Matrix | Una matrice base per la gestione |
Constructor: Matrix(rect, plgpts)
Matrix(rect, plgpts)
Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rect | RectangleF | Una struttura RectangleF che rappresenta il rettangolo da trasformare. |
| plgpts | PointF[] | Un array di tre strutture PointF che rappresenta i punti di un parallelogramma al quale devono essere trasformati gli angoli superiore sinistro, superiore destro e inferiore sinistro del rettangolo. L’angolo inferiore destro del parallelogramma è implicito dai primi tre angoli. |
Constructor: Matrix(rect, plgpts)
Matrix(rect, plgpts)
Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rect | Rectangle | Una struttura RectangleF che rappresenta il rettangolo da trasformare. |
| plgpts | Point[] | Un array di tre strutture PointF che rappresenta i punti di un parallelogramma al quale devono essere trasformati gli angoli superiore sinistro, superiore destro e inferiore sinistro del rettangolo. L’angolo inferiore destro del parallelogramma è implicito dai primi tre angoli. |
Method: create_with_rect(rect, plgpts) [static]
create_with_rect(rect, plgpts)
Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rect | Rectangle | Una struttura RectangleF che rappresenta il rettangolo da trasformare. |
| plgpts | Point[] | Un array di tre strutture PointF che rappresenta i punti di un parallelogramma al quale devono essere trasformati gli angoli superiore sinistro, superiore destro e inferiore sinistro del rettangolo. L’angolo inferiore destro del parallelogramma è implicito dai primi tre angoli. |
Returns
| Tipo | Descrizione |
|---|---|
| Matrix |
Method: create_with_rect_f(rect, plgpts) [static]
create_with_rect_f(rect, plgpts)
Inizializza una nuova istanza della classe Matrix alla trasformazione geometrica definita dal rettangolo specificato e dall’array di punti.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| rect | RectangleF | Una struttura RectangleF che rappresenta il rettangolo da trasformare. |
| plgpts | PointF[] | Un array di tre strutture PointF che rappresenta i punti di un parallelogramma al quale devono essere trasformati gli angoli superiore sinistro, superiore destro e inferiore sinistro del rettangolo. L’angolo inferiore destro del parallelogramma è implicito dai primi tre angoli. |
Returns
| Tipo | Descrizione |
|---|---|
| Matrix |
Method: get_elements()
get_elements()
Ottiene una copia degli elementi della matrice.
Returns
| Tipo | Descrizione |
|---|---|
| float[] | Una copia degli elementi della matrice. |
Method: multiply(t_tx)
multiply(t_tx)
Moltiplica questa Matrix per la matrice specificata nel parametro matrix usando l’ordine Prepend (predefinito).
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| t_tx | Matrix | La matrice con cui moltiplicare. |
Method: multiply(t_tx, order)
multiply(t_tx, order)
Moltiplica questa Matrix per la matrice specificata nel parametro matrix, nell’ordine specificato nel parametro order.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| t_tx | Matrix | Il tx. Il tx. Il tx. |
| order | MatrixOrder | L’ordine. L’ordine. L’ordine. |
Method: rotate(angle)
rotate(angle)
Applica una rotazione in senso orario di un valore specificato nel parametro angle, attorno all’origine (coordinate x e y pari a zero) per questa Matrix nell’ordine predefinito (Prepend).
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| angle | float | L’angolo di rotazione. |
Method: rotate(angle, order)
rotate(angle, order)
Applica una rotazione in senso orario di un valore specificato nel parametro angle, attorno all’origine (coordinate x e y pari a zero) per questa Matrix nell’ordine specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| angle | float | L’angolo di rotazione. |
| order | MatrixOrder | L’ordine della matrice. |
Method: rotate_at(angle, point)
rotate_at(angle, point)
Applica una rotazione in senso orario attorno al punto specificato a questa Matrix nell’ordine predefinito (Prepend).
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| angle | float | L’angolo. |
| point | PointF | Il punto. |
Method: rotate_at(angle, point, order)
rotate_at(angle, point, order)
Applica una rotazione in senso orario attorno al punto specificato a questa Matrix nell’ordine specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| angle | float | L’angolo. |
| point | PointF | Il punto. |
| order | MatrixOrder | L’ordine. |
Method: scale(scale_x, scale_y, order)
scale(scale_x, scale_y, order)
Applica il vettore di scala specificato (scaleX e scaleY) a questa Matrix usando l’ordine specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| scale_x | float | La scala X. |
| scale_y | float | La scala Y. |
| order | MatrixOrder | L’ordine. |
Method: scale(sx, sy)
scale(sx, sy)
Applica il vettore di scala specificato (scaleX e scaleY) a questa Matrix usando l’ordine Prepend (predefinito).
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| sx | float | Il sx. Il sx. Il sx. |
| sy | float | Il sy. Il sy. Il sy. |
Method: transform_points(points)
transform_points(points)
Applica la trasformazione geometrica rappresentata da questa Matrix a un array di punti specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| points | PointF[] | I punti. |
Method: translate(offset_x, offset_y, order)
translate(offset_x, offset_y, order)
Applica il vettore di traslazione specificato a questa Matrix nell’ordine specificato.
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| offset_x | float | L’offset X. |
| offset_y | float | L’offset Y. |
| order | MatrixOrder | L’ordine. |
Method: translate(tx, ty)
translate(tx, ty)
Applica il vettore di traslazione specificato a questa Matrix usando l’ordine Prepend (predefinito).
Parameters:
| Parametro | Tipo | Descrizione |
|---|---|---|
| tx | float | Il tx. Il tx. Il tx. |
| ty | float | Il ty. Il ty. Il ty. |