Classe Matrix

Summary: Replaces the GDI+ Matrix.

Module: aspose.imaging

Full Name: aspose.imaging.Matrix

Constructors

NameDescrizione
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

NameTypeAccessDescrizione
TYPE_FLIP [static]intrQuesto 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]intrQuesto 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]intrUna 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]intrQuesta 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]intrUna 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]intrQuesta costante è una maschera di bit per qualsiasi dei bit di flag di rotazione.
TYPE_MASK_SCALE [static]intrQuesta costante è una maschera di bit per qualsiasi dei bit di flag di scala.
TYPE_QUADRANT_ROTATION [static]intrQuesto 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]intrUna 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]intrUna 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.
elementsfloat[]rOttiene un array di valori a virgola mobile che rappresenta gli elementi di questo Matrix.
m11floatrOttiene l’elemento della matrice alla prima riga prima colonna. Rappresenta la scala lungo l’asse X.
m12floatrOttiene l’elemento della matrice alla prima riga seconda colonna. Rappresenta lo shear lungo l’asse Y.
m21floatrOttiene l’elemento della matrice nella seconda riga prima colonna. Rappresenta un taglio lungo l’asse X.
m22floatrOttiene l’elemento della matrice nella seconda riga seconda colonna. Rappresenta una scalatura lungo l’asse Y.
m31floatrOttiene l’elemento della matrice nella terza riga prima colonna. Rappresenta una traslazione lungo l’asse X.
m32floatrOttiene l’elemento della matrice nella terza riga prima colonna. Rappresenta una traslazione lungo l’asse Y.

Methods

NameDescrizione
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:

ParametroTipoDescrizione
m11floatm00 M11 Scala X
m12floatm10 M12 Taglio Y
m21floatm01 M21 Taglio X
m22floatm11 M22 Scala Y
m31floatm02 M31 Trasla X
m32floatm12 M32 Trasla Y

Constructor: Matrix(origin)

 Matrix(origin) 

Crea una copia della classe Matrix.

Parameters:

ParametroTipoDescrizione
originMatrixUna 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:

ParametroTipoDescrizione
rectRectangleFUna struttura RectangleF che rappresenta il rettangolo da trasformare.
plgptsPointF[]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:

ParametroTipoDescrizione
rectRectangleUna struttura RectangleF che rappresenta il rettangolo da trasformare.
plgptsPoint[]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:

ParametroTipoDescrizione
rectRectangleUna struttura RectangleF che rappresenta il rettangolo da trasformare.
plgptsPoint[]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

TipoDescrizione
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:

ParametroTipoDescrizione
rectRectangleFUna struttura RectangleF che rappresenta il rettangolo da trasformare.
plgptsPointF[]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

TipoDescrizione
Matrix

Method: get_elements()

 get_elements() 

Ottiene una copia degli elementi della matrice.

Returns

TipoDescrizione
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:

ParametroTipoDescrizione
t_txMatrixLa 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:

ParametroTipoDescrizione
t_txMatrixIl tx. Il tx. Il tx.
orderMatrixOrderL’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:

ParametroTipoDescrizione
anglefloatL’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:

ParametroTipoDescrizione
anglefloatL’angolo di rotazione.
orderMatrixOrderL’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:

ParametroTipoDescrizione
anglefloatL’angolo.
pointPointFIl 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:

ParametroTipoDescrizione
anglefloatL’angolo.
pointPointFIl punto.
orderMatrixOrderL’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:

ParametroTipoDescrizione
scale_xfloatLa scala X.
scale_yfloatLa scala Y.
orderMatrixOrderL’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:

ParametroTipoDescrizione
sxfloatIl sx. Il sx. Il sx.
syfloatIl 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:

ParametroTipoDescrizione
pointsPointF[]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:

ParametroTipoDescrizione
offset_xfloatL’offset X.
offset_yfloatL’offset Y.
orderMatrixOrderL’ordine.

Method: translate(tx, ty)

 translate(tx, ty) 

Applica il vettore di traslazione specificato a questa Matrix usando l’ordine Prepend (predefinito).

Parameters:

ParametroTipoDescrizione
txfloatIl tx. Il tx. Il tx.
tyfloatIl ty. Il ty. Il ty.