                             Kameleon 3.2
                             ------------
                          autor: K.A.Ziembik
                            ROHAR 1992-98
                          program Freeware

           Ostatnia zmiana w programie: 6 sierpnia 1998 r.
           Ostatnia zmiana w dokumencie: 6 sierpnia 1998 r.



1. Co to jest?
   -----------

     Kameleon to atwy w obsudze i do rozbudowany konwerter rnych 
formatw graficznych,  stosowanych zarwno na ST/STE,  jak i na XL/XE. 
Konwersji  podlegaj dane obrazu a take,  z  pewnymi  ograniczeniami, 
paleta  kolorw.  Wymagania programu to ST/STE z minimum 0.5 MB RAM  i 
monitorem kolorowym lub telewizorem.
     Kameleon  jest  programem FREEWARE - mona  kopiowa  go  dowoln 
ilo razy,  przekazywa kademu,  rozpowszechnia wszdzie, gdzie si 
da,  a  take  uywa  jak  i kiedy  si  chce,  ale  zabroniona  jest 
jakakolwiek interwencja w kod programu i dokumentacji bez zgody  grupy 
ROHAR.



2. Z czego si skada?
   -------------------

     W  wersji 3.2 program Kameleon skada si z nastpujcych  plikw 
zawartych w kartotece KAMELEON.3_2:

     KAMELEON.MIC - rysunek w formacie MicroPaintera, 
     KAMELEON.PRG - uruchamialny program, 
     KAMELEON.TXT - dokument, ktry czytasz.

     Do  prawidowego dziaania programu przydatna jest  te  nakadka 
udostpniajca  polskie  znaki  narodowe w standarcie  Klubu  ST  (np. 
MacroFont,  Mikoaj Rej,  PRO Polonica,  Polonus,  Polskie  znaki).  W 
ostatecznoci mona si bez niej oby, ale opcje i komunikaty programu 
mog si sta nieczytelne.



3. Opis programu
   -------------

     Kameleon  jest  bardzo prosty w obsudze.  Dostp  do  wszystkich 
moliwoci programu  uzyskuje  si  korzystajc  z  rozwijanego  menu. 
Pozostaa  cz  ekranu przeznaczona jest  do  wywietlania  rysunku. 
Poniewa   jednak   nie  byby  widoczny  w caoci   (menu   zasania 
kilkanacie  grnych linii) mona dokona podgldu caego  rysunku  po 
naciniciu prawego klawisza myszy, a potem powrci do menu w ten sam 
sposb. W wersji 3.2 menu zawiera nastpujce elementy:

Atari
-----
     Kameleon  - najwaniejsze informacje o programie.

Plik
----
-Rysunek-
     Odczyt    - odczyt  rysunku o formacie  ustalonym w "Format" oraz 
                 wedug ustawie w menu "Parametry".

     Zapis     - zapis  aktualnego rysunku w formacie ustalonym w menu 
                 "Format" z palet  w przypadku  formatu ST/STE, a bez 
                 danych o kolorach w przypadku formatu XL/XE.

-Paleta-
     Odczyt    - odczyt palety  w  formie pliku o dugoci  32  bajtw 
                 (dane  palety  zapisane w taki  sposb  jak  w  pliku 
                 DEGAS-a).

     Zapis     - zapis aktualnej palety w takiej samej postaci.

     Wolne KB  - pokazuje  ilo  wolnej pamici RAM i wolnego miejsca 
                 na aktualnie uywanym dysku.

     Dugo   - pokazanie dugoci wybranego pliku w bajtach.

     Kasowanie - kasowanie wybranego pliku.

     Wyjcie   - wyjcie z programu.

Format         
------
     Zawiera  szesnacie formatw graficznych,  ktrych opis  znajduje 
