Ŀ
    Die PortFolio Grafik Toolbox                                          
                    (c)  1991  by  DaxSoft                                



Mit  der  PortFolio  Grafik Toolbox sind Sie in  der  Lage,  eigene  Grafik- 
programme  fr  den  Atari PortFolio zu erstellen.  Der Inhalt  der  Toolbox 
besteht aus:

       - PortFolio Paint :

         ein Malprogramm, mit dem Sie auf einem PC/XT/AT Bildschirmscreens 
         fr den PortFolio erstellen knnen.

       - PFGRAPH.TPU / PCGRAPH.TPU :

         Turbo Pascal Unit fr die Version 5.x, die grundlegende Routinen
         zur Verfgung stellt, um eigene Grafikprogramme zu erstellen.

       - PortFolio Camera :

         Ein  Snapshotprogramm,  mit dem es mglich ist,  aus  laufenden  PC
         CGA  Grafikprogrammen  einen Bildschirmausschnitt  zu  whlen,  und
         diesen als Atari Portfolio Grafikscreen zu speichern. Dieser Screen
         kann  u.  a.  von der Pascal Unit geladen oder von PortFolio  Paint
         bearbeitet werden.

       - Screenconverter APF2COM :

         konvertieren Sie Ihre Bildschirmscreen's in eine COM Datei, das als
         eigenstndiges Programm gestartet werden kann (nicht in der  Share-
         wareversion enthalten).

       - Beispielbilder

         im Verzeichnis PICTURES

       - KAEFER.COM / MICKEY.COM

         mit APF2COM konvertierte PortFolio Bilder































Ŀ
                P  o  r  t  F  o  l  i  o  -  P  a  i  n  t               




PortFolio Paint ist ein Malprogramm,  mit dem es mglich ist,  Grafiken  fr 
den Atari PortFolio zu erstellen.  Damit von vornherein kein Miverstndinis
aufkommt: PortFolio Paint luft nicht auf einem Atari PortFolio, sondern nur
auf  konventionellen PC's mit mindestens einer CGA Karte und einer Microsoft 
oder kompatiblen Mouse.

PortFolio   Paint   bentigt   zum  Betrieb  folgende   Dateien   in   einem 
Unterverzeichnis :

            - PFPAINT .EXE
            - FNT5x8  .CHR
            - FNT8x8  .CHR
            - FNT8X8B .CHR
            - RS8X8   .CHR
            - FNT8X14 .CHR
            - FNT8X16 .CHR

Starten Sie das Programm mit PFPAINT. Sind alle zustzlichen *.CHR Dateien im 
gleichen  Verzeichnis,  erscheint der Arbeitsbildschirm.  Sie knnen nun  mit 
Ihrer Arbeit beginnen.

Fr die Arbeit mit PortFolio Paint stehen verschiedene Funktionen zu Auswahl. 
Diese Funktionen mssen mit verschiedenen Tasten ausgewhlt werden.

