Classe Matrix

Summary: Replaces the GDI+ Matrix.

Module: aspose.imaging

Full Name: aspose.imaging.Matrix

Constructors

NameDescription
Matrix()Initialise une nouvelle instance de la classe Matrix en tant que matrice identité.
Matrix(m11, m12, m21, m22, m31, m32)Initialise une nouvelle instance de la classe Matrix.
Matrix(origin)Crée une copie de la classe Matrix.
Matrix(rect, plgpts)Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.
Matrix(rect, plgpts)Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.

Properties

NameTypeAccessDescription
TYPE_FLIP [static]intrCe bit de drapeau indique que la transformation définie par cet objet
effectue un retournement en miroir autour d’un axe qui transforme le
système de coordonnées normalement droitier en un système gaucher
en plus des conversions indiquées par les autres bits de drapeau.
Un système de coordonnées droitier est celui où l’axe X positif
tourne dans le sens antihoraire pour se superposer à l’axe Y positif
similaire à la direction dans laquelle les doigts de votre main droite
se courbent lorsque vous regardez votre pouce de face.
Un système de coordonnées gaucher est celui où l’axe X positif
tourne dans le sens horaire pour se superposer à l’axe Y positif similaire
à la direction dans laquelle les doigts de votre main gauche se courbent.
Il n’existe aucun moyen mathématique de déterminer l’angle de la
transformation de retournement ou de miroir d’origine puisque tous les angles
de retournement sont identiques avec une rotation d’ajustement appropriée.
NOTE : TypeFlip a été ajouté après que GENERAL_TRANSFORM était en diffusion publique
et les bits de drapeau ne pouvaient plus être renumérotés commodément
sans introduire d’incompatibilité binaire dans le code externe.
TYPE_GENERAL_ROTATION [static]intrCe bit de drapeau indique que la transformation définie par cet objet
effectue une rotation d’un angle arbitraire en plus des
conversions indiquées par les autres bits de drapeau.
Une rotation modifie les angles des vecteurs du même montant
quel que soit le sens d’origine du vecteur et sans
changer la longueur du vecteur.
Ce bit de drapeau est mutuellement exclusif avec le
TYPE_GENERAL_SCALE [static]intrUne mise à l’échelle générale multiplie la longueur des vecteurs par des valeurs différentes
dans les directions x et y sans changer l’angle
entre les vecteurs perpendiculaires.
Ce bit de drapeau est mutuellement exclusif avec le drapeau TypeUniformScale.
TYPE_GENERAL_TRANSFORM [static]intrCette constante indique que la transformation définie par cet objet
effectue une conversion arbitraire des coordonnées d’entrée.
Si cette transformation peut être classée par l’une des constantes ci‑dessus,
le type sera soit la constante TypeIdentity soit une
combinaison des bits de drapeau appropriés pour les diverses conversions de coordonnées
que cette transformation effectue.
TYPE_IDENTITY [static]intrUne transformation identité est celle dans laquelle les coordonnées de sortie sont
toujours les mêmes que les coordonnées d’entrée.
Si cette transformation n’est pas la transformation identité,
le type sera soit la constante GENERAL_TRANSFORM soit une
combinaison des bits de drapeau appropriés pour les diverses conversions de coordonnées
que cette transformation effectue.
TYPE_MASK_ROTATION [static]intrCette constante est un masque de bits pour n’importe lequel des bits de drapeau de rotation.
TYPE_MASK_SCALE [static]intrCette constante est un masque de bits pour n’importe lequel des bits de drapeau d’échelle.
TYPE_QUADRANT_ROTATION [static]intrCe bit de drapeau indique que la transformation définie par cet objet
effectue une rotation de quadrant par un multiple de 90 degrés en
plus des conversions indiquées par les autres bits de drapeau.
Une rotation modifie les angles des vecteurs du même montant
quel que soit le sens d’origine du vecteur et sans
changer la longueur du vecteur.
Ce bit de drapeau est mutuellement exclusif avec le drapeau TypeGeneralRotation.
TYPE_TRANSLATION [static]intrUne translation déplace les coordonnées d’une quantité constante en x
et y sans changer la longueur ou l’angle des vecteurs.
TYPE_UNIFORM_SCALE [static]intrUne mise à l’échelle uniforme multiplie la longueur des vecteurs du même montant
dans les directions x et y sans changer l’angle entre
vecteurs.
elementsfloat[]rObtient un tableau de valeurs à virgule flottante qui représente les éléments de ce Matrix.
m11floatrObtient l’élément de matrice à la première ligne première colonne. Représente l’échelle le long de l’axe X.
m12floatrObtient l’élément de matrice à la première ligne deuxième colonne. Représente le cisaillement le long de l’axe Y.
m21floatrObtient l’élément de la matrice à la deuxième ligne première colonne. Représente le cisaillement le long de l’axe X.
m22floatrObtient l’élément de la matrice à la deuxième ligne deuxième colonne. Représente l’échelle le long de l’axe Y.
m31floatrObtient l’élément de la matrice à la troisième ligne première colonne. Représente la translation le long de l’axe X.
m32floatrObtient l’élément de la matrice à la troisième ligne première colonne. Représente la translation le long de l’axe Y.

