Selektierung

Die auf dieser Seite erklärten Attribute sind in der Kategorie Selection zu finden.

Eigenschaft: SelectionMode

Mit der Eigenschaft SelectionMode kann eingestellt werden, ob und wie Farbwerte auf dem Histogramm ausgewählt werden können:

• Bei Single kann nur ein einzelner Farbwert ausgewählt werden.
• Bei Range können mehrere aufeinanderfolgende Farbwerte durch Klicken, Halten und Ziehen mit der Maus ausgewählt werden.
• Single or Range kombiniert beide Möglichkeiten.
• Disabled deaktiviert die Auswahl von Farbwerten komplett.

In der Infobar werden bei einer Einzelauswahl der ausgewählte Farbwert (Bin) und die dazugehörigen Häufigkeitswerte pro Farbkanal angezeigt. Bei einer Bereichsauswahl werden der Farbwertebereich sowie die durchschnittlichen Häufigkeitswerte aus diesem Bereich pro Farbkanal angezeigt.

Eigenschaften: SelectionLowerBound und SelectionUpperBound

Die Eigenschaft SelectionLowerBound enthält bei einer Bereichsauswahl den niedrigsten Farbwert (Bin) der Auswahl. Die Eigenschaft SelectionUpperBound enthält dementsprechend den höchsten Farbwert der Auswahl. Bei einer Einzelauswahl enthalten beide Eigenschaften identisch den exakt ausgewählten Farbwert.

Eigenschaft: SelectionFrequencies

Die Eigenschaft SelectionFrequencies enthält ein numerisches Array mit der Länge 1-3, je nach Anzahl der definierten Farbkanäle. Bei Einzelauswahl beinhaltet es die Häufigkeitswerte des ausgewählten Farbwerts pro Kanal. Bei Bereichsauswahl werden Durchschnittswerte pro Kanal berechnet.

Eigenschaft: SelectionColor

Die Eigenschaft SelectionColor dient zum Einstellen der Farbe des Auswahlbereichs auf dem Histogramm. Diese sollte idealerweise teiltransparent (mit einem Alpha-Wert) gewählt werden, damit die Datenreihen des Histogramms unter dem markierten Bereich weiterhin gut erkennbar bleiben.

Funktion: clearSelection()

Beim Aufruf der Funktion clearSelection() wird die aktuelle Auswahl vollständig aufgehoben.

Event: onSelectionChanged

Das Event onSelectionChanged wird ausgelöst, sobald sich die Auswahl ändert (ein oder mehrere Farbwerte neu ausgewählt oder abgewählt wurden).