DN CURVES 0.8.2 - PHOTOSHOP / WINDOWS x64

INSTALLATION
1. Das gesamte ZIP entpacken.
2. Photoshop schliessen.
3. INSTALLIEREN.exe starten und die Windows-Abfrage bestaetigen.
   Bei mehreren oder abweichend installierten Photoshop-Versionen den
   Photoshop-Hauptordner waehlen, in dem Photoshop.exe liegt.
4. Den angezeigten Zielordner bestaetigen.
5. Photoshop starten: Filter > DNAstro > DN Curves...

Die Datei wird nach Plug-ins\DNAstro\DN-Curves.8bf kopiert.
Eine dort vorhandene alte Version wird zuvor als .bak gesichert.
Auch die bisherige DN-Curves-Native.8bf wird als .bak aufbewahrt, damit
Photoshop nur die neue DN-Curves.8bf laedt. Scheitert das Ersetzen,
wird der bisherige Dateiname wiederhergestellt.
Die Testanwendung wird nicht in Photoshop installiert.

ALTERNATIV MANUELL
Photoshop schliessen und bin\DN-Curves.8bf nach
<Photoshop-Ordner>\Plug-ins\DNAstro\ kopieren; vorhandene Version ersetzen.
Die bisherige DN-Curves-Native.8bf zuvor in .bak umbenennen.
Nur eine aktive Kopie des Plugins in Photoshops Plugin-Ordnern behalten.

BEDIENELEMENTE 0.8.2
Oben: Vorher/Nachher, direkt rechts daneben Vergleich.
Rechts ueber der Bildvorschau: Zoom (Einpassen, 100 %, 200 %).
Rechts neben den Wertefeldern unter der Kurve: Zurueck und Vor.
Am unteren rechten Fensterrand: Abbrechen und Anwenden.
Bei sehr wenig Platz stehen Zoom oben rechts und Zurueck/Vor unten rechts,
damit sich die Bedienelemente nicht ueberlagern.

ERSTER AUFRUF
1. Ein RGB- oder Graustufenbild mit 8, 16 oder 32 Bit pro Kanal oeffnen.
2. Zum Ausprobieren eine Kopie der Pixelebene mit Strg+J anlegen und deren
   Bildminiatur aktivieren. Den gesamten RGB-/Graukanal verwenden.
3. Eine aktive Auswahl mit Strg+D aufheben.
4. Filter > DNAstro > DN Curves... aufrufen.
5. Die Hand ist beim Start aus. Einen Rahmen im Bild aufziehen zum Zoomen;
   Doppelklick stellt Einpassen her. Ausschnitt: Leertaste + Ziehen.
   Fuer Tonwertanpassungen Hand einschalten, ins Bild klicken und nach oben
   heller / unten dunkler ziehen. Umschalt: fein. Messung fest 2x2 Pixel.
6. Schwarz- und Weisspunkt lassen sich direkt in der Kurve in X/Y bewegen.
   Zuruecksetzen (rechts neben Punkt entfernen) setzt die gewaehlte Kurve
   auf die Gerade zurueck.
7. Anwenden uebernimmt die Kurven in voller Bildaufloesung.
   Abbrechen verwirft den Aufruf ohne Ausgabepixel anzufordern.
8. Photoshop: Strg+Z nimmt den Filter zurueck. Das reale Photoshop-Protokoll
   und diese Ruecknahme gehoeren zum noch ausstehenden Host-Praxistest.

Die Plugin-Vorschau ist eigenstaendig. Waehrend des Bearbeitens wird die
Photoshop-Ebene noch nicht veraendert. Neue Kurvenparameter werden erst
nach erfolgreicher Bildverarbeitung fuer den naechsten Aufruf gespeichert.

AUTO-STRETCH / STF-AEHNLICHE STRECKUNG
1. Lineares FITS-Bild als 32-Bit-Bild in Photoshop oeffnen.
2. Im Plugin Auto-Stretch anklicken.
3. Kette geschlossen / RGB gemeinsam: dieselbe Streckung fuer alle Kanaele.
   Kette geoeffnet / RGB getrennt: Hintergrundmediane angleichen und einen
   Farbstich ausgleichen. Bei aktiver Streckung wird sofort neu berechnet.
4. Bei Bedarf die normalen Kurven oder die Hand weiter verwenden.
5. Anwenden uebernimmt die Streckung UND die Kurven in die Pixelebene.

Stretch zurueck schaltet nur Auto-Stretch aus. Manuelle Kurven bleiben.
Rueckgaengig und Vorgaben enthalten auch die Stretch-Einstellungen.
Wiederholtes Auto-Stretch stapelt die Wirkung nicht; Zoomaenderungen
beeinflussen die ermittelten Parameter nicht. Graubilder nutzen eine Kurve.
Bei 32 Bit bleibt die Ausgabe Float32. Aktiver Auto-Stretch schneidet
Werte bis zum ermittelten Schwarzpunkt auf 0 ab; ohne Auto-Stretch gilt
der bisherige Kurvenpfad. Details und Anzeige-Zielwert: README.md.

32-BIT-FLOAT
Das Dokument bleibt 32 Bit. Die Kurven werden direkt mit voller Float-
Praezision angewendet. Zahlenfelder verwenden hier lineare Werte 0 bis 1.
Vorschau, Handmessung und Originalausschnitt verarbeiten Float-Daten.
Unveraenderte Kurven erhalten auch negative Werte und HDR-Werte ueber 1.
Bei Kurvenaenderungen werden Werte ausserhalb 0..1 mit Steigung 1 und dem
Randversatz fortgesetzt; HDR-Werte werden nicht pauschal abgeschnitten.
Die Vorschau ist eine SDR-Anzeige bei 0 EV; Photoshops eigene HDR-
Vorschau-Belichtung und OCIO-Darstellung werden nicht uebernommen.

UMFANG
RGB/Grau 8/16/32 Bit auf einer Pixelebene, ohne aktive Auswahl.
Keine Smartfilter, Maskenbearbeitung, CMYK/Lab.
Bei Ebenen mit Transparenz/Masken ist die vollstaendige Photoshop-
Ebenenkomposition in der eigenen Vorschau noch nicht nachgebildet.

PRUEFSTATUS
Windows-x64-Dateien gebaut; Berechnung, simuliertes Host-Protokoll und
Dateiinstallation getestet. Das echte Photoshop und die Windows-
Installer-Oberflaeche wurden in dieser Entwicklungsumgebung nicht ausgefuehrt.
SELBSTTEST.cmd prueft die lokale Testanwendung und Simulationen unter Windows.

DEINSTALLATION / VORHERIGE VERSION
Photoshop schliessen. Nur DN-Curves.8bf im DNAstro-Ordner entfernen.
Fuer die vorherige Version die gewuenschte DN-Curves.previous-*.bak
wieder DN-Curves.8bf nennen. Eine Sicherung DN-Curves-Native.previous-*.bak
wieder DN-Curves-Native.8bf nennen. Vorher die aktuelle .8bf entfernen;
auch bei der Rueckkehr nur eine aktive .8bf behalten.
Bestehende .dncurves-Vorgaben bleiben lesbar. Neu gespeicherte Vorgaben
mit Auto-Stretch benoetigen mindestens Version 0.8.0.