si w poniszej tabelce:

 +-------------------+----------+---------+---------------+--------+
 |   nazwa formatu   | komputer | dugo | rozdzielczo | paleta |
 |                   |          | (bajty) |   (piksele)   |        |
 +-------------------+----------+---------+---------------+--------+
 | DEGAS Elite   PI1 |  ST/STE  |  32066  |   320 x 200   |   16   |
 | Doodle        DOO |  ST/STE  |  32000  |   320 x 200   |   16   |
 | C.O.L.R       MUR |  ST/STE  |  32000  |   320 x 200   |   16   |
 | D.A.L.I       SD0 |  ST/STE  |  32128  |   320 x 200   |   16   |
 | NEOchrome     NEO |  ST/STE  |  32128  |   320 x 200   |   16   |
 | ColorSTar     ART |  ST/STE  |  32032  |   320 x 200   |   16   |
 | Art Director  ART |  ST/STE  |  32512  |   320 x 200   |   16   |
 | Quantum Paint PBX |  ST/STE  |  32512  |   320 x 200   |   16   |
 | Koala         PIC*|   XL/XE  | zmienna |   160 x 192   |    4   |
 | Fun with Art  FUN*|   XL/XE  | zmienna |   160 x 192   |    4   |
 | MicroPainter  MIC*|   XL/XE  |   7684  |   160 x 192   |    4   |
 | Graphics 7    G7  |   XL/XE  | 3840/44 |   160 x  96   |    4   |
 | Graphics 8    G8  |   XL/XE  | 7680/84 |   320 x 192   |    2   |
 | Graphics 9    G9  |   XL/XE  |   7680  |    80 x 192   |   16   |
 | Graphics 14   G14 |   XL/XE  | 3840/44 |   160 x 192   |    2   |
 | Graphics 15   G15 |   XL/XE  | 7680/84 |   160 x 192   |    4   |
 +-------------------+----------+---------+---------------+--------+
 | * - tylko odczyt                                                |
 +-----------------------------------------------------------------+

     Kameleon  ma  jednak pewn tolerancj przy  adowaniu  niektrych 
formatw.  Na przykad po wybraniu "DEGAS Elite PI1", program bdzie w 
stanie odczyta rysunki o dugoci 32034 i 32066 bajtw. Podobnie przy 
Graphics 7  i 14 (pliki mog mie dugo 3840 lub 3844 bajtw) oraz 8 
i 15 (7680, 7684 bajtw).
     Jeeli  wczytany  rysunek  w  formacie  XL/XE  ma  informacje   o 
kolorach, to komputer przy zapisywaniu go w jednym z formatow Graphics 
automatycznie  umieci  w pliku te informacje.  W  przeciwnym  wypadku 
poinformuje, e nie zapisze palety.
     Oprcz tego,  jeli plik nie zawiera danych o kolorach,  Kameleon 
stosuje  standardow  palet  ST/STE lub XL/XE  (zalenie  od  rodzaju 
rysunku).

Parametry
---------
-Paleta-
     Z pliku        - przy odczycie rysunku,  jego paleta  bdzie  po- 
                      bierana z pliku.  Jeeli w pliku nie ma danych o 
                      kolorach,  Kameleon  ustawi  standardowe  kolory 
                      ST/STE lub XL/XE.

     Aktualna       - po  odczycie rysunku paleta pozostanie  niezmie- 
                      niona,  niezalenie  od tego,  czy plik  zawiera 
                      kolory czy te nie.

     Systemowa      - po odczycie zostanie przywrcona paleta systemo- 
                      wa ST/STE.
-Konwersja palety-
     X-Former II    - konwersja  palety XL/XE bdzie zgodna z emulato-
                      rem  maego Atari  na ST pod nazw  X-Former II.
                      Ta konwersja  uywa  tylko palety ST (512 barw).

     DEGAS Elite    - konwersja  kolorw wedug  programu  graficznego 
                      DEGAS Elite. Rwnie korzysta tylko z palety ST.

     Kameleon (STE) - paleta  XL/XE  bdzie konwertowana z uwzgldnie- 
                      niem moliwoci STE (4096 kolorw).  Na ST mona 
                      uywa  tej opcji, konwersja  nadal bdzie  pop- 
                      rawna, ale efekty  bd widoczne dopiero po wy- 
                      wietleniu zapisanego rysunku na STE.

     PicSwitch (STE)- podobnie jak wyej,  konwersja kolorw wykorzys- 
                      tujca palet STE wedug programu PicSwitch.

