Matrix.Shear Método

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Aplica o vetor de distorção especificado a este Matrix acrescentando o vetor de distorção.

Sobrecargas

Shear(Single, Single, MatrixOrder)	Aplica o vetor de distorção especificado a este Matrix na ordem especificada.
Shear(Single, Single)	Aplica o vetor de distorção especificado a este Matrix acrescentando a transformação de distorção.

Shear(Single, Single, MatrixOrder)

Origem:

Matrix.cs

Aplica o vetor de distorção especificado a este Matrix na ordem especificada.

public:
 void Shear(float shearX, float shearY, System::Drawing::Drawing2D::MatrixOrder order);

public void Shear (float shearX, float shearY, System.Drawing.Drawing2D.MatrixOrder order);

member this.Shear : single * single * System.Drawing.Drawing2D.MatrixOrder -> unit

Public Sub Shear (shearX As Single, shearY As Single, order As MatrixOrder)

Parâmetros

shearX

Single

O fator de distorção horizontal.

shearY

Single

O fator de distorção vertical.

order

MatrixOrder

Um MatrixOrder que especifica a ordem (acrescentar no começo ou no fim) em que a distorção é aplicada.

Exemplos

Para ver um exemplo, consulte Shear(Single, Single).

Comentários

A transformação aplicada nesse método é uma tesoura pura somente se um dos parâmetros for 0. Aplicada a um retângulo na origem, quando o shearY fator é 0, a transformação move a borda inferior horizontalmente por shearX vezes a altura do retângulo. Quando o shearX fator é 0, ele move a borda direita verticalmente por shearY vezes a largura do retângulo. A cautela está em ordem quando ambos os parâmetros são diferentes de zero, pois os resultados são difíceis de prever. Por exemplo, se ambos os fatores forem 1, a transformação será singular (portanto, não invertível), apertando todo o plano para uma única linha.

Shear(Single, Single)

Origem:

Matrix.cs

Aplica o vetor de distorção especificado a este Matrix acrescentando a transformação de distorção.

public:
 void Shear(float shearX, float shearY);

public void Shear (float shearX, float shearY);

member this.Shear : single * single -> unit

Public Sub Shear (shearX As Single, shearY As Single)

Parâmetros

shearX

Single

O fator de distorção horizontal.

shearY

Single

O fator de distorção vertical.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, um Paint objeto de evento. O código executa a seguinte ação:

• Desenha um retângulo na tela, usando uma caneta verde, antes de aplicar uma transformação de dimensionamento.

• Cria um Matrix e o usa para definir uma transformação de coordenadas do mundo para o Graphics.

• Desenha outro retângulo usando uma caneta vermelha.

• Desenha uma elipse usando uma caneta azul.

O resultado é um retângulo verde, um paralelismo vermelho e uma elipse azul transformada. Observe que o retângulo verde (desenhado antes de definir a transformação) usa diretamente as coordenadas fornecidas na DrawRectangle chamada. As outras duas figuras são transformadas antes do desenho. O retângulo é transformado em um paralelismo (vermelho) e a elipse (azul) é transformada para caber no paralelismo transformado. Observe que a parte inferior do retângulo é movida (desarmada) no eixo x por um fator de duas vezes a altura do retângulo, formando assim o paralelismo.

public:
   void MatrixShearExample( PaintEventArgs^ e )
   {
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Shear( 2, 0 );
      e->Graphics->DrawRectangle( gcnew Pen( Color::Green ), 0, 0, 100, 50 );
      e->Graphics->MultiplyTransform( myMatrix );
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red ), 0, 0, 100, 50 );
      e->Graphics->DrawEllipse( gcnew Pen( Color::Blue ), 0, 0, 100, 50 );
   }

public void MatrixShearExample(PaintEventArgs e)
{
    Matrix myMatrix = new Matrix();
    myMatrix.Shear(2, 0);
    e.Graphics.DrawRectangle(new Pen(Color.Green), 0, 0, 100, 50);
    e.Graphics.MultiplyTransform(myMatrix);
    e.Graphics.DrawRectangle(new Pen(Color.Red), 0, 0, 100, 50);
    e.Graphics.DrawEllipse(new Pen(Color.Blue), 0, 0, 100, 50);
}

Public Sub MatrixShearExample(ByVal e As PaintEventArgs)
    Dim myMatrix As New Matrix
    myMatrix.Shear(2, 0)
    e.Graphics.DrawRectangle(New Pen(Color.Green), 0, 0, 100, 50)
    e.Graphics.MultiplyTransform(myMatrix)
    e.Graphics.DrawRectangle(New Pen(Color.Red), 0, 0, 100, 50)
    e.Graphics.DrawEllipse(New Pen(Color.Blue), 0, 0, 100, 50)
End Sub

Comentários

A transformação aplicada nesse método é uma tesoura pura somente se um dos parâmetros for 0. Aplicada a um retângulo na origem, quando o shearY fator é 0, a transformação move a borda inferior horizontalmente por shearX vezes a altura do retângulo. Quando o shearX fator é 0, ele move a borda direita verticalmente por shearY vezes a largura do retângulo. A cautela está em ordem quando ambos os parâmetros são diferentes de zero, pois os resultados são difíceis de prever. Por exemplo, se ambos os fatores forem 1, a transformação será singular (portanto, não invertível), apertando todo o plano para uma única linha.