Graphics.MultiplyTransform Método

Definição

Espaço de Nomes:
System.Drawing
Assemblagem:
System.Drawing.dll

Multiplica a transformação do mundo de isto Graphics e especifica o Matrix.

Sobrecargas

Name Description
MultiplyTransform(Matrix)

Multiplica a transformação do mundo de isto Graphics e especifica o Matrix.
MultiplyTransform(Matrix, MatrixOrder)

Multiplica a transformação do mundo disto Graphics e especifica o Matrix na ordem especificada.

MultiplyTransform(Matrix)

Multiplica a transformação do mundo de isto Graphics e especifica 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 do mundo.

Exemplos

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

  • Cria uma transformMatrix matriz (uma matriz identidade dois por dois mais um vetor de translação zero).

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

  • Roda a matriz de transformação do mundo do Windows Form em 30 graus, antepõe a matriz de rotação durante 30 graus à matriz de transformação do formulário.

  • Multiplica a matriz de transformação do mundo rodada pela traduzida transformMatrix, e antepõe a transformMatrix à matriz de transformação do mundo.

  • Desenha uma elipse rotacionada 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

Observações

Este método antepõe a matriz especificada pelo matrix parâmetro, de modo que o resultado é matrix a transformação de x mundos.

Ver também

Aplica-se a

MultiplyTransform(Matrix, MatrixOrder)

Multiplica a transformação do mundo disto Graphics e especifica 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 do mundo.

order
MatrixOrder

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

Exemplos

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

  • Cria uma transformMatrix matriz (uma matriz identidade dois por dois mais um vetor de translação zero).

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

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

  • Multiplica a matriz de transformação do mundo rodada pela translada transformMatrix, acrescentando o transformMatrix à matriz de transformação do mundo.

  • Desenha uma elipse rotacionada 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

Observações

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

Ver também

Aplica-se a