Die Malaktionen:


  Es stehen folgende Malaktionen zur Verfgung:

         Punkt, Fllen, Kreis, Linie, Rechteck, Text, Pinsel


  Das  Auswhlen  einer dieser Funktionen geschieht mit der  Taste  <A>.  Ein 
  kleines  <a> bewirkt das Einstellen der nchsten Funktion,  ein groes  <A>
  stellt die vrangegangene Funktion ein.

  Die Bedeutung der einzelnen Malaktionen:

  - Punkt :
    diese Funktion kann zwei Bedeutungen haben.  Ist die Option Pinsel  nicht
    aktiv  eingestellt,  so bewirkt das Drcken auf die linke Mousetaste  das 
    zeichnen  eines Punktes auf dem Bildschirm.  Dieses geschieht mit dem  in 
    Farbe eingestellten Farbwert.

    Ist die Option Pinsel aktiv eingestellt, so kann whrend des Drckens der 
    linken  Mousetaste  ein Bildschirmausschnitt,  der mit der Aktion  Pinsel 
    definiert wurde ber den Bildschirm bewegt werden.  Mit dem Loslassen der 
    linken Mousetaste wird die Position festgelegt, an der der Bildschirmaus- 
    schnitt gesetzt wird.

  - Fllen:
    Mit dieser Aktion ist es mglich,  umrandete Bildschirmbereich mit  Farbe 
    auszufllen.  Die  Fllfarbe  ist  in Farbe definiert.  Bewegen  Sie  den 
    Mousecursor  auf  das  auszufllende Objekt und  drcken  Sie  die  linke
    Mousetaste.

  - Kreis:
    zeichnen eines Kreises.  Bewegen Sie den Mousecursor auf den  Mittelpunkt 
    des  zu zeichnenden Kreises und drcken Sie anschlieend die linke Mouse- 
    taste.  Halten Sie die Taste gedrckt und bewegen Sie die Mouse.  Solange
    die  linke  Mousetaste  gedrckt ist knnen Sie  die  Gre  des  Kreises 
    verndern. Mit loslassen der Mousetaste wird der Kreis auf dem Bildschirm 
    fest  gezeichnet.  Der  Kreis wird mit dem in Muster  definierten  Muster 
    ausgefllt.  Ist  in Muster nur ein schwarzes Rechteck zu sehen,  so wird 
    der Kreis nicht ausgefllt.  Der Kreisrand erhlt die in Farbe angegebene 
    Farbe.

  - Linie:
    bewegen  Sie  die Mouse auf den Anfangspunkt der  zu  zeichnenden  Linie. 
    Drcken  Sie  die  linke Mousetaste,  und bewegen Sie die  Mouse  an  die 
    gewnschte  Endposition.  Mit  loslassen der linken Mousetaste  wird  die 
    Position  der  Linie  festgelegt.   Die  Linie  wird  mit  dem  in  Farbe 
    definierten Farbwert gezeichnet.

  - Rechteck:
    bewegen  Sie  die Mouse an einen Eckpunkt des zu  zeichnenden  Rechtecks. 
    Drcken  Sie  die  linke Mousetaste,  und bewegen Sie die  Mouse  an  die 
    gewnschte  Endposition.  Mit  loslassen der linken Mousetaste  wird  die 
    Position  des Rechtecks festgelegt.  Das Rechteck wird mit dem in  Muster 
    angegebenen  Muster ausgefllt.  Ist in Muster nur ein schwarzes Rechteck
    zu sehen,  so wird das Rechteck nicht ausgefllt.  Das Rechteck wird  mit 
    dem in Farbe angegebenen Farbwert gezeichnet.

  - Text:
    bewegen Sie die Mouse an die Stelle,  an der Text ausgegeben werden soll. 
    Klicken Sie dann kurz auf die linke Mousetaste.  Anschlieend  knnen Sie 
    einen Text ber die Tastatur eingeben.  Mit der DEL Taste kann das letzte 
    Zeichen  gelscht  werden.  Mit  der RETURN Taste  wird  die  Texteingabe 
    beendet. Die Zeichenaktionen ndern sich zur Aktion "Punkt".

    Der  Text wird mit dem in T-Font angegebenen Schriftstil mit dem in Farbe 
    definierten Wert ausgegeben.

  - Pinsel:
    mit  dieser  Aktion knnen sie mit der Mouse  einen  Bildschirmausschnitt 
    whlen,  der  dann mit der Aktion "Punkt" an einer beliebigen Stelle  des 
    Bildschirms  wieder  ausgegeben werden kann.  Umranden  Sie  hierbei  den 
    Bildschirmausschnitt in der gleichen Weise wie Sie Rechtecke zeichnen.


