Graphics 3 Planner 
~ Abbuc Software Contest 2016 ~
1. co to jest?
Graphics 3 Planner (gr3 planner) to prosty program do edycji grafiki w Atarowskim trybie Graphics 3 (a waciwie Graphics 19 - bez okienka tekstowego). Cay program jest napisany w Turbo Basicu XL.
2. Obsuga programu
1,2,3,0 - wybr koloru
+ - zmiana rejestru biecego koloru o 2
- - zmiana biecego koloru o -2
D - rysowanie danych
C - wymazanie danych
M - wyjcie do menu
E - edycja informacji
V - podgld informacji
L - wczytanie danych
    240 bajtw w formacie SG3
    odpowiednia ilo bajtw formatu AG3
    podanie "DIR" jako nazwy pliku wywietla pliki formatu *.AG3 oraz *.SG3 znajdujce si w katalogu D: 

S - zapis danych w wybranym formacie
    zapis w formacie SG3 lub AG3 (z odpowiednim wyrnikiem)
    podanie "DIR" jako nazwy pliku wywietla pliki formatu *.AG3 oraz *.SG3 znajdujce si w katalogu D: 

Rysujemy przy pomocy joystickaa. Odczyt/zapis wymaga pki co penej cieki (na przykad: D:TEST.SG3 - dugo zagniedze przewidziana do 40-tu znakw).
3. Stosowane formaty pliku
3.1 SG3
Pena nazwa to Standard Graphics 3, format pliku programu Graphics 3 Planner. 
Brak jakichkolwiek dodatkowych informacji, zawiera czyste dane grafiki.
- cztery kolory
- 40x24
- brak informacji dodatkowych (czyste dane)
- tylko 240 bajtw
3.2 AG3
Pena nazwa to Additional Graphics 3, format pliku programu Graphics 3 Planner.
Rozszerzony o dodatkowe dane format SG3. Opis wskazuje na dodatkowe elementy (opis wedug kolejnoci).

    informacja o ustawieniach kolorw na kocu pliku (4 bajty w kolejnoci rejestrw 708, 709, 710 i 712)
    wyrnik pliku (1 bajt w formie znaku):
        N - brak dalszych informacji
        S - short info
        I - info
        A - animacja
        F - przysze zastosowania 
    dugo 245 (lub 245+dodatkowe) bajtw 

Wyrniki:
    N - wskazuje na brak dodatkowych informacji, koczy plik, dugo pliku 245 bajtw
    S - czyli krtkie info, 40 bajtowa informacja tekstowa na kocu pliku, dugo pliku 285 bajtw
    I - info, informacja opisowa, podzielona na bloki:
        240 bajtw danych
        4 bajty kolorw
        wyrnik I - 1 bajt
        40 bajtw infa (tosame z wyrnikiem S)
        1 bajt informujcy o iloci 80 bajtowych blokw opisu (od 1 do 3)
        bloki dodatkowych opisw - 80, 160 lub 240 bajtw
W sumie dugo pliku wynosi 376, 456 lub 536 bajtw

    A - animacja (w opracowaniu)
    F - "future", do dodatkw, jeszcze nie sprecyzowane (prawdopodobnie szeroko obrazu, wysoko, inne - w opracowaniu) 
4. Uwagi kocowe
4.1 Dlaczego wersja 0.75, a nie 1.0?
Program ma przewidziane kilka dodatkowych rozszerze - na przykd modu animacji i modu niestandardowych rozmiarw obrazu. Poniewa cz rzeczy jest jeszcze w opracowaniu - nie nadaem penego numeru. Podstawowa funkcjonalno jest pena.
4.2 Po co dodatkowe bloki informacji?
Na przykad do wystawiania prac na rnego rodzaju party. Dziki dodatkowej informacji - ktra standardowo nie jest wywietlana - moliwe s do zawarcia w pracy dodatkowe informacje bez dodatkowych plikwe tekstowych (na przykd autor, tytu pracy, konkurencja, itp., itd.)
4.3 Niedogodnoci
Program by koczony na compo Abbuca - niestety, z powodu przyczyn osobistych nie udao mi si wszystkiego skoczy na czas. Kuleje jeszcze obsuga bdw. Prosz o wyrozumiao.
4.4 Inne
Program dziaa wycznie spod DOSu (cho w wersji kasetowej te powinien). Przy podawaniu nazwy plikw mona stosowa cieki do 40 znakw (wraz z zagniedzeniami), czyli z obsug podkatalogw. Caoc bya testowana pod MyDOSem.
5. Copyright
Program ma status DONATIONWARE, czyli - jeli uwaasz, e jest przydatny - wpa dowoln kwot na adres paypal: sikor_soft@interia.pl z dopiskiem "GR3 planner". Zmotywuje mnie to do dalszych dziaa nad jego rozwojem.
                        Pawe Sikorski, 28.07.2016
