Clase System.Drawing.Drawing2D.Matrix

En este artículo se proporcionan comentarios adicionales a la documentación de referencia de esta API.

La Matrix clase encapsula una matriz afín de 3 a 3 que representa una transformación geométrica.

En GDI+, puede almacenar una transformación affine en un Matrix objeto . Dado que la tercera columna de una matriz que representa una transformación affine siempre es (0, 0, 1), solo se especifican los seis números de las dos primeras columnas al construir un Matrix objeto . La instrucción Matrix myMatrix = new Matrix(0, 1, -1, 0, 3, 4) construye la matriz que se muestra en la ilustración siguiente.

Nota:

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).

Transformaciones compuestas

Una transformación compuesta es una secuencia de transformaciones, una seguida de la otra. Tenga en cuenta las matrices y las transformaciones de la lista siguiente:

Matriz	Transformación
Matriz A	Girar 90 grados
Matriz B	Escalar por un factor de 2 en la dirección del eje x
Matriz C	Traducir 3 unidades en la dirección y

Si comienza con el punto (2, 1) - representado por la matriz [2 1 1] y multiplicado por A, después B, C, el punto (2, 1) se somete a las tres transformaciones en el orden enumerado.

[2 1 1]ABC = [-2 5 1]

En lugar de almacenar las tres partes de la transformación compuesta en tres matrices independientes, puede multiplicar A, B y C juntas para obtener una sola matriz 3×3 que almacena toda la transformación compuesta. Supongamos que ABC = D. A continuación, un punto multiplicado por D da el mismo resultado que un punto multiplicado por A, después B y C.

[2 1 1]D = [-2 5 1]

En la ilustración siguiente se muestran las matrices A, B, C y D.

El hecho de que la matriz de una transformación compuesta se puede formar multiplicando las matrices de transformación individuales significa que cualquier secuencia de transformaciones afín se puede almacenar en un solo Matrix objeto.

Precaución

El orden de una transformación compuesta es importante. En general, girar y, a continuación, escalar, traducir no es lo mismo que la escala, luego girar y luego traducir. Del mismo modo, el orden de multiplicación de matriz es importante. En general, ABC no es lo mismo que BAC.

La Matrix clase proporciona varios métodos para crear una transformación compuesta: Multiply, Rotate, RotateAtScale, , Sheary Translate. En el ejemplo siguiente se crea la matriz de una transformación compuesta que primero gira 30 grados, luego se escala por un factor de 2 en la dirección y, y a continuación traduce 5 unidades en la dirección x.

Matrix myMatrix = new Matrix();
myMatrix.Rotate(30);
myMatrix.Scale(1, 2, MatrixOrder.Append);
myMatrix.Translate(5, 0, MatrixOrder.Append);

Dim myMatrix As New Matrix()
myMatrix.Rotate(30)
myMatrix.Scale(1, 2, MatrixOrder.Append)
myMatrix.Translate(5, 0, MatrixOrder.Append)