
	Datei: readme.txt
	Datum: 15.10.91
	Zuletzt: 16.03.93
	Release: 1.8C
	Copyright (c) 1991-1993 by Andre Moeller
	Manhagener Allee 62A
	D-22926 Ahrensburg
	Tel: 04102/53892


Vertrieb:

	ͻ
	  Q-Graphic 1.8c                
	  SWD-QNX4 Addendum             
	Ķ
	  SW Datentechnik GmbH          
	  Raiffeisenstr. 2-4            
	  D-25445 Quickborn(Germany)    
	  Phone:+49(0)4106-61090        
	  Fax:+49(0)4106-610940 or 4030 
	  Tlx:2180657 swdq              
	  Box:+49(0)4106-610981         
	  X.25:454 106 832 4            
	ͼ



                   Q G R A P H I C   I N S T A L L A T I O N


Inhalt:
=======
1.) QGRAPHIC Kurzvorstellung
2.) Programme auf Diskette
3.) Installation
4.) Compilieren der Demoprogramme
5.) Zuknftige Treiber
6.) Haftung
7.) Falls Probleme auftreten


1.) QGRAPHIC - das komplette Turbo-Grafik-Paket fr Hercules-Monochrom,
    EGA/VGA-Grafikkarten und NEC-P6/P7 24-Nadel-Drucker;

- luft unter DOS/BorlandC, QNX 2.15/C86 (Computer Innovations) und
  QNX 4.x/WatcomC;

- ist komplett in ANSI-C geschrieben und daher leicht auf andere Systeme
  portierbar;

- programmiert direkt die Grafik-Hardware ohne jeglichen BIOS-Aufruf;

- untersttzt je nach Treiber folgende Auflsungen:


Auflsung   Farben  Modus       Treiber   VGA-Karte    Speicher  Monitor

 720 x 348       2  HERCMONOHI  HERC      Hercules      32/64KB  TTL-Mono
 640 x 200      16  EGALO       EGAVGA    VGA           256KB    Analog
 640 x 350      16  EGAHI       EGAVGA    VGA           256KB    Analog
 640 x 200      16  VGALO       EGAVGA    VGA           256KB    Analog
 640 x 350      16  VGAMED      EGAVGA    VGA           256KB    Analog
 640 x 480      16  VGAHI       EGAVGA    VGA           256KB    Analog
 720 x 480      16  VGA720      EGAVGA    VGA           256KB    Analog
 800 x 600 3)   16  VGA800      EGAVGA    VGA           256KB    Multisync
1024 x 768      16  VGA1024     EGAVGAHI  Video7-1024i  512KB    IBM8514
1024 x 768 2)   16  VGA1024     EGAVGAHI  TSENG-ET4000  512KB    IBM8514
 320 x 200     256  VGA256LO    VGA256    VGA           256KB    Analog
 360 x 480     256  VGASCQ      VGA256    VGA           256KB    Analog
 640 x 400 1)  256  VGA256MD    VGA256    VGA           256KB    Analog
1024 x 768 2)  256  VGA256HI    VGA256HI  TSENG-ET4000  1MB      IBM8514

1920 x 1440      2  NECP6       NECP6     NECP6-Printer   345,6KB minimum Heap

1) in Vorbereitung
2) z.B. IRIS VGA
3) z.Zt. nur unter DOS