Methods

NameDescription
create_with_rect(rect, plgpts)Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.
create_with_rect_f(rect, plgpts)Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.
get_elements()Obtient une copie des éléments de la matrice.
multiply(t_tx)Multiplie cette Matrix par la matrice spécifiée dans le paramètre matrix en utilisant l’ordre (par défaut) Prepend.
multiply(t_tx, order)Multiplie cette Matrix par la matrice spécifiée dans le paramètre matrix, et dans l’ordre spécifié dans le paramètre order.
reset()Réinitialise cette Matrix pour qu’elle contienne les éléments de la matrice identité.
rotate(angle)Applique une rotation horaire d’une valeur spécifiée dans le paramètre angle, autour de l’origine (coordonnées x et y nulles) pour cette Matrix dans l’ordre par défaut (Prepend).
rotate(angle, order)Applique une rotation horaire d’une valeur spécifiée dans le paramètre angle, autour de l’origine (coordonnées x et y nulles) pour cette Matrix dans l’ordre spécifié.
rotate_at(angle, point)Applique une rotation horaire autour du point spécifié à cette Matrix dans l’ordre par défaut (Prepend).
rotate_at(angle, point, order)Applique une rotation horaire autour du point spécifié à cette Matrix dans l’ordre spécifié.
scale(scale_x, scale_y, order)Applique le vecteur d’échelle spécifié (scaleX et scaleY) à cette Matrix en utilisant l’ordre spécifié.
scale(sx, sy)Applique le vecteur d’échelle spécifié (scaleX et scaleY) à cette Matrix en utilisant l’ordre (par défaut) Prepend.
transform_points(points)Applique la transformation géométrique représentée par cette Matrix à un tableau de points spécifié.
translate(offset_x, offset_y, order)Applique le vecteur de translation spécifié à cette Matrix dans l’ordre spécifié.
translate(tx, ty)Applique le vecteur de translation spécifié à cette Matrix en utilisant l’ordre (par défaut) Prepend.

Constructor: Matrix()

 Matrix() 

Initialise une nouvelle instance de la classe Matrix en tant que matrice identité.

Constructor: Matrix(m11, m12, m21, m22, m31, m32)

 Matrix(m11, m12, m21, m22, m31, m32) 

Initialise une nouvelle instance de la classe Matrix.

Parameters:

ParamètreTypeDescription
m11floatm00 M11 Échelle X
m12floatm10 M12 Cisaillement Y
m21floatm01 M21 Cisaillement X
m22floatm11 M22 Échelle Y
m31floatm02 M31 Translation X
m32floatm12 M32 Translation Y

Constructor: Matrix(origin)

 Matrix(origin) 

Crée une copie de la classe Matrix.

Parameters:

ParamètreTypeDescription
originMatrixUne matrice de base pour la copie

Constructor: Matrix(rect, plgpts)

 Matrix(rect, plgpts) 

Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.

Parameters:

ParamètreTypeDescription
rectRectangleFUne structure RectangleF qui représente le rectangle à transformer.
plgptsPointF[]Un tableau de trois structures PointF qui représente les points d’un parallélogramme vers lequel les coins supérieur-gauche, supérieur-droit et inférieur-gauche du rectangle doivent être transformés. Le coin inférieur-droit du parallélogramme est implicite à partir des trois premiers coins.

Constructor: Matrix(rect, plgpts)

 Matrix(rect, plgpts) 

Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.

Parameters:

ParamètreTypeDescription
rectRectangleUne structure RectangleF qui représente le rectangle à transformer.
plgptsPoint[]Un tableau de trois structures PointF qui représente les points d’un parallélogramme vers lequel les coins supérieur-gauche, supérieur-droit et inférieur-gauche du rectangle doivent être transformés. Le coin inférieur-droit du parallélogramme est implicite à partir des trois premiers coins.

Method: create_with_rect(rect, plgpts) [static]

 create_with_rect(rect, plgpts) 

Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.

Parameters:

ParamètreTypeDescription
rectRectangleUne structure RectangleF qui représente le rectangle à transformer.
plgptsPoint[]Un tableau de trois structures PointF qui représente les points d’un parallélogramme vers lequel les coins supérieur-gauche, supérieur-droit et inférieur-gauche du rectangle doivent être transformés. Le coin inférieur-droit du parallélogramme est implicite à partir des trois premiers coins.