Die Optionen:


  Unabhngig   zu  den  verschiedenen  Malaktionen  knnen  Sie  im  Programm 
  verschiedende Einstellungen ndern :

  - Farbe:
    mit der Taste <F> knnen Sie die eine der 2 Zeichenfarben auswhlen (grau 
    oder schwarz).

  - Pinsel:
    mit der Taste <P> knnen Sie einstellen, ob bei der Malaktion "Punkt" ein 
    Punkt oder ein Bildschirmausschnitt gesetzt wird.

  - T-Font:
    mit der Taste <T> knnen Sie einen von 6 verschiedenen Schriftstile  aus- 
    whlen,  in der Text dargestellt wird. Ein kleines <t> setzt den nchsten 
    Schriftstil,   ein   groes   <T>  den  vorhergenden   Schriftstil.   Die 
    verschiedenen   Schriftstile  sind  am  unteren  Rand   des   Bildschirms 
    angezeigt.

  - Muster
    mit   der   Taste  <M>  knnen  Sie  verschiedene  Fllmuster   fr   die 
    Zeichenaktionen Kreis und Rechteck auswhlen.  Mit einem kleinem <m> wird 
    das   nchste   Muster  ausgewhlt,   mit  einem  groen  <M>  wird   das 
    vorhergehende Muster aktiviert.  Is bei Muster nur ein schwarzes  Recteck 
    zu sehen, so wird bei einer Zeichenaktion nicht's ausgefllt.

  - Clear:
    die Taste <C> lscht den momentanen Bildschirminhalt.

  - Invertieren:
    die Taste <I> invertiert den momentanen Bildschirminhalt. D. h. aus einem 
    schwarzen Punkt wird ein grauer Punkt und umgekehrt.

  - Laden:
    mit der Taste <L> wird ein neuer Bildschirm geladen. Hierzu erscheint ein 
    Men  der auswhlbaren Dateien.  Whlen Sie mit der Mouse die  gewnschte 
    Datei  aus  und klicken Sie anschlieend die linke Mousetaste.  Wenn  Sie 
    sich  es  anderst berlegt haben,  und Sie kien  Bild  laden  wollen,  so
    klicken Sie die rechte Mousetaste, es wird dann kein Bild geladen.

    Sollten mehrere Bilder auf Diskette verfgbar sein, als angezeigt werden, 
    so  knnen  Sie  den Balken rechts neben der Auswahlliste mit  der  Mouse 
    verschieben,  um weitere Dateien aufzulisten. Whlen Sie anschlieend Ihr 
    gewnschtes Bild aus.

  - Speichern:
    Mit der Taste <S> speichern Sie Ihr Bild ab. Geben Sie einen neuen Datei-
    namen fr Ihr gerade bearbeitetes Bild an und bettigen Sie  anschlieend 
    die  RETURN  Taste.  Vorsicht:  Sollte der angegeben  Dateinamen  bereits 
    existieren, so wird die alte Datei Kommentarlos berschrieben.

  - Undo:
    Mit  der  Taste  <U>  wird die vorangegangene  Aktion  wieder  rckgngig 
    gemacht (auch diese der Option U).

  - ESC:
    Die   Taste  <ESC>  beendet  ProtFolio  Paint.   Ein  gerade  in   Arbeit 
    befindliches Bild wird nicht gespeichert.


Ŀ
               P  o  r  t  F  o  l  i  o    C  a  m  e  r  a              



PortFolio Camera ist ein speicherresidentes Snapshot Programm. Mit ihm ist es
mglich,  aus  laufenden CGA Grafikprogrammen einen Bildschirmausschnitt  als 
PortFolio  Screen  abzuspeichern.  Nach  dem Start  von  PFCAM  stehen  diese 
Mglichkeiten  zur Verfgung.  PFCAM kann beim Start ein Pfad- und  Dateiname 
als Parameter bergeben werden, mit denen die Screenshots gespeichert werden.
Jedem  Dateinamen  wird hierbei eine Zahl angehngt entsprechend  der  Anzahl 
gespeicherter Bildschirmausschnitte (nicht in der Shareware Version).

Whrend  eines  Programmlaufs  wird  PFCAM mit der  Tastenkombination  ALT  P 
aufgerufen. Mit den Cursortasten kann ein Rechteck ber den Bildschirm bewegt
werden, der den Bildschirmausschnitt markiert. Die Anzahl der Punkte, mit der 
das Rechteck bewegt wird kann mit den Tasten 1..9 eingestellt werden.