-Maska-
     Standardowa    - operacje  dyskowe  bd ze standardowymi rozsze-
                      rzeniami, wymienionymi w menu "Format".

     Przezroczysta  - przezroczysta  maska (*.*)  dla operacji  dysko-
                      wych.

     Ostatnio uyta - maska  z rozszerzeniem  ostatnio uytym przy ko-
                      korzystaniu z dysku.

     Niestety, Kameleon ma te pewne ograniczenia zwizane z konwersj 
grafiki. Oto najwaniejsze z nich:

     - przy formacie Quantum Paint nie do, e moliwa jest konwersja 
       wycznie  rysunkw  128-kolorowych,  to jeszcze  brane s  pod 
       uwag  kolory  tylko  pierwszej  palety;  nie  jest  to  jednak 
       popularny  format na  ST/STE,  std  wada ta nie  ma  wielkiego 
       znaczenia,

     - po wybraniu formatu Koali,  Fun with Art lub MicroPaintera  nie 
       jest  moliwy  zapis  rysunku (od wersji  4.0  bdzie  ju  to 
       moliwe),

     - przy  formacie  Fun with Art program  nie  uwzgldnia  przerwa 
       Display List,  a przez to rysunki bd najwyej czterokolorowe, 
       ale  poniewa mao kto  korzysta z tego formatu,  nie  jest  to 
       wielki problem,

     - aby konwersja na format Graphics 8 i 14 bya poprawna,  rysunek 
       ST powinien  korzysta  tylko z rejestrw 0 i 1  (dla  nieprog- 
       ramistw:  jest to  pierwszy i drugi kolor  w palecie  rysunku, 
       reszta  kolorw  na obrazku ST  nie bdzie w  ogle  brana  pod 
       uwag), 

     - ta sama  uwaga  dotyczy Graphics 7 i  15,  z tym,  e  rejestry 
       kolorw do wykorzystania to 0, 1, 2 i 3 (pierwsze cztery kolory 
       palety, reszta jak wyej), 

     - konwersja formatw XL/XE wci  trwa zbyt dugo (od wersji  4.0 
       to si zmieni - procedury w assemblerze s gotowe),

     - przy formacie Graphics 9  stosowane s tylko odcienie szaroci, 
       ale jest to wada nieistotna.

     I  na  koniec opisu dziaania programu  -  krtki  algorytm,  jak 
postpowa, aby przekonwertowa obrazek w jednym formacie (np. PI1) na 
inny (np. NEO):

     - ustawi "DEGAS Elite PI1" w "Format",

     - wczyta wybrany plik opcj "Odczyt",

     - ustawi opcj "NEOchrome NEO" w "Format",

     - zapisa rysunek pod wybran nazw opcj "Zapis".

Analogicznie naley postpowa w przypadku zamiany innych formatw.



4. Podzikowania
   -------------

     Do powstania Kameleona przyczyniy si nastpujce osoby,  ktrym 
grupa ROHAR chciaaby podzikowa:
     - Przemek Kobel (podrzucenie pewnego ciekawego pomysu),
     - Witek Warczak (wprowadzenie w assembler 68000).



5. Korespondencja
   --------------

     Wszelk  korespondencj  dotyczc  naszych  programw,   pytania 
dotyczce ich dziaania, informacje o wykrytych bdach, sugestie, jak 
je ulepszy oraz pytania o najnowsz ofert ROHAR-u naley kierowa na 
jeden z poniszych adresw:

     KAZ
     ---
     ul. Wojrowicka 46/26
     54-436 Wrocaw
     e-mail: kziembik@wroc.net

     Zyga
     ----
     Doboszowice 52
     57-241 Doboszowice
     e-mail: bak@mvax.pwr.wroc.pl

     Pamitaj  jednak  o tym,  by do listu  doczy  zaadresowan  do 
siebie  kopert  i  wany  znaczek.  Tylko  wtedy  moemy  gwarantowa 
odpowied.  Jeli  chcesz otrzyma najnowsz wersj jakiego  programu 
musisz do koperty i znaczka doda dyskietk (3.5 cala jeli ma to  by 
dla ST/STE, a 5.25 cala gdy dla XL/XE).

     Miego korzystania z programu.