- ist kompatibel zu smtlichen Funktionen des Borland Graphics Interface
  (BGI):

  Kontrollfunktionen:
    registerbgifont, installuserfont, detectgraph, getmoderange, getmaxmode,
    getdrivername, getmodename, initgraph, graphdefaults, setgraphmode,
    getgraphmode, restorecrtmode, closegraph;

  Zeichnen und Flchenfllungen:
    arc, circle, drawpoly, ellipse, getarccoords, getaspectratio,
    setaspectratio, getlinesettings, line, lineto, linerel, moveto, moverel,
    rectangle, setlinestyle, setwritemode, bar, bar3d, fillellipse, fillpoly,
    floodfill, getfillpattern, getfillsettings, pieslice, sector,
    setfillpattern, setfillstyle;

  Zugriffe auf den Bildspeicher und Zeichenfenster:
    cleardevice, setactivepage, setvisualpage;

  Manipulation des Zeichenfensters:
    clearviewport, getviewsettings;

  Manipulation des Bildausschnitts:
    setviewport, getimage, imagesize, putimage;

  Manipulation der Bildpunkte:
    getpixel, putpixel;

  Funktionen zur Ausgabe von Text:
    gettextsettings, outtext, outtextxy, settextjustify, settextstyle,
    setusercharsize, textheight, textwidth;

  Bildschirmfarben:
    getbkcolor, getcolor, getmaxcolor, getpalette, setallpalette, setbkcolor,
    setcolor, setpalette, setrgbpalette;

  Fehlerbehandlung:
    graphresult, grapherrormsg;

  Status-Abfrage:
    getarccoords, getaspectratio, getbkcolor, getcolor, getdefaultpalette,
    getdrivername, getfillpattern, getfillsettings, getgraphmode,
    getlinesettings, getmaxcolor, getmaxmode, getmaxx, getmaxy, getmodename,
    getmoderange, getpalette, getpalettesize, getpixel, gettextsettings,
    getviewsettings, getx, gety;

- untersttzt zwei weitere Pixel-Fonts (8x14 (EGA/VGA) und 8x16 (nur VGA))
  zustzlich zum 8x8-Pixelfont;

- ermglicht das Anzeigen und Speichern von PCX-Image-Files (ZSoft-Standard):
    pcxload, pcxsave;

- stellt neue Funktionen zum Verschieben von Bildausschnitten bereit:
    moveleft, movetop, moveright, movebottom;

- enhlt einfache Routinen zur Speicherung und Anzeige ganzer Grafikseiten:
    loadscreen, savescreen;

- enthlt ein Modul zum Drucken von Bildausschnitten:
    printscreen;

- untersttzt sechs weitere Vector-Fonts mit dem kompletten IBM-Zeichensatz
  (incl. dt. Umlaute) wie Script, Simplex, Triplex-Script, Complex,
  European und Bold zustzlich zu den Standard-Vector-Fonts Triplex,
  Small, Sans-Serif und Gothic;

- kann durch Einbinden neu programmierter Treiber auch zuknftige Grafikmodis
  untersttzen.


2.) Dateien auf der Distributions-Diskette:
===========================================
Die Diskette ist eine 1.2 Megabyte Diskette im DOS-Format und beinhaltet
folgende Dateien:

o bgidemo.c     Borlands Grafik Demonstrationsprogramm
o egavga.c      Treiber-Funktionen fr Grafikmodi bis 16 Farben
o egavgahi.c    Treiber fr Grafikmodi mit 1024x768 Punkten und 16 Farben
o herc.c        Treiber-Funktionen fr die Hercules-Monochrom-Karte
o makefile.ci   Makefile fr QNX2/CI zum Erzeugen der Demoprogramme
o makefile.wc   Makefile fr QNX4/WC zum Erzeugen der Demoprogramme
o necp6.c       Treiber-Funktionen fr den NEC-P6/P7 24-Nadel-Drucker
o printscr.c    Experimenteller Druckertreiber fr Epson-kompatible Drucker
o printscr.h    Header-Datei fr "printscr.c"
o qgraphic.c    QGRAPHIC-Grafik-Modul
o qgraphic.h    Header-Datei fr "qgraphic.c"
o qgraphic.doc  Beschreibung der Vernderungen und Erweiterungen in Englisch
o qgraphic.txt  Beschreibung der Vernderungen und Erweiterungen in Deutsch
o qdemo.c       Demonstration der neuen QGRAPHIC-Funktionen
o qdemonec.c    Demonstrationsprogramm fr den NECP6/P7-Druckertreiber
o qdriver.h     Header-Datei fr "<Treiber>.c"
o qworld.pcx    Weltkarte im Grafik-PCX-Format (wird von qdemonec.c geladen)
o readme.doc    Diese Datei in Englisch
o readme.txt    Diese Datei
o referenz.doc  Eine kurze Funktionz-Referenz fr QGRAPHIC in Englisch
o referenz.txt  Eine kurze Funktionz-Referenz fr QGRAPHIC
o register.c    Testprogramm zum statischen Einbinden von Vektorfonts
o vga256.c      Treiber-Funktionen fr Grafikmodi bis 256 Farben
o vga256hi.c    Treiber fr Grafikmodi mit 1024x768 Punkten und 256 Farben
o *.chr         Vektor-Zeichenstze
o *.obj         Vektor-Zeichenstze zum statischen Einbinden ins Programm