Returns

TypeDescription
Matrix

Method: create_with_rect_f(rect, plgpts) [static]

 create_with_rect_f(rect, plgpts) 

Initialise une nouvelle instance de la classe Matrix pour la transformation géométrique définie par le rectangle spécifié et le tableau de points.

Parameters:

ParamètreTypeDescription
rectRectangleFUne structure RectangleF qui représente le rectangle à transformer.
plgptsPointF[]Un tableau de trois structures PointF qui représente les points d’un parallélogramme vers lequel les coins supérieur-gauche, supérieur-droit et inférieur-gauche du rectangle doivent être transformés. Le coin inférieur-droit du parallélogramme est implicite à partir des trois premiers coins.

Returns

TypeDescription
Matrix

Method: get_elements()

 get_elements() 

Obtient une copie des éléments de la matrice.

Returns

TypeDescription
float[]Une copie des éléments de la matrice.

Method: multiply(t_tx)

 multiply(t_tx) 

Multiplie cette Matrix par la matrice spécifiée dans le paramètre matrix en utilisant l’ordre (par défaut) Prepend.

Parameters:

ParamètreTypeDescription
t_txMatrixLa matrice avec laquelle multiplier.

Method: multiply(t_tx, order)

 multiply(t_tx, order) 

Multiplie cette Matrix par la matrice spécifiée dans le paramètre matrix, et dans l’ordre spécifié dans le paramètre order.

Parameters:

ParamètreTypeDescription
t_txMatrixLe tx. Le tx. Le tx.
orderMatrixOrderL’ordre. L’ordre. L’ordre.

Method: rotate(angle)

 rotate(angle) 

Applique une rotation horaire d’une valeur spécifiée dans le paramètre angle, autour de l’origine (coordonnées x et y nulles) pour cette Matrix dans l’ordre par défaut (Prepend).

Parameters:

ParamètreTypeDescription
anglefloatL’angle de rotation.

Method: rotate(angle, order)

 rotate(angle, order) 

Applique une rotation horaire d’une valeur spécifiée dans le paramètre angle, autour de l’origine (coordonnées x et y nulles) pour cette Matrix dans l’ordre spécifié.

Parameters:

ParamètreTypeDescription
anglefloatL’angle de rotation.
orderMatrixOrderL’ordre de la matrice.

Method: rotate_at(angle, point)

 rotate_at(angle, point) 

Applique une rotation horaire autour du point spécifié à cette Matrix dans l’ordre par défaut (Prepend).

Parameters:

ParamètreTypeDescription
anglefloatL’angle.
pointPointFLe point.

Method: rotate_at(angle, point, order)

 rotate_at(angle, point, order) 

Applique une rotation horaire autour du point spécifié à cette Matrix dans l’ordre spécifié.

Parameters:

ParamètreTypeDescription
anglefloatL’angle.
pointPointFLe point.
orderMatrixOrderL’ordre.

Method: scale(scale_x, scale_y, order)

 scale(scale_x, scale_y, order) 

Applique le vecteur d’échelle spécifié (scaleX et scaleY) à cette Matrix en utilisant l’ordre spécifié.

Parameters:

ParamètreTypeDescription
scale_xfloatL’échelle X.
scale_yfloatL’échelle Y.
orderMatrixOrderL’ordre.

Method: scale(sx, sy)

 scale(sx, sy) 

Applique le vecteur d’échelle spécifié (scaleX et scaleY) à cette Matrix en utilisant l’ordre (par défaut) Prepend.

Parameters:

ParamètreTypeDescription
sxfloatLe sx. Le sx. Le sx.
syfloatLe sy. Le sy. Le sy.

Method: transform_points(points)

 transform_points(points) 

Applique la transformation géométrique représentée par cette Matrix à un tableau de points spécifié.

Parameters:

ParamètreTypeDescription
pointsPointF[]Les points.

Method: translate(offset_x, offset_y, order)

 translate(offset_x, offset_y, order) 

Applique le vecteur de translation spécifié à cette Matrix dans l’ordre spécifié.

Parameters:

ParamètreTypeDescription
offset_xfloatLe décalage X.
offset_yfloatLe décalage Y.
orderMatrixOrderL’ordre.

Method: translate(tx, ty)

 translate(tx, ty) 

Applique le vecteur de translation spécifié à cette Matrix en utilisant l’ordre (par défaut) Prepend.

Parameters:

ParamètreTypeDescription
txfloatLe tx. Le tx. Le tx.
tyfloatLe ty. Le ty. Le ty.