<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="../../../design/description.xslt" type="text/xsl"?>

<node xmlns="http://dynamicnodes.mastersign.de/description" 
      type="DynamicNode.Lib.Imaging.NDynamicThreshold" assembly="NLibDefault">
  <caption>Dynamischer Schwellwert</caption>
  <group>Bildverarbeitung</group>
  <description>Bildet für jeden Pixel einen dynamischen Schwellwert mittels seiner Umgebung.</description>
  <inPorts>
    <port name="image" caption="Vorlagebild">
<type>IMDO&lt;Byte&gt;</type>
<description>Das Quell-Bild.</description>
</port>
    <port name="radius" caption="Radius" managed="true">
      <type>Int32</type>
      <description>Der Radius, der die Größe der Umgebung eines Pixels angibt.</description>
    </port>
    <port name="r" caption="Parameter r" managed="true">
      <type>Single</type>
      <description>Dieser Wert bestimmt den Einfluss der Umgebung des einzelnen
      Pixels auf seinen Schwellwert.
      (Ist dieser Wert 0, so ist der Schwellwert für das gesamte Bild 127).</description>
    </port>
    <port name="median" caption="Median-Filter" managed="true">
      <type>Boolean</type>
      <description>
        Gibt an, ob die Umgebung mit einem Medianfilter abgebildet werden soll.
        Wenn dieser Eingang mit <c>false</c> belegt ist, wird die Umgebung mit
        dem Mittelwert abgebildet.
      </description>
    </port>
  </inPorts>
  <outPorts>
    <port name="threshold" caption="Schwellwerte">
      <type>IMDO&lt;Byte&gt;</type>
      <description>Ein MDO mit den gleichen Dimensionen wie das Quell-Bild.</description>
    </port>
  </outPorts>
  <helpText>
    <p>
      Dieser Knoten erzeugt einen Schwellwert für jedes Feld des Quell-Bildes.
      Dabei wird der Mittelwert oder der Median der Umgebung mit 127 gemischt.
      Die Größe der Umgebung wird durch den Radius bestimmt. 
    </p>
    <info>
      Die Umgebung ist nicht kreisförmig, sondern quadratisch. 
      Also wirkt der Radius als halbe Kantenlänge des Umgebungsquadrates.
      Bei mehr als 2 Dimensionen bezieht sich die Aussage auf Kugel und Würfel...
    </info>
    <p>
      Es werden alle vorhandenen Dimensionen berücksichtigt.
      D.h. wenn das Quell-Bild ein Mehrkanalbild ist, 
      wird der Schwellwert als Mittelwert oder Median
      aller im Bereich des Radius liegenden Werte gebildet
      sowohl in X- und Y-Richtung als auch in den Kanälen.
      Ist also der Radius 1 wird für den Rot-Kanal Rot und Grün verwendet,
      für den Grün-Kanal alle drei Kanäle und für den Blau-Kanal Grün und Blau.<br/>
      Ist der Radius min. 2, so werden bei allen Kanälen alle Kanäle in die
      Mittelwertbildung oder den Median einbezogen.
    </p>
  </helpText>
</node>