3.) Installation:
=================
Folgende Schritte sind ntig, um QGRAPHIC auf die Festplatte zu installieren:

Unter DOS:
----------
xcopy a:\qgraphic c:\qgraphic /s


Unter QNX 2.15:
---------------
dfs start a=1 T=c,h,txt,doc &
backup a:/qgraphic 3:/qgraphic +a s=c +n
dfs stop


Unter QNX 4.x:
--------------
Fsys.floppy
Dosfsys -s &
cp /dos/a/qgraphic/*.* /qgraphic

cd /qgraphic
/* Umbenennen aller .obj-Zeichensatzdateien */
mv trip.obj trip.o
mv tripf.obj tripf.o
...

4.) Compilieren der Demoprogramme:
==================================

Mit BorlandC:
-------------
Environment-Einstellungen:
--------------------------
- Large Memory Model
- no Graphics Lib

Kommandozeilen-Parameter:
-------------------------
bcc -ml -eqdemo qdemo.c qgraphic.c egavga.c


Mit dem C86:
------------
cq -AL qdemo.c qgraphic.c egavga.c
patch qdemo +p

Bemerkung:
Soll das sog. Console-Switching weiterhin untersttzt werden, so ist der
Treiber EGAVGA mit dem Compiler-Parameter -D (=Define) aufzurufen:

cq -AL qdemo qgraphic egavga.c -DUSE_QNX_GLIB
patch qdemo +p

QGRAPHIC verwendet dann die Funktion graph_set_mode() aus der QNX shared
Library, um den Textmodus oder Grafikmodus ein- bzw. auszuschalten.
In diesem Fall werden aber nur noch die beiden Grafikmodis VGAMED und VGAHI
untersttzt.

Achtung: Mit dem C86 Version 3.40 wird die Grafik-Bibliothek glib_ci.vga mit
auf Diskette ausgeliefert. Mit dieser Bibliothek funktioniert das
Console-Switching von Grafik nach Text nicht mehr. Hoffentlich sind Sie noch
im Besitz einer "alten" Bibliothek:

Beispiel:
---------
glib.ci_vga   9-Aug.-89  18:32  88 Blks  /* Console-Switching geht */
glib.ci_vga  19-Sept-91  20:50  87 Blks  /* Console-Switching geht nicht */


Mit WatcomC unter QNX 4.x:
--------------------------

cc -ml -T1 -o qdemo qdemo.c qgraphic.c egavga.c

Starten Sie nun das Programm mit:

   ./qdemo


5.) Zuknftige Treiber:
=======================
QGRAPHIC und der Treiber EGAVGA werden mit der Applikation zusammengebunden.
Bei Verwendung neuer in Zukunft erhltliche Treiber mu jetzt dieser anstatt
der Treiber EGAVGA mit der Applikation zusammengebunden werden.

Achtung: Die Header-Datei qdriver.h wird nur in den jeweiligen Treiber
(z.B. egavga.c) eingebunden und nicht etwa in die eigene Applikation.


6.) Haftung:
============
Die QGRAPHIC Toolbox wird wie besehen verkauft. Der Autor und
SW Datentechnik GmbH bernehmen keinerlei Garantien fr die
Verwendungsfhigkeit des Programms zu irgendeinem bestimmten Zweck;
jede Haftung fr direkte, indirekte, verursachte oder gefolgte Schden,
die durch die Verwendung dieses Programms entstehen knnten,
ist ausgeschlossen.


7.) Falls Probleme auftreten:
=============================
Falls sich Probleme ergeben, schreiben Sie bitte ein kleines Testprogramm,
das den Fehler aufzeigt und schicken Sie dieses bitte an oben genannte
Adresse. Geben Sie bitte auch die Seriennummer der Diskette und die
Versionsnummer von QGRAPHIC mit an. Letztere finden Sie am Anfang dieser
Datei.
Dieses Verfahren hat gegenber telefonischen Anrufen den Vorteil, da Ihre
Anfrage auf jeden Fall unmiverstndlich ankommt und ebenfalls unverzglich
bearbeitet wird.

Vielen Dank!
