Graphics.MultiplyTransform Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Multiplica a transformação global deste Graphics e especificou o Matrix.

Sobrecargas

MultiplyTransform(Matrix)	Multiplica a transformação global deste Graphics e especificou o Matrix.
MultiplyTransform(Matrix, MatrixOrder)	Multiplica a transformação global deste Graphics e especificou o Matrix na ordem especificada.

MultiplyTransform(Matrix)

Origem:

Graphics.cs

Multiplica a transformação global deste Graphics e especificou o Matrix.

public:
 void MultiplyTransform(System::Drawing::Drawing2D::Matrix ^ matrix);

public void MultiplyTransform (System.Drawing.Drawing2D.Matrix matrix);

member this.MultiplyTransform : System.Drawing.Drawing2D.Matrix -> unit

Public Sub MultiplyTransform (matrix As Matrix)

Parâmetros

matrix

Matrix

4x4 Matrix que multiplica a transformação global.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma transformMatrix matriz (uma matriz de duas por duas identidades mais um vetor de tradução zero).

• Converte a matriz de transformação por um vetor (200, 100).

• Gira a matriz de transformação do mundo do Windows Form em 30 graus, acrescenta a matriz de rotação de 30 graus à matriz de transformação do formulário.

• Multiplica a matriz de transformação do mundo girado pelo traduzido transformMatrixe acrescenta o transformMatrix à matriz de transformação do mundo.

• Desenha uma elipse girada e traduzida.

public:
   void MultiplyTransformMatrix( PaintEventArgs^ e )
   {
      // Create transform matrix.
      Matrix^ transformMatrix = gcnew Matrix;

      // Translate matrix, prepending translation vector.
      transformMatrix->Translate( 200.0F, 100.0F );

      // Rotate transformation matrix of graphics object,
      // prepending rotation matrix.
      e->Graphics->RotateTransform( 30.0F );

      // Multiply (prepend to) transformation matrix of
      // graphics object to translate graphics transformation.
      e->Graphics->MultiplyTransform( transformMatrix );

      // Draw rotated, translated ellipse.
      e->Graphics->DrawEllipse( gcnew Pen( Color::Blue,3.0f ), -80, -40, 160, 80 );
   }

private void MultiplyTransformMatrix(PaintEventArgs e)
{

    // Create transform matrix.
    Matrix transformMatrix = new Matrix();

    // Translate matrix, prepending translation vector.
    transformMatrix.Translate(200.0F, 100.0F);

    // Rotate transformation matrix of graphics object,

    // prepending rotation matrix.
    e.Graphics.RotateTransform(30.0F);

    // Multiply (prepend to) transformation matrix of

    // graphics object to translate graphics transformation.
    e.Graphics.MultiplyTransform(transformMatrix);

    // Draw rotated, translated ellipse.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), -80, -40, 160, 80);
}

Private Sub MultiplyTransformMatrix(ByVal e As PaintEventArgs)

    ' Create transform matrix.
    Dim transformMatrix As New Matrix

    ' Translate matrix, prepending translation vector.
    transformMatrix.Translate(200.0F, 100.0F)

    ' Rotate transformation matrix of graphics object,

    ' prepending rotation matrix.
    e.Graphics.RotateTransform(30.0F)

    ' Multiply (prepend to) transformation matrix of

    ' graphics object to translate graphics transformation.
    e.Graphics.MultiplyTransform(transformMatrix)

    ' Draw rotated, translated ellipse.
    e.Graphics.DrawEllipse(New Pen(Color.Blue, 3), -80, -40, 160, 80)
End Sub

Comentários

Esse método precede a matriz especificada pelo matrix parâmetro , de modo que o resultado seja matrix a transformação x world.

Confira também

• Representação matricial de transformações

MultiplyTransform(Matrix, MatrixOrder)

Origem:

Graphics.cs

Multiplica a transformação global deste Graphics e especificou o Matrix na ordem especificada.

public:
 void MultiplyTransform(System::Drawing::Drawing2D::Matrix ^ matrix, System::Drawing::Drawing2D::MatrixOrder order);

public void MultiplyTransform (System.Drawing.Drawing2D.Matrix matrix, System.Drawing.Drawing2D.MatrixOrder order);

member this.MultiplyTransform : System.Drawing.Drawing2D.Matrix * System.Drawing.Drawing2D.MatrixOrder -> unit

Public Sub MultiplyTransform (matrix As Matrix, order As MatrixOrder)

Parâmetros

matrix

Matrix

4x4 Matrix que multiplica a transformação global.

order

MatrixOrder

Membro da enumeração MatrixOrder que determina a ordem da multiplicação.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma transformMatrix matriz (uma matriz de duas por duas identidades mais um vetor de tradução zero).

• Converte a matriz de transformação por um vetor (200, 100).

• Gira a matriz de transformação mundial do Windows Form em 30 graus, acrescentando a matriz de rotação de 30 graus à matriz de transformação do formulário.

• Multiplica a matriz de transformação do mundo girado pelo traduzido transformMatrix, acrescentando o transformMatrix à matriz de transformação do mundo.

• Desenha uma elipse girada e traduzida.

public:
   void MultiplyTransformMatrixOrder( PaintEventArgs^ e )
   {
      // Create transform matrix.
      Matrix^ transformMatrix = gcnew Matrix;

      // Translate matrix, prepending translation vector.
      transformMatrix->Translate( 200.0F, 100.0F );

      // Rotate transformation matrix of graphics object,
      // prepending rotation matrix.
      e->Graphics->RotateTransform( 30.0F );

      // Multiply (append to) transformation matrix of
      // graphics object to translate graphics transformation.
      e->Graphics->MultiplyTransform( transformMatrix, MatrixOrder::Append );

      // Draw rotated, translated ellipse.
      e->Graphics->DrawEllipse( gcnew Pen( Color::Blue,3.0f ), -80, -40, 160, 80 );
   }

private void MultiplyTransformMatrixOrder(PaintEventArgs e)
{

    // Create transform matrix.
    Matrix transformMatrix = new Matrix();

    // Translate matrix, prepending translation vector.
    transformMatrix.Translate(200.0F, 100.0F);

    // Rotate transformation matrix of graphics object,

    // prepending rotation matrix.
    e.Graphics.RotateTransform(30.0F);

    // Multiply (append to) transformation matrix of

    // graphics object to translate graphics transformation.
    e.Graphics.MultiplyTransform(transformMatrix, MatrixOrder.Append);

    // Draw rotated, translated ellipse.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), -80, -40, 160, 80);
}

Private Sub MultiplyTransformMatrixOrder(ByVal e As PaintEventArgs)

    ' Create transform matrix.
    Dim transformMatrix As New Matrix

    ' Translate matrix, prepending translation vector.
    transformMatrix.Translate(200.0F, 100.0F)

    ' Rotate transformation matrix of graphics object,

    ' prepending rotation matrix.
    e.Graphics.RotateTransform(30.0F)

    ' Multiply (append to) transformation matrix of

    ' graphics object to translate graphics transformation.
    e.Graphics.MultiplyTransform(transformMatrix, MatrixOrder.Append)

    ' Draw rotated, translated ellipse.
    e.Graphics.DrawEllipse(New Pen(Color.Blue, 3), -80, -40, 160, 80)
End Sub

Comentários

Um valor de Prepend para o order parâmetro especifica que a ordem da multiplicação é matrix a transformação x world. Um valor de Append para order especifica que a ordem da multiplicação é a transformação de mundo x matrix.

Confira também

• Representação matricial de transformações