 XLPaint 2.5-2.6 MaX
---------------------

.Autorzy

Orygina Stanley/USG (Stanislaw Skwiot), poprawki i dodatki TeBe/Madteam (Tomasz Biela).


.Wstep

XLPaint Max to przystosowany do rysowania w 16 kolorach-interlace program Stanleya z USG, ktry 
oryginalnie pozwala na rysowanie w 7 kolorach-interlace. Dodatkowo Max pozwala na zmian palety 
kolorw co drug lini ekranu. Ekran na ktrym rysujemy ma rozmiar 160 pixli x 192 linie. Oczywicie
poprzez odpowiednie ustawienie palety mona rysowa w 4 kolorach bez interlacu lub 7 kolorach interlace jak
w starej wersji XLPaint-a.

Program wykorzystuje ca podstawow pamici XE/XL (64kB) od adresu $1F00.

Dane pierwszego obrazu znajduj si pod adresem $70b0, drugi obraz pod $90b0.

Wersja 2.6 przeznaczona jest tylko dla CPU 65816, dla CPU 6502 najnowsz wersj jest 2.5


.Mysz ST

W czasie dziaania programu moemy sterowa kursorem zawsze za pomoc klawiszy, joysticka i myszy.
Wyjtkiem jest Zoom, tutaj nie bdzie dziaaa myszka.

Mysz od Atari ST musi by podczone do portu 2 joysticka. Pod emulatorem 'Atari800Win Plus'
w zakadce Input->Mouse Device->wybieramy Atari ST mouse, w zakadce Input->Mouse...->ustawiamy
Emulated Device: Atari ST mouse, Mouse port: 2, Speed of emulated device: 16 lub wg uznania.
Aktywacja myszki nastpi poprzez nacinicie klawisza F12.

Procedur odczytu myszki udostepni Pecus -> http://atariarea.nostalgia.pl/forum/viewtopic.php?t=291


.Ekran

Ekran podzielony jest na 4 czci. Paleta z kolorami + aktywny kolor, pasek menu + wspXY kursora,
obszar do rysowania, menu dolne z wyborem rodzaju rysowania.

Pasek menu: 'Info File fUnc Otch            X000 Y000'

Dua litera z nazwy + Shift to aktywacja, np: Shift+I, Shift+F, Shift+U.
Podobnie aktywuje sie inne funkcje.


.Klawiszologia

HELP		- help
LOGO		- zoom ekranu, od pozycji XY kursora
0-9		- kolory od 0-9
Shift 1-6	- kolory od 10-15
SPACE		- nastpny kolor z palety
Shift SPACE	- poprzedni kolor z palety
RETURN		- odpowiednik przycisku Fire
INSERT		- pobranie koloru spod kursora, nie dziala pod Zoomem, wystarczy wyj z Zooma (LOGO)
		  pobra kolor przez Insert i wrci (LOGO), pozycja XY kursora zostaje zachowana
U		- undo, usunicie ostatniej zmiany na obrazie (ZOOM wycza UNDO)
ESC		- przerwanie rysowania wybrana metoda
Shift X		- zmiana ksztatu kursora, 4 rozne ksztalty
Shift .		- normalna wysoko kursora
Shift ,		- podwjna wysoko kursora
Shift I		- info o autorach INFO
Shift F		- operacje we/wy FILE, odczyt - zapis
Shift U		- wybr funkcji fUnc
Shift TAB	- przejcie do wyboru i modyfikacji palety kolorw
Shift RETURN	- nowa paleta kolorw od pozycji Y kursora na ekranie, tylko w liniach parzystych
Shift CLEAR	- czyci ekran, bez potwierdzenia
Shift DEL	- zamienia wskazany przez kursor kolor na nowy wybrany kolor na caym obrazie
Shift Ctrl Q	- wyjcie do DOS-a, powrt jest niemoliwy

P - Point	- stawia pojedyczy pixel
A - Spray	- spray
K - Kspray	- kspray
D - Draw	- swobodne rysowanie
L - Line	- pojedycza linia
I - Lines	- linie, krzywa amana
Y - Rays	- promienie 'soca' :), odcinki wychodzce z jednego wsplnego punktu
T - Triangle	- trjkat
R - Rectangle	- czworokt
C - Circle	- okrg, max promien = 64, ktry jest wyliczany na podstawie pozycji X kursora
F - Fill	- wypenianie
B - Box		- wypeniony czworokt
S - Disc	- wypeniony okrg, ograniczenia takie jak dla Circle
O - Object	- operacje na obiekcie cOpy, Move, Paste