Ist  ein  Bildschirmausschnitt  gewhlt,  so beendet  die  RETURN  Taste  das 
Programm,  und der Ausschnitt wird gespeichert.  Wird die ESC Taste gedrckt, 
wird das Programm ohne Speicherung beendet.

Die  mit  PFCAM erzeugten Dateien haben die Standart Erweiterung  APF.  Diese 
Dateien  knnen  mit PFPAINT weiterbearbeitet werden oder mittels  der  Turbo 
Pascal Unit PFGRAPH in eigenen Grafikprogrammen verwendet werden.


Ŀ
              P o r t F o l i o   S c r e e n k o n v e r t e r           



Der Screenkonverter APF2COM ist nicht in der Shareware Version enthalten.

Mit  diesem  Konverter ist es mglich,  eine Bildschirmdatei  fr  den  Atari
PortFolio  in  ein  lauffhiges Programm umzukonvertieren.  Das  so  erzeugte
Programm ist direkt auf einem Atari PortFolio lauffhig. Wird die so erzeugte
Datei  ohne Parameter aufgerufen,  wird das Bild angezeigt,  und  nach  einem
Tastendruck wieder in Textmodus versetzt.  Wird das Bild mit dem Buchstaben C
als  Parameter  gestartet  (beispielsweise  BILD0  c),  dann  wird  das  Bild
angezeigt,  und  das Programm beendet.  Dadurch ist es mglich,  das Bild aus
einem  anderen  Programm  heraus  aufzurufen,   und  anschlieend mit  diesem
Bildschirminhalt das alte Programm weiterlaufen zu lassen.

Die Handhabung von APF2COM:


  APF2COM  kann  mit einem Dateinamen als  Parameter  gestartet  werden.  Der 
  Dateiname gibt hierbei den Namen der Bilddatei an.

  War  kein  Dateiname angegeben,  so mu als erstes der Namen der  Bilddatei 
  eingegeben werden.

  War ein Dateiname angegeben, so verlangt APF2COM lediglich den Namen des zu
  erzeugenden Programms.  Soll der vorgeschlagene Name bernommen werden,  so
  mu lediglich die RETURN Taste gedrckt werden.

  Die Endung COM mu mit angegeben werden.  Existiert diese Datei  schon,  so
  wird diese ohne vorherige Warnung berschrieben.



