Matrix.TransformPoints Metoda

Definicja

Stosuje przekształcenia geometryczne, Matrix które reprezentuje do tablicy punktów.Applies the geometric transform this Matrix represents to an array of points.

Przeciążenia

TransformPoints(Point[])

Stosuje transformację geometryczną reprezentowaną przez tę wartość Matrix do określonej tablicy punktów.Applies the geometric transform represented by this Matrix to a specified array of points.

TransformPoints(PointF[])

Stosuje transformację geometryczną reprezentowaną przez tę wartość Matrix do określonej tablicy punktów.Applies the geometric transform represented by this Matrix to a specified array of points.

TransformPoints(Point[])

Stosuje transformację geometryczną reprezentowaną przez tę wartość Matrix do określonej tablicy punktów.Applies the geometric transform represented by this Matrix to a specified array of points.

public:
 void TransformPoints(cli::array <System::Drawing::Point> ^ pts);
public void TransformPoints (System.Drawing.Point[] pts);
member this.TransformPoints : System.Drawing.Point[] -> unit
Public Sub TransformPoints (pts As Point())

Parametry

pts
Point[]

Tablica Point struktur reprezentujących punkty do przekształcenia.An array of Point structures that represents the points to transform.

Przykłady

Poniższy przykład kodu jest przeznaczony do użytku z Windows Forms i wymaga PaintEventArgs e Paint obiektu zdarzenia.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an Paint event object. Kod wykonuje następujące czynności:The code performs the following actions:

  • Tworzy tablicę punktów, które tworzą prostokąt.Creates an array of points that form a rectangle.

  • Rysuje tę tablicę punktów (na ekranie przed zastosowaniem transformacji skalowania (niebieskim prostokątem).Draws this array of points (to the screen prior to applying a scaling transform (the blue rectangle).

  • Tworzy macierz i skaluje ją przez 3 na osi x i 2 w osi y.Creates a matrix and scales it by 3 in the x-axis and 2 in the y-axis.

  • Stosuje to przekształcenie macierzy do tablicy punktów.Applies this matrix transform to the array of points.

  • Rysuje przekształconą tablicę do ekranu (czerwony prostokąt).Draws the transformed array to the screen (the red rectangle).

Zwróć uwagę, że czerwony prostokąt został przeskalowany przez współczynnik 3 na osi x i 2 w osi y, w tym górny róg prostokąta (punkt początkowy prostokąta).Notice that the red rectangle has been scaled by a factor of 3 in the x-axis and by 2 in the y-axis, including the upper left-hand corner of the rectangle (the beginning point of the rectangle).

public:
   void TransformPointsExample( PaintEventArgs^ e )
   {
      Pen^ myPen = gcnew Pen( Color::Blue,1.0f );
      Pen^ myPen2 = gcnew Pen( Color::Red,1.0f );

      // Create an array of points.
      array<Point>^ myArray = {Point(20,20),Point(120,20),Point(120,120),Point(20,120),Point(20,20)};

      // Draw the Points to the screen before applying the
      // transform.
      e->Graphics->DrawLines( myPen, myArray );

      // Create a matrix and scale it.
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Scale( 3, 2, MatrixOrder::Append );
      myMatrix->TransformPoints( myArray );

      // Draw the Points to the screen again after applying the
      // transform.
      e->Graphics->DrawLines( myPen2, myArray );
   }
public void TransformPointsExample(PaintEventArgs e)
{
    Pen myPen = new Pen(Color.Blue, 1);
    Pen myPen2 = new Pen(Color.Red, 1);
             
    // Create an array of points.
    Point[] myArray =
             {
                 new Point(20, 20),
                 new Point(120, 20),
                 new Point(120, 120),
                 new Point(20, 120),
                 new Point(20,20)
             };
             
    // Draw the Points to the screen before applying the
    // transform.
    e.Graphics.DrawLines(myPen, myArray);
             
    // Create a matrix and scale it.
    Matrix myMatrix = new Matrix();
    myMatrix.Scale(3, 2, MatrixOrder.Append);
    myMatrix.TransformPoints(myArray);
             
    // Draw the Points to the screen again after applying the
    // transform.
    e.Graphics.DrawLines(myPen2, myArray);
}
Public Sub TransformPointsExample(ByVal e As PaintEventArgs)
    Dim myPen As New Pen(Color.Blue, 1)
    Dim myPen2 As New Pen(Color.Red, 1)

    ' Create an array of points.
    Dim myArray As Point() = {New Point(20, 20), New Point(120, 20), _
    New Point(120, 120), New Point(20, 120), New Point(20, 20)}

    ' Draw the Points to the screen before applying the
    ' transform.
    e.Graphics.DrawLines(myPen, myArray)

    ' Create a matrix and scale it.
    Dim myMatrix As New Matrix
    myMatrix.Scale(3, 2, MatrixOrder.Append)
    myMatrix.TransformPoints(myArray)

    ' Draw the Points to the screen again after applying the
    ' transform.
    e.Graphics.DrawLines(myPen2, myArray)
End Sub

Dotyczy

TransformPoints(PointF[])

Stosuje transformację geometryczną reprezentowaną przez tę wartość Matrix do określonej tablicy punktów.Applies the geometric transform represented by this Matrix to a specified array of points.

public:
 void TransformPoints(cli::array <System::Drawing::PointF> ^ pts);
public void TransformPoints (System.Drawing.PointF[] pts);
member this.TransformPoints : System.Drawing.PointF[] -> unit
Public Sub TransformPoints (pts As PointF())

Parametry

pts
PointF[]

Tablica PointF struktur reprezentujących punkty do przekształcenia.An array of PointF structures that represents the points to transform.

Przykłady

Aby zapoznać się z przykładem, zobacz TransformPoints(Point[]) .For an example, see TransformPoints(Point[]).

Dotyczy