Simple TextPaint V1.1

Transkript

1 Simple TextPaint V Überblick 2. Systemvoraussetzungen & Entwicklungsumgebung 3. Hauptbildschirm & Grundfunktionen 4. Tastaturkürzel 5. Fenster 6. Werkzeuge 7. Bekannte Fehler 8. Zukünftige Verbesserungen 9. Referenzen 10. Werbung ;) 11. Kontakt & Copyright 1. Übersicht Simple TextPaint ist ein kleines Programm zum Zeichnen von "ANSI-art". Dabei werden lediglich Textzeichen und die DOS Standardfarben zum Erzeugen des Bildes verwendet. Das Programm befindet sich in der Beta-Version und ist noch nicht ausgereift. Beispiel für ein 'ANSI-art' Bild. (c) by Michael Arnett 2. Systemvoraussetzungen & Entwicklungsumgebung Simple TextPaint wurde unter Borland C für MS-DOS entwickelt. Weil die Grundfunktionen zum Ansteuern des Cursors z.z. noch über ESC-Sequenzen laufen, muss der Gerätetreiber ANSI.sys geladen sein. Dies geschieht in der Regel über einen Eintrag in der 'Config.sys'.: DEVICE=C:\Windows\COMMAND\ANSI.SYS Das Programm kann auch in einer Windows Dos-Box ausgeführt werden. Allerdings können je nach Bildschirmeinstellungen Probleme bei der Darstellung auftreten. Das Fenster der DOS Box sollte auf jeden Fall maximiert werden. Werden dann immer noch einige Zeichen falsch dargestellt so liegt die Ursache möglicherweise in einem faschen Zeichsatz. Zum Überprüfen öffnen Sie die 'config.sys' und suchen nach einer Zeile die in etwa so aussieht: DEVICE=C:\Windows\COMMAND\display.sys con=(ega,... Entfernen Sie diese Zeile und starten Sie das System neu. 3. Hauptbildschirm & Funktionsumfang

2 Simple TextPaint in einer DOS Box Die unterste Zeile des Bildschirms wird vom Programm als Statusbar genutzt. Hier sind immer folgende Informationen ersichtlich: x1,y1: Die ersten Koordinaten die ggf. ausgewählt wurden x2,y2: Die zweiten Koordinaten die ausgewählt wurden Tool: Das aktuell ausgewählte Werkzeug Modus: Der Programm Modus Zeichen: Das aktuelle Zeichen Cursor positionieren: Der Cursor wird mit Hilfe der Pfeiltasten positioniert. Dabei wird die aktuelle Position immer grau hinterlegt dargestellt. Um die grau markierte Cursorposition als (x1,y1), (x2,y2) Koordinate zu setzen, bzw. das aktuelle Werkzeug anzuwenden, drücken Sie RETURN. Koordinaten: Sie benötigen je nach Werkzeug ein bis zwei Koordinaten. Nachdem für die jeweilige Funktion die benötigten Koordinaten gesetzt sind, wird diese automatisch ausgeführt. Modus: Das Programm unterscheidet zwischen Editier- und Kontrollmodus. Im ersten können Sie auf dem Bildschirm zeichnen, im Zweiten können sie innerhalb eines Menüs agieren. Zeichen: Das gewählte Zeichen in den aktuellen Farben. Beim Ausführen eines Werkzeuges wird dieses Zeichen angewendet, sofern dies vorgesehen ist. 3. Tastaturkürzel Das Programm wird zur Zeit vollständig über die Tastatur gesteuert. Für die Zukunft ist jedoch eine Mausunterstützung geplant. Im Editiermodus: Tasten Funktion Reaktion F1 Menü zum Wechseln der Hintergrundfarbe -> Kontrollmodus F2 Menü zum Wechseln der Vordergrundfarbe -> Kontrollmodus F3 Menü zum Wechseln des Werkzeugs -> Kontrollmodus F4 Menü zum Wechseln der Zeichens -> Kontrollmodus F5 Dialog zum Laden einer Datei -> Kontrollmodus F6 Dialog zum Speichern einer Datei -> Kontrollmodus

3 F7 Kurzhilfe -> Kontrollmodus F8 Demo -> Kontrollmodus F9 Über des Programm -> Kontrollmodus F10 Spezial: Speichern als ANSI Datei -> Kontrollmodus Alt-1 Wähle die nächste Hintergrundfarbe - Alt-2 Wähle die nächste Vordergrundfarbe - Alt-3 Wähle das nächste Werkzeug - Alt-4 Wähle das nächste Zeichen - Alt-q Programm beenden Sonstiges darstellbares Zeichen Ausgabe des Zeichens an der aktuellen Cursorposition - Return Koordinaten setzen, Werkzeug ausführen - Im Kontrollmodus: Tasten Funktion Reaktion ggf. Pfeiltasten Auswahl ändern - ggf. Return Auswahl übernehmen und Menü verlassen -> Kontrollmodus ESC Abbruch -> Kontrollmodus sonstige Tasten gemäß Ausgabe 4. Fenster Die Fenster ermöglichen eine visuelle Auswahl der aktuellen Werkzeug Optionen. Sobald sie in einem Fenster/Menü sind wechselt das Programm in den Kontrollmodus. Alle Fenster kennen das Tastaturkürzel ESC (Abbruch) und Return (OK). Die Funktionen der einzelnen Fenster entnehmen sie bitte der Tastaturkürzel Tabell. Hintergrundfarbe Vordergrundfarbe Werkzeuge Laden Speichern 5. Werkzeuge Name Koord. Funktion Linie 2 Zeichnet eine Linie zwischen den beiden Koordinaten Rechteck 2 Zeichnet ein Rechteck. Die Koordinaten definieren die linke obere und rechte untere Ecke. Ellipse 2 Zeichnet ein eine Ellipse. Die Koordinaten definieren die linke obere und rechte untere Ecke eines imaginären Rechtecks, in das die Ellipse gezeichnet wird. Pixel 1 Setzt das aktuelle Zeichen an die Cursorposition Füllen Hintergrund 1 'Floodfill' in Abhängigkeit von der Hintergrundfarbe an der Cursorposition. Füllen Vordergrund 1 'Floodfill' in Abhängigkeit von der Vordergrundfarbe an der Cursorposition Füllen Zeichen 1 'Floodfill' in Abhängigkeit von dem Zeichen an der Cursorposition

4 Bildschirm löschen 0 cls Rechteck mit doppelter Linie Rechteck mit einzelner Linie 2 Wie obiges Rechteck, allerdings wird nicht das aktuelle Zeichen verwendet, sondern eine doppelte Linie. 2 Wie obiges Rechteck, allerdings wird nicht das aktuelle Zeichen verwendet, sondern eine einfache Linie. Rechteck gefüllt 2 Zeichnet ein gefülltes Rechteck. Die Koordinaten definieren die linke obere und rechte untere Ecke. Kopieren 2 Kopiert den ausgewählten Bereich in eine programminteren Zwischenablage. Die Koordinaten definieren die linke obere und rechte untere Ecke. Einfügen 1 Fügt die Zwischenablage ein. Ggf. überstehende Teile werden abgeschnitten Ausschneiden 1 Kopiert den ausgewählten Bereich in eine programminteren Zwischenablage und löscht den Bereich. Die Koordinaten definieren die linke obere und rechte untere Ecke. Colorieren Hintergrund Colorieren Hintergrund 1 Färbt den ausgewählten Bereich in der aktuellen Hintergrundfarbe (Vordergrundfarbe und Zeichen bleiben erhalten). Die Koordinaten definieren die linke obere und rechte untere Ecke. 1 Färbt den ausgewählten Bereich in der aktuellen Vordergrundfarbe (Hintergrundfarbe und Zeichen bleiben erhalten). Die Koordinaten definieren die linke obere und rechte untere Ecke. Spiegeln horizontal 1 Spiegelt den ausgewählten Bereich horizontal. Die Koordinaten definieren die linke obere und rechte untere Ecke. Spiegeln vertikal 1 Spiegelt den ausgewählten Bereich vertikal. Die Koordinaten definieren die linke obere und rechte untere Ecke. 6. Bekannte Fehler ggf ist die graue Cursor Markierung nicht sichtbar. die Funktion Ellipse ist nicht exakt und macht Rundungsfehler die Eingabe von Dateinamen hat Probleme mit Sonderzeichen Dateinamen müssen den DOS Konventionen entsprechen (8Zeichen.EXT) 7. Zukünftige Verbesserungen Steuerung des Cursors über Interrupts Mausunterstützung zusätzliche Funktionen (undo,...) laden von ANSI Dateien Referenzen Programmiersprache C - Eine strukturierte Einführung (rororo) C/C++ Lösungen (Franzis') Computer Graphics: Principles and Practice (Verlag:?) Dinkum C Library Reference ( Introduction to Object-Oriented Programming Using C++ ( C-Kurs ( The Art of Computer Programming [ Beispiel ANSI Bilder (teilw.): ACID Artpacks ( ] 9. Werbung Hier eine Auswahl weiterer Textart Tools. Sie sind alle Freeware und können von meiner Homepage heruntergeladen werden.

5 ASCIIEditor IV Vermutlich das einzige Windows Programm zur einfachen Erstellung von Text-Art. Es bearbeitet einfache Textbilder bis hin zu komplexen HTML Grafiken. Eine vielzahl von Formaten (HTML/ANSI/BMP/...) werden unterstützt und (fast;) alle Funktionen die aus Grafikprogrammen bekannt sind wurden integriert... Text-art Applet Ein JAVA Applet, dass es ermöglich formatierten Text auszugeben und den Cursor zu positionieren. Der Syntax ist den DOS ESCSquencen ähnlich. Neben der manuellen Codierung ist es auch möglich mit ASCIIEditor IV erstellte Grafiken zu speichern. ANSI-art Applet ANSI-art ist bisher im www fast ausschießlich als GIF Screenshots dargestellt worden. Dieses Applet hat den erweiterten IBM Zeichensatz integriert und kann animierte sowie scrollbare ANSI Grafiken anzeigen. Mit Hilfe eines Tools können ANSI Dateien automatisch in eine HTML Seite konvertiert werden, die das Applet anzeigen kann. 10. Kontakt, Copyright Diese Programm ist im Rahmen einer Projektarbeit fuer die Berufsschule entstanden. Es ist mein erstes C Programm und es hat sicherlich noch viele Schwächen und Bugs. 'Simple Text Paint' ist Freeware für private Nutzung. Bei Veröffentlichungen im Internet muss ein Verweis auf meine Internetseite angegeben werden. Dort kann auch der Quelltext heruntergeladen werden. Simple Text Paint (Programmentwurf) Version 1.1 Zielsetzung: Ein Programm zum Erstellen und Bearbeiten von ANSI-art. Das Programm soll über elementare Zeichenfunktionen, eine einfache grafische Benutzeroberfläche und Funktionen zum Laden/speichern der Bilder verfügen. Funktionsumfang - Datei laden/speichern ( selbstdefiniertes Format, später ANSI) - Zeichenfunktionen: Linie, Kreis, Viereck, Füllen, colorieren, spiegeln, füllen, cls - Farben: DOS Standardfarben (Vorder- und Hintergrund) Benutzeroberfläche - Statusbar, Menüs und Fenster im DOS Stil Systemumgebung - DOS / Windows DOS Box Hardwarevoraussetzungen - Pentium empfohlen verwendete Entwicklungswerkzeuge - Borland C / C ANSI C Umfang der Dokumentation - Kurzanleitung Übergabetermin - 25.Mai (Entwurf) Entwurf: (ab Version 1.1)

6 Anmerkung: Minimaler Speicherbedarf durch Verwendung des Typs CHAR zum Speichern von Zahlenwerten. Steuerung der Ausgabe über ANSI Sequenzen (ANSI.sys muss geladen sein) DOS Dateinamens Konventionen gelten auch in der DOS-Box Tastatursteuerung