Ŀ
        Die Turbo Pascal 5.x Unit    P F G R A P H . U N I                



  PFGRAPH.TPU  ist  eine Grafikbibliothek,  die es  erlaubt,  eigene  Grafik-
  programme  fr  den  Atari PortFolio zu entwickeln.  Die Unit kann  nur  in
  Verbindung mit der Turbo Pascal 5.0 / 5.5 genutzt werden.


  Die einzelnen Grafikroutinen:
  

      INITGRAPH                                   Procedure       

      Syntax : InitGraph;

      Initgraph  setzt den Grafikmodus des  PortFolio's.  Bevor  irgendwelche 
      Grafikroutinen  benutzt werden,  mu diese Procedure aufgerufen  worden 
      sein.


      CLEARDEVICE                                 Procedure

      Syntax : ClearDevice;

      Diese Procedure lscht den Grafikbildschirm.


      SAVESCREEN                                  Procedure

      Syntax : SaveScreen;

      speichert  den  aktuellen  Bildschirminhalt im RAM,  und  kann  mittels 
      LOADSCREEN wieder angezeigt werden.


      LOADSCREEN                                  Procedure

      Syntax : LoadScreen;

      restauriert  den  mit SAVESCREEN  gespeicherten  Bildschirminhalt  beim 
      nchsten Tastendruck.


      LOADSDAT                                    Procedure

      Syntax : LoadSDat(Dateiname : string);

      ldt eine APF Screendatei,  und zeigt diese an.  <Dateiname> beinhaltet
      den Pfad und den Namen der Datei,  die angezeigt werden soll. Existiert 
      diese  Datei  nicht,  so  wird das Programm  mit  einem  Luafzeitfehler 
      beendet.


      SHOWSOBJ                                    Procedure

      Syntax : ShowSObj(puffer : pointer);

      zeigt  einen Bildschirmscreen an.  Die Daten der Bildpunkte sind in dem 
      Zeiger <Puffer> angegeben.  Mit dieser Procedure ist es  mglich,  eine 
      APF  Datei direct in das Programm mit einzubinden.  Hierzu ist folgende 
      Vorgehensweise ntig:

         Die  APF Datei mu in ein OBJ Format gebracht werden.  Hier  bedient 
         man sich am besten mit dem Turbo Pascal Utility BINOBJ:

               BINOBJ Quelldatei ObjDatei Procedurename

              <BINOBJ BILD.APF BILD.OBJ screen>

         Diese Datei wird dann wie folgt in einem Pascal Programm angezeigt:

         Program ZeigeBild;

         uses
          dos,pfcrt,pfgraph;

         var
           ch   : char;

         procedure screen; external;     { unser Bildschirmscreen }
         {$L bild.obj}

         begin
           InitGraph;
           ShowSObj(@screen);
           ch:= readkey;
           CloseGraph;
         end.


         PUTPIXEL                                 Procedure

         Syntax : PutPixel(x,y : integer; f : byte);

         setzt  einen  Punkt  an der in <X,Y> angegebenen Koordinate  in  der 
         Farbe F.  Mgliche Werte fr <X> sind 0..239,  fr <Y> 0..63 und fr 
         <F> 0..1.


         GETPIXEL                                 Function

         Syntax : GetPixel(x,y : integer) : byte;

         liest einen Farbwert an der in <X,Y> angegebenen Farbe aus. Mgliche 
         Werte siehe PUTPIXEL.


         GETIMAGE                                 Procedure

         Syntax : GetImage(x1,y1,x2,y2 : byte; var puffer);

         kopiert   einen   Bildschirmausschnitt,   der  in  den   Koordinaten 
         <X1,Y1,X2,Y2> angegeben ist in einen Speicherbereich.  <X1,Y1>  gibt 
         die Koordinate der linken oberen Ecke an, <X2,Y2> die Koordinate der 
         rechten  unteren  Ecke.   Der  Bildschirmausschnitt  lt  sich  mit 
         PUTIMAGE wieder ausgeben.

         Der Speicherbedarf errechnet sich folgendermaen :

                   Bedarf= ((x2-x1)+1)*((y2-y1)+1)+2



         PUTIMAGE                                 Procedure

         Syntax : PutImage(x1,y1 : byte; var puffer);

         setzt einen mit GETIMAGE kopierten Bildschirmausschnitt an die linke
         obere Ecke, die in <X1,Y1> angegeben ist.


         AKTF                                     Variable

         Syntax : Aktf:= farbwert;

         Der  Inhalt  der  Variablen  <AKTF>  git  die  Farbe  an,   mit  der 
         Zeichenoperationen durchgefhrt werden.


         ELLIPSE                                  Procedure

         Syntax : Ellipse(x,y,rx,ry : integer);

         zeichnet  eine Ellipse mit dem Mittelpunkt <X,Y>,  dem X Radius <RX> 
         und dem Y Radius <RY> mit der in AKTF enthaltenen Farbe.


         CIRCLE                                   Procedure

         Syntax : Circle(x,y,r : integer);

         zeichnet einen Kreis mit dem Mittelpunkt <X,Y>,  dem Radius <R>  mit 
         dem in AKTF enthaltenen Farbwert


         LINE                                     Procedure

         Syntax : Line(x1,y1,x2,y2 : integer);

         zeichnet eine Linie zwischen den Endpunkten <X1,Y1,X2,Y2> mit dem in 
         AKTF enthaltenen Farbwert.


         RECTANGLE                                Procedure

         Syntax : Rectangle(x1,y1,x2,y2 : integer);

         zeichnet   ein   Rechteck  mit  den  in  <X1,Y1,X2,Y2>   angegebenen
         Koordinaten und dem in AKTF angegebenem Farbwert.


         BAR                                      Procedure

         Syntax : BAR(x1,y1,x2,y2 : integer);

         zeichnet   ein  ausgeflltes  Rechteck  mit  den  in   <X1,Y1,X2,Y2> 
         angegebenen Koordinaten und dem in AKTF angegebenen Farbwert.


         FLOODFILL                                Procedure

         Syntax : FloodFill(x,y : integer; f : byte);

         fllt einen umrandeten Bildschirmbereich um die Koordinate <X,Y> mit 
         der Farbe <F> aus.


         FILLPATTERN                              Procedure

         Syntax : FillPattern(x1,y1,x2,y2 : integer; m : fillpatterntype);

         fllt  einen  rechteckigen  Bereich mit  einem  Muster  aus,  dessen 
         Koordinaten    in   <X1,Y1,X2,Y2>   angegeben    sind.    Der    Typ 
         <FILLPATTERNTYPE>   ist  im  Interface  als  <array[1..8]  of  byte> 
         deklariert.  Dieses Array beinhaltet das Bitmuster,  das  ausgegeben 
         werden soll.


         CLOSEGRAPH                               Procedure

         Syntax : CloseGraph;

         beendet den Grafikmodus und setzt den Textmodi 0.


  Die  Pascal Unit PCGRAPH.TPU enthlt dieselben Routinen  wie  PFGRAPH,  nur 
  sind diese Routinen zum Austesten auf einem PC gedacht.  Es ist sinnvoll in 
  der  USES Anweisung whrend der Entwicklung eines Grafikprogramms die  Unit
  PCGRAPH  anzugeben.  Nach  Fertigstellung  des Programms wird dann  an  die 
  Stelle von PCGRAPH nur noch PFGRAPH angegeben,  und schon luft das Program 
  auf einem Atari PortFolio.



