.. highlightlang:: us

.. _poly_poly_intersect:

poly_poly_intersect
===================

.. index:: poly_poly_intersect

.. us.tag  poly_poly_intersect NOTREADYGERMAN base_graph New420

:ref:`poly_poly_intersect` ermittelt die Schnittpunkte zweier Linienzüge (Polygone).

.. function::  rmXY_I1I2 = poly_poly_intersect(rmXY1, rmXY2)

.. us.return

**Returnwert**

*rmXY_I1I2* ist ein Matrix mit 4 Spalten:

.. list-table::
   :header-rows: 1

   * - Wert
     - Bedeutung
   * - rmXY_I1I2[1]
     - x-Koordinaten der Schnittpunkte.
   * - rmXY_I1I2[2]
     - y-Koordinaten der Schnittpunkte.
   * - rmXY_I1I2[3]
     - Index des Datenpunktes der zur Schnittlinie von rmXY1 gehört.
   * - rmXY_I1I2[4]
     - Index des Datenpunktes der zur Schnittlinie von rmXY2 gehört.

Falls die Polygone keine Schnittpunkte enthalten, liefert die Funktion den Wert 0.

.. us.params

**Parameter**

.. uparam:: rmXY1

   *rmXY1* ist eine zweispaltige Matrix der Datenpunkte. ``rmXY1[;1]``  sind die 
   x-Koordinaten und ``rmXY1[;2]`` sind die y-Koordinaten der Datenpunkte. 

.. uparam:: rmXY2

   *rmXY2* ist eine zweispaltige Matrix der Datenpunkte. ``rmXY2[;1]`` sind die 
   x-Koordinaten und ``rmXY2[;2]`` sind die y-Koordinaten der Datenpunkte. 

.. us.example

**Beispiel**

::

   def XYGetIntersection(hData1, hData2)
   {
       rmXY1 = XYGetData(hData1);
       rmXY2 = XYGetData(hData2);
       rmXY_I1I2 = poly_poly_intersect(rmXY1, rmXY2);
       if (len(rmXY_I1I2) == 1) {
           return 0;
       }
       return rmXY_I1I2[;1,2];
   }

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 4.2.0
     - Neu

.. seealso::
   :ref:`poly_poly_clip`

:sub:`id-222886`