.fUnc 		- Shift+U funkcje

H-flip		- obrt wzgledem osi Y
V-flip		- obrt wzgledem osi X
Centflip	- obrt wzgledem osi X i Y
Rotate		- obrt o 90 stopni
Lighting	- rozjanienie zaznaczonego fragmentu o 1 stopie
Darkness	- ciemnienie zaznaczonego fragmentu o 1 stopie
Negative	- negatyw koloru
Blur		- blur
Spill		- efekt spywania farby
Embos		- embos, efekt kamienia
Antique		- antique
eFfect3d	- efekt 3d, przesuniecie osi X o wektor (1,1)
shadoW		- cie
eXch-col	- 'przebarwienia'


.Menu File (Shift+F)

LOAD FILE pozwala na zaadowanie pliku akceptowanego przez program, czyli INP, MIC, XLP lub MAX.
Program rozpoznaje format INP oraz MIC po rozmiarze pliku: INP-16004bajty, MIC-7684bajty. Inne
pliki zostan zignorowane.

SAVE .XLP zapis skompresowanego obrazu-interlace dla 7 kolorw.
SAVE .RAW zapis nieskompresowanego obrazu-interlace bez informacji o kolorach.
SAVE .MIC zapis nieskompresowanego obrazu, bez interlace dla 4 kolorw.
SAVE .MAX zapis skompresowanego obrazu-interlace z pen informacj o kolorach.

XLP	- nagwek 4 bajtowy XLPC
	- 4 bajtowa informacja o kolorach
	- skompresowane dane

RAW	- nagwek 4 bajtowy XLPB
	- nieskompresowane dane obrazu - 7680+7680bajty

MIC	- dane obrazu 7680 bajty
	- informacja o kolorach - 4 bajty

MAX	- nagwek 4 bajtowy XLPM
	- 192 bajty kolor 0
	- 192 bajty kolor 1
	- 192 bajty kolor 2
	- 192 bajty kolor 3
	- 192 bajty jasno 0
	- 192 bajty jasno 1
	- 192 bajty jasno 2
	- 192 bajty jasno 3
	- 192 bajty tablica wskanikow palety kolorw
	- skompresowane dane


.Historia
2006/08/11 (65816)
	- dodana mozliwo cofnicia UNDO
	- wersja 2.6 przeznaczona dla CPU 65816, oglnie szybsza od wersji dla 6502

2006/08/10
	- optymalizacja szybkoci wykonywania procedur, np. PLOT, UNDO, PUTCHAR
	- rezygnacja z moliwoci zmiany koloru ta co linie, mona tylko zmienia kolor caego ta

2006/08/08
	- poprawione i zoptymalizawane programy przerwa DLI, w poprzedniej wersji programu zmiany
          kolorw trway wicej ni 1 linie obrazu co byo wida najbardziej pod ZOOM-em

2003/06/08
	- mona wczyta MIC-a bez palety kolorw, czyli 7680 bajtw
	- zapisuje ju poprawnie pliki MAX

2003/02/03
	- dodana opcja zmniejszenia numeru koloru Shift+SPACE
	- zmiana wysokoci kursora dla wszystkich 4 ksztatw
	- zmienianie ksztatu kursora pod Zoomem
	- naprawiony Shift+DEL, zamienia wskazany przez kursor kolor na nowo wybrany
	- pobranie koloru spod kursora poprzez klawisz INSERT, nie dziala pod Zoomem
	- naprawione dzialanie Object (cOpy, Move, Paste)
	- zerowanie stanu przycisku Fire po wyjsciu z dolnego menu
	- dodanie obslugi myszki Atari ST, w porcie 2 joysticka
	- poprawione Circle i Disc, nadal jednak promie wyliczany jest wg wspX, a jego max dlugosc=64
	- wywietlanie nazwy wybranej funkcji (Shift+U)
	
2002/08/12
	- efekty typu emboss, blur dziaay nadal z 7kol paleta, teraz z 16kol
	- powsta dodatkowy program RIP2MAX, konwertujcy format RIP na MAX

2002/03/04
	- par zauwaonych bugw
	- zmiana palety kolorw widoczna pod ZOOM'em
	- przesw ekranu co 2 wiersze pod ZOOM'em

2002/02/16
	- buforowany przycisk FIRE

2002/02/12
	- poprawka dla Shift+, Shift- (zy kod klawisza)

2002/02/11
	- zmiana palety kolorw w liniach parzystych
	- przeczanie grna/dolna poowa ekranu przy wyborze palety kolorw (Shift+Tab)