Ŀ
           Die Turbo Pascal 5.x Unit    P F C R T . U N I                 



  Ein  Turbo Pascal Programm,  das auf dem Atari PortFolio laufen soll,  darf 
  nicht  die Standart Unit CRT benutzen,  da diese den PortFolio zum  Absturz 
  bringt.

  Nun knnen auf manche Funktionen der Unit CRT nur schwer verzichtet werden. 
  Die Unit PFCRT bildet die wichtigsten Routinen von CRT nach,  die auch  auf 
  einem PortFolio laufen.

  Folgende Routinen sind implementiert:

                - CLRSCR
                - WHEREX
                - WHEREY
                - GOTOXY
                - READKEY
                - INSLINE
                - DELLINE
                - TEXTMODE
                - KEYPRESSED



  Da  diese Funktionen Nachbildungen der Unit CRT darstellen,  knnen Sie die 
  Funktionsbeschreibung  den Handbchern zu Turbo Pascal entnehmen  (und  mir 
  einige Tipparbeit ersparen).



  Unterschiede zwischen Shareware und registerter Version
  

  Die registrierte Version hat:

      - keine  Wartezeiten  bei den Lade- und Speicheraktionen von  PortFolio 
        Paint

      - den Quellcode der Turbo Pascal Units PFGRAPH, PCGRAPH und PFCRT.

      - die Option der Verzeichnisangabe und Dateizhler der PortFolio Camera

      - den  Screenkonverter  APF2COM,  mit dem es  mglich  ist,  ein  Bild-
        schirminhalt in ein Programm zu konvertieren.

      -  und mir eine Anerkennung fr meine Arbeit gegeben.




  Eine   registrierte   Vollversion   kostet  39,95   DM.   Sie   ist   gegen
    Verrechnungsscheck oder Vorkasse nur bei mir erhltlich.



    Registrierungsformular:
  
  Ŀ
    Registrierung von :                                       
                   Die Atari PortFolio Grafik Toolbox         
  Ĵ
                                                              
    fr                                                       
                                                              
  Ŀ      
    Name   :                                                 
  Ĵ      
    Strae :                                                 
  Ĵ      
    Ort    :                                                 
        
                                                              
                                                              
        Preis                 : 39,95 DM                      
        Porto und Verpackung  :  3,00 DM                      
                               ----------                     
        Gesamt                : 42,95 DM                      
                                                              
  