==========================================================

English translation (mostly Google Translator)
Graphics 3 Planner
~ ABBUC Software Contest 2016 ~
1. What is it?
Graphics 3 Planner (gr3 planner) is a simple program to edit graphics in Atari Graphics mode 3 (actually Graphics 19 - without a text window). The entire program is written in Turbo BASIC XL.
2. Short manual
1,2,3,0 - color selection
+ - Registry change current color 2
- - Change the current color of -2
D - drawing data
C - erase data
M - exit to menu
E - edit information
V - View information
L - load data
    240 bytes in size SG3
    the corresponding number of bytes format AG3
    enter "DIR" as the file name displays the format files * and * .AG3 .SG3 located in the D:

S - save data in the selected format
    recording format SG3 or AG3 (with appropriate differentiator)
    enter "DIR" as the file name displays the format files * and * .AG3 .SG3 located in the D:

We draw with joystickaa. Read / write requires while at full path (for example: D: TEST.SG3 - length nesting intended to just 40 characters).
3. Applied file formats
3.1 SG3
The full name of this Standard Graphics 3 file format Graphics 3 Planner.
No any additional information, contains pure data graphics.
- Four colors
- 40x24
- No additional information (raw data)
- Only 240 bytes
3.2 AG3
Full name is Additional Graphics 3 file format Graphics 3 Planner.
Expanded with additional data format SG3. Description indicates the additional elements (description in the order).

    information about the color settings on the end of the file (4 bytes in order of registers 708, 709, 710 and 712)
    discriminant file (1 byte in the form of a mark):
        N - No additional information
        S - short info
        I - info
        A - Animation
        F - future applications
    length of 245 (245 + or more) bytes

Highlights:
    N - indicates the absence of additional information, it ends the file, the file length 245 bytes
    S - a short info, 40-byte text information at the end of the file, the file length of 285 bytes
    I - info, information Descriptive divided into blocks:
        240 bytes of data
        4 bytes of colors
        I differentiator - 1 byte
        INFA 40 bytes (the same as the differentiator S)
        1 byte indicating an amount of 80 byte blocks for information (1 to 3)
        blocks further descriptions - 80, 160 or 240 bytes
The total length of the file is 376, 456 or 536 bytes

    A - Animation (in development)
    F - "future", additives, not yet defined (probably the image width, height, others - in preparation)
4. Concluding remarks
4.1 Why version 0.75 and not 1.0?
The program has provided some additional extensions - for example, the animation module and custom module size image. Because some things are still in development - not the full number I gave. The basic functionality is full.
4.2 What additional information blocks?
For example, to issue work for all kinds of party. With the additional information - which normally is not displayed - are possible to include in the work additional information without additional text files (for example, the author, title of work, competition, etc., Etc.)
4.3 disadvantages
The program was ended on compo ABBUC - unfortunately, because of personal reasons I could not finish everything on time. Still limping error handling. Please bear with us.
4.4 Other
The program only works from DOS (although in the version cassette it should). When specifying the file names can be used path to 40 characters (including zagniedzeniami), which enabled directories. The whole was tested for MyDOS.
5. Copyright
The program has the status Donationware, that is - if you think it is useful - a deposit of any amount to the address paypal: sikor_soft@interia.pl marked "GR3 planner". It motivates me to continue on its development.
                        Pawel Sikorski, 28/07/2016

========================================================
Deutsch Unterricht - Google bersetzer

Graphics 3-Planner
~ ABBUC Software Contest 2016 ~
1. Was ist das?
Graphics 3-Planner (gr3 Planer) ist ein einfaches Programm zu bearbeiten Grafik in Atari Grafikmodus 3 (eigentlich Graphics 19 - ohne ein Textfeld). Das gesamte Programm wird in Turbo BASIC XL geschrieben.
2. Untersttzung Programm
1,2,3,0 - Farbauswahl
+ - Registry ndern aktuelle Farbe 2
- - ndern Sie die aktuelle Farbe von -2
D - Zeichnungsdaten
C - Lschen von Daten
M - Ausgang zum Men
E - Informationen bearbeiten
V - Anzeigen von Informationen
L - Hochladen von Daten
    240 Bytes gro SG3
    die entsprechende Anzahl von Bytes Format AG3
    Geben Sie "DIR", wie der Name der Datei zeigt die Dateien im Format * und * .AG3 .SG3 im D:

S - Aufzeichnen von Daten im gewhlten Format
    Aufnahmeformat SG3 oder AG3 (mit entsprechenden Unterscheidungsmerkmal)
    Geben Sie "DIR", wie der Name der Datei zeigt die Dateien im Format * und * .AG3 .SG3 im D:

Wir ziehen mit joystickaa. Lesen / Schreiben erfordert, whrend bei vollstndigen Pfad (zB: D: TEST.SG3 - Lnge Verschachtelung soll nur 40 Zeichen).
3. Angewandte Dateiformate
3.1 SG3
Der vollstndige Name dieser Norm Graphics 3 Dateiformat Graphics 3 Planner.
Keine alle zustzlichen Informationen, enthlt reine Daten-Grafiken.
- Vier Farben
- 40x24
- Keine weiteren Informationen (Rohdaten)
- Nur 240 Byte
3.2 AG3
Vollstndiger Name ist Zustzliche Grafiken 3 Dateiformat Graphics 3 Planner.
Expanded mit zustzlichen Datenformat SG3. Beschreibung zeigt die zustzlichen Elemente (Beschreibung in der Reihenfolge).

    Informationen ber die Farbeinstellungen auf dem Ende der Datei (4 Bytes in der Reihenfolge der Register 708, 709, 710 und 712)
    Diskriminanzanalyse Datei (1 Byte in Form einer Markierung):
        N - Keine weiteren Informationen
        S - Kurzinfo
        I - Info
        A - Animation
        F - zuknftige Anwendungen
    Lnge von 245 (245 + oder mehr) Bytes

Highlights:
    N - zeigt das Fehlen von zustzlichen Informationen, die Datei zu Ende, die Dateilnge 245 Bytes
    S - eine kurze Info, 40-Byte-Textinformationen am Ende der Datei, die Dateilnge von 285 Bytes
    I - Info, Informationen Beschreibende in Blcke unterteilt:
        240 Bytes von Daten
        4 Byte Farben
        I Differen - 1 Byte
        INFA 40 Bytes (der gleiche wie der Differenzierer S)
        1 Byte einer Menge von 80-Byte-Blcke fr Informationen (1 bis 3), die anzeigt
        Blcke weitere Beschreibungen - 80, 160 oder 240 Bytes
Die Gesamtlnge der Datei betrgt 376, 456 oder 536 Bytes

    A - Animation (in Entwicklung)
    F - "Zukunft", Zusatzstoffe, noch nicht definiert (wahrscheinlich die Bildbreite, Hhe, andere - in Vorbereitung)
4. Schlussbemerkungen
4.1 Warum Version 0.75 und 1.0 nicht?
Das Programm hat einige zustzliche Erweiterungen zur Verfgung gestellt - zum Beispiel das Animationsmodul und benutzerdefinierte Modulgre Bild. Da einige Dinge noch in der Entwicklung sind - nicht die volle Zahl gab ich. Die Grundfunktionalitt ist voll.
4.2 Welche zustzlichen Informationsblcke?
Zum Beispiel, Arbeit fr alle Arten von Partei zu erteilen. Mit der zustzlichen Informationen - die in der Regel nicht angezeigt wird - sind mglich in der Arbeit zustzliche Informationen ohne zustzliche Textdateien (zum Beispiel der Autor, Titel der Arbeit, Wettbewerb, etc., etc.) enthalten
4.3 Nachteile
Das Programm wurde am Kompo ABBUC endete - leider aus persnlichen Grnden, die ich nicht alles rechtzeitig zu Ende bringen konnte. Noch hinken die Fehlerbehandlung. Bitte beachten Sie bei uns.
4.4 Sonstige
Das Programm funktioniert nur unter DOS (obwohl in der Version Kassette es sollte). Wenn die Dateinamen angibt kann Pfad zu 40 Zeichen verwendet werden (einschlielich zagniedzeniami), welche Verzeichnisse freigegeben. Das Ganze wurde MyDOS getestet.
5. Urheberrecht
Das Programm den Status Donationware hat, das ist - wenn Sie denken, dass es sinnvoll ist - eine Anzahlung in Hhe eines Betrages an die Adresse paypal: sikor_soft@interia.pl markiert "GR3 Planer". Es motiviert mich auf seine Entwicklung fortzusetzen.
                        Paul Sikorski, 28/07/2016