



                           -------------------
                              P A L E T T E
                           -------------------



                Version 1.00  19.3.1992  -  Matthias Strmer




   Zweck:          Dieses  Programm  dient  der  universellen  komfortablen
                   Farbeinstellung am Atari (ST/TT).


   Zielgruppe:     Es richtet sich hauptschlich an  Besitzer einer Grafik-
                   Erweiterungskarte.   Dabei  werden  bis  zu  256  Farben
                   untersttzt.


   Voraussetzung:  Atari mit  Grafiktreiber,  der die Farbeinstellung  ber
                   VDI-Funktionen untersttzt (wie im ROM).


   Nutzungsrechte: Dieses Programm ist Shareware. Die Gebhr betrgt DM 20.-


   Highlights:     - Farbwertauswahl auch mit Farbwrfel oder Farbdreieck
                   - unerwnschte  nderungen  sind  jederzeit mit  einem
                     Tastendruck wieder rckgngig zu machen
                   - Farbverlauf linear und logarithmisch
                   - Systemfarben sind auf Wunsch unvernderbar
                   - schwarz und wei werden auf hnlichkeit berprft
                   - Tastaturbedienung mglich
                   - Accessoryversion durch Umbenennen
                   - Fenstertechnik



   Im weiteren Verlauf dieser Anleitung folgen noch folgende Abschnitte:

                   - Programmstart
                   - Menfenster
                   - Verlauf
                   - Konfiguration
                   - Fenster
                   - Tastaturbedienung
                   - Fehlermeldungen
                   - Inhalt des Ordners PALETTE
                   - Allgemeines
                   - Unterschiede
                   - Nutzungsrechte



 Programmstart:
 --------------
 Bei Programmstart wird die Resourcedatei geladen.  Ist diese nicht vorhanden,
 so kann man sie  (nur) in der  Programm-Version nachladen.  Die Grundeinstel-
 lung,  d.h.  Farb- und  Konfigurationsdaten,  wird,  so  vorhanden,  aus  den
 Dateien "PALETTE.PAL" und "PALETTE.PCF" gelesen.

 Die Grundfunktionen  werden im  Menfenster bedient,  das beim  Programmstart
 sofort erscheint.  Ein Schlieen des Menfensters ist gleichbedeutend mit dem
 Programmende, bzw. dem Schlieen des Accessories.



 Menfenster:
 ------------
 Die meisten Funktionen bedrfen wohl  keiner Erklrung, dennoch -  und sei es
 der Vollstndigkeit wegen - einige Erluterungen:
 Verlauf:   Farbverlauf zwischen Farbe 1 und 2.
 1>2, 2>1:  Kopiert die Werte der Farbe 1 zur Farbe 2, bzw. umgekehrt.
 Ursprung:  Stellt die Farben ein, die bei Programmbeginn eingestellt waren.
 Standard:  Stellt Standard(Default)-Werte ein.
 Laden:     Ldt Farbpalette (*.PAL).
 Speichern: Speichert Farbpalette (*.PAL).
 Hilfe:     Fenster zur Anzeige der Tastaturcodes.
 Konfig:    Konfiguration des Programmes.
 Info:      Kurze Programm-Info.
 Ok:        Programmende.
 Abbruch:   Programmende mit Wiederherstellen der ursprnglichen Farbpalette.

 Die groen  Pfeilbuttons dienen dazu,  die aktuelle Farbe um 10% aufzuhellen,
 bzw. abzudunkeln. In Verbindung mit der Shift-Taste nur um 5%.
 Bei den anderen Pfeilbuttons  (RGB-Wert-Einstellung)  bewirkt die Shift-Taste
 eine nderung um 1 statt um 10.

 Auch  in den  anderen  Fenstern  verringert die  Shift-Taste die  Wirkung der
 Pfeilbuttons.



 Verlauf:
 --------
 Der Farbverlauf kann auf vier verschieden Arten zwischen Farbe 1 und Farbe 2
 gewhlt werden.
 Streng linear:            Nach  dem  Modell  des  RGB-Farbwrfels  wird  eine
                           direkte Raumdiagonale zwischen Start- und Zielfarbe
                           gezogen.
 linear:                   hnlich wie 'Streng linear',  nur werden nderungen
                           nacheinander fr  jede Farbkanone  einzeln durchge-
                           fhrt.  Die grere  Nuancierung wirkt sich bei  16
                           Farben am meisten aus.
 logarithmisch progressiv: nderungen sind am Anfang grer als am Ende.
 logarithmisdch degressiv: nderungen sind am Ende grer als am Anfang.

 Der Farbverlauf  darf  nicht  ber den Farbindex 1  gehen,  da dieser die vom
 Betriebssystem benutzte Farbe  schwarz ist und schwarz und wei so zu hnlich
 wrden. D.h. der kleinste mgliche Index beim Farbverlauf ist 1.



 Konfiguration:
 --------------
 - Systemfarben bei Programmstart sichern:  Programmstart meint den  Start des
            Palettenprogramms, bzw. -Accessories.
 - Farbverlauf Defaultbutton: Voreinstellung,  welcher Button bei der Funktion
            Verlauf  mit  dem  Default-Status  versehen  wird,  d.h.  ber die
            [Return]-Taste zu erreichen ist.
 - Konfiguration laden, bzw. speichern: laden, bzw. speichern der Werte dieser
            Dialogbox und der Fensterpositionen in einer *.PCF - Datei.



 Fenster:
 --------
 Palettenfenster:Auswahl einer Farbnummer.
 Wrfelfenster:  Auswahl eines Farbwertes.  Prinzip  des  RGB-Farbraumes:  Die
                 drei Raumachsen entsprechen den Farbachsen.  Dargestellt wird
                 der Wrfel durch eine Flche (2 Achsen) und einen Schiebereg-
                 ler (dritte Achse).  Der  zweite  Schieberegler  bestimmt die
                 Grundhelligkeit. Die Achsen knnen frei gewhlt werden.
 Dreieckfenster: Auswahl eines Farbwertes. Prinzip des Farbdreiecks:  Die drei
                 Ecken  entsprechen  den  Grundfarben  (rot, grn, blau).  Der
                 Schieberegler bestimmt die Grundhelligkeit.
 Kreisfenster:   Auswahl eines Farbwertes. Prinzip des Farbkreises.
                 (Noch in Arbeit.)
 Helpfenster:    Anzeigen der Tastaturcodes.

 Systemfarben verriegeln: vor nderungen schtzen,  d.h. sperren.  Als System-
 farben werden  die ersten  16  Farben bezeichnet,  da sie vom  Betriebssystem
 z.T. direkt verwendet werden.  Bei 'Ursprung' und 'Standard' werden, wenn die
 Systemfarben geschtzt sind, nur die Farben ab Index 16 verndert.

 Farbauswahlfenster knnen nur bei einer  Farbanzahl von mindestens 256 Farben
 geffnet werden.  Mehrere gleichzeitig knnen nur bei  mehr als 256 vernder-
 baren Farben dargestellt werden, was aber z.Zt. noch  nicht im  Programm vor-
 gesehen ist  und bei Grafikerweiterungen wohl so schnell nicht in bezahlbarer
 Nhe sein wird. (Trust in update.)

 Werte im  Menfenster  knnen auch direkt  eingestellt werden,  indem man das
 entsprechende Feld anklickt (Farbindex und Werte der Farbkanonen).

 Wie auch im Desktop kann z.B. ein Button in einem nicht-aktiven Fenster durch
 das Drcken beider  Maustasten bedient werden.  Dies gilt allgemein fr Maus-
 knopfereignisse, was bei Slidern - zugegeben - etwas seltsam aussehen kann.

 nderungen jeder Art knnen knnen durch die  'Undo'-Taste rckgngig gemacht
 werden.  Bei einfachen Farbnderungen wird die entsprechende Farbe wiederher-
 gestellt,  bei nderungen,  die die gesamte  Farbpalette betreffen  (Verlauf,
 Ursprung, Standard, Laden ) wird auch die gesamte Farbpalette restauriert.



 Tastaturbedienung:
 ------------------
 Die meisten Funktionen knnen auch per Tastatur bedient werden:

 Cursor links, rechts : aktuelle Farbe ist Farbe 1, bzw. 2
 Cursor hoch, runter  : aktuellen Farbindex erhhen, erniedrigen
 [Insert] :             aktuellen Farbindex eingeben
 [Help] :               Hilfe-Fenster
 [Control] U :          Fenster schlieen
 [Control] W :          Fenster wechseln
 [Control] Q :          Abbruch
 [Undo] :               letzte nderung rckgngig machen
 [F1],[F2],[F3] ,       Men-, Paletten-, Wrfel-, Dreieck-, Kreis-
 [F4],[F5] :            fenster ffnen, bzw. in den Vordergrund holen
 [7],[4],[1] :          R-, G-, B-Wert verringern
 [8],[5],[2] :          R-, G-, B-Wert vergrern
 [9],[6],[3] :          R-, G-, B-Wert eingeben
 [+] [-] :              aktuelle Farbe aufhellen/abdunkeln
 [Alternate] F :        Systemfarben vor nderungen schtzen.
 [Alternate] + Anfangsbuchstabe (meistens): entsprechende Funktion:
 [Alternate] V :        Verlauf zwischen Farbe 1 und 2
 [Alternate] 1 :        Kopieren Farbe 1 -> Farbe 2
 [Alternate] 2 :        Kopieren Farbe 2 -> Farbe 1
 [Alternate] U :        Ursprung
 [Alternate] D :        Standard (Default)
 [Alternate] L :        Laden
 [Alternate] S :        Speichern
 [Alternate] H :        Hilfe
 [Alternate] I :        Information
 [Alternate] K :        Konfigurationsdialog
 [Alternate] E :        Ende
 [Alternate] A :        Abbruch



 Cursor- und Ziffernblock:
 -------------------------

  ----------- -----------        ------- ------- ------- -------
 |Help       |Undo       |      |(      |)      |/      |*      |
 |   -Fenster|    zurck |      |       |       |       |       |
  ----------- -----------        ------- ------- ------- -------
 |Ins    |^      |Clr    |      |7      |8      |9      |-      |
 |   I?  |   I-  |       |      |   R-  |   R+  |   R?  |   H-  |
  ------- ------- -------        ------- ------- ------- -------
 |<      |v      |>      |      |4      |5      |6      |+      |
 | Farbe1|   I+  | Farbe2|      |   G-  |   G+  |   G?  |   H+  |
  ------- ------- -------        ------- ------- ------- -------
                                |1      |2      |3      |       |
 I:       Farbindex             |   B-  |   B+  |   B?  |       |
 H:       Helligkeit             ------- ------- -------        |
 R, G, B: RGB-Farbwert          |0              |.      | Enter |
 +, -:    erhhen, erniedrigen  |               |       |       |
 ?:       Wert eingeben          --------------- ------- -------



 Fehlermeldungen:
 ----------------
 Resourcedatei nicht gefunden.
   Accessory: Resourcedatei an entsprechende Stelle kopieren.
   Programm:  Resourcedatei suchen.
 Resource konnte nicht geladen werden.
   Falsche oder fehlerhafte Resource beim Programmstart.
 Die Resource wurde unbefugt verndert.  Ein korrekter Betrieb kann nicht mehr
   gewhrleistet werden.
 Farbeinstellung konnte nicht in Menuleiste installiert werden.
   Menuleiste ist voll.
 Fehler bei OPEN WORKSTATION.
   Schwerer Systemfehler.
 Fehler bei APPLICATION INIT.
   Schwerer Systemfehler.
 Fehler beim Programmstart.
   Schwerer Systemfehler.
 Schwarz und wei wren beinahe zu hnlich geworden.Farboperation abgebrochen!
   Zwischen  schwarz  (Farbindex 1)  und  wei  (Farbindex 0)  mu  immer  ein
   bestimmter Sicherheitsabstand bestehen.
 Die Systemfarben sind verriegelt und drfen nicht verndert werden.
   Farbwertnderung bei einer Systemfarbe, whrend sie verriegelt sind.
 Undo nicht mglich!
   Es wurde noch keine  Farbwert-nderung durchgefhrt,  die rckgngig gemacht
   werden knnte.
 Es ist nur ein Farbwert-Auswahlfenster mglich.
   Aufgrund der  Darstellungsweise  der Farben ist nur  ein  Farbwert-Auswahl-
   fenster mglich. Abhilfe: Das geffnete FA-Fenster schlieen.
 XXX-fenster : Die Auflsung ist zu niedrig.
   Die Auflsung ist zu niedrig, um das Fenster darzustellen.
 Schwarz und wei drfen nicht aufeinander kopiert werden!
   Schwarz und wei drfen nicht identisch sein.
 Der Farbverlauf darf nicht ber schwarz oder wei gehen.
   Schwarz und wei wrden sonst zu hnlich werden.
 Keine weiteren Fenster verfgbar! Nicht bentigte Fenster schliessen bringt's.
 Wenn Farbe 1 und 2 den selben Index haben, ist ein Farbverlauf nicht mglich.
 Wenn Farbe 1 und 2 direkt benachbart sind, ist ein Farbverlauf nicht mglich.
 Farbpalette laden:      Datei konnte nicht geffnet werden.
 Farbpalette laden:      Fehler beim Lesen der Datei.
 Farbpalette laden:      Dies ist keine Palettendatei.
 Farbpalette laden:      Datei hat fehlerhafte Daten.
 Farbpalette laden:      Datei enthlt zu wenig Daten. Es wurden  alle verfg-
                         baren Daten gelesen.
 Farbpalette laden:      Datei enthlt zu viele Daten.  Es wurden nur so viele
                         Daten gelesen wie notwendig waren.
 Farbpalette laden:      Datei enthlt weniger Daten als angegeben.
 Farbpalette speichern:  Datei konnte nicht geffnet werden.
 Farbpalette speichern:  Fehler beim Schreiben der Datei.
 Konfiguration laden:    Datei konnte nicht geffnet werden.
 Konfiguration laden:    Fehler beim Lesen der Datei.
 Konfiguration laden:    Dies ist keine Konfig-Datei.
 Konfig-Datei speichern: Datei konnte nicht geffnet werden.
 Konfig-Datei speichern: Fehler beim Schreiben der Datei.



 Inhalt des Ordners PALETTE:
 ---------------------------
 LIESMICH      dieser Text                       16273 Bytes
 PALETTE.RSC   Rescource-Datei                    9448 Bytes
 PALETTE.PRG   Programmversion von PALETTE       47652 Bytes
   oder
 PALMINI.PRG   eingeschrnkte Programmversion    32167 Bytes
   oder
 PALDEMO.PRG   Demoversion                       47604 Bytes

 Die neueste Version wird auch stets im MausNet verfgbar sein.
 (z.B. Maus Karlsruhe: 0721 - 358887)



 Allgemeines:
 ------------
 Durch  Umbenennen ist  das Programm auch als  Accessory lauffhig.  Dies gilt
 nicht fr die eingeschrnkte Version.



 Unterschiede:
 -------------
 - zwischen Demo- und Vollversion:
   bis auf eine regelmig erscheinende Dialogbox keine Unterschiede.

 - zwischen Programm mit eingeschrnktem Funktionsumfang und Vollversion:
   Menfenster:     - Verlauf nicht vorhanden
                    - Kopie 1->2, 2->1 nicht vorhanden
                    - Hilfe nicht vorhanden
                    - Konfiguration nicht vorhanden
                    - Systemfarben-Riegel nicht vorhanden
                    - Undo nicht mglich
                    - Tastaturbedienung nicht mglich
   Palettenfenster: - kein Unterschied
   Wrfelfenster:   - Fenster nicht vorhanden
   Dreieckfenster:  - Fenster nicht vorhanden
   Kreisfenster:    - Fenster nicht vorhanden
   Accessory:       - nicht durch Umbenennen mglich



 Nutzungsrechte:
 ---------------
 Unter der Voraussetzung,  da immer alle Dateien im Ordner PALETTE ungendert
 kopiert werden,  darf PALETTE von privaten Anwendern ausprobiert und beliebig
 kopiert werden.  Das Programm darf und soll auch ber Mailboxsysteme verbrei-
 tet werden.  Dazu  sollten alle  Dateien  im Ordner  PALETTE  in einem Archiv
 (LHARC, ZIP oder hnlich) zusammengefat werden. Das Kopieren der Vollversion
 als Zugabe zu anderen Programmpaketen ist nicht gestattet.

 Nun ist das aber kein PD-Programm, sondern Shareware. Das heit, wer das Pro-
 gramm regelmssig benutzt,  hat die Arbeit,  die dahintersteckt,  mit DM 20.-
 zu  honorieren,  wodurch  er erst das  Recht erhlt,  PALETTE  regelmssig zu
 benutzen.  Dafr erhlt man auch die auf seinen  Namen registrierte  Vollver-
 sion mit stark erweitertem Funktionsumfang.

 Der Erwerb irgendwelcher Disketten,  auf welche PALETTE als Zugabe mitkopiert
 wird (z.B. bei Grafikkarten), zieht alleine noch kein Recht zur regelmssigen
 Nutzung nach sich,  da der Autor (also ich)  vom Erls aus dem Verkauf dieser
 Disketten, bzw. der Grafikkarte keine mde Mark zu sehen bekommt.

 Wer PALETTE kommerziell benutzen will,  hat sich vorher mit dem Autor in Ver-
 bindung zu setzen.


 Ich hoffe,  hiermit alle wesentlichen  Fragen geklrt zu haben.  Falls nicht,
 stehe ich  (fast) jederzeit fr  Fragen zur  Verfgung.  Genauso  bin ich fr
 jegliche Anregung dankbar. So oder so, hier ist noch einmal meine Adresse:

                       Matthias Strmer
                       Reinhold-Frank-Strae 66
                       W-7500 Karlsruhe 1
                       MausNet: Matthias Strmer @ KA

 Sparkasse Karlsruhe,  BLZ 660 501 01,  Kto. 9003690


 Ich kann  keine Haftung fr  irgendwelche  direkten oder  indirekten  Schden
 - einschlielich  aber nicht  beschrnkt auf  materielle  oder  finanzielle -
 bernehmen,  die durch die Benutzung von PALETTE (oder die Untauglichkeit von
 PALETTE) fr einen bestimmten Zweck entstehen.


 Karlsruhe, 19.3.1992                                                     SSKM
